org.exolab.castor.xml.util.resolvers

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 org.exolab.castor.xml.util.ResolverStrategy

ResolverStrategy.ResolverResults

Field Summary

Fields inherited from interface org.exolab.castor.xml.util.ResolverStrategy

PROPERTY_CLASS_LOADER, PROPERTY_INTROSPECTOR, PROPERTY_LOAD_PACKAGE_MAPPINGS, PROPERTY_MAPPING_LOADER, PROPERTY_USE_INTROSPECTION

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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 java.lang.Object

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

Constructor Detail

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 Detail

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