Package org.spongepowered.api.data

Class DataTransactionResult.Builder

java.lang.Object

org.spongepowered.api.data.DataTransactionResult.Builder

All Implemented Interfaces:

AbstractBuilder<DataTransactionResult>, Builder<DataTransactionResult,DataTransactionResult.Builder>, CopyableBuilder<DataTransactionResult,DataTransactionResult.Builder>, ResettableBuilder<DataTransactionResult,DataTransactionResult.Builder>

Enclosing class:

DataTransactionResult

public static final class DataTransactionResult.Builder
extends Object
implements Builder<DataTransactionResult,DataTransactionResult.Builder>, CopyableBuilder<DataTransactionResult,DataTransactionResult.Builder>

A type of builder for building DataTransactionResults. The common use is for both implementations of DataHolders, and various ChangeDataHolderEvent.ValueChanges.

Method Summary

Modifier and Type	Method	Description
DataTransactionResult.Builder	absorbResult(DataTransactionResult result)	Combines the currently building DataTransactionResult with the one provided.
DataTransactionResult	build()	Builds a new DataTransactionResult with the providing Lists of Value.Immutables that are successfully offered, Value.Immutables that were replaced, and Value.Immutables that were rejected.
DataTransactionResult.Builder	from(DataTransactionResult value)	Resets this builder to the values of the given built object.
DataTransactionResult.Builder	reject(Iterable<Value.Immutable<?>> values)	Adds the provided Value.Immutables to the List of "rejected" Value.Immutables.
DataTransactionResult.Builder	reject(Value.Immutable<?> value)	Adds the provided Value.Immutable to the List of "rejected" Value.Immutables.
DataTransactionResult.Builder	replace(Iterable<Value.Immutable<?>> values)	Adds the provided Value.Immutables to the List of "replaced" Value.Immutables.
DataTransactionResult.Builder	replace(Value.Immutable<?> value)	Adds the provided Value.Immutable to the List of "replaced" Value.Immutables.
DataTransactionResult.Builder	reset()	Resets this builder to a "default" state such that there is no remaining data to set.
DataTransactionResult.Builder	result(DataTransactionResult.Type type)	Sets the expectant DataTransactionResult.Type to the provided type.
DataTransactionResult.Builder	success(Iterable<Value.Immutable<?>> values)	Adds the provided Value.Immutables to the List of "successful" Value.Immutables.
DataTransactionResult.Builder	success(Value.Immutable<?> value)	Adds the provided Value.Immutable to the List of "successful" Value.Immutables.

Methods inherited from class java.lang.Object

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

Method Details

result

public DataTransactionResult.Builder result(DataTransactionResult.Type type)

Sets the expectant DataTransactionResult.Type to the provided type. A DataTransactionResult must always have a type to mark the transaction a "success" or "failure".

Parameters:

type - The type of the transaction result

Returns:

This builder, for chaining

replace

public DataTransactionResult.Builder replace(Value.Immutable<?> value)

Adds the provided Value.Immutable to the List of "replaced" Value.Immutables. The replaced values are always copied for every DataTransactionResult for referencing.

Parameters:

value - The value to replace

Returns:

This builder, for chaining

replace

public DataTransactionResult.Builder replace(Iterable<Value.Immutable<?>> values)

Adds the provided Value.Immutables to the List of "replaced" Value.Immutables. The replaced values are always copied for every DataTransactionResult for referencing.

Parameters:

values - The values to replace

Returns:

This builder, for chaining

reject

public DataTransactionResult.Builder reject(Value.Immutable<?> value)

Adds the provided Value.Immutable to the List of "rejected" Value.Immutables. The rejected values are always copied for every DataTransactionResult for referencing.

Parameters:

value - The values to reject

Returns:

This builder, for chaining

reject

public DataTransactionResult.Builder reject(Iterable<Value.Immutable<?>> values)

Adds the provided Value.Immutables to the List of "rejected" Value.Immutables. The rejected values are always copied for every DataTransactionResult for referencing.

Parameters:

values - The values to reject

Returns:

This builder, for chaining

success

public DataTransactionResult.Builder success(Value.Immutable<?> value)

Adds the provided Value.Immutable to the List of "successful" Value.Immutables. The successful values are always copied for every DataTransactionResult for referencing.

Parameters:

value - The value that was successfully provided

Returns:

This builder, for chaining

success

public DataTransactionResult.Builder success(Iterable<Value.Immutable<?>> values)

Adds the provided Value.Immutables to the List of "successful" Value.Immutables. The rejected values are always copied for every DataTransactionResult for referencing.

Parameters:

values - The values that were successfully provided

Returns:

This builder, for chaining

absorbResult

public DataTransactionResult.Builder absorbResult(DataTransactionResult result)

Combines the currently building DataTransactionResult with the one provided. Usually, this means that there is some merging of the Value.Immutables based on Key. If this builder already has an Value.Immutable as being successfully offered, and the provided result shows the same key as being rejected, the rejected Value.Immutable will remain in the final result.

Parameters:

result - The result to merge

Returns:

This builder, for chaining

build

public DataTransactionResult build()

Builds a new DataTransactionResult with the providing Lists of Value.Immutables that are successfully offered, Value.Immutables that were replaced, and Value.Immutables that were rejected.

Specified by:

build in interface AbstractBuilder<DataTransactionResult>

Returns:

The newly created transaction result

from

public DataTransactionResult.Builder from(DataTransactionResult value)

Description copied from interface: CopyableBuilder

Resets this builder to the values of the given built object.

Specified by:

from in interface CopyableBuilder<DataTransactionResult,DataTransactionResult.Builder>

Parameters:

value - The built object

Returns:

This builder, for chaining

reset

public DataTransactionResult.Builder reset()

Description copied from interface: Builder

Resets this builder to a "default" state such that there is no remaining data to set. This is to be the presumed "default" state.

Specified by:

reset in interface Builder<DataTransactionResult,DataTransactionResult.Builder>

Specified by:

reset in interface ResettableBuilder<DataTransactionResult,DataTransactionResult.Builder>

Returns:

This builder, for chaining