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

网格计算

开发平台:

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 java.util.Collection;
  21. import java.util.List;
  22. import org.apache.hadoop.conf.Configurable;
  23. import org.apache.hadoop.conf.Configuration;
  24. /**
  25.  * Used by a {@link JobTracker} to schedule {@link Task}s on
  26.  * {@link TaskTracker}s.
  27.  * <p>
  28.  * {@link TaskScheduler}s typically use one or more
  29.  * {@link JobInProgressListener}s to receive notifications about jobs.
  30.  * <p>
  31.  * It is the responsibility of the {@link TaskScheduler}
  32.  * to initialize tasks for a job, by calling {@link JobInProgress#initTasks()}
  33.  * between the job being added (when
  34.  * {@link JobInProgressListener#jobAdded(JobInProgress)} is called)
  35.  * and tasks for that job being assigned (by
  36.  * {@link #assignTasks(TaskTrackerStatus)}).
  37.  * @see EagerTaskInitializationListener
  38.  */
  39. abstract class TaskScheduler implements Configurable {
  40.   protected Configuration conf;
  41.   protected TaskTrackerManager taskTrackerManager;
  42.   
  43.   public Configuration getConf() {
  44.     return conf;
  45.   }
  46.   public void setConf(Configuration conf) {
  47.     this.conf = conf;
  48.   }
  49.   public synchronized void setTaskTrackerManager(
  50.       TaskTrackerManager taskTrackerManager) {
  51.     this.taskTrackerManager = taskTrackerManager;
  52.   }
  53.   
  54.   /**
  55.    * Lifecycle method to allow the scheduler to start any work in separate
  56.    * threads.
  57.    * @throws IOException
  58.    */
  59.   public void start() throws IOException {
  60.     // do nothing
  61.   }
  62.   
  63.   /**
  64.    * Lifecycle method to allow the scheduler to stop any work it is doing.
  65.    * @throws IOException
  66.    */
  67.   public void terminate() throws IOException {
  68.     // do nothing
  69.   }
  70.   /**
  71.    * Returns the tasks we'd like the TaskTracker to execute right now.
  72.    * 
  73.    * @param taskTracker The TaskTracker for which we're looking for tasks.
  74.    * @return A list of tasks to run on that TaskTracker, possibly empty.
  75.    */
  76.   public abstract List<Task> assignTasks(TaskTrackerStatus taskTracker)
  77.     throws IOException;
  78.   /**
  79.    * Returns a collection of jobs in an order which is specific to 
  80.    * the particular scheduler.
  81.    * @param queueName
  82.    * @return
  83.    */
  84.   public abstract Collection<JobInProgress> getJobs(String queueName);
  85.     
  86. }