/*
 * 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;
  }

}