org.apache.hadoop.tools

Class FileBasedCopyListing

java.lang.Object

org.apache.hadoop.conf.Configured

org.apache.hadoop.tools.CopyListing

org.apache.hadoop.tools.FileBasedCopyListing

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable

public class FileBasedCopyListing
extends CopyListing

FileBasedCopyListing implements the CopyListing interface, to create the copy-listing for DistCp, by iterating over all source paths mentioned in a specified input-file.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.tools.CopyListing

CopyListing.AclsNotSupportedException, CopyListing.XAttrsNotSupportedException

Constructor Summary

Constructors

Constructor and Description
FileBasedCopyListing(org.apache.hadoop.conf.Configuration configuration, org.apache.hadoop.security.Credentials credentials) Constructor, to initialize base-class.

Method Summary

Methods

Modifier and Type	Method and Description
void	doBuildListing(org.apache.hadoop.fs.Path pathToListFile, DistCpOptions options) Implementation of CopyListing::buildListing().
protected long	getBytesToCopy() Return the total bytes that distCp should copy for the source paths This doesn't consider whether file is same should be skipped during copy
protected long	getNumberOfPaths() Return the total number of paths to distcp, includes directories as well This doesn't consider whether file/dir is already present and should be skipped during copy
protected void	validatePaths(DistCpOptions options) Validate input and output paths

Methods inherited from class org.apache.hadoop.tools.CopyListing

buildListing, getCopyListing, getCredentials, setCredentials

Methods inherited from class org.apache.hadoop.conf.Configured

getConf, setConf

Methods inherited from class java.lang.Object

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

Constructor Detail

FileBasedCopyListing

public FileBasedCopyListing(org.apache.hadoop.conf.Configuration configuration,
                    org.apache.hadoop.security.Credentials credentials)

Constructor, to initialize base-class.

Parameters:

configuration - The input Configuration object.

credentials - - Credentials object on which the FS delegation tokens are cached. If null delegation token caching is skipped

Method Detail

validatePaths

protected void validatePaths(DistCpOptions options)
                      throws IOException,
                             org.apache.hadoop.tools.CopyListing.InvalidInputException

Validate input and output paths

Specified by:

validatePaths in class CopyListing

Parameters:

options - - Input options

Throws:

IOException - any Exception with FS

org.apache.hadoop.tools.CopyListing.InvalidInputException

doBuildListing

public void doBuildListing(org.apache.hadoop.fs.Path pathToListFile,
                  DistCpOptions options)
                    throws IOException

Implementation of CopyListing::buildListing(). Iterates over all source paths mentioned in the input-file.

Specified by:

doBuildListing in class CopyListing

Parameters:

pathToListFile - Path on HDFS where the listing file is written.

options - Input Options for DistCp (indicating source/target paths.)

Throws:

IOException

getBytesToCopy

protected long getBytesToCopy()

Return the total bytes that distCp should copy for the source paths This doesn't consider whether file is same should be skipped during copy

Specified by:

getBytesToCopy in class CopyListing

Returns:

total bytes to copy

getNumberOfPaths

protected long getNumberOfPaths()

Return the total number of paths to distcp, includes directories as well This doesn't consider whether file/dir is already present and should be skipped during copy

Specified by:

getNumberOfPaths in class CopyListing

Returns:

Total number of paths to distcp