omero.api

Interface _IUpdateOperations

All Superinterfaces:

_ServiceInterfaceOperations

All Known Subinterfaces:

IUpdate

All Known Implementing Classes:

_IUpdateDisp, _IUpdateTie, UpdateI

public interface _IUpdateOperations
extends _ServiceInterfaceOperations

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.

Method Summary

Modifier and Type	Method and Description
void	deleteObject_async(AMD_IUpdate_deleteObject __cb, IObject row, Ice.Current __current) Deprecated. use omero::cmd::Delete2 instead
void	indexObject_async(AMD_IUpdate_indexObject __cb, IObject row, Ice.Current __current) Initiates full-text indexing for the given object.
void	saveAndReturnArray_async(AMD_IUpdate_saveAndReturnArray __cb, java.util.List<IObject> graph, Ice.Current __current)
void	saveAndReturnIds_async(AMD_IUpdate_saveAndReturnIds __cb, java.util.List<IObject> graph, Ice.Current __current)
void	saveAndReturnObject_async(AMD_IUpdate_saveAndReturnObject __cb, IObject obj, Ice.Current __current)
void	saveArray_async(AMD_IUpdate_saveArray __cb, java.util.List<IObject> graph, Ice.Current __current)
void	saveCollection_async(AMD_IUpdate_saveCollection __cb, java.util.List<IObject> objs, Ice.Current __current)
void	saveObject_async(AMD_IUpdate_saveObject __cb, IObject obj, Ice.Current __current)

Method Detail

saveObject_async

void saveObject_async(AMD_IUpdate_saveObject __cb,
                      IObject obj,
                      Ice.Current __current)
               throws ServerError

Throws:

ServerError

saveCollection_async

void saveCollection_async(AMD_IUpdate_saveCollection __cb,
                          java.util.List<IObject> objs,
                          Ice.Current __current)
                   throws ServerError

Throws:

ServerError

saveAndReturnObject_async

void saveAndReturnObject_async(AMD_IUpdate_saveAndReturnObject __cb,
                               IObject obj,
                               Ice.Current __current)
                        throws ServerError

Throws:

ServerError

saveArray_async

void saveArray_async(AMD_IUpdate_saveArray __cb,
                     java.util.List<IObject> graph,
                     Ice.Current __current)
              throws ServerError

Throws:

ServerError

saveAndReturnArray_async

void saveAndReturnArray_async(AMD_IUpdate_saveAndReturnArray __cb,
                              java.util.List<IObject> graph,
                              Ice.Current __current)
                       throws ServerError

Throws:

ServerError

saveAndReturnIds_async

void saveAndReturnIds_async(AMD_IUpdate_saveAndReturnIds __cb,
                            java.util.List<IObject> graph,
                            Ice.Current __current)
                     throws ServerError

Throws:

ServerError

deleteObject_async

void deleteObject_async(AMD_IUpdate_deleteObject __cb,
                        IObject row,
                        Ice.Current __current)
                 throws ServerError

Deprecated. use omero::cmd::Delete2 instead

Parameters:

__cb - The callback object for the operation.

__current - The Current object for the invocation.

Throws:

ServerError

indexObject_async

void indexObject_async(AMD_IUpdate_indexObject __cb,
                       IObject row,
                       Ice.Current __current)
                throws ServerError

Initiates full-text indexing for the given object. This may have to wait for the current FullTextThread to finish. Can only be executed by an admin. Other users must wait for the background Thread to complete.

Parameters:

__cb - The callback object for the operation.

row - a persistent IObject to be deleted

__current - The Current object for the invocation.

Throws:

ServerError