Class CastorXMLStrategy

java.lang.Object

org.exolab.castor.xml.util.resolvers.CastorXMLStrategy

All Implemented Interfaces:

ResolverStrategy

public class CastorXMLStrategy
extends Object
implements ResolverStrategy

The Castor XML resolver strategy implements the resolving behaviour as it had been implmented before this refactoring step. Meaning that:
It uses multiple steps to find a class descriptor for a class.
It uses a cache of class descriptors
A class that couldn't be resolved once is marked as unresolvable and will not be resolved again - even on a second call.

Since:

1.2

Version:

$Revision$ $Date$

Author:

Joachim Grueneis, Steven Dolg

Nested Class Summary

Nested classes/interfaces inherited from interface ResolverStrategy

ResolverStrategy.ResolverResults

Modifier and Type	Interface	Description
static interface	ResolverStrategy.ResolverResults	As a strategy generate one or more class descriptors it needs a place to put the results to.

Field Summary

Fields inherited from interface ResolverStrategy

PROPERTY_CLASS_LOADER, PROPERTY_INTROSPECTOR, PROPERTY_LOAD_PACKAGE_MAPPINGS, PROPERTY_MAPPING_LOADER, PROPERTY_USE_INTROSPECTION

Modifier and Type	Field	Description
static final String	PROPERTY_CLASS_LOADER	To set the class loader property for resolving.
static final String	PROPERTY_INTROSPECTOR	To set the introspector property for resolving.
static final String	PROPERTY_LOAD_PACKAGE_MAPPINGS	To set the LoadPackageMappings property for resolving.
static final String	PROPERTY_MAPPING_LOADER	To set the mapping loader property for resolving.
static final String	PROPERTY_USE_INTROSPECTION	To set the use introspection property for resolving.

Constructor Summary

Constructors

Constructor	Description
CastorXMLStrategy()	CastorXMLStrategy requires a configuration to be set.

Method Summary

Modifier and Type	Method	Description
ClassDescriptor	resolveClass(ResolverStrategy.ResolverResults resolverResults, String className)	Implementes a strategy how a class is resolved into a list of class descriptors.
void	resolvePackage(ResolverStrategy.ResolverResults resolverResults, String packageName)	Implementes a strategy how a package is resolved into a list of class descriptors.
void	setProperty(String key, Object value)	To set properties for strategy and/or commands.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CastorXMLStrategy

public CastorXMLStrategy()

CastorXMLStrategy requires a configuration to be set. Within the constructor the commands building the strategy are instantiated, a command configuration is created and the descriptor cache.

Method Details

setProperty

public void setProperty(String key,
 Object value)

To set properties for strategy and/or commands.

Specified by:

setProperty in interface ResolverStrategy

Parameters:

key - name of the property

value - value the property is set to

resolveClass

public ClassDescriptor resolveClass(ResolverStrategy.ResolverResults resolverResults,
 String className)
                             throws ResolverException

Implementes a strategy how a class is resolved into a list of class descriptors.

Specified by:

resolveClass in interface ResolverStrategy

Parameters:

resolverResults - to put the resolver reszlts into

className - the class to resolve

Returns:

the ClassDescriptor for the class or null if the class couldn't be resolved

Throws:

ResolverException - in case that resolving fails fatally

resolvePackage

public void resolvePackage(ResolverStrategy.ResolverResults resolverResults,
 String packageName)
                    throws ResolverException

Implementes a strategy how a package is resolved into a list of class descriptors.

Specified by:

resolvePackage in interface ResolverStrategy

Parameters:

resolverResults - to put the resolver reszlts into

packageName - the package to resolve

Throws:

ResolverException - in case that resolving fails fatally