Package org.elasticsearch.action.bulk

Class BulkItemResponse

java.lang.Object

org.elasticsearch.action.bulk.BulkItemResponse

All Implemented Interfaces:

Writeable, StatusToXContentObject, ToXContent, ToXContentObject

public class BulkItemResponse
extends Object
implements Writeable, StatusToXContentObject

Represents a single item response for an action executed as part of the bulk API. Holds the index/type/id of the relevant action, and if it has failed or not (with the failure message in case it failed).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BulkItemResponse.Failure	Represents a failure.

Nested classes/interfaces inherited from interface org.elasticsearch.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY_PARAMS

Method Summary

Modifier and Type	Method	Description
static BulkItemResponse	failure(int id, DocWriteRequest.OpType opType, BulkItemResponse.Failure failure)
static BulkItemResponse	fromXContent(XContentParser parser, int id)	Reads a BulkItemResponse from a XContentParser.
BulkItemResponse.Failure	getFailure()	The actual failure object if there was a failure.
String	getFailureMessage()	The failure message, null if it did not fail.
String	getId()	The id of the action.
String	getIndex()	The index name of the action.
int	getItemId()	The numeric order of the item matching the same request order in the bulk request.
DocWriteRequest.OpType	getOpType()	The operation type ("index", "create" or "delete").
<T extends DocWriteResponse> T	getResponse()	The actual response (IndexResponse or DeleteResponse).
String	getType()	The type of the action.
long	getVersion()	The version of the action.
boolean	isFailed()	Is this a failed execution of an operation.
RestStatus	status()	Returns the REST status to make sure it is returned correctly
static BulkItemResponse	success(int id, DocWriteRequest.OpType opType, DocWriteResponse response)
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
void	writeThin(StreamOutput out)
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.elasticsearch.xcontent.ToXContentObject

isFragment

Method Details

status

public RestStatus status()

Description copied from interface: StatusToXContentObject

Returns the REST status to make sure it is returned correctly

Specified by:

status in interface StatusToXContentObject

toXContent

public XContentBuilder toXContent(XContentBuilder builder,
 ToXContent.Params params)
                           throws IOException

Specified by:

toXContent in interface ToXContent

Throws:

IOException

fromXContent

public static BulkItemResponse fromXContent(XContentParser parser,
 int id)
                                     throws IOException

Reads a BulkItemResponse from a XContentParser.

Parameters:

parser - the XContentParser

id - the id to assign to the parsed BulkItemResponse. It is usually the index of the item in the BulkResponse.getItems() array.

Throws:

IOException

success

public static BulkItemResponse success(int id,
 DocWriteRequest.OpType opType,
 DocWriteResponse response)

failure

public static BulkItemResponse failure(int id,
 DocWriteRequest.OpType opType,
 BulkItemResponse.Failure failure)

getItemId

public int getItemId()

The numeric order of the item matching the same request order in the bulk request.

getOpType

public DocWriteRequest.OpType getOpType()

The operation type ("index", "create" or "delete").

getIndex

public String getIndex()

The index name of the action.

getType

public String getType()

The type of the action.

getId

public String getId()

The id of the action.

getVersion

public long getVersion()

The version of the action.

getResponse

public <T extends DocWriteResponse> T getResponse()

The actual response (IndexResponse or DeleteResponse). null in case of failure.

isFailed

public boolean isFailed()

Is this a failed execution of an operation.

getFailureMessage

public String getFailureMessage()

The failure message, null if it did not fail.

getFailure

public BulkItemResponse.Failure getFailure()

The actual failure object if there was a failure.

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Throws:

IOException

writeThin

public void writeThin(StreamOutput out)
               throws IOException

Throws:

IOException