omero.api

Interface IUpdate

All Superinterfaces:

_IUpdateOperations, _IUpdateOperationsNC, _ServiceInterfaceOperations, _ServiceInterfaceOperationsNC, Ice.Object, ServiceInterface

All Known Implementing Classes:

_IUpdateDisp, _IUpdateTie

public interface IUpdate
extends Ice.Object, _IUpdateOperations, _IUpdateOperationsNC, ServiceInterface

Provides methods for directly updating object graphs. IUpdate is the lowest level (level-1) interface which may make changes (INSERT, UPDATE, DELETE) to the database. All other methods of changing the database may leave it in an inconsistent state.

All the save* methods act recursively on the entire object graph, replacing placeholders and details where necessary, and then merging the final graph. This means that the objects that are passed into IUpdate.save* methods are copied over to new instances which are then returned. The original objects should be discarded.

saveAndReturnIds behaves slightly differently in that it does not handle object modifications. The graph of objects passed in can consist ONLY if either newly created objects without ids or of unloaded objects with ids. Note: The ids of the saved values may not be in order. This is caused by persistence-by-transitivity. Hibernate may detect an item later in the array if they are interconnected and therefore choose to save it first.

All methods throw ValidationException if the input objects do not pass validation, and OptimisticLockException if the version of a given has already been incremented.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ice_staticId
static long	serialVersionUID

Method Summary

Methods inherited from interface omero.api._IUpdateOperations

deleteObject_async, indexObject_async, saveAndReturnArray_async, saveAndReturnIds_async, saveAndReturnObject_async, saveArray_async, saveCollection_async, saveObject_async

Methods inherited from interface omero.api._IUpdateOperationsNC

deleteObject_async, indexObject_async, saveAndReturnArray_async, saveAndReturnIds_async, saveAndReturnObject_async, saveArray_async, saveCollection_async, saveObject_async

Methods inherited from interface Ice.Object

__dispatch, __read, __read, __write, __write, clone, ice_dispatch, ice_dispatch, ice_id, ice_id, ice_ids, ice_ids, ice_isA, ice_isA, ice_operationAttributes, ice_ping, ice_ping, ice_postUnmarshal, ice_preMarshal

Field Detail

ice_staticId

static final java.lang.String ice_staticId

See Also:

Constant Field Values

serialVersionUID

static final long serialVersionUID

See Also:

Constant Field Values