org.datanucleus.metadata.MetaData Maven / Gradle / Ivy
Show all versions of datanucleus-core Show documentation
/**********************************************************************
Copyright (c) 2004 Erik Bengtson and others. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Contributors:
2005 Andy Jefferson - addition of states
2007 Andy Jefferson - moved extensions to this class, javadocs
...
**********************************************************************/
package org.datanucleus.metadata;
import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;
import org.datanucleus.ClassLoaderResolver;
import org.datanucleus.exceptions.NucleusException;
/**
* Base class for all MetaData.
* MetaData Lifecycle
* The states represent the lifecycle of a MetaData object. The lifecycle goes as follows :
*
* - MetaData object is created (values passed in from a parsed file, or manually generated)
* - MetaData object is populated (maybe pass in a class that it represents, creating any additional information that wasn't in the initial data).
* - MetaData object is initialised (any internal arrays are set up, and additions of data is blocked from this point).
*
- MetaData object is added to with runtime information like actual column names and types in use.
*
* MetaData Extensibility
*
* All MetaData elements are extensible with extensions. We only store the DataNucleus vendor extensions here.
*/
public class MetaData implements Serializable
{
private static final long serialVersionUID = -5477406260914096062L;
private enum State
{
CREATED,
POPULATED,
INITIALISED,
USED
}
/** Vendor name (DataNucleus) used for extensions. */
public static final String VENDOR_NAME = "datanucleus";
/** Class : read only. */
public static final String EXTENSION_CLASS_READ_ONLY = "read-only";
/** Class : when using multitenancy for this class. */ // TODO Drop this when we support XML metadata
public static final String EXTENSION_CLASS_MULTITENANT = "multitenant";
/** Class : when using multitenancy, defines the column name used for the mutitenancy discriminator. */ // TODO Drop this when we support XML metadata
public static final String EXTENSION_CLASS_MULTITENANCY_COLUMN_NAME = "multitenancy-column-name";
/** Class : when using multitenancy, defines the length of column used for the mutitenancy discriminator. */ // TODO Drop this when we support XML metadata
public static final String EXTENSION_CLASS_MULTITENANCY_COLUMN_LENGTH = "multitenancy-column-length";
/** Class : when using multitenancy, defines the jdbc-type used for the mutitenancy discriminator column. */ // TODO Drop this when we support XML metadata
public static final String EXTENSION_CLASS_MULTITENANCY_JDBC_TYPE = "multitenancy-jdbc-type";
/** Class : when the class will use soft deletion (deletion flag column) rather than actually deleting objects. */
public static final String EXTENSION_CLASS_SOFTDELETE = "softdelete";
/** Class : when the class will use soft deletion, specifies the column name to use. */
public static final String EXTENSION_CLASS_SOFTDELETE_COLUMN_NAME = "softdelete-column-name";
/** Class : when the class will have a create-user column for auditing. */
public static final String EXTENSION_CLASS_CREATEUSER = "create-user";
/** Class : when the class will have a create-user column for auditing, specifies the column name to use. */
public static final String EXTENSION_CLASS_CREATEUSER_COLUMN_NAME = "create-user-column-name";
/** Class : when the class will have a create-user column for auditing, defines the length of column to use. */
public static final String EXTENSION_CLASS_CREATEUSER_COLUMN_LENGTH = "create-user-column-length";
/** Class : when the class will have a update-user column for auditing. */
public static final String EXTENSION_CLASS_UPDATEUSER = "update-user";
/** Class : when the class will have a update-user column for auditing, specifies the column name to use. */
public static final String EXTENSION_CLASS_UPDATEUSER_COLUMN_NAME = "update-user-column-name";
/** Class : when the class will have a update-user column for auditing, defines the length of column to use. */
public static final String EXTENSION_CLASS_UPDATEUSER_COLUMN_LENGTH = "update-user-column-length";
/** Class : when the class will have a create-timestamp column for auditing. */
public static final String EXTENSION_CLASS_CREATETIMESTAMP = "create-timestamp";
/** Class : when the class will have a create-timestamp column for auditing, specifies the column name to use. */
public static final String EXTENSION_CLASS_CREATETIMESTAMP_COLUMN_NAME = "create-timestamp-column-name";
/** Class : when the class will have a update-timestamp column for auditing. */
public static final String EXTENSION_CLASS_UPDATETIMESTAMP = "update-timestamp";
/** Class : when the class will have a update-timestamp column for auditing, specifies the column name to use. */
public static final String EXTENSION_CLASS_UPDATETIMESTAMP_COLUMN_NAME = "update-timestamp-column-name";
/** Class : define the name of a member that will store the version of this class. */
public static final String EXTENSION_CLASS_VERSION_FIELD_NAME = "field-name"; // TODO Change to member-name
/** Class : initial value to use for this class for versioning (when using version-number strategy). */
public static final String EXTENSION_VERSION_NUMBER_INITIAL_VALUE = "version-initial-value";
/** Member : name of type converter to use. */
public final static String EXTENSION_MEMBER_TYPE_CONVERTER_NAME = "type-converter-name";
public final static String EXTENSION_MEMBER_TYPE_CONVERTER_DISABLED = "type-converter-disabled";
/** Member : name of comparator class when of SortedSet/SortedMap type. */
public static final String EXTENSION_MEMBER_COMPARATOR_NAME = "comparator-name";
/** Member : implementation class names, when the member is of a interface/reference type. */
public static final String EXTENSION_MEMBER_IMPLEMENTATION_CLASSES = "implementation-classes";
/** Member : implementation class names, when the member is of a interface/reference type. */
public static final String EXTENSION_MEMBER_KEY_IMPLEMENTATION_CLASSES = "key-implementation-classes";
/** Member : implementation class names, when the member is of a interface/reference type. */
public static final String EXTENSION_MEMBER_VALUE_IMPLEMENTATION_CLASSES = "value-implementation-classes";
/** Member : when field is enum, name of the method to get the "value" of the enum. */
public static final String EXTENSION_MEMBER_ENUM_VALUE_GETTER = "enum-value-getter";
/** Member : when the field is Calendar, signifies that it should be stored as a single column. */
public static final String EXTENSION_MEMBER_CALENDAR_ONE_COLUMN = "calendar-one-column";
/** Member : whether the field is insertable (for JDO). */
public static final String EXTENSION_MEMBER_INSERTABLE = "insertable";
/** Member : whether the field is updateable (for JDO). */
public static final String EXTENSION_MEMBER_UPDATEABLE = "updateable";
/** Member : whether the field is cascade-persist (for JDO). */
public static final String EXTENSION_MEMBER_CASCADE_PERSIST = "cascade-persist";
/** Member : whether the field is cascade-attach (for JDO). */
public static final String EXTENSION_MEMBER_CASCADE_ATTACH = "cascade-attach";
/** Member : whether the field is cascade-detach (for JDO). */
public static final String EXTENSION_MEMBER_CASCADE_DETACH = "cascade-detach";
/** Member : whether the field is cascade-refresh (for JDO). */
public static final String EXTENSION_MEMBER_CASCADE_REFRESH = "cascade-refresh";
/** Member : whether the field is (L2) cacheable (for JPA). */
public static final String EXTENSION_MEMBER_CACHEABLE = "cacheable";
/** Member : whether this member (collection/map/array) should allow null elements/keys/values. */
public static final String EXTENSION_MEMBER_CONTAINER_ALLOW_NULLS = "allow-nulls";
/** Member : the ordering clause to use for this List field. */
public static final String EXTENSION_MEMBER_LIST_ORDERING = "list-ordering";
/** Member : when this field has a value generator, only apply it when the field is not set. */
public static final String EXTENSION_MEMBER_STRATEGY_WHEN_NOTNULL = "strategy-when-notnull";
/** Member : shared relation, column name for relation discriminator column. */
public static final String EXTENSION_MEMBER_RELATION_DISCRIM_COLUMN = "relation-discriminator-column";
/** Member : shared relation, value for this class for relation discriminator column. */
public static final String EXTENSION_MEMBER_RELATION_DISCRIM_VALUE = "relation-discriminator-value";
/** Member : shared relation, where the relation discriminator column is part of the PK. */
public static final String EXTENSION_MEMBER_RELATION_DISCRIM_PK = "relation-discriminator-pk";
/** Member : create user extension. */
public static final String EXTENSION_MEMBER_CREATE_USER = "create-user";
/** Member : create timestamp extension. */
public static final String EXTENSION_MEMBER_CREATE_TIMESTAMP = "create-timestamp";
/** Member : create user extension. */
public static final String EXTENSION_MEMBER_UPDATE_USER = "update-user";
/** Member : create timestamp extension. */
public static final String EXTENSION_MEMBER_UPDATE_TIMESTAMP = "update-timestamp";
/** Class : definition of VIEW (when mapping to a view). */
public static final String EXTENSION_CLASS_VIEW_DEFINITION = "view-definition";
/** Class : definition of imports for VIEW (when mapping to a view). */
public static final String EXTENSION_CLASS_VIEW_IMPORTS = "view-imports";
/** Index : orderings of columns in an index, comma separated series of "ASC", "DESC" etc. */
public static final String EXTENSION_INDEX_COLUMN_ORDERING = "index-column-ordering";
/** State of the MetaData. */
protected State metaDataState = State.CREATED;
/** Parent MetaData object, allowing hierarchical MetaData structure. */
protected MetaData parent;
/** Extensions for this MetaData element. */
protected Map extensions = null;
public MetaData()
{
}
/**
* Constructor. Taking the parent MetaData object (if any).
* @param parent The parent MetaData object.
*/
public MetaData(MetaData parent)
{
this.parent = parent;
}
/**
* Copy constructor. Taking the parent MetaData object, and an object to copy from.
* @param parent The parent MetaData object.
* @param copy The metadata to copy from
*/
public MetaData(MetaData parent, MetaData copy)
{
this.parent = parent;
if (copy != null && copy.extensions != null)
{
if (extensions == null)
{
extensions = new HashMap<>(copy.extensions);
}
else
{
extensions.clear();
extensions.putAll(copy.extensions);
}
}
}
public void initialise(ClassLoaderResolver clr)
{
setInitialised();
}
void setInitialised()
{
metaDataState = State.INITIALISED;
}
void setPopulated()
{
metaDataState = State.POPULATED;
}
void setUsed()
{
metaDataState = State.USED;
}
public boolean isPopulated()
{
return metaDataState == State.POPULATED || metaDataState == State.INITIALISED || metaDataState == State.USED;
}
public boolean isInitialised()
{
return metaDataState == State.INITIALISED || metaDataState == State.USED;
}
public boolean isUsed()
{
return metaDataState == State.USED;
}
public MetaDataManager getMetaDataManager()
{
return parent != null ? parent.getMetaDataManager() : null;
}
public void setParent(MetaData md)
{
if (isPopulated() || isInitialised())
{
throw new NucleusException("Cannot set parent of " + this + " since it is already populated/initialised");
}
this.parent = md;
}
public MetaData getParent()
{
return parent;
}
public MetaData addExtensions(Map exts)
{
if (exts == null || exts.size() == 0)
{
return this;
}
if (extensions == null)
{
extensions = new HashMap<>(exts);
}
else
{
extensions.putAll(exts);
}
return this;
}
public MetaData setExtensions(Map exts)
{
if (exts == null)
{
extensions = null;
}
else
{
extensions = new HashMap<>(exts);
}
return this;
}
public MetaData addExtension(String key, String value)
{
if (key == null || value == null)
{
throw new InvalidMetaDataException("044160", VENDOR_NAME, key, value);
}
if (hasExtension(key))
{
// Remove any existing value
removeExtension(key);
}
if (extensions == null)
{
extensions = new HashMap<>();
}
extensions.put(key, value);
return this;
}
public MetaData removeExtension(String key)
{
if (extensions == null)
{
return this;
}
extensions.remove(key);
return this;
}
public int getNoOfExtensions()
{
return extensions != null ? extensions.size() : 0;
}
public Map getExtensions()
{
if (extensions == null || extensions.isEmpty())
{
return null;
}
return extensions;
}
public boolean hasExtension(String key)
{
if (extensions == null || key == null)
{
return false;
}
return extensions.containsKey(key);
}
/**
* Accessor for the value of a particular extension.
* @param key The key of the extension
* @return The value of the extension (null if not existing)
*/
public String getValueForExtension(String key)
{
if (extensions == null || key == null)
{
return null;
}
return extensions.get(key);
}
/**
* Accessor for the value of a particular extension, but splitting it into separate parts.
* This is for extension tags that have a value as comma separated.
* @param key The key of the extension
* @return The value(s) of the extension (null if not existing)
*/
public String[] getValuesForExtension(String key)
{
if (extensions == null || key == null)
{
return null;
}
String value = extensions.get(key);
if (value != null)
{
return MetaDataUtils.getInstance().getValuesForCommaSeparatedAttribute(value);
}
return null;
}
}