Modifier and Type	Class and Description
public static class	JavaSECMPInitializer.TempEntityLoader This class loader is provided at initialization time to allow us to temporarily load domain classes so we can examine them for annotations.

Modifier and Type	Field and Description
public static Instrumentation	globalInstrumentation
private static final Object	initializationLock
protected static JavaSECMPInitializer	initializer
protected static boolean	isInContainer
protected static boolean	isInitialized
protected static boolean	usesAgent

Access	Constructor and Description
protected	JavaSECMPInitializer() User should not instantiate JavaSECMPInitializer.
protected	JavaSECMPInitializer(ClassLoader loader)

Method Summary

Modifier and Type	Method and Description
public void	checkWeaving(Map<K, V> The list of properties to check for weaving and update if weaving is not needed properties) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.checkWeaving. Check whether weaving is possible and update the properties and variable as appropriate
protected ClassLoader	createTempLoader(Collection<E> col) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader. Create a temporary class loader that can be used to inspect classes and then thrown away.
protected ClassLoader	createTempLoader(Collection<E> col, boolean shouldOverrideLoadClassForCollectionMembers) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader.
public static JavaSECMPInitializer	getJavaSECMPInitializer() Get the singleton entityContainer.
public static JavaSECMPInitializer	getJavaSECMPInitializer(ClassLoader classLoader)
public static JavaSECMPInitializer	getJavaSECMPInitializer(ClassLoader classLoader, Map<K, V> m, boolean fromAgent)
public static JavaSECMPInitializer	getJavaSECMPInitializerFromAgent()
public static JavaSECMPInitializer	getJavaSECMPInitializerFromMain(Map<K, V> m)
protected static void	initializeFromAgent(Instrumentation instrumentation) INTERNAL: Should be called only by the agent.
public static void	initializeFromMain(Map<K, V> - a map containing the set of properties to instantiate with. m) Usually JavaSECMPInitializer is initialized from agent during premain to ensure that the classes to be weaved haven't been loaded before initialization.
public static void	initializeFromMain() The version of initializeFromMain that passes an empty map.
public static boolean	isInContainer()
public static boolean	isInitialized() Indicates whether initialization has already occurred.
public boolean	isPersistenceUnitUniquelyDefinedByName() Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.isPersistenceUnitUniquelyDefinedByName. Indicates whether puName uniquely defines the persistence unit.
protected boolean	keepAllPredeployedPersistenceUnits() Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.keepAllPredeployedPersistenceUnits. Indicates whether initialPuInfos and initialEmSetupImpls are used.
public void	registerTransformer(final ClassTransformer transformer, PersistenceUnitInfo persistenceUnitInfo, Map<K, V> properties) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.registerTransformer. Register a transformer.
public static void	setIsInContainer(boolean isInContainer)
public static boolean	usesAgent() Indicates whether Java agent and globalInstrumentation was used.

Inherited from org.eclipse.persistence.internal.jpa.deployment.JPAInitializer:: callPredeploy createUniquePersistenceUnitName extractInitialEmSetupImpl findPersistenceUnitInfo findPersistenceUnitInfoInArchive findPersistenceUnitInfoInArchives getInitializationClassLoader initialize initializeTopLinkLoggingFile initPersistenceUnits isPersistenceProviderSupported loadEntityClasses

Field Detail

globalInstrumentation	back to summary
public static Instrumentation globalInstrumentation

initializationLock	back to summary
private static final Object initializationLock

initializer	back to summary
protected static JavaSECMPInitializer initializer

isInContainer	back to summary
protected static boolean isInContainer

isInitialized	back to summary
protected static boolean isInitialized

usesAgent	back to summary
protected static boolean usesAgent

JavaSECMPInitializer	back to summary
protected JavaSECMPInitializer() User should not instantiate JavaSECMPInitializer.

JavaSECMPInitializer	back to summary
protected JavaSECMPInitializer(ClassLoader loader)

Method Detail

checkWeaving	back to summary
public void checkWeaving(Map<K, V> properties) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.checkWeaving. Check whether weaving is possible and update the properties and variable as appropriate Parameters properties:Map<K, V> The list of properties to check for weaving and update if weaving is not needed Annotations @Override

checkWeaving

back to summary

public void checkWeaving(Map<K, V> properties)

Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.checkWeaving.

Check whether weaving is possible and update the properties and variable as appropriate

Parameters

properties:Map<K, V>: The list of properties to check for weaving and update if weaving is not needed

