org.apache.openjpa.enhance
Class PCEnhancer

java.lang.Object
  extended by org.apache.openjpa.enhance.PCEnhancer

public class PCEnhancer
extends Object

Bytecode enhancer used to enhance persistent classes from metadata. The enhancer must be invoked on all persistence-capable and persistence aware classes.

Author:
Abe White

Nested Class Summary
static interface PCEnhancer.AuxiliaryEnhancer
          Plugin interface for additional enhancement.
static class PCEnhancer.Flags
          Run flags.
 
Field Summary
static int ENHANCE_AWARE
           
static int ENHANCE_INTERFACE
           
static int ENHANCE_NONE
           
static int ENHANCE_OID
           
static int ENHANCE_PC
           
 
Constructor Summary
PCEnhancer(OpenJPAConfiguration conf, serp.bytecode.BCClass type, ClassMetaData meta)
          Constructor.
PCEnhancer(OpenJPAConfiguration conf, serp.bytecode.BCClass type, MetaDataRepository repos)
          Constructor.
PCEnhancer(OpenJPAConfiguration conf, Class type)
          Constructor.
PCEnhancer(OpenJPAConfiguration conf, ClassMetaData type)
          Constructor.
 
Method Summary
 boolean getAddDefaultConstructor()
          A boolean indicating whether the enhancer should add a no-args constructor if one is not already present in the class.
 PCEnhancer.AuxiliaryEnhancer[] getAuxiliaryEnhancers()
          Gets the auxiliary enhancers registered as services.
 serp.bytecode.BCClass getBytecode()
          Return the bytecode representation of the class being manipulated.
 BytecodeWriter getBytecodeWriter()
          Return the current BytecodeWriter to write to or null if none.
 File getDirectory()
          The base build directory to generate code to.
 boolean getEnforcePropertyRestrictions()
          Whether to fail if the persistent type uses property access and bytecode analysis shows that it may be violating OpenJPA's property access restrictions.
 ClassMetaData getMetaData()
          Return the metadata for the class being manipulated, or null if not a persistent type.
 Collection getObjectIdBytecode()
          Return the bytecode representations of any oid classes that must be manipulated.
 Class getType(ClassMetaData meta)
          Return the concrete type for the given class, i.e.
static void main(String[] args)
          Usage: java org.apache.openjpa.enhance.PCEnhancer [option]* <class name | .java file | .class file | .jdo file>+ Where the following options are recognized.
 void record()
          Write the generated bytecode.
 int run()
          Perform bytecode enhancements.
static boolean run(OpenJPAConfiguration conf, String[] args, Options opts)
          Run the tool.
static boolean run(OpenJPAConfiguration conf, String[] args, PCEnhancer.Flags flags, MetaDataRepository repos, BytecodeWriter writer, ClassLoader loader)
          Enhance the given classes.
 void setAddDefaultConstructor(boolean addDefaultConstructor)
          A boolean indicating whether the enhancer should add a no-args constructor if one is not already present in the class.
 void setBytecodeWriter(BytecodeWriter writer)
          Set the BytecodeWriter to write the bytecode to or null if none.
 void setDirectory(File dir)
          The base build directory to generate code to.
 void setEnforcePropertyRestrictions(boolean fail)
          Whether to fail if the persistent type uses property access and bytecode analysis shows that it may be violating OpenJPA's property access restrictions.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ENHANCE_NONE

public static final int ENHANCE_NONE
See Also:
Constant Field Values

ENHANCE_AWARE

public static final int ENHANCE_AWARE
See Also:
Constant Field Values

ENHANCE_INTERFACE

public static final int ENHANCE_INTERFACE
See Also:
Constant Field Values

ENHANCE_PC

public static final int ENHANCE_PC
See Also:
Constant Field Values

ENHANCE_OID

public static final int ENHANCE_OID
See Also:
Constant Field Values
Constructor Detail

PCEnhancer

public PCEnhancer(OpenJPAConfiguration conf,
                  Class type)
Constructor. Supply configuration and type to enhance.


PCEnhancer

public PCEnhancer(OpenJPAConfiguration conf,
                  ClassMetaData type)
Constructor. Supply configuration and type to enhance.


PCEnhancer

