org.exolab.castor.xml.util

Interface ResolverClassCommand

All Known Implementing Classes:

AbstractResolverClassCommand, ByDescriptorClass, ByIntrospection, ByMappingLoader

public interface ResolverClassCommand

A command used by a resolver strategy to get class descriptors. A command may return none, a single class descriptor or multiple class descriptors and even if class descriptors are returned, is not garanteed that the requested descriptor is within. No exceptions are thrown if the class could not be resolved - this is a possible result! Commands are planned to be something like a service which might get invoked multiple times in parallel. So no resolve specific states are allowed to be stored in the class state!

Since:

1.2

Version:

$Revision$ $Date$

Author:

Joachim Grueneis

Method Summary

Methods

Modifier and Type	Method and Description
Map	resolve(String className, Map p) The one and only purpose resolver commands are good for ;-) .

Method Detail

resolve

Map resolve(String className,
          Map p)
            throws ResolverException

The one and only purpose resolver commands are good for ;-) . It can be called with className and clazz set, so the command decides which suites it best or at least one of the two arguments set.

Parameters:

className - the name of the class to resolve

p - the Properties to be used at resolve

Returns:

a Map of className and XMLClassDescriptor

Throws:

IllegalArgumentException - if both parameters are null

ResolverException - in case that resolving fails fatally