/*
 * Hibernate, Relational Persistence for Idiomatic Java
 *
 * License: GNU Lesser General Public License (LGPL), version 2.1 or later.
 * See the lgpl.txt file in the root directory or <http://www.gnu.org/licenses/lgpl-2.1.html>.
 */
package org.hibernate.engine.spi;

import org.hibernate.MappingException;
import org.hibernate.id.IdentifierGeneratorHelper;
import org.hibernate.internal.CoreLogging;

import org.jboss.logging.Logger;

A strategy for determining if a version value is a version of a new transient instance or a previously persistent transient instance. The strategy is determined by the unsaved-value attribute in the mapping file.
Author:Gavin King
/** * A strategy for determining if a version value is a version of * a new transient instance or a previously persistent transient instance. * The strategy is determined by the <tt>unsaved-value</tt> attribute in * the mapping file. * * @author Gavin King */
public class VersionValue implements UnsavedValueStrategy { private static final Logger LOG = CoreLogging.logger( VersionValue.class ); private final Object value;
Assume the transient instance is newly instantiated if the version is null, otherwise assume it is a detached instance.
/** * Assume the transient instance is newly instantiated if the version * is null, otherwise assume it is a detached instance. */
public static final VersionValue NULL = new VersionValue() { @Override public final Boolean isUnsaved(Object version) { LOG.trace( "Version unsaved-value strategy NULL" ); return version == null; } @Override public Object getDefaultValue(Object currentValue) { return null; } @Override public String toString() { return "VERSION_SAVE_NULL"; } };
Assume the transient instance is newly instantiated if the version is null, otherwise defer to the identifier unsaved-value.
/** * Assume the transient instance is newly instantiated if the version * is null, otherwise defer to the identifier unsaved-value. */
public static final VersionValue UNDEFINED = new VersionValue() { @Override public final Boolean isUnsaved(Object version) { LOG.trace( "Version unsaved-value strategy UNDEFINED" ); return version == null ? Boolean.TRUE : null; } @Override public Object getDefaultValue(Object currentValue) { return currentValue; } @Override public String toString() { return "VERSION_UNDEFINED"; } };
Assume the transient instance is newly instantiated if the version is negative, otherwise assume it is a detached instance.
/** * Assume the transient instance is newly instantiated if the version * is negative, otherwise assume it is a detached instance. */
public static final VersionValue NEGATIVE = new VersionValue() { @Override public final Boolean isUnsaved(Object version) throws MappingException { LOG.trace( "Version unsaved-value strategy NEGATIVE" ); if ( version == null ) { return Boolean.TRUE; } if ( version instanceof Number ) { return ((Number) version).longValue() < 0L; } throw new MappingException( "unsaved-value NEGATIVE may only be used with short, int and long types" ); } @Override public Object getDefaultValue(Object currentValue) { return IdentifierGeneratorHelper.getIntegralDataTypeHolder( currentValue.getClass() ) .initialize( -1L ) .makeValue(); } @Override public String toString() { return "VERSION_NEGATIVE"; } }; protected VersionValue() { this.value = null; }
Assume the transient instance is newly instantiated if its version is null or equal to value
Params:
  • value – value to compare to
/** * Assume the transient instance is newly instantiated if * its version is null or equal to <tt>value</tt> * * @param value value to compare to */
public VersionValue(Object value) { this.value = value; } @Override public Boolean isUnsaved(Object version) throws MappingException { LOG.tracev( "Version unsaved-value: {0}", value ); return version == null || version.equals( value ); } @Override public Object getDefaultValue(Object currentValue) { return value; } @Override public String toString() { return "version unsaved-value: " + value; } }