org.apache.hadoop.fs.azure

Class NativeAzureFileSystem.FolderRenamePending

java.lang.Object

org.apache.hadoop.fs.azure.NativeAzureFileSystem.FolderRenamePending

Enclosing class:

NativeAzureFileSystem

public static class NativeAzureFileSystem.FolderRenamePending
extends Object

A description of a folder rename operation, including the source and destination keys, and descriptions of the files in the source folder.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SUFFIX

Constructor Summary

Constructors

Constructor and Description
FolderRenamePending(org.apache.hadoop.fs.Path redoFile, NativeAzureFileSystem fs)
FolderRenamePending(String srcKey, String dstKey, SelfRenewingLease lease, NativeAzureFileSystem fs)

Method Summary

Modifier and Type	Method and Description
void	cleanup() Clean up after execution of rename.
void	execute() Execute a folder rename.
String	getDstKey()
org.apache.hadoop.fs.azure.FileMetadata[]	getFiles()
SelfRenewingLease	getFolderLease()
org.apache.hadoop.fs.azure.FileMetadata	getSourceMetadata()
String	getSrcKey()
String	makeRenamePendingFileContents() Return the contents of the JSON file to represent the operations to be performed for a folder rename.
void	redo() Recover from a folder rename failure by redoing the intended work, as recorded in the -RenamePending.json file.
void	writeFile(NativeAzureFileSystem fs) Write to disk the information needed to redo folder rename, in JSON format.

Methods inherited from class java.lang.Object

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

Field Detail

SUFFIX

public static final String SUFFIX

See Also:

Constant Field Values

Constructor Detail

FolderRenamePending

public FolderRenamePending(String srcKey,
                           String dstKey,
                           SelfRenewingLease lease,
                           NativeAzureFileSystem fs)
                    throws IOException

Throws:

IOException

FolderRenamePending

public FolderRenamePending(org.apache.hadoop.fs.Path redoFile,
                           NativeAzureFileSystem fs)
                    throws IllegalArgumentException,
                           IOException

Throws:

IllegalArgumentException

IOException

Method Detail

getFiles

public org.apache.hadoop.fs.azure.FileMetadata[] getFiles()

getFolderLease

public SelfRenewingLease getFolderLease()

writeFile

public void writeFile(NativeAzureFileSystem fs)
               throws IOException

Write to disk the information needed to redo folder rename, in JSON format. The file name will be wasb://<sourceFolderPrefix>/folderName-RenamePending.json The file format will be:

 {
   FormatVersion: "1.0",
   OperationTime: "<YYYY-MM-DD HH:MM:SS.MMM>",
   OldFolderName: "<key>",
   NewFolderName: "<key>",
   FileList: [ <string> , <string> , ... ]
 }

 Here's a sample:
 {
  FormatVersion: "1.0",
  OperationUTCTime: "2014-07-01 23:50:35.572",
  OldFolderName: "user/ehans/folderToRename",
  NewFolderName: "user/ehans/renamedFolder",
  FileList: [
    "innerFile",
    "innerFile2"
  ]
 } 

Parameters:

fs - file system on which a file is written.

Throws:

IOException - Thrown when fail to write file.

makeRenamePendingFileContents

public String makeRenamePendingFileContents()

Return the contents of the JSON file to represent the operations to be performed for a folder rename.

Returns:

JSON string which represents the operation.

getSrcKey

public String getSrcKey()

getDstKey

public String getDstKey()

getSourceMetadata

public org.apache.hadoop.fs.azure.FileMetadata getSourceMetadata()
                                                          throws IOException

Throws:

IOException

execute

public void execute()
             throws IOException

Execute a folder rename. This is the execution path followed when everything is working normally. See redo() for the alternate execution path for the case where we're recovering from a folder rename failure.

Throws:

IOException - Thrown when fail to renaming.

cleanup

public void cleanup()
             throws IOException

Clean up after execution of rename.

Throws:

IOException - Thrown when fail to clean up.

redo

public void redo()
          throws IOException

Recover from a folder rename failure by redoing the intended work, as recorded in the -RenamePending.json file.

Throws:

IOException - Thrown when fail to redo.