/******************************************************************************* | |
* Copyright (c) 1998, 2014 Oracle and/or its affiliates. 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. | |
* | |
* Contributors: | |
* 04/15/2008-1.0M7 Guy Pelletier | |
* - 226517: Add existence support to the EclipseLink-ORM.XML Schema | |
******************************************************************************/ | |
package org.eclipse.persistence.annotations; | |
import java.lang.annotation.Target; | |
import java.lang.annotation.Retention; | |
import static java.lang.annotation.ElementType.TYPE; | |
import static java.lang.annotation.RetentionPolicy.RUNTIME; | |
import static org.eclipse.persistence.annotations.ExistenceType.CHECK_CACHE; | |
/** | |
* The ExistenceChecking annotation is used to specify the type of checking | |
* EclipseLink should use when determining if an entity is new or existing. | |
* It is specifically used on a merge() operation to determine if only the cache | |
* should be used to determine if an object exists, or the object should | |
* be read (from the database or cache). By default the object is read. | |
* | |
* An existence-checking specification is supported on an Entity or | |
* MappedSuperclass annotation. | |
* | |
* @see org.eclipse.persistence.annotations.ExistenceType | |
* @see org.eclipse.persistence.queries.DoesExistQuery | |
* @author Guy Pelletier | |
* @since Eclipselink 1.0 | |
*/ | |
@Target({TYPE}) | |
@Retention(RUNTIME) | |
public @interface ExistenceChecking { | |
/** | |
* (Optional) Set the existence check for determining | |
* if an insert or update should occur for an object. | |
*/ | |
ExistenceType value() default CHECK_CACHE; | |
} |