CastorXMLStrategy (Castor JavaDoc)

java.lang.Object
- org.exolab.castor.xml.util.resolvers.CastorXMLStrategy

All Implemented Interfaces:

ResolverStrategy
```
public class CastorXMLStrategy
extends java.lang.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 Description

CastorXMLStrategy()
CastorXMLStrategy requires a configuration to be set.

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

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`ClassDescriptor`	`resolveClass(ResolverStrategy.ResolverResults resolverResults, java.lang.String className)`	Implementes a strategy how a class is resolved into a list of class descriptors.
`void`	`resolvePackage(ResolverStrategy.ResolverResults resolverResults, java.lang.String packageName)`	Implementes a strategy how a package is resolved into a list of class descriptors.
`void`	`setProperty(java.lang.String key, java.lang.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(java.lang.String key,
                        java.lang.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,
                                    java.lang.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,
                           java.lang.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

Class CastorXMLStrategy

Nested Class Summary

Nested classes/interfaces inherited from interface org.exolab.castor.xml.util.ResolverStrategy

Field Summary

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

CastorXMLStrategy

Method Detail

setProperty

resolveClass

resolvePackage