Class MappingUnmarshaller

java.lang.Object
org.castor.mapping.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 Details

    • MappingUnmarshaller

      public MappingUnmarshaller()
      Construct a new MappingUnmarshaller.
  • Method Details

    • 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.
    • getMappingLoader

      public MappingLoader getMappingLoader(Mapping mapping, BindingType bindingType) throws MappingException
      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) throws MappingException
      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.
    • loadMappingOnly

      public void loadMappingOnly(Mapping mapping) throws MappingException
      Throws:
      MappingException
    • loadMappingInternal

      protected void loadMappingInternal(Mapping mapping, DTDResolver resolver, String url) throws IOException, MappingException
      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.