Annotations

@Override

createTempLoader	back to summary
protected ClassLoader createTempLoader(Collection<E> col) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader. Create a temporary class loader that can be used to inspect classes and then thrown away. This allows classes to be introspected prior to loading them with application's main class loader enabling weaving. Annotations @Override

createTempLoader

back to summary

protected ClassLoader createTempLoader(Collection<E> col)

Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader.

Create a temporary class loader that can be used to inspect classes and then thrown away. This allows classes to be introspected prior to loading them with application's main class loader enabling weaving.

Annotations

@Override

createTempLoader	back to summary
protected ClassLoader createTempLoader(Collection<E> col, boolean shouldOverrideLoadClassForCollectionMembers) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader. Annotations @Override

createTempLoader

back to summary

protected ClassLoader createTempLoader(Collection<E> col, boolean shouldOverrideLoadClassForCollectionMembers)

Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.createTempLoader.

Annotations

@Override

getJavaSECMPInitializer	back to summary
public static JavaSECMPInitializer getJavaSECMPInitializer() Get the singleton entityContainer.

getJavaSECMPInitializer	back to summary
public static JavaSECMPInitializer getJavaSECMPInitializer(ClassLoader classLoader)

getJavaSECMPInitializer	back to summary
public static JavaSECMPInitializer getJavaSECMPInitializer(ClassLoader classLoader, Map<K, V> m, boolean fromAgent)

getJavaSECMPInitializerFromAgent	back to summary
public static JavaSECMPInitializer getJavaSECMPInitializerFromAgent()

getJavaSECMPInitializerFromMain	back to summary
public static JavaSECMPInitializer getJavaSECMPInitializerFromMain(Map<K, V> m)

initializeFromAgent	back to summary
protected static void initializeFromAgent(Instrumentation instrumentation) throws Exception INTERNAL: Should be called only by the agent. (when weaving classes) If succeeded return true, false otherwise.

initializeFromMain	back to summary
public static void initializeFromMain(Map<K, V> m) Usually JavaSECMPInitializer is initialized from agent during premain to ensure that the classes to be weaved haven't been loaded before initialization. However, in this case initialization can't be debugged. In order to be able to debug initialization specify in java options -javaagent with parameter "main": (note: a separate eclipselink-agent.jar is no longer required) -javaagent:c:\trunk\eclipselink.jar=main that causes instrumentation to be cached during premain and postpones initialization until main. With initialization done in main (during the first createEntityManagerFactory call) there's a danger of the classes to be weaved being already loaded. In that situation initializeFromMain should be called before any classes are loaded. The sure-to-work method would be to create a new runnable class with a main method consisting of just two lines: calling initializeFromMain followed by reflective call to the main method of the original runnable class. The same could be achieved by calling PersistenceProvider.createEntityManagerFactory method instead of JavaSECMPInitializer.initializeFromMain method, however initializeFromMain might be more convenient because it doesn't require a persistence unit name. The method doesn't do anything if JavaSECMPInitializer has been already initialized. Parameters m:Map<K, V> - a map containing the set of properties to instantiate with.

initializeFromMain

back to summary

public static void initializeFromMain(Map<K, V> m)

Usually JavaSECMPInitializer is initialized from agent during premain to ensure that the classes to be weaved haven't been loaded before initialization. However, in this case initialization can't be debugged. In order to be able to debug initialization specify in java options -javaagent with parameter "main": (note: a separate eclipselink-agent.jar is no longer required) -javaagent:c:\trunk\eclipselink.jar=main that causes instrumentation to be cached during premain and postpones initialization until main. With initialization done in main (during the first createEntityManagerFactory call) there's a danger of the classes to be weaved being already loaded. In that situation initializeFromMain should be called before any classes are loaded. The sure-to-work method would be to create a new runnable class with a main method consisting of just two lines: calling initializeFromMain followed by reflective call to the main method of the original runnable class. The same could be achieved by calling PersistenceProvider.createEntityManagerFactory method instead of JavaSECMPInitializer.initializeFromMain method, however initializeFromMain might be more convenient because it doesn't require a persistence unit name. The method doesn't do anything if JavaSECMPInitializer has been already initialized.

Parameters

m:Map<K, V>: - a map containing the set of properties to instantiate with.

initializeFromMain	back to summary
public static void initializeFromMain() The version of initializeFromMain that passes an empty map.

isInContainer	back to summary
public static boolean isInContainer()

