org.elasticsearch.gateway

クラス MetaDataStateFormat<T>

java.lang.Object

org.elasticsearch.gateway.MetaDataStateFormat<T>

型パラメータ:

T - the type of the XContent base data-structure

public abstract class MetaDataStateFormat<T>
extends Object

MetaDataStateFormat is a base class to write checksummed XContent based files to one or more directories in a standardized directory structure.

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static String	STATE_DIR_NAME
static String	STATE_FILE_EXTENSION

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	MetaDataStateFormat(XContentType format, String prefix) Creates a new MetaDataStateFormat instance

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static void	deleteMetaState(Path... dataLocations) Deletes all meta state directories recursively for the given data locations
XContentType	format() Returns the XContentType used to serialize xcontent on write.
abstract T	fromXContent(XContentParser parser) Reads a new instance of the state from the given XContentParser Subclasses need to implement this class for theirs specific state.
T	loadLatestState(ESLogger logger, Path... dataLocations) Tries to load the latest state from the given data-locations.
protected org.apache.lucene.store.Directory	newDirectory(Path dir)
protected XContentBuilder	newXContentBuilder(XContentType type, OutputStream stream)
T	read(Path file) Reads the state from a given file and compares the expected version against the actual version of the state.
abstract void	toXContent(XContentBuilder builder, T state) Writes the given state to the given XContentBuilder Subclasses need to implement this class for theirs specific state.
void	write(T state, long version, Path... locations) Writes the given state to the given directories.

クラスから継承されたメソッド java.lang.Object

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

フィールドの詳細

STATE_DIR_NAME

public static final String STATE_DIR_NAME

関連項目:

定数フィールド値

STATE_FILE_EXTENSION

public static final String STATE_FILE_EXTENSION

関連項目:

定数フィールド値

コンストラクタの詳細

MetaDataStateFormat

protected MetaDataStateFormat(XContentType format,
                              String prefix)

Creates a new MetaDataStateFormat instance

パラメータ:

format - the format of the x-content

メソッドの詳細

format

public XContentType format()

Returns the XContentType used to serialize xcontent on write.

write

public final void write(T state,
                        long version,
                        Path... locations)
                 throws IOException

Writes the given state to the given directories. The state is written to a state directory ("_state") underneath each of the given file locations and is created if it doesn't exist. The state is serialized to a temporary file in that directory and is then atomically moved to it's target filename of the pattern {prefix}{version}.st.

パラメータ:

state - the state object to write

version - the version of the state

locations - the locations where the state should be written to.

例外:

IOException - if an IOException occurs

newXContentBuilder

protected XContentBuilder newXContentBuilder(XContentType type,
                                             OutputStream stream)
                                      throws IOException

例外:

IOException

toXContent

public abstract void toXContent(XContentBuilder builder,
                                T state)
                         throws IOException

Writes the given state to the given XContentBuilder Subclasses need to implement this class for theirs specific state.

例外:

IOException

fromXContent

public abstract T fromXContent(XContentParser parser)
                        throws IOException

Reads a new instance of the state from the given XContentParser Subclasses need to implement this class for theirs specific state.

例外:

IOException

read

public final T read(Path file)
             throws IOException

Reads the state from a given file and compares the expected version against the actual version of the state.

例外:

IOException

newDirectory

protected org.apache.lucene.store.Directory newDirectory(Path dir)
                                                  throws IOException

例外:

IOException

loadLatestState

public T loadLatestState(ESLogger logger,
                         Path... dataLocations)
                  throws IOException

Tries to load the latest state from the given data-locations. It tries to load the latest state determined by the states version from one or more data directories and if none of the latest states can be loaded an exception is thrown to prevent accidentally loading a previous state and silently omitting the latest state.

パラメータ:

logger - an elasticsearch logger instance

dataLocations - the data-locations to try.

戻り値:

the latest state or null if no state was found.

例外:

IOException

deleteMetaState

public static void deleteMetaState(Path... dataLocations)
                            throws IOException

Deletes all meta state directories recursively for the given data locations

パラメータ:

dataLocations - the data location to delete

例外:

IOException