|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IUpdate
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(IObject[])
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.
Validation
,
UpdateImpl
,
Details
Method Summary | ||
---|---|---|
void |
deleteObject(ome.model.IObject row)
Deletes a single entity. |
|
void |
indexObject(ome.model.IObject row)
Initiates full-text indexing for the given object. |
|
ome.model.IObject[] |
saveAndReturnArray(ome.model.IObject[] graph)
|
|
List<Long> |
saveAndReturnIds(ome.model.IObject[] objects)
Logic differs from other methods. |
|
|
saveAndReturnObject(T graph)
|
|
void |
saveArray(ome.model.IObject[] graph)
|
|
void |
saveCollection(Collection<ome.model.IObject> graph)
|
|
void |
saveObject(ome.model.IObject graph)
|
Method Detail |
---|
List<Long> saveAndReturnIds(ome.model.IObject[] objects)
IUpdate
void saveCollection(Collection<ome.model.IObject> graph)
IUpdate
void saveObject(ome.model.IObject graph)
IUpdate
void saveArray(ome.model.IObject[] graph)
IUpdate
<T extends ome.model.IObject> T saveAndReturnObject(T graph)
IUpdate
ome.model.IObject[] saveAndReturnArray(ome.model.IObject[] graph)
IUpdate
void deleteObject(ome.model.IObject row) throws ome.conditions.ValidationException
row
- a persistent {@link IObject{ to be deleted.
ome.conditions.ValidationException
- if the row is locked, has foreign key constraints, or is
otherwise marked un-deletable.void indexObject(ome.model.IObject row) throws ome.conditions.ValidationException
FullTextThread
to finish.
Can only be executed by an admin. Other users must wait for the
background Thread
to complete.
row
- a persistent IObject
to be deleted
ome.conditions.ValidationException
- if the object does not exist or is nul
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Version: 4.3.4-dbcbce5a-b4
Copyright © 2009 The University of Dundee. All Rights Reserved.