com.sleepycat.persist.model.ClassMetadata Maven / Gradle / Ivy
The newest version!
/*-
* Copyright (C) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
*
* This file was distributed by Oracle as part of a version of Oracle Berkeley
* DB Java Edition made available at:
*
* http://www.oracle.com/technetwork/database/database-technologies/berkeleydb/downloads/index.html
*
* Please see the LICENSE file included in the top-level directory of the
* appropriate version of Oracle Berkeley DB Java Edition for a copy of the
* license and additional information.
*/
package com.sleepycat.persist.model;
import java.io.Serializable;
import java.util.Collection;
import java.util.List;
import java.util.Map;
/**
* The metadata for a persistent class. A persistent class may be specified
* with the {@link Entity} or {@link Persistent} annotation.
*
* {@code ClassMetadata} objects are thread-safe. Multiple threads may
* safely call the methods of a shared {@code ClassMetadata} object.
*
* This and other metadata classes are classes rather than interfaces to
* allow adding properties to the model at a future date without causing
* incompatibilities. Any such property will be given a default value and
* its use will be optional.
*
* @author Mark Hayes
*/
public class ClassMetadata implements Serializable {
private static final long serialVersionUID = -2520207423701776679L;
private String className;
private int version;
private String proxiedClassName;
private boolean entityClass;
private PrimaryKeyMetadata primaryKey;
private Map secondaryKeys;
private List compositeKeyFields;
private Collection persistentFields;
/**
* Used by an {@code EntityModel} to construct persistent class metadata.
* The optional {@link #getPersistentFields} property will be set to null.
*
* @param className the class name.
* @param version the version.
* @param proxiedClassName the proxied class name.
* @param entityClass whether the class is an entity class.
* @param primaryKey the primary key metadata.
* @param secondaryKeys the secondary key metadata.
* @param compositeKeyFields the composite key field metadata.
*/
public ClassMetadata(String className,
int version,
String proxiedClassName,
boolean entityClass,
PrimaryKeyMetadata primaryKey,
Map secondaryKeys,
List compositeKeyFields) {
this(className, version, proxiedClassName, entityClass, primaryKey,
secondaryKeys, compositeKeyFields, null /*persistentFields*/);
}
/**
* Used by an {@code EntityModel} to construct persistent class metadata.
*
* @param className the class name.
* @param version the version.
* @param proxiedClassName the proxied class name.
* @param entityClass whether the class is an entity class.
* @param primaryKey the primary key metadata.
* @param secondaryKeys the secondary key metadata.
* @param compositeKeyFields the composite key field metadata.
* @param persistentFields the persistent field metadata.
*/
public ClassMetadata(String className,
int version,
String proxiedClassName,
boolean entityClass,
PrimaryKeyMetadata primaryKey,
Map secondaryKeys,
List compositeKeyFields,
Collection persistentFields) {
this.className = className;
this.version = version;
this.proxiedClassName = proxiedClassName;
this.entityClass = entityClass;
this.primaryKey = primaryKey;
this.secondaryKeys = secondaryKeys;
this.compositeKeyFields = compositeKeyFields;
this.persistentFields = persistentFields;
}
/**
* Returns the name of the persistent class.
*
* @return the name of the persistent class.
*/
public String getClassName() {
return className;
}
/**
* Returns the version of this persistent class. This may be specified
* using the {@link Entity#version} or {@link Persistent#version}
* annotation.
*
* @return the version of this persistent class.
*/
public int getVersion() {
return version;
}
/**
* Returns the class name of the proxied class if this class is a {@link
* PersistentProxy}, or null otherwise.
*
* @return the class name of the proxied class, or null.
*/
public String getProxiedClassName() {
return proxiedClassName;
}
/**
* Returns whether this class is an entity class.
*
* @return whether this class is an entity class.
*/
public boolean isEntityClass() {
return entityClass;
}
/**
* Returns the primary key metadata for a key declared in this class, or
* null if none is declared. This may be specified using the {@link
* PrimaryKey} annotation.
*
* @return the primary key metadata, or null.
*/
public PrimaryKeyMetadata getPrimaryKey() {
return primaryKey;
}
/**
* Returns an unmodifiable map of key name (which may be different from
* field name) to secondary key metadata for all secondary keys declared in
* this class, or null if no secondary keys are declared in this class.
* This metadata may be specified using {@link SecondaryKey} annotations.
*
* @return the unmodifiable map, or null.
*/
public Map getSecondaryKeys() {
return secondaryKeys;
}
/**
* Returns an unmodifiable list of metadata for the fields making up a
* composite key, or null if this is a not a composite key class. The
* order of the fields in the returned list determines their stored order
* and may be specified using the {@link KeyField} annotation. When the
* composite key class does not implement {@link Comparable}, the order of
* the fields is the relative sort order.
*
* @return the unmodifiable list, or null.
*/
public List getCompositeKeyFields() {
return compositeKeyFields;
}
/**
* Returns an unmodifiable list of metadata for the persistent fields in
* this class, or null if the default rules for persistent fields should be
* used. All fields returned must be declared in this class and must be
* non-static.
*
* By default (if null is returned) the persistent fields of a class
* will be all declared instance fields that are non-transient (are not
* declared with the transient keyword). The default rules
* may be overridden by an {@link EntityModel}. For example, the {@link
* AnnotationModel} overrides the default rules when the {@link
* NotPersistent} or {@link NotTransient} annotation is specified.
*
* @return the unmodifiable list, or null.
*/
public Collection getPersistentFields() {
return persistentFields;
}
@Override
public boolean equals(Object other) {
if (other instanceof ClassMetadata) {
ClassMetadata o = (ClassMetadata) other;
return version == o.version &&
entityClass == o.entityClass &&
nullOrEqual(className, o.className) &&
nullOrEqual(proxiedClassName, o.proxiedClassName) &&
nullOrEqual(primaryKey, o.primaryKey) &&
nullOrEqual(secondaryKeys, o.secondaryKeys) &&
nullOrEqual(compositeKeyFields, o.compositeKeyFields);
} else {
return false;
}
}
@Override
public int hashCode() {
return version +
(entityClass ? 1 : 0) +
hashCode(className) +
hashCode(proxiedClassName) +
hashCode(primaryKey) +
hashCode(secondaryKeys) +
hashCode(compositeKeyFields);
}
static boolean nullOrEqual(Object o1, Object o2) {
if (o1 == null) {
return o2 == null;
} else {
return o1.equals(o2);
}
}
static int hashCode(Object o) {
if (o != null) {
return o.hashCode();
} else {
return 0;
}
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy