Package org.objectweb.jac.core

Provides JAC system core classes.

See:
Description

Interface Summary

BaseProgramListener	This interface specify the prototypes of the methods that can be notified when an event occurs within the base program.
CollaborationParticipant	The classes that implement this interface are objects that can participate to a collaboration.
Display	This interface is an abstract description of how a display is defined in org.objectweb.jac.
InputStreamParser	Configuration file parser interface
Parser	Configuration file parser interface
Wrappee	This interface is seamlessly implemented by all the wrappable objects loaded by org.objectweb.jac.
WrappeeTranslator	WrappeeTranslator translates a regular java class into a wrappable one.

Class Summary

ACConfiguration	This class defines aspect component configurations so that the programmer or the system administrator will be able to configure the available aspects for a given application.
ACManager	This class manages all the aspect components that are present in the JAC system.
Application	This class represents the JAC applications.
ApplicationRepository	This class is a repository for all the applications defined in the JAC system.
AspectComponent	This class is the root class for the aspect components defined by a Jac application programmers.
Collaboration	This class represents a set of contextual informations for a given thread of a running JAC system.
CompositeAspectComponent	This class is the root class for the composite aspect components defined by JAC aspect programmers.
CompositionAspect	This special aspect component is used by the system to solve inter-aspect composition issues.
ConfigMethod	This class represents configuration methods for aspect components.
Imports
ImportStatement	This class represents configuration methods for aspect components.
Interaction
Jac	This is the main class of org.objectweb.jac.
JacLoader	The JAC specific class loader for JAC objects.
JacObjectInputStream	JacObjectInputStream is used to read JAC objects from an input stream during a deserialization process.
JacObjectOutputStream	JacObjectOutputStream is used to write JAC objects into an output stream during a serialization process.
JacPropLoader	This class is used to load all the properties necessary to the execution of JAC.
JacPropTools	This class provides useful primitives to parse Java property files.
MethodPointcut	This class can be used by JAC aspect components to easily define a set of method points on the base program that the aspects will use to modify its behavior.
NameRepository	Provides a naming repository within a running JAC system.
Naming	This class implements useful static methods to manipulate JAC objects and names.
ObjectRepository	This class allows the JAC applications to access objects that are managed within the current VM or that can be defined outside of it by the currently woven aspects.
ParserImpl	This is the default implementation for the aspect-configuration files.
Pointcut	This abstract class is the definition of a pointcut in org.objectweb.jac.
SerializedJacObject	This class defines all the needed information when (de)serializing a JAC object.
Utils
Wrapper	This class is the root class for all the wrappers.
Wrapping	This class provides a set of useful static methods that allow the wrapping of wrappable objects (wrappee) by some wrapper objects.
WrappingChain

Package org.objectweb.jac.core Description

Provides JAC system core classes.

The JAC generic framework can be summarized as following:

• Wrappable JAC objects (wrappees) automatically implement the Wrappee interface during the class loading (transformation are implemented with BCEL).
• Classes can be excluded from translation (see the $JAC_ROOT/org.objectweb.jac.prop file).
• The wrapper classes must extend Wrapper and can provide 3 kinds of methods:
  • wrapping methods that extends existing wrappees methods by executing some code before and after
  • role methods that add methods to the wrappees
  • exception handlers that handle exceptions thrown by the program
• At runtime, any wrappee can be wrapped and unwrapped by any wrapper
• Wrapping a set of wrappee with a set of wrappers must be defined in well-located components: Aspect Components
• An aspect component (instance of AspectComponent) defines pointcuts so that it can wrap the JAC object when needed. It implements a program extension called an Aspect, e.g. authentication, persistence, distribution.
• The aspect components set registered in the system is managed in the ACManager class.

Related Documentation

For overviews, sources, tutorials, examples, guides, and tool documentation, please see:

• A JAC technical overview (PDF)
• The JAC programmer's guide
• HTML sources
• HTML overview