de.ipcon.db.protocol

Class BackendRequestSave

java.lang.Object

de.ipcon.db.protocol.AbstractBackendRequest

de.ipcon.db.protocol.ComplexBackendRequest

de.ipcon.db.protocol.BackendRequestSave

All Implemented Interfaces:

BackendRequestI, BackendRequestSaveI, ComplexBackendRequestI

public class BackendRequestSave
extends ComplexBackendRequest
implements BackendRequestSaveI

Field Summary

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

Constructor Summary

Constructors

Constructor and Description
BackendRequestSave()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	applyBOLoader(java.lang.Object bo)
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.
void	processRequest()
void	readRequestParameters(SecureObjectInputI in)
void	writeRequestResults(SecureObjectOutputI out)

Methods inherited from class de.ipcon.db.protocol.AbstractBackendRequest

calculateResponse, getBCH, getCommand, getCommandString, getDefaultExceptionPrefix, getProgressDisplay, getResponseException, getResults, getSession, getSlot, getUtx, initClientSide, initServerSide, isAllowedUnauthenticated, isParallelProcessAndWrite, prepareRequest, receiveResponse, releaseTransport, sendRequest, setException

Methods inherited from class java.lang.Object

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

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

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

Constructor Detail

BackendRequestSave

public BackendRequestSave()

Method Detail

initClientSide

public void initClientSide(java.lang.String _serverAddress,
                           int _getResultsTimeoutSeconds,
                           Transaction _tx,
                           int _lockTimeout,
                           int _retries)

Description copied from interface: BackendRequestSaveI

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

Specified by:

initClientSide in interface BackendRequestSaveI

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

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

Description copied from interface: BackendRequestSaveI

Retrieves the resulting transaction answer once processing completes.

Specified by:

getTransactionAnswer in interface BackendRequestSaveI

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

readRequestParameters

public void readRequestParameters(SecureObjectInputI in)
                           throws java.io.IOException,
                                  java.lang.ClassNotFoundException

Specified by:

readRequestParameters in interface BackendRequestI

Throws:

java.io.IOException

java.lang.ClassNotFoundException

processRequest

public void processRequest()

Specified by:

processRequest in interface BackendRequestI

writeRequestResults

public void writeRequestResults(SecureObjectOutputI out)
                         throws java.io.IOException

Specified by:

writeRequestResults in interface BackendRequestI

Throws:

java.io.IOException

applyBOLoader

public java.lang.Object applyBOLoader(java.lang.Object bo)