com.yahoo.documentapi

Interface SyncSession

All Superinterfaces:

Session

All Known Implementing Classes:

LocalSyncSession, MessageBusSyncSession

public interface SyncSession
extends Session

A session for synchronous access to a document repository. This class provides simple document access where throughput is not a concern.

Author:

Simon Thoresen, bjorncs

Method Summary

Modifier and Type	Method and Description
com.yahoo.document.Document	get(com.yahoo.document.DocumentId id) Gets a document.
default com.yahoo.document.Document	get(com.yahoo.document.DocumentId id, Duration timeout) Gets a document with timeout.
com.yahoo.document.Document	get(com.yahoo.document.DocumentId id, String fieldSet, DocumentProtocol.Priority priority) Gets a document.
default com.yahoo.document.Document	get(com.yahoo.document.DocumentId id, String fieldSet, DocumentProtocol.Priority priority, Duration timeout) Gets a document with timeout.
void	put(com.yahoo.document.DocumentPut documentPut) Puts a document.
void	put(com.yahoo.document.DocumentPut documentPut, DocumentProtocol.Priority priority) Puts a document.
boolean	remove(com.yahoo.document.DocumentRemove documentRemove) Removes a document if it is present and condition is fulfilled.
boolean	remove(com.yahoo.document.DocumentRemove documentRemove, DocumentProtocol.Priority priority) Removes a document if it is present.
boolean	update(com.yahoo.document.DocumentUpdate update) Updates a document.
boolean	update(com.yahoo.document.DocumentUpdate update, DocumentProtocol.Priority priority) Updates a document.

Methods inherited from interface com.yahoo.documentapi.Session

destroy, getNext, getNext

Method Detail

put

void put(com.yahoo.document.DocumentPut documentPut)

Puts a document. When this method returns, the document is safely received. This enables setting condition compared to using Document.

Parameters:

documentPut - The DocumentPut operation

put

void put(com.yahoo.document.DocumentPut documentPut,
         DocumentProtocol.Priority priority)

Puts a document. When this method returns, the document is safely received.

Parameters:

documentPut - The DocumentPut operation

priority - The priority with which to perform this operation.

get

com.yahoo.document.Document get(com.yahoo.document.DocumentId id)

Gets a document.

Parameters:

id - The id of the document to get.

Returns:

The known document having this id, or null if there is no document having this id.

Throws:

UnsupportedOperationException - Thrown if this access does not support retrieving.

get

com.yahoo.document.Document get(com.yahoo.document.DocumentId id,
                                String fieldSet,
                                DocumentProtocol.Priority priority)

Gets a document.

Parameters:

id - The id of the document to get.

fieldSet - A comma-separated list of fields to retrieve

priority - The priority with which to perform this operation.

Returns:

The known document having this id, or null if there is no document having this id.

Throws:

UnsupportedOperationException - Thrown if this access does not support retrieving.

get

default com.yahoo.document.Document get(com.yahoo.document.DocumentId id,
                                        Duration timeout)

Gets a document with timeout.

Parameters:

id - The id of the document to get.

timeout - Timeout. If timeout is null, an unspecified default will be used.

Returns:

The known document having this id, or null if there is no document having this id.

Throws:

UnsupportedOperationException - Thrown if this access does not support retrieving.

DocumentAccessException - on any messagebus error, including timeout (ErrorCode.TIMEOUT).

get

default com.yahoo.document.Document get(com.yahoo.document.DocumentId id,
                                        String fieldSet,
                                        DocumentProtocol.Priority priority,
                                        Duration timeout)

Gets a document with timeout.

Parameters:

id - The id of the document to get.

fieldSet - A comma-separated list of fields to retrieve

priority - The priority with which to perform this operation.

timeout - Timeout. If timeout is null, an unspecified default will be used.

Returns:

The known document having this id, or null if there is no document having this id.

Throws:

UnsupportedOperationException - Thrown if this access does not support retrieving.

DocumentAccessException - on any messagebus error, including timeout (ErrorCode.TIMEOUT).

remove

boolean remove(com.yahoo.document.DocumentRemove documentRemove)

Removes a document if it is present and condition is fulfilled.

Parameters:

documentRemove - document to delete

Returns:

true If the document with this id was removed, false otherwise.

remove

boolean remove(com.yahoo.document.DocumentRemove documentRemove,
               DocumentProtocol.Priority priority)

Removes a document if it is present.

Parameters:

documentRemove - Document remove operation

priority - The priority with which to perform this operation.

Returns:

true If the document with this id was removed, false otherwise.

Throws:

UnsupportedOperationException - Thrown if this access does not support removal.

update

boolean update(com.yahoo.document.DocumentUpdate update)

Updates a document.

Parameters:

update - The updates to perform.

Returns:

True, if the document was found and updated.

Throws:

UnsupportedOperationException - Thrown if this access does not support update.

update

boolean update(com.yahoo.document.DocumentUpdate update,
               DocumentProtocol.Priority priority)

Updates a document.

Parameters:

update - The updates to perform.

priority - The priority with which to perform this operation.

Returns:

True, if the document was found and updated.

Throws:

UnsupportedOperationException - Thrown if this access does not support update.