Posted on 2008-11-01 10:10
Neil's NoteBook 阅读(100)
评论(0) 编辑 收藏
Hibernate users have requested a general purpose method that either saves a
transient instance by generating a new identifier or updates/reattaches the
detached instances associated with its current identifier. The saveOrUpdate()
method implements this functionality.
// in the first session
Cat cat = (Cat) firstSession.load(Cat.class, catID);
// in a higher tier of the application
Cat mate = new Cat();
cat.setMate(mate);
// later, in a new session
secondSession.saveOrUpdate(cat); // update existing state (cat has a non-null id)
secondSession.saveOrUpdate(mate); // save the new instance (mate has a null id)
The usage and semantics of saveOrUpdate()
seems to
be confusing for new users. Firstly, so long as you are not trying to use
instances from one session in another new session, you should not need to use
update()
, saveOrUpdate()
,
or merge()
. Some whole applications will never use
either of these methods.
Usually update()
or saveOrUpdate()
are used in the following scenario:
-
the application loads an object in the first session
-
the object is passed up to the UI tier
-
some modifications are made to the object
-
the object is passed back down to the business logic tier
-
the application persists these modifications by calling update()
in a second session
saveOrUpdate()
does the following:
-
if the object is already persistent in this session, do nothing
-
if another object associated with the session has the same identifier, throw
an exception
-
if the object has no identifier property, save()
it
-
if the object's identifier has the value assigned to a newly instantiated
object, save()
it
-
if the object is versioned (by a <version>
or <timestamp>
), and the version property value
is the same value assigned to a newly instantiated object, save()
it
-
otherwise update()
the object
and merge()
is very different:
-
if there is a persistent instance with the same identifier currently
associated with the session, copy the state of the given object onto the
persistent instance
-
if there is no persistent instance currently associated with the session, try
to load it from the database, or create a new persistent instance
-
the persistent instance is returned
-
the given instance does not become associated with the session, it remains
detached