RuntimeInstance.java
// SECTION-START[License Header]
// <editor-fold defaultstate="collapsed" desc=" Generated License ">
/*
* Java Object Management and Configuration
* Copyright (C) Christian Schulte <cs@schulte.it>, 2011-313
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* o Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* o Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* $JOMC: RuntimeInstance.java 5061 2015-05-31 13:20:40Z schulte $
*
*/
// </editor-fold>
// SECTION-END
package org.jomc.ri.model;
import java.lang.ref.Reference;
import java.lang.ref.WeakReference;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
import java.util.Map;
import javax.xml.bind.annotation.XmlTransient;
import org.jomc.model.Instance;
import org.jomc.model.JavaTypeName;
import org.jomc.model.ModelObjectException;
import org.jomc.model.Specification;
import org.jomc.util.WeakIdentityHashMap;
import static org.jomc.ri.model.RuntimeModelObjects.BOOTSTRAP_CLASSLOADER_KEY;
import static org.jomc.ri.model.RuntimeModelObjects.classesByClassLoaderAndNameCache;
import static org.jomc.ri.model.RuntimeModelObjects.createMap;
// SECTION-START[Documentation]
// <editor-fold defaultstate="collapsed" desc=" Generated Documentation ">
/**
* Runtime {@code Instance}.
*
* <dl>
* <dt><b>Identifier:</b></dt><dd>org.jomc.ri.model.RuntimeInstance</dd>
* <dt><b>Name:</b></dt><dd>JOMC ⁑ RI ⁑ RuntimeInstance</dd>
* <dt><b>Specifications:</b></dt>
* <dd>org.jomc.ri.model.RuntimeModelObject @ 1.2</dd>
* <dt><b>Abstract:</b></dt><dd>No</dd>
* <dt><b>Final:</b></dt><dd>No</dd>
* <dt><b>Stateless:</b></dt><dd>No</dd>
* </dl>
*
* @author <a href="mailto:cs@schulte.it">Christian Schulte</a> 1.2
* @version 1.2
*/
// </editor-fold>
// SECTION-END
// SECTION-START[Annotations]
// <editor-fold defaultstate="collapsed" desc=" Generated Annotations ">
@javax.annotation.Generated( value = "org.jomc.tools.SourceFileProcessor 1.9", comments = "See http://www.jomc.org/jomc/1.9/jomc-tools-1.9" )
// </editor-fold>
// SECTION-END
public class RuntimeInstance extends Instance implements RuntimeModelObject
{
// SECTION-START[RuntimeInstance]
/**
* Classes by class loader any instance cache.
*/
@XmlTransient
static final Map<ClassLoader, Map<String, Reference<Class<?>[]>>> classesByClassLoaderAndInstanceCache =
new WeakIdentityHashMap<ClassLoader, Map<String, Reference<Class<?>[]>>>();
/**
* Constructors by class loader any instance cache.
*/
@XmlTransient
static final Map<ClassLoader, Map<String, Reference<Constructor<?>>>> constructorsByClassLoaderAndInstanceCache =
new WeakIdentityHashMap<ClassLoader, Map<String, Reference<Constructor<?>>>>();
/**
* Methods by class loader any instance cache.
*/
@XmlTransient
static final Map<ClassLoader, Map<String, Reference<Method>>> methodsByClassLoaderAndInstanceCache =
new WeakIdentityHashMap<ClassLoader, Map<String, Reference<Method>>>();
/**
* Assignable flags by class loader any instance cache.
*/
@XmlTransient
static final Map<ClassLoader, Map<String, Boolean>> assignableFlagsByClassLoaderAndInstanceCache =
new WeakIdentityHashMap<ClassLoader, Map<String, Boolean>>();
/**
* Proxy classes by class loader any instance cache.
*/
@XmlTransient
static final Map<ClassLoader, Map<String, Reference<Class<?>>>> proxyClassesByClassLoaderAndInstanceCache =
new WeakIdentityHashMap<ClassLoader, Map<String, Reference<Class<?>>>>();
/**
* Method name.
*/
@XmlTransient
private volatile String javaClassFactoryMethodName;
/**
* Java type name.
*/
@XmlTransient
private volatile JavaTypeName javaTypeName;
/**
* Creates a new {@code RuntimeInstance} instance by deeply copying a given {@code Instance} instance.
*
* @param instance The instance to copy.
*
* @throws NullPointerException if {@code instance} is {@code null}.
*/
public RuntimeInstance( final Instance instance )
{
super( instance );
if ( this.getAuthors() != null )
{
this.setAuthors( RuntimeModelObjects.getInstance().copyOf( this.getAuthors() ) );
}
if ( this.getDependencies() != null )
{
this.setDependencies( RuntimeModelObjects.getInstance().copyOf( this.getDependencies() ) );
}
if ( this.getDocumentation() != null )
{
this.setDocumentation( RuntimeModelObjects.getInstance().copyOf( this.getDocumentation() ) );
}
if ( this.getMessages() != null )
{
this.setMessages( RuntimeModelObjects.getInstance().copyOf( this.getMessages() ) );
}
if ( this.getProperties() != null )
{
this.setProperties( RuntimeModelObjects.getInstance().copyOf( this.getProperties() ) );
}
if ( this.getSpecifications() != null )
{
this.setSpecifications( RuntimeModelObjects.getInstance().copyOf( this.getSpecifications() ) );
}
}
/**
* Gets the Java class of the instance for a given class loader.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the class loader, should the state of the class loader change.
* </p>
*
* @param classLoader The class loader to get the Java class from or {@code null}, to get the Java class from the
* platform's bootstrap class loader.
*
* @return The Java class of the instance.
*
* @throws ClassNotFoundException if the Java class is not found.
* @throws ModelObjectException if parsing the name of the referenced type fails.
*
* @see #getClazz()
* @see RuntimeModelObjects#clear()
*/
@Override
public Class<?> getJavaClass( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
Class<?> javaClass = null;
if ( this.getJavaTypeName() != null )
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( classesByClassLoaderAndNameCache )
{
Map<String, Reference<Class<?>>> map = classesByClassLoaderAndNameCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
classesByClassLoaderAndNameCache.put( classLoaderKey, map );
}
final Reference<Class<?>> reference = map.get( this.getJavaTypeName().getClassName() );
if ( reference != null )
{
javaClass = reference.get();
}
if ( javaClass == null )
{
javaClass = super.getJavaClass( classLoader );
map.put( this.getJavaTypeName().getClassName(), new WeakReference<Class<?>>( javaClass ) );
}
}
}
return javaClass;
}
/**
* Gets the Java classes of all specifications of the instance for a given class loader.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the instance and class loader, should the state of the instance or class loader
* change.
* </p>
*
* @param classLoader The class loader to get the Java classes from or {@code null}, to get the Java classes from
* the platform's bootstrap class loader.
*
* @return The Java classes of all specifications of the instance.
*
* @throws ClassNotFoundException if a Java class is not found.
* @throws ModelObjectException if parsing a name of a referenced type fails.
*
* @see #getSpecifications()
* @see Specification#getClazz()
* @see RuntimeModelObjects#clear()
*/
@Override
public Class<?>[] getJavaClasses( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( classesByClassLoaderAndInstanceCache )
{
Class<?>[] javaClasses = null;
Map<String, Reference<Class<?>[]>> map = classesByClassLoaderAndInstanceCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
classesByClassLoaderAndInstanceCache.put( classLoaderKey, map );
}
final Reference<Class<?>[]> reference = map.get( this.getIdentifier() );
if ( reference != null )
{
javaClasses = reference.get();
}
if ( javaClasses == null && ( reference != null || !map.containsKey( this.getIdentifier() ) ) )
{
javaClasses = super.getJavaClasses( classLoader );
map.put( this.getIdentifier(), new WeakReference<Class<?>[]>( javaClasses ) );
}
return javaClasses;
}
}
/**
* Gets the Java constructor to use for creating objects of the instance.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the instance and class loader, should the state of the instance or class loader
* change.
* </p>
*
* @param classLoader The class loader to get the Java class from or {@code null}, to get the Java class from the
* platform's bootstrap class loader.
*
* @return The public default Java constructor of the Java class of the instance or {@code null}, if that class
* does not declare such a constructor, is abstract or is not public.
*
* @throws ClassNotFoundException if the Java class is not found.
* @throws ModelObjectException if parsing the name of the type referenced by the instance fails.
*
* @see #getJavaClass(java.lang.ClassLoader)
* @see RuntimeModelObjects#clear()
*/
@Override
public Constructor<?> getJavaConstructor( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( constructorsByClassLoaderAndInstanceCache )
{
Constructor<?> javaClassConstructor = null;
Map<String, Reference<Constructor<?>>> map = constructorsByClassLoaderAndInstanceCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
constructorsByClassLoaderAndInstanceCache.put( classLoaderKey, map );
}
final Reference<Constructor<?>> reference = map.get( this.getIdentifier() );
if ( reference != null )
{
javaClassConstructor = reference.get();
}
if ( javaClassConstructor == null && ( reference != null || !map.containsKey( this.getIdentifier() ) ) )
{
javaClassConstructor = super.getJavaConstructor( classLoader );
map.put( this.getIdentifier(), new WeakReference<Constructor<?>>( javaClassConstructor ) );
}
return javaClassConstructor;
}
}
/**
* Gets the name of the Java method to use for creating objects of the instance.
* <p>
* This method queries an internal cache for a result object to return. If no cached result object is available,
* this method queries the super-class for a result object to return and caches the outcome of that query for use on
* successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code clear()} must be used to synchronize the state of the internal cache with the
* state of the instance, should the state of the instance change.
* </p>
*
* @return The name of the Java method to use for creating objects of the instance or {@code null}, if no such
* method name is supported.
*
* @throws ModelObjectException if compiling the name of the instance to a {@code JavaIdentifier} fails.
*
* @see #getName()
* @see #clear()
*/
@Override
public String getJavaFactoryMethodName() throws ModelObjectException
{
if ( this.javaClassFactoryMethodName == null )
{
this.javaClassFactoryMethodName = super.getJavaFactoryMethodName();
}
return this.javaClassFactoryMethodName;
}
/**
* Gets the Java method to use for creating objects of the instance.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the instance and class loader, should the state of the instance or class loader
* change.
* </p>
*
* @param classLoader The class loader to get the Java class from or {@code null}, to get the Java class from the
* platform's bootstrap class loader.
*
* @return The public Java method of the Java class of the instance to use for creating objects of the instance or
* {@code null}, if that class does not declare such a method.
*
* @throws ClassNotFoundException if the Java class is not found.
* @throws ModelObjectException if parsing the name of the type referenced by the instance fails.
*
* @see #getJavaClass(java.lang.ClassLoader)
* @see #getJavaFactoryMethodName()
* @see RuntimeModelObjects#clear()
*/
@Override
public Method getJavaFactoryMethod( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( methodsByClassLoaderAndInstanceCache )
{
Method javaClassFactoryMethod = null;
Map<String, Reference<Method>> map = methodsByClassLoaderAndInstanceCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
methodsByClassLoaderAndInstanceCache.put( classLoaderKey, map );
}
final Reference<Method> reference = map.get( this.getIdentifier() );
if ( reference != null )
{
javaClassFactoryMethod = reference.get();
}
if ( javaClassFactoryMethod == null && ( reference != null || !map.containsKey( this.getIdentifier() ) ) )
{
javaClassFactoryMethod = super.getJavaFactoryMethod( classLoader );
map.put( this.getIdentifier(), new WeakReference<Method>( javaClassFactoryMethod ) );
}
return javaClassFactoryMethod;
}
}
/**
* Gets a flag indicating the Java class of the instance is assignable to all Java classes of all specifications of
* the instance.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the instance and class loader, should the state of the instance or class loader
* change.
* </p>
*
* @param classLoader The class loader to get the Java classes from or {@code null}, to get the Java classes from
* the platform's bootstrap class loader.
*
* @return {@code true}, if the Java class of the instance is assignable to all Java classes of all specifications
* of the instance; {@code false}, if the Java class of the instance is not assignable to all Java classes of all
* specifications of the instance.
*
* @throws ClassNotFoundException if a Java class is not found.
* @throws ModelObjectException if parsing a name of a referenced type fails.
*
* @see #getJavaClass(java.lang.ClassLoader)
* @see #getJavaClasses(java.lang.ClassLoader)
* @see RuntimeModelObjects#clear()
*/
@Override
public boolean isJavaClassAssignable( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( assignableFlagsByClassLoaderAndInstanceCache )
{
Map<String, Boolean> map = assignableFlagsByClassLoaderAndInstanceCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
assignableFlagsByClassLoaderAndInstanceCache.put( classLoaderKey, map );
}
Boolean javaClassAssignable = map.get( this.getIdentifier() );
if ( javaClassAssignable == null && !map.containsKey( this.getIdentifier() ) )
{
javaClassAssignable = super.isJavaClassAssignable( classLoader );
map.put( this.getIdentifier(), javaClassAssignable );
}
return javaClassAssignable == null ? false : javaClassAssignable;
}
}
/**
* Gets the Java proxy class for a given class loader.
* <p>
* This method queries an internal cache for a result object to return for the given argument values. If no
* cached result object is available, this method queries the super-class for a result object to return and caches
* the outcome of that query for use on successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code RuntimeModelObjects.clear()} must be used to synchronize the state of the
* internal cache with the state of the instance and class loader, should the state of the instance or class loader
* change.
* </p>
*
* @param classLoader The class loader to get the Java proxy class for.
*
* @return The Java proxy class for {@code classLoader} or {@code null}, if the instance does not support a Java
* proxy class.
*
* @throws ClassNotFoundException if a Java class is not found.
* @throws ModelObjectException if parsing a name of a referenced type fails.
*
* @see #getJavaClasses(java.lang.ClassLoader)
* @see RuntimeModelObjects#clear()
*/
@Override
public Class<?> getJavaProxyClass( final ClassLoader classLoader )
throws ModelObjectException, ClassNotFoundException
{
ClassLoader classLoaderKey = classLoader;
if ( classLoaderKey == null )
{
classLoaderKey = BOOTSTRAP_CLASSLOADER_KEY;
}
synchronized ( proxyClassesByClassLoaderAndInstanceCache )
{
Class<?> javaProxyClass = null;
Map<String, Reference<Class<?>>> map = proxyClassesByClassLoaderAndInstanceCache.get( classLoaderKey );
if ( map == null )
{
map = createMap();
proxyClassesByClassLoaderAndInstanceCache.put( classLoaderKey, map );
}
final Reference<Class<?>> reference = map.get( this.getIdentifier() );
if ( reference != null )
{
javaProxyClass = reference.get();
}
if ( javaProxyClass == null && ( reference != null || !map.containsKey( this.getIdentifier() ) ) )
{
javaProxyClass = super.getJavaProxyClass( classLoader );
map.put( this.getIdentifier(), new WeakReference<Class<?>>( javaProxyClass ) );
}
return javaProxyClass;
}
}
/**
* Gets the Java type name of the type referenced by the instance.
* <p>
* This method queries an internal cache for a result object to return. If no cached result object is available,
* this method queries the super-class for a result object to return and caches the outcome of that query for use on
* successive calls.
* </p>
* <p>
* <b>Note:</b><br/>Method {@code clear()} must be used to synchronize the state of the internal cache with the
* state of the instance, should the state of the instance change.
* </p>
*
* @return The Java type name of the type referenced by the instance or {@code null}, if the instance does not
* reference a type.
*
* @throws ModelObjectException if compiling the name of the referenced type to a {@code JavaTypeName} fails.
*
* @since 1.4
*
* @see Instance#getJavaTypeName()
* @see #clear()
*/
@Override
public JavaTypeName getJavaTypeName() throws ModelObjectException
{
if ( this.javaTypeName == null )
{
this.javaTypeName = super.getJavaTypeName();
}
return this.javaTypeName;
}
// SECTION-END
// SECTION-START[RuntimeModelObject]
public void gc()
{
this.gcOrClear( true, false );
}
public void clear()
{
this.javaClassFactoryMethodName = null;
this.javaTypeName = null;
this.gcOrClear( false, true );
}
private void gcOrClear( final boolean gc, final boolean clear )
{
if ( this.getAuthors() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getAuthors() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getAuthors() ).clear();
}
}
if ( this.getDependencies() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getDependencies() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getDependencies() ).clear();
}
}
if ( this.getDocumentation() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getDocumentation() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getDocumentation() ).clear();
}
}
if ( this.getMessages() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getMessages() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getMessages() ).clear();
}
}
if ( this.getProperties() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getProperties() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getProperties() ).clear();
}
}
if ( this.getSpecifications() instanceof RuntimeModelObject )
{
if ( gc )
{
( (RuntimeModelObject) this.getSpecifications() ).gc();
}
if ( clear )
{
( (RuntimeModelObject) this.getSpecifications() ).clear();
}
}
}
// SECTION-END
// SECTION-START[Constructors]
// <editor-fold defaultstate="collapsed" desc=" Generated Constructors ">
/** Creates a new {@code RuntimeInstance} instance. */
@javax.annotation.Generated( value = "org.jomc.tools.SourceFileProcessor 1.9", comments = "See http://www.jomc.org/jomc/1.9/jomc-tools-1.9" )
public RuntimeInstance()
{
// SECTION-START[Default Constructor]
super();
// SECTION-END
}
// </editor-fold>
// SECTION-END
// SECTION-START[Dependencies]
// SECTION-END
// SECTION-START[Properties]
// SECTION-END
// SECTION-START[Messages]
// SECTION-END
}