| /******************************************************************************* | |
| * Copyright (c) 2011, 2013 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: | |
| * James Sutherland - initial design and implementation | |
| ******************************************************************************/ | |
| package org.eclipse.persistence.annotations; | |
| /** | |
| * Configures what type of database change notification an entity/descriptor should use. | |
| * This is only relevant if the persistence unit/session has been configured with a DatabaseEventListener, | |
| * such as the OracleChangeNotificationListener that receives database change events. | |
| * This allows for the EclipseLink cache to be invalidated or updated from database changes. | |
| * | |
| * @see Cache#databaseChangeNotificationType() | |
| * @see org.eclipse.persistence.descriptors.CachePolicy#setDatabaseChangeNotificationType(DatabaseChangeNotificationType) | |
| * @author James Sutherland | |
| * @since EclipseLink 2.4 | |
| */ | |
| public enum DatabaseChangeNotificationType { | |
| /** | |
| * No database change events will be processed. | |
| */ | |
| NONE, | |
| /** | |
| * Invalidates the EclipseLink cache when a database change event is received for an object. | |
| * This requires a DatabaseEventListener to be configured with the persistence unit or session. | |
| * This requires that the database change can be determine to affect the object, some database change events, | |
| * such as the OracleChangeNotificationListener (Oracle DCN/QCN) only give the ROWID, so changes to secondary | |
| * table or relationships may not be able to be determined to affect and object unless its version is also changed. | |
| */ | |
| INVALIDATE | |
| } |