public PCEnhancer(OpenJPAConfiguration conf,
                  serp.bytecode.BCClass type,
                  MetaDataRepository repos)
Constructor. Supply configuration.

Parameters:
type - the bytecode representation fo the type to enhance; this can be created from any stream or file
repos - a metadata repository to use for metadata access, or null to create a new reporitory; the repository from the given configuration isn't used by default because the configuration might be an implementation-specific subclass whose metadata required more than just base metadata files

PCEnhancer

public PCEnhancer(OpenJPAConfiguration conf,
                  serp.bytecode.BCClass type,
                  ClassMetaData meta)
Constructor. Supply configuration, type, and metadata.

Method Detail

getBytecode

public serp.bytecode.BCClass getBytecode()
Return the bytecode representation of the class being manipulated.


getObjectIdBytecode

public Collection getObjectIdBytecode()
Return the bytecode representations of any oid classes that must be manipulated.


getMetaData

public ClassMetaData getMetaData()
Return the metadata for the class being manipulated, or null if not a persistent type.


getAddDefaultConstructor

public boolean getAddDefaultConstructor()
A boolean indicating whether the enhancer should add a no-args constructor if one is not already present in the class. OpenJPA requires that a no-arg constructor (whether created by the compiler or by the user) be present in a PC.


setAddDefaultConstructor

public void setAddDefaultConstructor(boolean addDefaultConstructor)
A boolean indicating whether the enhancer should add a no-args constructor if one is not already present in the class. OpenJPA requires that a no-arg constructor (whether created by the compiler or by the user) be present in a PC.


getEnforcePropertyRestrictions

public boolean getEnforcePropertyRestrictions()
Whether to fail if the persistent type uses property access and bytecode analysis shows that it may be violating OpenJPA's property access restrictions.


setEnforcePropertyRestrictions

public void setEnforcePropertyRestrictions(boolean fail)
Whether to fail if the persistent type uses property access and bytecode analysis shows that it may be violating OpenJPA's property access restrictions.


getDirectory

public File getDirectory()
The base build directory to generate code to. The proper package structure will be created beneath this directory. Defaults to overwriting the existing class file if null.


setDirectory

public void setDirectory(File dir)
The base build directory to generate code to. The proper package structure will be creaed beneath this directory. Defaults to overwriting the existing class file if null.


getBytecodeWriter

public BytecodeWriter getBytecodeWriter()
Return the current BytecodeWriter to write to or null if none.


setBytecodeWriter

public void setBytecodeWriter(BytecodeWriter writer)
Set the BytecodeWriter to write the bytecode to or null if none.


run

public int run()
Perform bytecode enhancements.

Returns:
ENHANCE_* constant

record

public void record()
            throws IOException
Write the generated bytecode.

Throws:
IOException

getAuxiliaryEnhancers

public PCEnhancer.AuxiliaryEnhancer[] getAuxiliaryEnhancers()
Gets the auxiliary enhancers registered as services.


getType

public Class getType(ClassMetaData meta)
Return the concrete type for the given class, i.e. impl for managed interfaces


main

public static void main(String[] args)
                 throws IOException
Usage: java org.apache.openjpa.enhance.PCEnhancer [option]* <class name | .java file | .class file | .jdo file>+ Where the following options are recognized. Each additional argument can be either the full class name of the type to enhance, the path to the .java file for the type, the path to the .class file for the type, or the path to a .jdo file listing one or more types to enhance. If the type being enhanced has metadata, it will be enhanced as a persistence capable class. If not, it will be considered a persistence aware class, and all access to fields of persistence capable classes will be replaced by the appropriate get/set method. If the type explicitly declares the persistence-capable interface, it will not be enhanced. Thus, it is safe to invoke the enhancer on classes that are already enhanced.

Throws:
IOException

run

public static boolean run(OpenJPAConfiguration conf,
                          String[] args,
                          Options opts)
                   throws IOException
Run the tool. Returns false if invalid options given.

Throws:
IOException

run

public static boolean run(OpenJPAConfiguration conf,
                          String[] args,
                          PCEnhancer.Flags flags,
                          MetaDataRepository repos,
                          BytecodeWriter writer,
                          ClassLoader loader)
                   throws IOException
Enhance the given classes.

Throws:
IOException


Copyright © 2006 Apache Software Foundation. All Rights Reserved.