org.apache.hadoop.fs.s3a.commit.files

Class PendingSet

java.lang.Object

org.apache.hadoop.fs.s3a.commit.files.PersistentCommitData

org.apache.hadoop.fs.s3a.commit.files.PendingSet

All Implemented Interfaces:

Serializable

@InterfaceAudience.Private
 @InterfaceStability.Unstable
public class PendingSet
extends PersistentCommitData

Persistent format for multiple pending commits. Contains 0 or more SinglePendingCommit entries; validation logic checks those values on load.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	VERSION Supported version value: 1.

Constructor Summary

Constructors

Constructor and Description
PendingSet()
PendingSet(int size)

Method Summary

Modifier and Type	Method and Description
void	add(SinglePendingCommit commit) Add a commit.
List<SinglePendingCommit>	getCommits()
int	getVersion()
static PendingSet	load(org.apache.hadoop.fs.FileSystem fs, org.apache.hadoop.fs.Path path) Load an instance from a file, then validate it.
void	save(org.apache.hadoop.fs.FileSystem fs, org.apache.hadoop.fs.Path path, boolean overwrite) Save to a hadoop filesystem.
static org.apache.hadoop.util.JsonSerialization<PendingSet>	serializer() Get a JSON serializer for this class.
void	setCommits(List<SinglePendingCommit> commits)
void	setVersion(int version)
int	size() Number of commits.
byte[]	toBytes() Serialize to JSON and then to a byte array, after performing a preflight validation of the data to be saved.
void	validate() Validate the data: those fields which must be non empty, must be set.

Methods inherited from class java.lang.Object

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

Field Detail

VERSION

public static final int VERSION

Supported version value: 1. If this is changed the value of serialVersionUID will change, to avoid deserialization problems.

See Also:

Constant Field Values

Constructor Detail

PendingSet

public PendingSet()

PendingSet

public PendingSet(int size)

Method Detail

serializer

public static org.apache.hadoop.util.JsonSerialization<PendingSet> serializer()

Get a JSON serializer for this class.

Returns:

a serializer.

load

public static PendingSet load(org.apache.hadoop.fs.FileSystem fs,
                              org.apache.hadoop.fs.Path path)
                       throws IOException

Load an instance from a file, then validate it.

Parameters:

fs - filesystem

path - path

Returns:

the loaded instance

Throws:

IOException - IO failure

ValidationFailure - if the data is invalid

add

public void add(SinglePendingCommit commit)

Add a commit.

Parameters:

commit - the single commit

validate

public void validate()
              throws ValidationFailure

Validate the data: those fields which must be non empty, must be set.

Specified by:

validate in class PersistentCommitData

Throws:

ValidationFailure - if the data is invalid

toBytes

public byte[] toBytes()
               throws IOException

Description copied from class: PersistentCommitData

Serialize to JSON and then to a byte array, after performing a preflight validation of the data to be saved.

Specified by:

toBytes in class PersistentCommitData

Returns:

the data in a persistable form.

Throws:

IOException - serialization problem or validation failure.

size

public int size()

Number of commits.

Returns:

the number of commits in this structure.

save

public void save(org.apache.hadoop.fs.FileSystem fs,
                 org.apache.hadoop.fs.Path path,
                 boolean overwrite)
          throws IOException

Description copied from class: PersistentCommitData

Save to a hadoop filesystem.

Specified by:

save in class PersistentCommitData

Parameters:

fs - filesystem

path - path

overwrite - should any existing file be overwritten

Throws:

IOException - IO exception

getVersion

public int getVersion()

Returns:

the version marker.

setVersion

public void setVersion(int version)

getCommits

public List<SinglePendingCommit> getCommits()

Returns:

commit list.

setCommits

public void setCommits(List<SinglePendingCommit> commits)