Package org.elasticsearch.repositories

Class RepositoryData

java.lang.Object

org.elasticsearch.repositories.RepositoryData

public final class RepositoryData
extends Object

A class that represents the data in a repository, as captured in the repository's index blob.

Field Summary

Fields

Modifier and Type	Field	Description
static RepositoryData	EMPTY	An instance initialized for an empty repository.
static long	EMPTY_REPO_GEN	The generation value indicating the repository has no index generational files.

Constructor Summary

Constructors

Constructor	Description
RepositoryData(long genId, Map<String,SnapshotId> snapshotIds, Map<String,SnapshotState> snapshotStates, Map<IndexId,Set<SnapshotId>> indexSnapshots)

Method Summary

Modifier and Type	Method	Description
RepositoryData	addSnapshot(SnapshotId snapshotId, SnapshotState snapshotState, List<IndexId> snapshottedIndices)	Add a snapshot and its indices to the repository; returns a new instance.
protected RepositoryData	copy()
boolean	equals(Object obj)
long	getGenId()	Gets the generational index file id from which this instance was read.
Map<String,IndexId>	getIndices()	Returns an unmodifiable map of the index names to IndexId in the repository.
Collection<SnapshotId>	getSnapshotIds()	Returns an unmodifiable collection of the snapshot ids.
Set<SnapshotId>	getSnapshots(IndexId indexId)	Returns an immutable collection of the snapshot ids for the snapshots that contain the given index.
SnapshotState	getSnapshotState(SnapshotId snapshotId)	Returns the SnapshotState for the given snapshot.
int	hashCode()
List<IndexId>	indicesToUpdateAfterRemovingSnapshot(SnapshotId snapshotId)	Returns the list of IndexId that have their snapshots updated but not removed (because they are still referenced by other snapshots) after removing the given snapshot from the repository.
RepositoryData	removeSnapshot(SnapshotId snapshotId)	Remove a snapshot and remove any indices that no longer exist in the repository due to the deletion of the snapshot.
IndexId	resolveIndexId(String indexName)	Resolve the index name to the index id specific to the repository, throwing an exception if the index could not be resolved.
List<IndexId>	resolveIndices(List<String> indices)	Resolve the given index names to index ids.
List<IndexId>	resolveNewIndices(List<String> indicesToResolve)	Resolve the given index names to index ids, creating new index ids for new indices in the repository.
static RepositoryData	snapshotsFromXContent(XContentParser parser, long genId)	Reads an instance of RepositoryData from x-content, loading the snapshots and indices metadata.
XContentBuilder	snapshotsToXContent(XContentBuilder builder)	Writes the snapshots metadata and the related indices metadata to x-content.
RepositoryData	withGenId(long newGeneration)	Create a new instance with the given generation and all other fields equal to this instance.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_REPO_GEN

public static final long EMPTY_REPO_GEN

The generation value indicating the repository has no index generational files.

See Also:

Constant Field Values

EMPTY

public static final RepositoryData EMPTY

An instance initialized for an empty repository.

Constructor Detail

RepositoryData

public RepositoryData(long genId,
                      Map<String,SnapshotId> snapshotIds,
                      Map<String,SnapshotState> snapshotStates,
                      Map<IndexId,Set<SnapshotId>> indexSnapshots)

Method Detail

copy

protected RepositoryData copy()

getGenId

public long getGenId()

Gets the generational index file id from which this instance was read.

getSnapshotIds

public Collection<SnapshotId> getSnapshotIds()

Returns an unmodifiable collection of the snapshot ids.

getSnapshotState

@Nullable
public SnapshotState getSnapshotState(SnapshotId snapshotId)

Returns the SnapshotState for the given snapshot. Returns null if there is no state for the snapshot.

getIndices

public Map<String,IndexId> getIndices()

Returns an unmodifiable map of the index names to IndexId in the repository.

indicesToUpdateAfterRemovingSnapshot

public List<IndexId> indicesToUpdateAfterRemovingSnapshot(SnapshotId snapshotId)

Returns the list of IndexId that have their snapshots updated but not removed (because they are still referenced by other snapshots) after removing the given snapshot from the repository.

Parameters:

snapshotId - SnapshotId to remove

Returns:

List of indices that are changed but not removed

addSnapshot

public RepositoryData addSnapshot(SnapshotId snapshotId,
                                  SnapshotState snapshotState,
                                  List<IndexId> snapshottedIndices)

Add a snapshot and its indices to the repository; returns a new instance. If the snapshot already exists in the repository data, this method throws an IllegalArgumentException.

withGenId

public RepositoryData withGenId(long newGeneration)

Create a new instance with the given generation and all other fields equal to this instance.

Parameters:

newGeneration - New Generation

Returns:

New instance

removeSnapshot

public RepositoryData removeSnapshot(SnapshotId snapshotId)

Remove a snapshot and remove any indices that no longer exist in the repository due to the deletion of the snapshot.

getSnapshots

public Set<SnapshotId> getSnapshots(IndexId indexId)

Returns an immutable collection of the snapshot ids for the snapshots that contain the given index.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

resolveIndexId

public IndexId resolveIndexId(String indexName)

Resolve the index name to the index id specific to the repository, throwing an exception if the index could not be resolved.

resolveIndices

public List<IndexId> resolveIndices(List<String> indices)

Resolve the given index names to index ids.

resolveNewIndices

public List<IndexId> resolveNewIndices(List<String> indicesToResolve)

Resolve the given index names to index ids, creating new index ids for new indices in the repository.

snapshotsToXContent

public XContentBuilder snapshotsToXContent(XContentBuilder builder)
                                    throws IOException

Writes the snapshots metadata and the related indices metadata to x-content.

Throws:

IOException

snapshotsFromXContent

public static RepositoryData snapshotsFromXContent(XContentParser parser,
                                                   long genId)
                                            throws IOException

Reads an instance of RepositoryData from x-content, loading the snapshots and indices metadata.

Throws:

IOException