TaskInputOutputContext.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.mapreduce;
  19. import java.io.IOException;
  20. import org.apache.hadoop.conf.Configuration;
  21. import org.apache.hadoop.util.Progressable;
  22. /**
  23.  * A context object that allows input and output from the task. It is only
  24.  * supplied to the {@link Mapper} or {@link Reducer}.
  25.  * @param <KEYIN> the input key type for the task
  26.  * @param <VALUEIN> the input value type for the task
  27.  * @param <KEYOUT> the output key type for the task
  28.  * @param <VALUEOUT> the output value type for the task
  29.  */
  30. public abstract class TaskInputOutputContext<KEYIN,VALUEIN,KEYOUT,VALUEOUT> 
  31.        extends TaskAttemptContext implements Progressable {
  32.   private RecordWriter<KEYOUT,VALUEOUT> output;
  33.   private StatusReporter reporter;
  34.   private OutputCommitter committer;
  35.   public TaskInputOutputContext(Configuration conf, TaskAttemptID taskid,
  36.                                 RecordWriter<KEYOUT,VALUEOUT> output,
  37.                                 OutputCommitter committer,
  38.                                 StatusReporter reporter) {
  39.     super(conf, taskid);
  40.     this.output = output;
  41.     this.reporter = reporter;
  42.     this.committer = committer;
  43.   }
  44.   /**
  45.    * Advance to the next key, value pair, returning null if at end.
  46.    * @return the key object that was read into, or null if no more
  47.    */
  48.   public abstract 
  49.   boolean nextKeyValue() throws IOException, InterruptedException;
  50.  
  51.   /**
  52.    * Get the current key.
  53.    * @return the current key object or null if there isn't one
  54.    * @throws IOException
  55.    * @throws InterruptedException
  56.    */
  57.   public abstract 
  58.   KEYIN getCurrentKey() throws IOException, InterruptedException;
  59.   /**
  60.    * Get the current value.
  61.    * @return the value object that was read into
  62.    * @throws IOException
  63.    * @throws InterruptedException
  64.    */
  65.   public abstract VALUEIN getCurrentValue() throws IOException, 
  66.                                                    InterruptedException;
  67.   /**
  68.    * Generate an output key/value pair.
  69.    */
  70.   public void write(KEYOUT key, VALUEOUT value
  71.                     ) throws IOException, InterruptedException {
  72.     output.write(key, value);
  73.   }
  74.   public Counter getCounter(Enum<?> counterName) {
  75.     return reporter.getCounter(counterName);
  76.   }
  77.   public Counter getCounter(String groupName, String counterName) {
  78.     return reporter.getCounter(groupName, counterName);
  79.   }
  80.   @Override
  81.   public void progress() {
  82.     reporter.progress();
  83.   }
  84.   @Override
  85.   public void setStatus(String status) {
  86.     reporter.setStatus(status);
  87.   }
  88.   
  89.   public OutputCommitter getOutputCommitter() {
  90.     return committer;
  91.   }
  92. }