isInitialized	back to summary
public static boolean isInitialized() Indicates whether initialization has already occurred.

isPersistenceUnitUniquelyDefinedByName	back to summary
public boolean isPersistenceUnitUniquelyDefinedByName() Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.isPersistenceUnitUniquelyDefinedByName. Indicates whether puName uniquely defines the persistence unit. usesAgent means that it is a stand alone SE case. Otherwise it could be an application server case where different persistence units may have the same name: that could happen if they are loaded by different classloaders; the common case is the same persistence unit jar deployed in several applications. Annotations @Override

isPersistenceUnitUniquelyDefinedByName

back to summary

public boolean isPersistenceUnitUniquelyDefinedByName()

Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.isPersistenceUnitUniquelyDefinedByName.

Indicates whether puName uniquely defines the persistence unit. usesAgent means that it is a stand alone SE case. Otherwise it could be an application server case where different persistence units may have the same name: that could happen if they are loaded by different classloaders; the common case is the same persistence unit jar deployed in several applications.

Annotations

@Override

keepAllPredeployedPersistenceUnits	back to summary
protected boolean keepAllPredeployedPersistenceUnits() Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.keepAllPredeployedPersistenceUnits. Indicates whether initialPuInfos and initialEmSetupImpls are used. Annotations @Override

keepAllPredeployedPersistenceUnits

back to summary

protected boolean keepAllPredeployedPersistenceUnits()

Overrides org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.keepAllPredeployedPersistenceUnits.

Indicates whether initialPuInfos and initialEmSetupImpls are used.

Annotations

@Override

registerTransformer	back to summary
public void registerTransformer(final ClassTransformer transformer, PersistenceUnitInfo persistenceUnitInfo, Map<K, V> properties) Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.registerTransformer. Register a transformer. In this case, we use the instrumentation to add a transformer for the JavaSE environment Annotations @Override

registerTransformer

back to summary

public void registerTransformer(final ClassTransformer transformer, PersistenceUnitInfo persistenceUnitInfo, Map<K, V> properties)

Implements abstract org.eclipse.persistence.internal.jpa.deployment.JPAInitializer.registerTransformer.

Annotations

@Override

setIsInContainer	back to summary
public static void setIsInContainer(boolean isInContainer)

usesAgent	back to summary
public static boolean usesAgent() Indicates whether Java agent and globalInstrumentation was used.

org.eclipse.persistence.internal.jpa.deployment back to summary

public Class JavaSECMPInitializer.TempEntityLoader

Class Inheritance

extends URLClassLoader

java.lang.Object
java.lang.ClassLoader
java.security.SecureClassLoader
java.net.URLClassLoader
org.eclipse.persistence.internal.jpa.deployment.JavaSECMPInitializer.TempEntityLoader

This class loader is provided at initialization time to allow us to temporarily load domain classes so we can examine them for annotations. After they are loaded we will throw this class loader away. Transformers can then be registered on the real class loader to allow weaving to occur. It selectively loads classes based on the list of classnames it is instantiated with. Classes not on that list are allowed to be loaded by the parent.

Field Summary

Modifier and Type	Field and Description
pack-priv Collection<E>	classNames
pack-priv boolean	shouldOverrideLoadClassForCollectionMembers

Constructor Summary

Access	Constructor and Description
public	TempEntityLoader(URL[] urls, ClassLoader parent, Collection<E> classNames, boolean shouldOverrideLoadClassForCollectionMembers)
public	TempEntityLoader(URL[] urls, ClassLoader parent, Collection<E> classNames)

Method Summary

Modifier and Type	Method and Description
public Enumeration<URL>	getResources(String The resource name name) Overrides java.lang.ClassLoader.getResources. Finds all the resources with the given name.
protected synchronized Class<?>	loadClass(String The binary name of the class name, boolean If `true` then resolve the class resolve) Overrides java.lang.ClassLoader.loadClass. Loads the class with the specified binary name.
protected boolean	shouldOverrideLoadClass(String name)

Inherited from java.net.URLClassLoader:: addURL close definePackage findClass findResource findResources getPermissions getResourceAsStream getURLs newInstance newInstance

Field Detail

classNames	back to summary
pack-priv Collection<E> classNames

shouldOverrideLoadClassForCollectionMembers	back to summary
pack-priv boolean shouldOverrideLoadClassForCollectionMembers

Constructor Detail

