/*
 * Copyright (c) 2008, 2009, 2011 Oracle, Inc. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 and Eclipse Distribution License v. 1.0
 * which accompanies this distribution.  The Eclipse Public License is available
 * at http://www.eclipse.org/legal/epl-v10.html and the Eclipse Distribution License
 * is available at http://www.eclipse.org/org/documents/edl-v10.php.
 */
package javax.persistence;


Thrown by the persistence provider when an optimistic locking conflict occurs. This exception may be thrown as part of an API call, a flush or at commit time. The current transaction, if one is active, will be marked for rollback.
See Also:
  • find.find(Class, Object, LockModeType)
  • find.find(Class, Object, LockModeType, Map)
  • lock.lock(Object, LockModeType)
  • lock.lock(Object, LockModeType, Map)
Since:Java Persistence 1.0
/** * Thrown by the persistence provider when an optimistic locking conflict * occurs. This exception may be thrown as part of an API call, a flush or at * commit time. The current transaction, if one is active, will be marked for * rollback. * * @see EntityManager#find(Class, Object, LockModeType) * @see EntityManager#find(Class, Object, LockModeType, java.util.Map) * @see EntityManager#lock(Object, LockModeType) * @see EntityManager#lock(Object, LockModeType, java.util.Map) * @since Java Persistence 1.0 */
public class OptimisticLockException extends PersistenceException {
The object that caused the exception
/** * The object that caused the exception */
Object entity;
Constructs a new OptimisticLockException exception with null as its detail message.
/** * Constructs a new <code>OptimisticLockException</code> exception with * <code>null</code> as its detail message. */
public OptimisticLockException() { super(); }
Constructs a new OptimisticLockException exception with the specified detail message.
Params:
  • message – the detail message.
/** * Constructs a new <code>OptimisticLockException</code> exception with the * specified detail message. * * @param message the detail message. */
public OptimisticLockException(String message) { super(message); }
Constructs a new OptimisticLockException exception with the specified detail message and cause.
Params:
  • message – the detail message.
  • cause – the cause.
/** * Constructs a new <code>OptimisticLockException</code> exception with the * specified detail message and cause. * * @param message the detail message. * @param cause the cause. */
public OptimisticLockException(String message, Throwable cause) { super(message, cause); }
Constructs a new OptimisticLockException exception with the specified cause.
Params:
  • cause – the cause.
/** * Constructs a new <code>OptimisticLockException</code> exception with the * specified cause. * * @param cause the cause. */
public OptimisticLockException(Throwable cause) { super(cause); }
Constructs a new OptimisticLockException exception with the specified entity.
Params:
  • entity – the entity.
/** * Constructs a new <code>OptimisticLockException</code> exception with the * specified entity. * * @param entity the entity. */
public OptimisticLockException(Object entity) { this.entity = entity; }
Constructs a new OptimisticLockException exception with the specified detail message, cause, and entity.
Params:
  • message – the detail message.
  • cause – the cause.
  • entity – the entity.
/** * Constructs a new <code>OptimisticLockException</code> exception with the * specified detail message, cause, and entity. * * @param message the detail message. * @param cause the cause. * @param entity the entity. */
public OptimisticLockException(String message, Throwable cause, Object entity) { super(message, cause); this.entity = entity; }
Returns the entity that caused this exception.
Returns:the entity.
/** * Returns the entity that caused this exception. * * @return the entity. */
public Object getEntity() { return this.entity; } }