TaskSelector.java
上传用户:quxuerui
上传日期:2018-01-08
资源大小:41811k
文件大小:4k
源码类别:

网格计算

开发平台:

Java

  1. /**
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  *     http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing, software
  13.  * distributed under the License is distributed on an "AS IS" BASIS,
  14.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15.  * See the License for the specific language governing permissions and
  16.  * limitations under the License.
  17.  */
  18. package org.apache.hadoop.mapred;
  19. import java.io.IOException;
  20. import org.apache.hadoop.conf.Configurable;
  21. import org.apache.hadoop.conf.Configuration;
  22. /**
  23.  * A pluggable object for selecting tasks to run from a {@link JobInProgress} on
  24.  * a given {@link TaskTracker}, for use by the {@link TaskScheduler}. The
  25.  * <code>TaskSelector</code> is in charge of managing both locality and
  26.  * speculative execution. For the latter purpose, it must also provide counts of
  27.  * how many tasks each speculative job needs to launch, so that the scheduler
  28.  * can take this into account in its calculations.
  29.  */
  30. public abstract class TaskSelector implements Configurable {
  31.   protected Configuration conf;
  32.   protected TaskTrackerManager taskTrackerManager;
  33.   
  34.   public Configuration getConf() {
  35.     return conf;
  36.   }
  37.   public void setConf(Configuration conf) {
  38.     this.conf = conf;
  39.   }
  40.   public synchronized void setTaskTrackerManager(
  41.       TaskTrackerManager taskTrackerManager) {
  42.     this.taskTrackerManager = taskTrackerManager;
  43.   }
  44.   
  45.   /**
  46.    * Lifecycle method to allow the TaskSelector to start any work in separate
  47.    * threads.
  48.    */
  49.   public void start() throws IOException {
  50.     // do nothing
  51.   }
  52.   
  53.   /**
  54.    * Lifecycle method to allow the TaskSelector to stop any work it is doing.
  55.    */
  56.   public void terminate() throws IOException {
  57.     // do nothing
  58.   }
  59.   
  60.   /**
  61.    * How many speculative map tasks does the given job want to launch?
  62.    * @param job The job to count speculative maps for
  63.    * @return Number of speculative maps that can be launched for job
  64.    */
  65.   public abstract int neededSpeculativeMaps(JobInProgress job);
  66.   /**
  67.    * How many speculative reduce tasks does the given job want to launch?
  68.    * @param job The job to count speculative reduces for
  69.    * @return Number of speculative reduces that can be launched for job
  70.    */
  71.   public abstract int neededSpeculativeReduces(JobInProgress job);
  72.   
  73.   /**
  74.    * Choose a map task to run from the given job on the given TaskTracker.
  75.    * @param taskTracker {@link TaskTrackerStatus} of machine to run on
  76.    * @param job Job to select a task for
  77.    * @return A {@link Task} to run on the machine, or <code>null</code> if
  78.    *         no map should be launched from this job on the task tracker.
  79.    * @throws IOException 
  80.    */
  81.   public abstract Task obtainNewMapTask(TaskTrackerStatus taskTracker,
  82.       JobInProgress job) throws IOException;
  83.   /**
  84.    * Choose a reduce task to run from the given job on the given TaskTracker.
  85.    * @param taskTracker {@link TaskTrackerStatus} of machine to run on
  86.    * @param job Job to select a task for
  87.    * @return A {@link Task} to run on the machine, or <code>null</code> if
  88.    *         no reduce should be launched from this job on the task tracker.
  89.    * @throws IOException 
  90.    */
  91.   public abstract Task obtainNewReduceTask(TaskTrackerStatus taskTracker,
  92.       JobInProgress job) throws IOException;
  93. }