RecordReader.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.Closeable;
  20. import java.io.IOException;
  21. /**
  22.  * The record reader breaks the data into key/value pairs for input to the
  23.  * {@link Mapper}.
  24.  * @param <KEYIN>
  25.  * @param <VALUEIN>
  26.  */
  27. public abstract class RecordReader<KEYIN, VALUEIN> implements Closeable {
  28.   /**
  29.    * Called once at initialization.
  30.    * @param split the split that defines the range of records to read
  31.    * @param context the information about the task
  32.    * @throws IOException
  33.    * @throws InterruptedException
  34.    */
  35.   public abstract void initialize(InputSplit split,
  36.                                   TaskAttemptContext context
  37.                                   ) throws IOException, InterruptedException;
  38.   /**
  39.    * Read the next key, value pair.
  40.    * @return true if a key/value pair was read
  41.    * @throws IOException
  42.    * @throws InterruptedException
  43.    */
  44.   public abstract 
  45.   boolean nextKeyValue() throws IOException, InterruptedException;
  46.   /**
  47.    * Get the current key
  48.    * @return the current key or null if there is no current key
  49.    * @throws IOException
  50.    * @throws InterruptedException
  51.    */
  52.   public abstract
  53.   KEYIN getCurrentKey() throws IOException, InterruptedException;
  54.   
  55.   /**
  56.    * Get the current value.
  57.    * @return the object that was read
  58.    * @throws IOException
  59.    * @throws InterruptedException
  60.    */
  61.   public abstract 
  62.   VALUEIN getCurrentValue() throws IOException, InterruptedException;
  63.   
  64.   /**
  65.    * The current progress of the record reader through its data.
  66.    * @return a number between 0.0 and 1.0 that is the fraction of the data read
  67.    * @throws IOException
  68.    * @throws InterruptedException
  69.    */
  70.   public abstract float getProgress() throws IOException, InterruptedException;
  71.   
  72.   /**
  73.    * Close the record reader.
  74.    */
  75.   public abstract void close() throws IOException;
  76. }