SetFile.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.io;
  19. import java.io.*;
  20. import org.apache.hadoop.fs.*;
  21. import org.apache.hadoop.conf.*;
  22. /** A file-based set of keys. */
  23. public class SetFile extends MapFile {
  24.   protected SetFile() {}                            // no public ctor
  25.   /** 
  26.    * Write a new set file.
  27.    */
  28.   public static class Writer extends MapFile.Writer {
  29.     /** Create the named set for keys of the named class. 
  30.      *  @deprecated pass a Configuration too
  31.      */
  32.     public Writer(FileSystem fs, String dirName,
  33. Class<? extends WritableComparable> keyClass) throws IOException {
  34.       super(new Configuration(), fs, dirName, keyClass, NullWritable.class);
  35.     }
  36.     /** Create a set naming the element class and compression type. */
  37.     public Writer(Configuration conf, FileSystem fs, String dirName,
  38.                   Class<? extends WritableComparable> keyClass,
  39.                   SequenceFile.CompressionType compress)
  40.       throws IOException {
  41.       this(conf, fs, dirName, WritableComparator.get(keyClass), compress);
  42.     }
  43.     /** Create a set naming the element comparator and compression type. */
  44.     public Writer(Configuration conf, FileSystem fs, String dirName,
  45.                   WritableComparator comparator,
  46.                   SequenceFile.CompressionType compress) throws IOException {
  47.       super(conf, fs, dirName, comparator, NullWritable.class, compress);
  48.     }
  49.     /** Append a key to a set.  The key must be strictly greater than the
  50.      * previous key added to the set. */
  51.     public void append(WritableComparable key) throws IOException{
  52.       append(key, NullWritable.get());
  53.     }
  54.   }
  55.   /** Provide access to an existing set file. */
  56.   public static class Reader extends MapFile.Reader {
  57.     /** Construct a set reader for the named set.*/
  58.     public Reader(FileSystem fs, String dirName, Configuration conf) throws IOException {
  59.       super(fs, dirName, conf);
  60.     }
  61.     /** Construct a set reader for the named set using the named comparator.*/
  62.     public Reader(FileSystem fs, String dirName, WritableComparator comparator, Configuration conf)
  63.       throws IOException {
  64.       super(fs, dirName, comparator, conf);
  65.     }
  66.     // javadoc inherited
  67.     public boolean seek(WritableComparable key)
  68.       throws IOException {
  69.       return super.seek(key);
  70.     }
  71.     /** Read the next key in a set into <code>key</code>.  Returns
  72.      * true if such a key exists and false when at the end of the set. */
  73.     public boolean next(WritableComparable key)
  74.       throws IOException {
  75.       return next(key, NullWritable.get());
  76.     }
  77.     /** Read the matching key from a set into <code>key</code>.
  78.      * Returns <code>key</code>, or null if no match exists. */
  79.     public WritableComparable get(WritableComparable key)
  80.       throws IOException {
  81.       if (seek(key)) {
  82.         next(key);
  83.         return key;
  84.       } else
  85.         return null;
  86.     }
  87.   }
  88. }