de.ipcon.db.protocol

Interface BackendRequestSaveI

All Superinterfaces:

BackendRequestI, ComplexBackendRequestI

All Known Implementing Classes:

BackendRequestSave

public interface BackendRequestSaveI
extends ComplexBackendRequestI

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	$0

Fields inherited from interface de.ipcon.db.protocol.BackendRequestI

DEFAULT_TIMEOUT_COMPLEX_COMMANDS, DEFAULT_TIMEOUT_CONCISE_COMMANDS, DEFAULT_TIMEOUT_MEDIUM_COMMANDS, DEFAULT_TIMEOUT_SIMPLE_COMMANDS

Method Summary

Modifier and Type	Method and Description
TransactionAnswer	getTransactionAnswer() Retrieves the resulting transaction answer once processing completes.
void	initClientSide(java.lang.String serverAddress, int getResultsTimeoutSeconds, Transaction tx, int lockTimeout, int retries) Initializes the client-side save request with connection coordinates, payload, and retry policy.

Methods inherited from interface de.ipcon.db.protocol.BackendRequestI

calculateResponse, getCommandString, getDefaultExceptionPrefix, getResponseException, getResults, getSlot, initClientSide, initServerSide, isAllowedUnauthenticated, isParallelProcessAndWrite, prepareRequest, processRequest, readRequestParameters, receiveResponse, releaseTransport, sendRequest, setException, writeRequestResults

Field Detail

$0

static final java.lang.String $0

See Also:

Constant Field Values

Method Detail

initClientSide

void initClientSide(java.lang.String serverAddress,
                    int getResultsTimeoutSeconds,
                    Transaction tx,
                    int lockTimeout,
                    int retries)

Initializes the client-side save request with connection coordinates, payload, and retry policy.

Parameters:

serverAddress - the target server endpoint address

getResultsTimeoutSeconds - maximum duration in seconds to wait for the server to return the save result

tx - the Transaction containing entities to persist

lockTimeout - timeout in seconds when waiting for locked database records; 0 indicates no timeout (wait indefinitely), values > 0 specify an explicit duration in seconds, and values < 0 retain the underlying persistence layer default (30 seconds)

retries - maximum retry attempts on lock contention or serialization conflicts before aborting

getTransactionAnswer

TransactionAnswer getTransactionAnswer()
                                throws ObjectNotPersistentException,
                                       ObjectsNotPersistentException,
                                       SaveException,
                                       FeatureNotAvailableException

Retrieves the resulting transaction answer once processing completes.

Returns:

the TransactionAnswer containing persistence status, conflict reports, and ID mappings

Throws:

ObjectNotPersistentException - if an entity expected to be persistent could not be resolved

ObjectsNotPersistentException - if multiple entities expected to be persistent could not be resolved

SaveException - if a persistence, constraint, or database conflict error occurs during save

FeatureNotAvailableException - if a required backend persistence feature or capability is disabled