org.castor.mapping

Class MappingUnmarshaller

public final class MappingUnmarshaller extends Object

Version: $Revision: 5951 $ $Date: 2006-04-25 16:09:10 -0600 (Tue, 25 Apr 2006) $

Author: Ralf Joachim

Constructor Summary
MappingUnmarshaller()
Construct a new MappingUnmarshaller.
Method Summary
MappingLoadergetMappingLoader(Mapping mapping, BindingType bindingType)
Returns a mapping resolver for the suitable engine.
MappingLoadergetMappingLoader(Mapping mapping, BindingType bindingType, Object param)
Returns a mapping resolver for the suitable engine.
protected voidloadMappingInternal(Mapping mapping, DTDResolver resolver, String url)
Internal recursive loading method.
voidsetAllowRedefinitions(boolean allow)
Enables or disables the ability to allow the redefinition of class mappings.

Constructor Detail

MappingUnmarshaller

public MappingUnmarshaller()
Construct a new MappingUnmarshaller.

Method Detail

getMappingLoader

public MappingLoader getMappingLoader(Mapping mapping, BindingType bindingType)
Returns a mapping resolver for the suitable engine. The engine's specific mapping loader is created and used to create engine specific descriptors, returning a suitable mapping resolver. The mapping resolver is cached in memory and returned in subsequent method calls.

Parameters: mapping The mapping to load and resolve. bindingType The binding type to read from mapping.

Returns: A mapping resolver.

Throws: MappingException A mapping error occured preventing descriptors from being generated from the loaded mapping.

getMappingLoader

public MappingLoader getMappingLoader(Mapping mapping, BindingType bindingType, Object param)
Returns a mapping resolver for the suitable engine. The engine's specific mapping loader is created and used to create engine specific descriptors, returning a suitable mapping resolver. The mapping resolver is cached in memory and returned in subsequent method calls.

Parameters: mapping The mapping to load and resolve. bindingType The binding type to read from mapping. param Arbitrary parameter that is to be passed to resolver.loadMapping().

Returns: A mapping resolver

Throws: MappingException A mapping error occured preventing descriptors from being generated from the loaded mapping.

loadMappingInternal

protected void loadMappingInternal(Mapping mapping, DTDResolver resolver, String url)
Internal recursive loading method. This method will load the mapping document into a mapping object and load all the included mapping along the way into a single collection.

Parameters: mapping The mapping instance. resolver The entity resolver to use. url The URL of the mapping file.

Throws: IOException An error occured when reading the mapping file. MappingException The mapping file is invalid.

setAllowRedefinitions

public void setAllowRedefinitions(boolean allow)
Enables or disables the ability to allow the redefinition of class mappings.

Parameters: allow a boolean that when true enables redefinitions.

Intalio Inc. (C) 1999-2006. All rights reserved http://www.intalio.com