org.exolab.castor.xml.util.resolvers
Class ByDescriptorClass

java.lang.Object
  org.exolab.castor.xml.util.resolvers.AbstractResolverClassCommand
      org.exolab.castor.xml.util.resolvers.ByDescriptorClass

All Implemented Interfaces:

ResolverClassCommand

public class ByDescriptorClass

extends AbstractResolverClassCommand

Resolve a class by looking for a descriptor class 'nearby'. The descriptor class has to follow some specific naming conventions (and maybe be in a special package).

Since:

1.2

Version:

$Revision$ $Date$

Author:

Joachim Grueneis, Steven Dolg

Constructor Summary

ByDescriptorClass()
No specific stuff needed.

Method Summary

protected java.util.Map

internalResolve(java.lang.String className, java.lang.ClassLoader classLoader, java.util.Map properties) Tries to load an XMLClassDescriptor directly from an existing .class file.

Methods inherited from class org.exolab.castor.xml.util.resolvers.AbstractResolverClassCommand

resolve

Methods inherited from class java.lang.Object

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

Constructor Detail

ByDescriptorClass

public ByDescriptorClass()

No specific stuff needed.

Method Detail

internalResolve

protected java.util.Map internalResolve(java.lang.String className,
                                        java.lang.ClassLoader classLoader,
                                        java.util.Map properties)
                                 throws ResolverException

Tries to load an XMLClassDescriptor directly from an existing .class file.
The file that is searched for must be located in the classpath, have the name className + "Descriptor", and contain a valid XMLClassDescriptor.
If a descriptor is found it is added to the internal descriptor cache.
The required parameter checks are in the public method and here we expect that the resolve logic itself is implemented.

Specified by:

internalResolve in class AbstractResolverClassCommand

Parameters:

className - the name of the class to resolve

classLoader - the class loader to use

properties - the resolve properties to use

Returns:

a Map of className and XMLClassDescriptor

Throws:

ResolverException - if unrecoverable problems in resolve occured