TempEntityLoader	back to summary
public TempEntityLoader(URL[] urls, ClassLoader parent, Collection<E> classNames, boolean shouldOverrideLoadClassForCollectionMembers)

TempEntityLoader	back to summary
public TempEntityLoader(URL[] urls, ClassLoader parent, Collection<E> classNames)

Method Detail

getResources back to summary

getResources	back to summary
public Enumeration<URL> getResources(String name) throws IOException Overrides java.lang.ClassLoader.getResources. Doc from java.lang.ClassLoader.getResources. Finds all the resources with the given name. A resource is some data (images, audio, text, etc) that can be accessed by class code in a way that is independent of the location of the code. The name of a resource is a `/`-separated path name that identifies the resource. Resources in named modules are subject to the encapsulation rules specified by `Module.getResourceAsStream`. Additionally, and except for the special case where the resource has a name ending with "`.class`", this method will only find resources in packages of named modules when the package is `opened` unconditionally (even if the caller of this method is in the same module as the resource). Parameters name:String The resource name Returns:Enumeration<URL> An enumeration of `URL` objects for the resource. If no resources could be found, the enumeration will be empty. Resources for which a `URL` cannot be constructed, are in a package that is not opened unconditionally, or access to the resource is denied by the security manager, are not returned in the enumeration. Annotations @Override Exceptions IOException: If I/O errors occur

public Enumeration<URL> getResources(String name) throws IOException

Overrides java.lang.ClassLoader.getResources.

Doc from java.lang.ClassLoader.getResources.

Finds all the resources with the given name. A resource is some data (images, audio, text, etc) that can be accessed by class code in a way that is independent of the location of the code.

The name of a resource is a /-separated path name that identifies the resource.

Resources in named modules are subject to the encapsulation rules specified by Module.getResourceAsStream. Additionally, and except for the special case where the resource has a name ending with ".class", this method will only find resources in packages of named modules when the package is opened unconditionally (even if the caller of this method is in the same module as the resource).

Parameters

name:String: The resource name

Returns:Enumeration<URL>

An enumeration of URL objects for the resource. If no resources could be found, the enumeration will be empty. Resources for which a URL cannot be constructed, are in a package that is not opened unconditionally, or access to the resource is denied by the security manager, are not returned in the enumeration.

Annotations

@Override

Exceptions

IOException:: If I/O errors occur

loadClass back to summary

loadClass	back to summary
protected synchronized Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException Overrides java.lang.ClassLoader.loadClass. Doc from java.lang.ClassLoader.loadClass. Loads the class with the specified binary name. The default implementation of this method searches for classes in the following order: Invoke `findLoadedClass(String)` to check if the class has already been loaded. Invoke the `loadClass` method on the parent class loader. If the parent is `null` the class loader built into the virtual machine is used, instead. Invoke the `findClass(String)` method to find the class. If the class was found using the above steps, and the `resolve` flag is true, this method will then invoke the `resolveClass(Class)` method on the resulting `Class` object. Subclasses of `ClassLoader` are encouraged to override `findClass(String)`, rather than this method. Unless overridden, this method synchronizes on the result of `getClassLoadingLock` method during the entire class loading process. Parameters name:String The binary name of the class resolve:boolean If `true` then resolve the class Returns:Class<?> The resulting `Class` object Annotations @Override Exceptions ClassNotFoundException: If the class could not be found

protected synchronized Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException

Overrides java.lang.ClassLoader.loadClass.

Doc from java.lang.ClassLoader.loadClass.

Loads the class with the specified binary name. The default implementation of this method searches for classes in the following order:

Invoke findLoadedClass(String) to check if the class has already been loaded.
Invoke the loadClass method on the parent class loader. If the parent is null the class loader built into the virtual machine is used, instead.
Invoke the findClass(String) method to find the class.

If the class was found using the above steps, and the resolve flag is true, this method will then invoke the resolveClass(Class) method on the resulting Class object.

Subclasses of ClassLoader are encouraged to override findClass(String), rather than this method.

Unless overridden, this method synchronizes on the result of getClassLoadingLock method during the entire class loading process.

Parameters

name:String: The binary name of the class
resolve:boolean: If true then resolve the class

Returns:Class<?>

The resulting Class object

Annotations

@Override

Exceptions

ClassNotFoundException:: If the class could not be found

shouldOverrideLoadClass	back to summary
protected boolean shouldOverrideLoadClass(String name)

public Class JavaSECMPInitializer

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class JavaSECMPInitializer.TempEntityLoader

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail