/** * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.apache.pig.test; import java.io.IOException; import java.util.Properties; import org.apache.hadoop.conf.Configuration; import org.apache.hadoop.fs.FileSystem; import org.apache.hadoop.hdfs.MiniDFSCluster; import org.apache.pig.ExecType; import org.apache.pig.backend.hadoop.datastorage.ConfigurationUtil; /** * This class builds a single instance of itself with the Singleton * design pattern. While building the single instance, it sets up a * mini cluster that actually consists of a mini DFS cluster and a * mini MapReduce cluster on the local machine and also sets up the * environment for Pig to run on top of the mini cluster. * * This class is the base class for MiniCluster, which has slightly * difference among different versions of hadoop. MiniCluster implementation * is located in $PIG_HOME/shims. */ abstract public class MiniGenericCluster { protected MiniDFSCluster m_dfs = null; protected FileSystem m_fileSys = null; protected Configuration m_conf = null; protected static MiniGenericCluster INSTANCE = null; protected static boolean isSetup = false; public static String EXECTYPE_MR = "mr"; public static String EXECTYPE_TEZ = "tez"; public static String EXECTYPE_SPARK = "spark"; /** * Returns the single instance of class MiniGenericCluster that represents * the resources for a mini dfs cluster and a mini mr (or tez) cluster. The * system property "test.exec.type" is used to decide whether a mr or tez mini * cluster will be returned. */ public static MiniGenericCluster buildCluster() { if (INSTANCE == null) { String execType = System.getProperty("test.exec.type"); if (execType == null) { // Default to MR System.setProperty("test.exec.type", EXECTYPE_MR); return buildCluster(EXECTYPE_MR); } return buildCluster(execType); } return INSTANCE; } public static MiniGenericCluster buildCluster(String execType) { if (INSTANCE == null) { if (execType.equalsIgnoreCase(EXECTYPE_MR)) { INSTANCE = new MiniCluster(); } else if (execType.equalsIgnoreCase(EXECTYPE_TEZ)) { INSTANCE = new TezMiniCluster(); } else if (execType.equalsIgnoreCase(EXECTYPE_SPARK)) { INSTANCE = new SparkMiniCluster(); } else { throw new RuntimeException("Unknown test.exec.type: " + execType); } } if (!isSetup) { INSTANCE.setupMiniDfsAndMrClusters(); isSetup = true; } return INSTANCE; } abstract public ExecType getExecType(); abstract protected void setupMiniDfsAndMrClusters(); public void shutDown(){ INSTANCE.shutdownMiniDfsAndMrClusters(); } @Override protected void finalize() { shutdownMiniDfsAndMrClusters(); } protected void shutdownMiniDfsAndMrClusters() { isSetup = false; shutdownMiniDfsClusters(); shutdownMiniMrClusters(); m_conf = null; } protected void shutdownMiniDfsClusters() { try { if (m_fileSys != null) { m_fileSys.close(); } } catch (IOException e) { e.printStackTrace(); } if (m_dfs != null) { m_dfs.shutdown(); } m_fileSys = null; m_dfs = null; } abstract protected void shutdownMiniMrClusters(); public Properties getProperties() { errorIfNotSetup(); return ConfigurationUtil.toProperties(m_conf); } public Configuration getConfiguration() { return new Configuration(m_conf); } public void setProperty(String name, String value) { errorIfNotSetup(); m_conf.set(name, value); } public FileSystem getFileSystem() { errorIfNotSetup(); return m_fileSys; } /** * Throw RunTimeException if isSetup is false */ private void errorIfNotSetup(){ if(isSetup) return; String msg = "function called on MiniCluster that has been shutdown"; throw new RuntimeException(msg); } }