Package org.apache.hadoop.io

Class MapFile

java.lang.Object

org.apache.hadoop.io.MapFile

Direct Known Subclasses:

ArrayFile, SetFile

@Public
@Stable
public class MapFile
extends java.lang.Object

A file-based map from keys to values.

A map is a directory containing two files, the data file, containing all keys and values in the map, and a smaller index file, containing a fraction of the keys. The fraction is determined by MapFile.Writer.getIndexInterval().

The index file is read entirely into memory. Thus key implementations should try to keep themselves small.

Map files are created by adding entries in-order. To maintain a large database, perform updates by copying the previous version of a database and merging in a sorted change list, to create a new version of the database in a new file. Sorting large change lists can be done with SequenceFile.Sorter.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MapFile.Merger	Class to merge multiple MapFiles of same Key and Value types to one MapFile
static class	MapFile.Reader	Provide access to an existing map.
static class	MapFile.Writer	Writes a new map.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	DATA_FILE_NAME	The name of the data file.
static java.lang.String	INDEX_FILE_NAME	The name of the index file.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MapFile()

Method Summary

Modifier and Type	Method	Description
static void	delete(FileSystem fs, java.lang.String name)	Deletes the named map file.
static long	fix(FileSystem fs, Path dir, java.lang.Class<? extends Writable> keyClass, java.lang.Class<? extends Writable> valueClass, boolean dryrun, Configuration conf)	This method attempts to fix a corrupt MapFile by re-creating its index.
static void	main(java.lang.String[] args)
static void	rename(FileSystem fs, java.lang.String oldName, java.lang.String newName)	Renames an existing map directory.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INDEX_FILE_NAME

public static final java.lang.String INDEX_FILE_NAME

The name of the index file.

See Also:

Constant Field Values

DATA_FILE_NAME

public static final java.lang.String DATA_FILE_NAME

The name of the data file.

See Also:

Constant Field Values

Constructor Detail

MapFile

protected MapFile()

Method Detail

rename

public static void rename(FileSystem fs,
                          java.lang.String oldName,
                          java.lang.String newName)
                   throws java.io.IOException

Renames an existing map directory.

Parameters:

fs - fs.

oldName - oldName.

newName - newName.

Throws:

java.io.IOException - raised on errors performing I/O.

delete

public static void delete(FileSystem fs,
                          java.lang.String name)
                   throws java.io.IOException

Deletes the named map file.

Parameters:

fs - input fs.

name - input name.

Throws:

java.io.IOException - raised on errors performing I/O.

fix

public static long fix(FileSystem fs,
                       Path dir,
                       java.lang.Class<? extends Writable> keyClass,
                       java.lang.Class<? extends Writable> valueClass,
                       boolean dryrun,
                       Configuration conf)
                throws java.lang.Exception

This method attempts to fix a corrupt MapFile by re-creating its index.

Parameters:

fs - filesystem

dir - directory containing the MapFile data and index

keyClass - key class (has to be a subclass of Writable)

valueClass - value class (has to be a subclass of Writable)

dryrun - do not perform any changes, just report what needs to be done

conf - configuration.

Returns:

number of valid entries in this MapFile, or -1 if no fixing was needed

Throws:

java.lang.Exception - Exception.

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception