//
// This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, vhudson-jaxb-ri-2.1-2 
// See <a href="http://java.sun.com/xml/jaxb">http://java.sun.com/xml/jaxb</a> 
// Any modifications to this file will be lost upon recompilation of the source schema. 
// Generated on: 2015.05.31 at 11:45:27 PM CEST 
//


package org.jomc.model;

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import javax.annotation.Generated;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlType;


/**
 * List of modules.
 * 
 * <p>Java class for Modules complex type.
 * 
 * <p>The following schema fragment specifies the expected content contained within this class.
 * 
 * <pre>
 * &lt;complexType name="Modules">
 *   &lt;complexContent>
 *     &lt;extension base="{http://jomc.org/model}ModelObject">
 *       &lt;sequence>
 *         &lt;element ref="{http://jomc.org/model}module" maxOccurs="unbounded" minOccurs="0"/>
 *       &lt;/sequence>
 *     &lt;/extension>
 *   &lt;/complexContent>
 * &lt;/complexType>
 * </pre>
 * 
 * 
 */
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "Modules", namespace = "http://jomc.org/model", propOrder = {
    "module"
})
@Generated(value = "com.sun.tools.xjc.Driver", date = "2015-05-31T11:45:26+02:00", comments = "JAXB RI vhudson-jaxb-ri-2.1-2")
public class Modules
    extends ModelObject
    implements Cloneable
{

    @XmlElement(namespace = "http://jomc.org/model")
    @Generated(value = "com.sun.tools.xjc.Driver", date = "2015-05-31T11:45:26+02:00", comments = "JAXB RI vhudson-jaxb-ri-2.1-2")
    protected List<Module> module;

    /**
     * Creates a new {@code Modules} instance.
     * 
     */
    public Modules() {
        // CC-XJC Version 2.0.1 Build 2012-03-02T12:09:12+0000
        super();
    }

    /**
     * Creates a new {@code Modules} instance by deeply copying a given {@code Modules} instance.
     * 
     * 
     * @param o
     *     The instance to copy.
     * @throws NullPointerException
     *     if {@code o} is {@code null}.
     */
    public Modules(final Modules o) {
        // CC-XJC Version 2.0.1 Build 2012-03-02T12:09:12+0000
        super(o);
        if (o == null) {
            throw new NullPointerException("Cannot create a copy of 'Modules' from 'null'.");
        }
        // 'Module' collection.
        if (o.module!= null) {
            copyModule(o.getModule(), this.getModule());
        }
    }

    /**
     * Gets the value of the module property.
     * 
     * <p>
     * This accessor method returns a reference to the live list,
     * not a snapshot. Therefore any modification you make to the
     * returned list will be present inside the JAXB object.
     * This is why there is not a <CODE>set</CODE> method for the module property.
     * 
     * <p>
     * For example, to add a new item, do as follows:
     * <pre>
     *    getModule().add(newItem);
     * </pre>
     * 
     * 
     * <p>
     * Objects of the following type(s) are allowed in the list
     * {@link Module }
     * 
     * 
     */
    @Generated(value = "com.sun.tools.xjc.Driver", date = "2015-05-31T11:45:26+02:00", comments = "JAXB RI vhudson-jaxb-ri-2.1-2")
    public List<Module> getModule() {
        if (module == null) {
            module = new ArrayList<Module>();
        }
        return this.module;
    }

    /**
     * Copies all values of property {@code Module} deeply.
     * 
     * @param source
     *     The source to copy from.
     * @param target
     *     The target to copy {@code source} to.
     * @throws NullPointerException
     *     if {@code target} is {@code null}.
     */
    @SuppressWarnings("unchecked")
    @Generated(value = "com.sun.tools.xjc.Driver", date = "2015-05-31T11:45:26+02:00", comments = "JAXB RI vhudson-jaxb-ri-2.1-2")
    private static void copyModule(final List<Module> source, final List<Module> target) {
        // CC-XJC Version 2.0.1 Build 2012-03-02T12:09:12+0000
        if ((source!= null)&&(!source.isEmpty())) {
            for (final Iterator<?> it = source.iterator(); it.hasNext(); ) {
                final Object next = it.next();
                if (next instanceof Module) {
                    // CClassInfo: org.jomc.model.Module
                    target.add(((Module) next).clone());
                    continue;
                }
                // Please report this at https://apps.sourceforge.net/mantisbt/ccxjc/
                throw new AssertionError((("Unexpected instance '"+ next)+"' for property 'Module' of class 'org.jomc.model.Modules'."));
            }
        }
    }

    /**
     * Creates and returns a deep copy of this object.
     * 
     * 
     * @return
     *     A deep copy of this object.
     */
    @Override
    @Generated(value = "com.sun.tools.xjc.Driver", date = "2015-05-31T11:45:26+02:00", comments = "JAXB RI vhudson-jaxb-ri-2.1-2")
    public Modules clone() {
        {
            // CC-XJC Version 2.0.1 Build 2012-03-02T12:09:12+0000
            final Modules clone = ((Modules) super.clone());
            // 'Module' collection.
            if (this.module!= null) {
                clone.module = null;
                copyModule(this.getModule(), clone.getModule());
            }
            return clone;
        }
    }
    
    /**
     * Constant for the default name of the classpath module.
     * @see #getDefaultClasspathModuleName()
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final String DEFAULT_CLASSPATH_MODULE_NAME = "Java Classpath";

    /** Default classpath module name. */
    @javax.xml.bind.annotation.XmlTransient
    private static volatile String defaultClasspathModuleName;

    /** Empty {@code Class} array. */
    @javax.xml.bind.annotation.XmlTransient
    private static final Class<?>[] NO_CLASSES =
    {
    };

    /**
     * Comparator comparing dependency names lexicographically.
     * @since 1.2
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<Dependency> DEPENDENCY_NAME_COMPARATOR =
        new java.util.Comparator<Dependency>()
    {

        public int compare( final Dependency o1, final Dependency o2 )
        {
            return o1.getName().compareTo( o2.getName() );
        }

    };

    /**
     * Comparator comparing message names lexicographically.
     * @since 1.2
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<Message> MESSAGE_NAME_COMPARATOR =
        new java.util.Comparator<Message>()
    {

        public int compare( final Message o1, final Message o2 )
        {
            return o1.getName().compareTo( o2.getName() );
        }

    };

    /**
     * Comparator comparing property names lexicographically.
     * @since 1.2
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<Property> PROPERTY_NAME_COMPARATOR =
        new java.util.Comparator<Property>()
    {

        public int compare( final Property o1, final Property o2 )
        {
            return o1.getName().compareTo( o2.getName() );
        }

    };

    /**
     * Comparator comparing specification identifiers lexicographically.
     * @since 1.2
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<Specification> SPECIFICATION_IDENTIFIER_COMPARATOR =
        new java.util.Comparator<Specification>()
    {

        public int compare( final Specification o1, final Specification o2 )
        {
            return o1.getIdentifier().compareTo( o2.getIdentifier() );
        }

    };

    /**
     * Comparator comparing specification reference identifiers lexicographically.
     * @since 1.2
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<SpecificationReference> SPECIFICATION_REFERENCE_IDENTIFIER_COMPARATOR =
        new java.util.Comparator<SpecificationReference>()
    {

        public int compare( final SpecificationReference o1, final SpecificationReference o2 )
        {
            return o1.getIdentifier().compareTo( o2.getIdentifier() );
        }

    };

    /**
     * Comparator comparing {@code JavaTypeName} names lexicographically.
     * @since 1.4
     */
    @javax.xml.bind.annotation.XmlTransient
    private static final java.util.Comparator<JavaTypeName> JAVA_TYPE_NAME_COMPARATOR =
        new java.util.Comparator<JavaTypeName>()
    {

        public int compare( final JavaTypeName o1, final JavaTypeName o2 )
        {
            return o1.getName( true ).compareTo( o2.getName( true ) );
        }

    };

    /** Maps objects to {@code Instance}s. */
    @javax.xml.bind.annotation.XmlTransient private java.util.Map<Object, Instance> objects =
        new org.jomc.util.WeakIdentityHashMap<Object, Instance>();

    /**
     * Creates a new {@code Modules} instance taking a map backing the instance.
     *
     * @param objects The map backing the instance.
     */
    public Modules( final java.util.Map<Object, Instance> objects )
    {
        super();

        if ( objects == null )
        {
            throw new NullPointerException( "objects" );
        }

        this.objects = objects;
    }

    /**
     * Creates a new {@code Modules} instance by deeply copying a given {@code Modules} instance taking a map backing
     * the instance.
     *
     * @param o The instance to copy.
     * @param objects The map backing the instance.
     *
     * @throws NullPointerException if {@code o} or {@code objects} is {@code null}.
     */
    public Modules( final Modules o, final java.util.Map<Object, Instance> objects )
    {
        super( o );
        if ( o == null )
        {
            throw new NullPointerException( "Cannot create a copy of 'Modules' from 'null'." );
        }
        if ( objects == null )
        {
            throw new NullPointerException( "objects" );
        }

        copyModule( o.getModule(), getModule() );
        this.objects = objects;
    }

    /**
     * Gets the default classpath module name.
     * <p>The default classpath module name is controlled by system property
     * {@code org.jomc.model.Modules.defaultClasspathModuleName} holding the default classpath module name. If that
     * property is not set, the {@code Java Classpath} default is returned.</p>
     *
     * @return The default classpath module name.
     *
     * @see #getClasspathModule(java.lang.String, java.lang.ClassLoader)
     */
    public static String getDefaultClasspathModuleName()
    {
        if ( defaultClasspathModuleName == null )
        {
            defaultClasspathModuleName = System.getProperty( "org.jomc.model.Modules.defaultClasspathModuleName",
                                                             DEFAULT_CLASSPATH_MODULE_NAME );

        }

        return defaultClasspathModuleName;
    }

    /**
     * Sets the default classpath module name.
     *
     * @param value The new default classpath module name or {@code null},
     */
    public static void setDefaultClasspathModuleName( final String value )
    {
        defaultClasspathModuleName = value;
    }

    /**
     * Gets a module holding model objects resolved by inspecting a given class loader.
     * <p>This method searches this list of modules for unresolved references and tries to resolve each unresolved
     * reference by inspecting the given class loader.</p>
     *
     * @param moduleName The name of the module to return.
     * @param classLoader The class loader to use for resolving entities or {@code null}, to resolve entities using the
     * bootstrap class loader.
     *
     * @return A module holding model objects resolved by inspecting the given class loader or {@code null}, if nothing
     * is resolved.
     *
     * @throws NullPointerException if {@code moduleName} is {@code null}.
     *
     * @see #getDefaultClasspathModuleName()
     * @see #getModule()
     */
    public Module getClasspathModule( final String moduleName, final ClassLoader classLoader )
    {
        if ( moduleName == null )
        {
            throw new NullPointerException( "moduleName" );
        }

        final Module classpathModule = new Module();
        classpathModule.setVersion( System.getProperty( "java.specification.version" ) );
        classpathModule.setName( moduleName );

        this.resolveClasspath( classpathModule, classLoader );

        final boolean resolved = ( classpathModule.getSpecifications() != null
                                   && !classpathModule.getSpecifications().getSpecification().isEmpty() )
                                 || ( classpathModule.getImplementations() != null
                                      && !classpathModule.getImplementations().getImplementation().isEmpty() );

        return resolved ? classpathModule : null;
    }

    /**
     * Gets a module for a given name from the list of modules.
     *
     * @param name The name of the module to return.
     *
     * @return The first matching module or {@code null}, if no such module is found.
     *
     * @throws NullPointerException if {@code name} is {@code null}.
     *
     * @see #getModule()
     * @see Module#getName()
     */
    public Module getModule( final String name )
    {
        if ( name == null )
        {
            throw new NullPointerException( "name" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getName().equals( name ) )
            {
                return m;
            }
        }

        return null;
    }

    /**
     * Gets all specifications of the list of modules.
     *
     * @return All specifications or {@code null}, if no specifications are found.
     *
     * @see #getModule()
     */
    public Specifications getSpecifications()
    {
        final Specifications specifications = new Specifications();

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getSpecifications() != null )
            {
                specifications.getSpecification().addAll( m.getSpecifications().getSpecification() );
            }
        }

        return specifications.getSpecification().isEmpty() ? null : specifications;
    }

    /**
     * Gets all implementations of the list of modules.
     *
     * @return All implementations or {@code null}, if no implementations are found.
     *
     * @see #getModule()
     */
    public Implementations getImplementations()
    {
        final Implementations implementations = new Implementations();

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getImplementations() != null )
            {
                implementations.getImplementation().addAll( m.getImplementations().getImplementation() );
            }
        }

        return implementations.getImplementation().isEmpty() ? null : implementations;
    }

    /**
     * Gets the module declaring a given specification from the list of modules.
     *
     * @param specification The identifier of the specification whose declaring module to return.
     *
     * @return The first matching module or {@code null}, if no such module is found.
     *
     * @throws NullPointerException if {@code specification} is {@code null}.
     *
     * @see #getModule()
     * @see Module#getSpecifications()
     * @see Specifications#getSpecification( java.lang.String )
     */
    public Module getModuleOfSpecification( final String specification )
    {
        if ( specification == null )
        {
            throw new NullPointerException( "specification" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getSpecifications() != null && m.getSpecifications().getSpecification( specification ) != null )
            {
                return m;
            }
        }

        return null;
    }

    /**
     * Gets the module declaring a given implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation whose declaring module to return.
     *
     * @return The first matching module or {@code null}, if no such module is found.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see Module#getImplementations()
     * @see Implementations#getImplementation( java.lang.String )
     */
    public Module getModuleOfImplementation( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getImplementations() != null && m.getImplementations().getImplementation( implementation ) != null )
            {
                return m;
            }
        }

        return null;
    }

    /**
     * Gets a specification for a given identifier from the list of modules.
     *
     * @param specification The identifier of the specification to return.
     *
     * @return The first matching specification or {@code null}, if no such specification is found.
     *
     * @throws NullPointerException if {@code specification} is {@code null}.
     *
     * @see #getModule()
     * @see Module#getSpecifications()
     * @see Specifications#getSpecification( java.lang.String )
     */
    public Specification getSpecification( final String specification )
    {
        if ( specification == null )
        {
            throw new NullPointerException( "specification" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getSpecifications() != null )
            {
                final Specification s = m.getSpecifications().getSpecification( specification );

                if ( s != null )
                {
                    return s;
                }
            }
        }

        return null;
    }

    /**
     * Gets a specification declaring a given class from the list of modules.
     *
     * @param specification The class of the specification to return.
     *
     * @return The first matching specification declaring the given class or {@code null}, if no such specification is
     * found.
     *
     * @throws NullPointerException if {@code specification} is {@code null}.
     * @throws ModelObjectException if compiling a name of a referenced type to a {@code JavaTypeName} fails.
     *
     * @see #getModule()
     * @see Module#getSpecifications()
     * @see Specifications#getSpecification( java.lang.Class )
     */
    public Specification getSpecification( final Class<?> specification ) throws ModelObjectException
    {
        if ( specification == null )
        {
            throw new NullPointerException( "specification" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getSpecifications() != null )
            {
                final Specification s = m.getSpecifications().getSpecification( specification );

                if ( s != null )
                {
                    return s;
                }
            }
        }

        return null;
    }

    /**
     * Gets all specifications an implementation implements from the list of modules.
     *
     * @param implementation The identifier of the implementation to get all implemented specifications of.
     *
     * @return All specifications implemented by the first matching implementation or {@code null}, if no such
     * implementation is found or if the first matching implementation does not implement any specification.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see Implementation#getImplementations()
     * @see Implementations#getReference()
     * @see Implementation#getSpecifications()
     */
    public Specifications getSpecifications( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Specifications specs = new Specifications();
        final Implementation impl = this.getImplementation( implementation );
        this.collectModelObjects( impl, null, null, null, specs, null, new java.util.HashSet<String>(), true );
        this.collectClassDeclarationModelObjects( impl, null, null, null, specs, null );
        java.util.Collections.sort( specs.getSpecification(), SPECIFICATION_IDENTIFIER_COMPARATOR );
        java.util.Collections.sort( specs.getReference(), SPECIFICATION_REFERENCE_IDENTIFIER_COMPARATOR );
        return specs.getSpecification().isEmpty() && specs.getReference().isEmpty() ? null : specs;
    }

    /**
     * Gets a list holding all {@code JavaTypeName}s an implementation implements from the list of modules.
     *
     * @param implementation The identifier of the implementation to get all implemented specifications of.
     *
     * @return An unmodifiable list holding all {@code JavaTypeName}s implemented by the first matching implementation
     * or {@code null}, if no such implementation is found or if that implementation does not implement any
     * {@code JavaTypeName}.
     *
     * @throws ModelObjectException if compiling the name of a referenced type to a {@code JavaTypeName} fails.
     *
     * @see #getSpecifications(java.lang.String)
     * @see Specification#getJavaTypeName()
     *
     * @since 1.4
     */
    public List<JavaTypeName> getImplementedJavaTypeNames( final String implementation ) throws ModelObjectException
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Specifications implemented = this.getSpecifications( implementation );
        java.util.List<JavaTypeName> javaTypeNames = null;

        if ( implemented != null )
        {
            javaTypeNames = new java.util.ArrayList<JavaTypeName>( implemented.getSpecification().size() );

            for ( int i = 0, s0 = implemented.getSpecification().size(); i < s0; i++ )
            {
                final Specification s = implemented.getSpecification().get( i );
                final JavaTypeName javaTypeName = s.getJavaTypeName();

                if ( javaTypeName != null && !javaTypeNames.contains( javaTypeName ) )
                {
                    javaTypeNames.add( javaTypeName );
                }
            }

            java.util.Collections.sort( javaTypeNames, JAVA_TYPE_NAME_COMPARATOR );
            javaTypeNames = java.util.Collections.unmodifiableList( javaTypeNames );
        }

        return javaTypeNames;
    }

    /**
     * Gets an implementation for a given identifier from the list of modules.
     *
     * @param implementation The identifier of the implementation to return.
     *
     * @return The first matching implementation or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see Module#getImplementations()
     * @see Implementations#getImplementation( java.lang.String )
     */
    public Implementation getImplementation( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getImplementations() != null )
            {
                final Implementation current = m.getImplementations().getImplementation( implementation );

                if ( current != null )
                {
                    return current;
                }
            }
        }

        return null;
    }

    /**
     * Gets an implementation declaring a given class from the list of modules.
     *
     * @param implementation The class of the implementation to return.
     *
     * @return The first matching implementation declaring the given class or {@code null}, if no such implementation is
     * found.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     * @throws ModelObjectException if compiling a name of a referenced type to a {@code JavaTypeName} fails.
     *
     * @see #getModule()
     * @see Module#getImplementations()
     * @see Implementations#getImplementation( java.lang.Class )
     */
    public Implementation getImplementation( final Class<?> implementation ) throws ModelObjectException
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getImplementations() != null )
            {
                final Implementation current = m.getImplementations().getImplementation( implementation );

                if ( current != null )
                {
                    return current;
                }
            }
        }

        return null;
    }

    /**
     * Gets an implementation for a given object from the list of modules.
     *
     * @param object The object of the implementation to return.
     *
     * @return The first matching implementation or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code object} is {@code null}.
     * @throws ModelObjectException if compiling a name of a referenced type to a {@code JavaTypeName} fails.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.Class )
     */
    public Implementation getImplementation( final Object object ) throws ModelObjectException
    {
        return this.collectImplementation( object.getClass() );
    }

    /**
     * Gets an implementation for a given name implementing a given specification from the list of modules.
     *
     * @param specification The identifier of the specification to return an implementation of.
     * @param name The name of the implementation to return.
     *
     * @return The first matching implementation or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code specification} or {@code name} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementations( java.lang.String )
     * @see Implementations#getImplementationByName( java.lang.String )
     */
    public Implementation getImplementation( final String specification, final String name )
    {
        if ( specification == null )
        {
            throw new NullPointerException( "specification" );
        }
        if ( name == null )
        {
            throw new NullPointerException( "name" );
        }

        final Implementations implementations = this.getImplementations( specification );
        if ( implementations != null )
        {
            return implementations.getImplementationByName( name );
        }

        return null;
    }

    /**
     * Gets all dependencies of an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to get all dependencies of.
     *
     * @return All dependencies of the first matching implementation or {@code null}, if no such implementation is
     * found or if the first matching implementation does not have any dependencies.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see Implementation#getImplementations()
     * @see Implementations#getReference()
     * @see Implementation#getDependencies()
     */
    public Dependencies getDependencies( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Dependencies dependencies = new Dependencies();
        final Implementation impl = this.getImplementation( implementation );
        this.collectModelObjects( impl, dependencies, null, null, null, null, new java.util.HashSet<String>(), true );
        this.collectClassDeclarationModelObjects( impl, dependencies, null, null, null, null );
        java.util.Collections.sort( dependencies.getDependency(), DEPENDENCY_NAME_COMPARATOR );
        return dependencies.getDependency().isEmpty() ? null : dependencies;
    }

    /**
     * Gets the Java type name of a dependency.
     *
     * @param implementation The identifier of the implementation of the dependency.
     * @param dependency The name of the dependency to get the Java type name of.
     *
     * @return The Java type name of the dependency named {@code dependency } of the first matching implementation
     * identified by {@code implementation} or {@code null}, if the implementation, the dependency or the referenced
     * specification is not found or does not reference a Java type.
     *
     * @throws NullPointerException if {@code implementation} or {@code dependency} is {@code null}.
     * @throws ModelObjectException if compiling the name of the referenced type to a {@code JavaTypeName} fails.
     *
     * @since 1.4
     *
     * @see #getDependencies(java.lang.String)
     * @see Dependencies#getDependency(java.lang.String)
     * @see #getSpecification(java.lang.String)
     * @see Specification#getJavaTypeName()
     */
    public JavaTypeName getDependencyJavaTypeName( final String implementation, final String dependency )
        throws ModelObjectException
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }
        if ( dependency == null )
        {
            throw new NullPointerException( "dependency" );
        }

        String typeName = null;

        try
        {
            JavaTypeName javaTypeName = null;
            final Dependencies dependencies = this.getDependencies( implementation );

            if ( dependencies != null )
            {
                final Dependency d = dependencies.getDependency( dependency );

                if ( d != null )
                {
                    final Specification specification = this.getSpecification( d.getIdentifier() );

                    if ( specification != null && specification.getClazz() != null )
                    {
                        typeName = specification.getClazz();

                        if ( specification.getMultiplicity() == Multiplicity.MANY
                             && d.getImplementationName() == null )
                        {
                            typeName += "[]";
                        }

                        javaTypeName = JavaTypeName.parse( typeName );
                    }
                }
            }

            return javaTypeName;
        }
        catch ( final java.text.ParseException e )
        {
            throw new ModelObjectException( getMessage( "dependencyJavaTypeNameParseException", typeName,
                                                        getMessage( e ) ), e );

        }
    }

    /**
     * Gets the Java modifier name of a dependency.
     *
     * @param implementation The identifier of the implementation of the dependency.
     * @param dependency The name of the dependency to get the Java modifier name of.
     *
     * @return The Java modifier name of the dependency named {@code dependency} of the first matching implementation
     * identified by {@code implementation} or {@code null}, if the implementation or the dependency is not found.
     *
     * @throws NullPointerException if {@code implementation} or {@code dependency} is {@code null}.
     *
     * @since 1.4
     *
     * @see #getDependencies(java.lang.String)
     * @see Dependencies#getDependency(java.lang.String)
     */
    public String getDependencyJavaModifierName( final String implementation, final String dependency )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }
        if ( dependency == null )
        {
            throw new NullPointerException( "dependency" );
        }

        final Dependencies dependencies = this.getDependencies( implementation );

        if ( dependencies != null )
        {
            final Dependency d = dependencies.getDependency( dependency );

            if ( d != null )
            {
                return "private";
            }
        }

        return null;
    }

    /**
     * Gets all properties of an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to get all properties of.
     *
     * @return All properties of the first matching implementation or {@code null}, if no such implementation is found
     * or if the first matching implementation does not have any properties.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see Implementation#getImplementations()
     * @see Implementations#getReference()
     * @see Implementation#getProperties()
     */
    public Properties getProperties( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Properties properties = new Properties();
        final Specifications specifications = new Specifications();
        final Implementation impl = this.getImplementation( implementation );
        this.collectModelObjects(
            impl, null, null, properties, specifications, null, new java.util.HashSet<String>(), true );

        this.collectClassDeclarationModelObjects( impl, null, null, properties, specifications, null );
        this.collectSpecifiedModelObjects( specifications, properties );
        java.util.Collections.sort( properties.getProperty(), PROPERTY_NAME_COMPARATOR );
        return properties.getProperty().isEmpty() ? null : properties;
    }

    /**
     * Gets all properties specified for an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to return specified properties of.
     *
     * @return All properties specified for the first matching implementation or {@code null}, if no such implementation
     * is found or if the first matching implementation does not have any specified properties.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getSpecifications( java.lang.String )
     * @see Specification#getProperties()
     */
    public Properties getSpecifiedProperties( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Properties properties = new Properties();
        final Specifications specs = this.getSpecifications( implementation );

        if ( specs != null )
        {
            for ( int i = 0, s0 = specs.getSpecification().size(); i < s0; i++ )
            {
                final Specification s = specs.getSpecification().get( i );

                if ( s.getProperties() != null )
                {
                    properties.getProperty().addAll( s.getProperties().getProperty() );
                }
            }
        }

        java.util.Collections.sort( properties.getProperty(), PROPERTY_NAME_COMPARATOR );
        return properties.getProperty().isEmpty() ? null : properties;
    }

    /**
     * Gets the Java modifier name of a property.
     *
     * @param implementation The identifier of the implementation of the property.
     * @param property The name of the property to get the Java modifier name of.
     *
     * @return The Java modifier name of the property named {@code property} of the first matching implementation
     * identified by {@code implementation} or {@code null}, if the implementation or the property is not found.
     *
     * @throws NullPointerException if {@code implementation} or {@code dependency} is {@code null}.
     *
     * @since 1.4
     *
     * @see #getProperties(java.lang.String)
     * @see Properties#getProperty(java.lang.String)
     */
    public String getPropertyJavaModifierName( final String implementation, final String property )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }
        if ( property == null )
        {
            throw new NullPointerException( "property" );
        }

        final Properties properties = this.getProperties( implementation );

        if ( properties != null )
        {
            final Property p = properties.getProperty( property );

            if ( p != null )
            {
                final Properties specified = this.getSpecifiedProperties( implementation );

                return specified != null && specified.getProperty( property ) != null ? "public" : "private";
            }
        }

        return null;
    }

    /**
     * Gets all messages of an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to get all messages of.
     *
     * @return All messages of the first matching implementation or {@code null}, if no such implementation is found
     * or if the first matching implementation does not have any messages.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see Implementation#getImplementations()
     * @see Implementations#getReference()
     * @see Implementation#getMessages()
     */
    public Messages getMessages( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Messages msgs = new Messages();
        final Implementation impl = this.getImplementation( implementation );
        this.collectModelObjects( impl, null, msgs, null, null, null, new java.util.HashSet<String>(), true );
        this.collectClassDeclarationModelObjects( impl, null, msgs, null, null, null );
        java.util.Collections.sort( msgs.getMessage(), MESSAGE_NAME_COMPARATOR );
        return msgs.getMessage().isEmpty() ? null : msgs;
    }

    /**
     * Gets the Java modifier name of a message.
     *
     * @param implementation The identifier of the implementation of the message.
     * @param message The name of the message to get the Java modifier name of.
     *
     * @return The Java modifier name of the message named {@code message} of the first matching implementation
     * identified by {@code implementation} or {@code null}, if the implementation or the message is not found.
     *
     * @throws NullPointerException if {@code implementation} or {@code message} is {@code null}.
     *
     * @since 1.4
     *
     * @see #getMessages(java.lang.String)
     * @see Messages#getMessage(java.lang.String)
     */
    public String getMessageJavaModifierName( final String implementation, final String message )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }
        if ( message == null )
        {
            throw new NullPointerException( "message" );
        }

        final Messages messages = this.getMessages( implementation );

        if ( messages != null )
        {
            final Message m = messages.getMessage( message );

            if ( m != null )
            {
                return "private";
            }
        }

        return null;
    }

    /**
     * Gets any objects of an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to get any objects of.
     *
     * @return Any objects of the first matching implementation or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see Implementation#getImplementations()
     * @see Implementations#getReference()
     * @see Implementation#getAny()
     *
     * @since 1.2
     */
    public List<Object> getAnyObjects( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Implementation impl = this.getImplementation( implementation );
        final java.util.List<Object> any = new java.util.LinkedList<Object>();
        this.collectModelObjects( impl, null, null, null, null, any, new java.util.HashSet<String>(), true );
        this.collectClassDeclarationModelObjects( impl, null, null, null, null, any );
        return any;
    }

    /**
     * Gets all implementations implementing a given specification from the list of modules.
     *
     * @param specification The identifier of the specification to return all implementations of.
     *
     * @return All implementations implementing the first matching specification or {@code null}, if no such
     * specification is found or if the first matching specification does not have any implementations.
     *
     * @throws NullPointerException if {@code specification} is {@code null}.
     *
     * @see #getModule()
     * @see #getSpecifications( java.lang.String )
     */
    public Implementations getImplementations( final String specification )
    {
        if ( specification == null )
        {
            throw new NullPointerException( "specification" );
        }

        final Implementations implementations = new Implementations();

        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getImplementations() != null )
            {
                for ( int j = 0, s1 = m.getImplementations().getImplementation().size(); j < s1; j++ )
                {
                    final Implementation impl = m.getImplementations().getImplementation().get( j );
                    final Specifications specs = this.getSpecifications( impl.getIdentifier() );

                    if ( specs != null && specs.getSpecification( specification ) != null )
                    {
                        implementations.getImplementation().add( impl );
                    }
                }
            }
        }

        return implementations.getImplementation().size() > 0 ? implementations : null;
    }

    /**
     * Merges this list of modules to a single module.
     *
     * @param name The name of the module to return.
     *
     * @return A module holding all model objects from the list.
     *
     * @throws NullPointerException if {@code name} is {@code null}.
     */
    public Module getMergedModule( final String name )
    {
        if ( name == null )
        {
            throw new NullPointerException( "name" );
        }

        final Modules copy = this.clone();
        final Module mergedModule = new Module();
        mergedModule.setName( name );

        for ( int i = 0, s0 = copy.getModule().size(); i < s0; i++ )
        {
            final Module m = copy.getModule().get( i );
            final java.util.Set<String> referencedMessages = new java.util.HashSet<String>();
            final java.util.Set<String> referencedProperties = new java.util.HashSet<String>();

            if ( m.getImplementations() != null )
            {
                for ( int j = 0, s1 = m.getImplementations().getImplementation().size(); j < s1; j++ )
                {
                    final Implementation impl = m.getImplementations().getImplementation().get( j );
                    if ( mergedModule.getImplementations() == null )
                    {
                        mergedModule.setImplementations( new Implementations() );
                    }

                    if ( impl.getMessages() != null && !impl.getMessages().getReference().isEmpty() )
                    {
                        for ( java.util.Iterator<MessageReference> it = impl.getMessages().getReference().iterator();
                              it.hasNext(); )
                        {
                            final String messageName = it.next().getName();
                            impl.getMessages().getMessage().add( m.getMessages().getMessage( messageName ) );
                            referencedMessages.add( messageName );
                            it.remove();
                        }
                    }

                    if ( impl.getProperties() != null && !impl.getProperties().getReference().isEmpty() )
                    {
                        for ( java.util.Iterator<PropertyReference> it = impl.getProperties().getReference().iterator();
                              it.hasNext(); )
                        {
                            final String propertyName = it.next().getName();
                            impl.getProperties().getProperty().add( m.getProperties().getProperty( propertyName ) );
                            referencedProperties.add( propertyName );
                            it.remove();
                        }
                    }

                    mergedModule.getImplementations().getImplementation().add( impl );
                }
            }

            if ( m.getSpecifications() != null )
            {
                if ( mergedModule.getSpecifications() == null )
                {
                    mergedModule.setSpecifications( new Specifications() );
                }

                for ( int j = 0, s1 = m.getSpecifications().getSpecification().size(); j < s1; j++ )
                {
                    final Specification s = m.getSpecifications().getSpecification().get( j );

                    if ( s.getProperties() != null && !s.getProperties().getReference().isEmpty() )
                    {
                        for ( java.util.Iterator<PropertyReference> it = s.getProperties().getReference().iterator();
                              it.hasNext(); )
                        {
                            final String propertyName = it.next().getName();
                            s.getProperties().getProperty().add( m.getProperties().getProperty( propertyName ) );
                            referencedProperties.add( propertyName );
                            it.remove();
                        }
                    }

                    mergedModule.getSpecifications().getSpecification().add( s );
                }
            }

            for ( String messageName : referencedMessages )
            {
                for ( java.util.Iterator<Message> it = m.getMessages().getMessage().iterator(); it.hasNext(); )
                {
                    if ( messageName.equals( it.next().getName() ) )
                    {
                        it.remove();
                        break;
                    }
                }
            }

            for ( String propertyName : referencedProperties )
            {
                for ( java.util.Iterator<Property> it = m.getProperties().getProperty().iterator(); it.hasNext(); )
                {
                    if ( propertyName.equals( it.next().getName() ) )
                    {
                        it.remove();
                        break;
                    }
                }
            }

            if ( m.getProperties() != null && !m.getProperties().getProperty().isEmpty() )
            {
                if ( mergedModule.getProperties() == null )
                {
                    mergedModule.setProperties( new Properties() );
                }

                mergedModule.getProperties().getProperty().addAll( m.getProperties().getProperty() );
            }

            if ( m.getMessages() != null && !m.getMessages().getMessage().isEmpty() )
            {
                if ( mergedModule.getMessages() == null )
                {
                    mergedModule.setMessages( new Messages() );
                }

                mergedModule.getMessages().getMessage().addAll( m.getMessages().getMessage() );
            }
        }

        return mergedModule;
    }

    /**
     * Gets the instance of an object from the list of modules.
     *
     * @param object The object to get the instance of.
     *
     * @return The instance of {@code object} or {@code null}, if no such instance is found.
     *
     * @throws NullPointerException if {@code object} is {@code null}.
     * @throws ModelObjectException if compiling a name of a referenced type to a {@code JavaTypeName} fails.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.Object )
     * @see #getInstance( java.lang.String )
     * @see #createObject(org.jomc.model.Instance instance, java.lang.ClassLoader classLoader)
     */
    public Instance getInstance( final Object object ) throws ModelObjectException
    {
        if ( object == null )
        {
            throw new NullPointerException( "object" );
        }

        synchronized ( this.objects )
        {
            Instance instance = this.objects.get( object );

            if ( instance == null )
            {
                final Implementation i = this.getImplementation( object );

                if ( i != null )
                {
                    instance = this.getInstance( i.getIdentifier() );
                    if ( instance != null )
                    {
                        this.objects.put( object, instance );
                    }
                }
            }

            return instance;
        }
    }

    /**
     * Gets an instance for an implementation from the list of modules.
     *
     * @param implementation The identifier of the implementation to get an instance for.
     *
     * @return A new instance for the first matching implementation or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code implementation} is {@code null}.
     *
     * @see #getModule()
     * @see #getImplementation( java.lang.String )
     * @see #getDependencies(java.lang.String)
     * @see #getProperties(java.lang.String)
     * @see #getMessages(java.lang.String)
     * @see #getSpecifications(java.lang.String)
     * @see #getAnyObjects(java.lang.String)
     */
    public Instance getInstance( final String implementation )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }

        final Implementation i = this.getImplementation( implementation );

        if ( i != null && i.getClazz() != null )
        {
            final Instance instance = new Instance();
            instance.setIdentifier( i.getIdentifier() );
            instance.setName( i.getName() );
            instance.setClazz( i.getClazz() );
            instance.setStateless( i.isStateless() );
            instance.setDependencies( this.getDependencies( implementation ) );
            instance.setProperties( this.getProperties( implementation ) );
            instance.setMessages( this.getMessages( implementation ) );
            instance.setSpecifications( this.getSpecifications( implementation ) );
            instance.getAny().addAll( this.getAnyObjects( implementation ) );
            return instance;
        }

        return null;
    }

    /**
     * Gets an instance for an implementation from the list of modules overridden with a given dependency.
     *
     * @param implementation The identifier of the implementation to get an instance for.
     * @param dependency The dependency to use for overriding model objects of the instance.
     *
     * @return An instance for the first matching implementation with any model objects overridden using
     * {@code dependency} or {@code null}, if no such implementation is found.
     *
     * @throws NullPointerException if {@code implementation} or {@code dependency} is {@code null}.
     *
     * @see #getModule()
     * @see #getInstance( java.lang.String )
     */
    public Instance getInstance( final String implementation, final Dependency dependency )
    {
        if ( implementation == null )
        {
            throw new NullPointerException( "implementation" );
        }
        if ( dependency == null )
        {
            throw new NullPointerException( "dependency" );
        }

        Instance instance = this.getInstance( implementation );

        if ( instance != null )
        {
            final Specification dependencySpecification = this.getSpecification( dependency.getIdentifier() );

            if ( dependencySpecification != null && dependencySpecification.getScope() == null )
            {
                if ( dependency.getDependencies() != null && !dependency.getDependencies().getDependency().isEmpty() )
                {
                    final Dependencies dependencies = new Dependencies();
                    dependencies.getDependency().addAll( dependency.getDependencies().getDependency() );

                    if ( instance.getDependencies() != null )
                    {
                        for ( int i = 0, s0 = instance.getDependencies().getDependency().size(); i < s0; i++ )
                        {
                            final Dependency d = instance.getDependencies().getDependency().get( i );
                            final Dependency td = dependencies.getDependency( d.getName() );

                            if ( td == null )
                            {
                                dependencies.getDependency().add( d );
                            }
                            else
                            {
                                this.collectDependencies( d, td );
                            }
                        }
                    }

                    instance.setDependencies( dependencies );
                }

                if ( dependency.getMessages() != null && !dependency.getMessages().getMessage().isEmpty() )
                {
                    final Messages messages = new Messages();
                    messages.getMessage().addAll( dependency.getMessages().getMessage() );

                    if ( instance.getMessages() != null )
                    {
                        for ( int i = 0, s0 = instance.getMessages().getMessage().size(); i < s0; i++ )
                        {
                            final Message m = instance.getMessages().getMessage().get( i );

                            if ( messages.getMessage( m.getName() ) == null )
                            {
                                messages.getMessage().add( m );
                            }
                        }
                    }

                    instance.setMessages( messages );
                }

                if ( dependency.getProperties() != null && !dependency.getProperties().getProperty().isEmpty() )
                {
                    final Properties properties = new Properties();
                    properties.getProperty().addAll( dependency.getProperties().getProperty() );

                    if ( instance.getProperties() != null )
                    {
                        for ( int i = 0, s0 = instance.getProperties().getProperty().size(); i < s0; i++ )
                        {
                            final Property p = instance.getProperties().getProperty().get( i );

                            if ( properties.getProperty( p.getName() ) == null )
                            {
                                properties.getProperty().add( p );
                            }
                        }
                    }

                    instance.setProperties( properties );
                }
            }
        }

        return instance;
    }

    /**
     * Creates an object of a given instance from the list of modules.
     *
     * @param instance The instance to create an object of.
     * @param classLoader The class loader to use for creating the object or {@code null}, to use the bootstrap class
     * loader.
     *
     * @return A new object of {@code instance}.
     *
     * @throws NullPointerException if {@code instance}  is {@code null}.
     * @throws ModelObjectException if compiling the name of a referenced type to a {@code JavaTypeName} fails.
     * @throws InstantiationException if creating an object fails.
     *
     * @see #getModule()
     * @see Instance#getJavaClass(java.lang.ClassLoader)
     * @see Instance#getJavaConstructor(java.lang.ClassLoader)
     * @see Instance#getJavaFactoryMethodName()
     * @see Instance#getJavaFactoryMethod(java.lang.ClassLoader)
     * @see Instance#isJavaClassAssignable(java.lang.ClassLoader)
     */
    public Object createObject( final Instance instance, final ClassLoader classLoader )
        throws ModelObjectException, InstantiationException
    {
        if ( instance == null )
        {
            throw new NullPointerException( "instance" );
        }

        Object object = null;

        try
        {
            final java.lang.reflect.Constructor<?> ctor = instance.getJavaConstructor( classLoader );

            if ( ctor != null && instance.isJavaClassAssignable( classLoader ) )
            {
                object = instance.getJavaTypeName().getClass( classLoader, true ).newInstance();

                synchronized ( this.objects )
                {
                    this.objects.put( object, instance );
                }
            }
            else
            {
                java.lang.reflect.Method factoryMethod = instance.getJavaFactoryMethod( classLoader );

                if ( factoryMethod != null )
                {
                    if ( java.lang.reflect.Modifier.isStatic( factoryMethod.getModifiers() ) )
                    {
                        object = factoryMethod.invoke( null, (Object[]) null );

                        if ( object != null )
                        {
                            synchronized ( this.objects )
                            {
                                this.objects.put( object, instance );
                            }
                        }
                    }
                    else if ( ctor != null )
                    {
                        final Object o = ctor.newInstance();

                        synchronized ( this.objects )
                        {
                            this.objects.put( o, instance );
                        }

                        try
                        {
                            object = factoryMethod.invoke( o, (Object[]) null );
                        }
                        finally
                        {
                            synchronized ( this.objects )
                            {
                                this.objects.remove( o );

                                if ( object != null )
                                {
                                    this.objects.put( object, instance );
                                }
                            }
                        }
                    }
                }
            }

            if ( object == null )
            {
                throw new InstantiationException( getMessage(
                    instance.getJavaFactoryMethodName() != null
                    ? "failedCreatingObjectWithMethod" : "failedCreatingObject",
                    instance.getIdentifier(), instance.getJavaTypeName(), instance.getJavaFactoryMethodName() ) );

            }

            return object;
        }
        catch ( final java.lang.reflect.InvocationTargetException e )
        {
            final Throwable target = e.getTargetException() != null ? e.getTargetException() : e;
            throw (InstantiationException) new InstantiationException(
                getMessage( "exceptionCreatingObject", instance.getIdentifier() ) ).initCause( target );

        }
        catch ( final IllegalAccessException e )
        {
            throw (InstantiationException) new InstantiationException(
                getMessage( "exceptionCreatingObject", instance.getIdentifier() ) ).initCause( e );

        }
        catch ( final ClassNotFoundException e )
        {
            throw (InstantiationException) new InstantiationException(
                getMessage( "exceptionCreatingObject", instance.getIdentifier() ) ).initCause( e );

        }
    }

    /** @since 1.2 */
    private void collectModelObjects( final Implementation implementation, final Dependencies dependencies,
                                      final Messages messages, final Properties properties,
                                      final Specifications specifications, final List<Object> any,
                                      final java.util.Set<String> seen, final boolean includeDeclared )
    {
        if ( implementation != null && !seen.contains( implementation.getIdentifier() ) )
        {
            seen.add( implementation.getIdentifier() );

            if ( includeDeclared )
            {
                if ( dependencies != null && implementation.getDependencies() != null )
                {
                    for ( int i = 0, s0 = implementation.getDependencies().getDependency().size(); i < s0; i++ )
                    {
                        final Dependency d = implementation.getDependencies().getDependency().get( i );
                        final Dependency dependency = dependencies.getDependency( d.getName() );

                        if ( dependency == null )
                        {
                            dependencies.getDependency().add( d );
                        }
                        else
                        {
                            this.collectDependencies( d, dependency );
                        }
                    }
                }

                if ( messages != null && implementation.getMessages() != null )
                {
                    for ( int i = 0, s0 = implementation.getMessages().getMessage().size(); i < s0; i++ )
                    {
                        final Message msg = implementation.getMessages().getMessage().get( i );

                        if ( messages.getMessage( msg.getName() ) == null )
                        {
                            messages.getMessage().add( msg );
                        }
                    }

                    if ( !implementation.getMessages().getReference().isEmpty() )
                    {
                        final Module m = this.getModuleOfImplementation( implementation.getIdentifier() );

                        if ( m != null )
                        {
                            for ( int i = 0, s0 = implementation.getMessages().getReference().size(); i < s0; i++ )
                            {
                                final MessageReference ref = implementation.getMessages().getReference().get( i );

                                if ( messages.getMessage( ref.getName() ) == null )
                                {
                                    Message referenced = m.getMessages().getMessage( ref.getName() );
                                    if ( referenced != null )
                                    {
                                        referenced = referenced.clone();
                                        referenced.setDeprecated( ref.isDeprecated() );
                                        referenced.setFinal( ref.isFinal() );
                                        referenced.setOverride( ref.isOverride() );
                                        messages.getMessage().add( referenced );
                                    }
                                }
                            }
                        }
                    }
                }

                if ( properties != null && implementation.getProperties() != null )
                {
                    for ( int i = 0, s0 = implementation.getProperties().getProperty().size(); i < s0; i++ )
                    {
                        final Property p = implementation.getProperties().getProperty().get( i );

                        if ( properties.getProperty( p.getName() ) == null )
                        {
                            properties.getProperty().add( p );
                        }
                    }

                    if ( !implementation.getProperties().getReference().isEmpty() )
                    {
                        final Module m = this.getModuleOfImplementation( implementation.getIdentifier() );

                        if ( m != null )
                        {
                            for ( int i = 0, s0 = implementation.getProperties().getReference().size(); i < s0; i++ )
                            {
                                final PropertyReference ref = implementation.getProperties().getReference().get( i );

                                if ( properties.getProperty( ref.getName() ) == null )
                                {
                                    Property referenced = m.getProperties().getProperty( ref.getName() );
                                    if ( referenced != null )
                                    {
                                        referenced = referenced.clone();
                                        referenced.setDeprecated( ref.isDeprecated() );
                                        referenced.setFinal( ref.isFinal() );
                                        referenced.setOverride( ref.isOverride() );
                                        properties.getProperty().add( referenced );
                                    }
                                }
                            }
                        }
                    }
                }

                if ( specifications != null && implementation.getSpecifications() != null )
                {
                    for ( int i = 0, s0 = implementation.getSpecifications().getReference().size(); i < s0; i++ )
                    {
                        final SpecificationReference r = implementation.getSpecifications().getReference().get( i );

                        if ( specifications.getReference( r.getIdentifier() ) == null )
                        {
                            specifications.getReference().add( r );

                            final Specification s = this.getSpecification( r.getIdentifier() );
                            if ( s != null && specifications.getSpecification( s.getIdentifier() ) == null )
                            {
                                specifications.getSpecification().add( s );
                            }
                        }
                    }
                }

                if ( any != null && !implementation.getAny().isEmpty() )
                {
                    for ( int i = 0, s0 = implementation.getAny().size(); i < s0; i++ )
                    {
                        final Object o = implementation.getAny().get( i );

                        if ( o instanceof org.w3c.dom.Element )
                        {
                            if ( this.getElement( any, (org.w3c.dom.Element) o ) == null )
                            {
                                any.add( o );
                            }

                            continue;
                        }

                        if ( o instanceof javax.xml.bind.JAXBElement<?> )
                        {
                            if ( this.getElement( any, (javax.xml.bind.JAXBElement<?>) o ) == null )
                            {
                                any.add( o );
                            }

                            continue;
                        }

                        any.add( o );
                    }
                }
            }

            if ( implementation.getImplementations() != null )
            {
                for ( int i = 0, s0 = implementation.getImplementations().getReference().size(); i < s0; i++ )
                {
                    final ImplementationReference r = implementation.getImplementations().getReference().get( i );
                    this.collectModelObjects( this.getImplementation( r.getIdentifier() ), dependencies, messages,
                                              properties, specifications, any, seen, true );

                }
            }
        }
    }

    /** @since 1.2 */
    private void collectClassDeclarationModelObjects( final Implementation implementation,
                                                      final Dependencies dependencies, final Messages messages,
                                                      final Properties properties, final Specifications specifications,
                                                      final List<Object> any )
    {
        Implementation declaration = null;

        if ( implementation != null && implementation.getClazz() != null && !implementation.isClassDeclaration() )
        {
            for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
            {
                final Module m = this.getModule().get( i );

                if ( m.getImplementations() != null )
                {
                    for ( int j = 0, s1 = m.getImplementations().getImplementation().size(); j < s1; j++ )
                    {
                        final Implementation current = m.getImplementations().getImplementation().get( j );

                        if ( current.getClazz() != null && current.getClazz().equals( implementation.getClazz() )
                             && current.isClassDeclaration() )
                        {
                            declaration = current;
                            break;
                        }
                    }
                }
            }
        }

        if ( declaration != null )
        {
            this.collectModelObjects( declaration, dependencies, messages, properties, specifications, any,
                                      new java.util.HashSet<String>(), true );

        }
    }

    /** @since 1.2 */
    private void collectSpecifiedModelObjects( final Specifications specifications, final Properties properties )
    {
        for ( int i = 0, s0 = specifications.getSpecification().size(); i < s0; i++ )
        {
            final Specification s = specifications.getSpecification().get( i );

            if ( s.getProperties() != null )
            {
                for ( int j = 0, s1 = s.getProperties().getProperty().size(); j < s1; j++ )
                {
                    final Property p = s.getProperties().getProperty().get( j );

                    if ( properties.getProperty( p.getName() ) == null )
                    {
                        properties.getProperty().add( p );
                    }
                }
            }
        }
    }

    private void collectDependencies( final Dependency source, final Dependency target )
    {
        if ( source.getMessages() != null )
        {
            if ( target.getMessages() == null )
            {
                target.setMessages( new Messages() );
            }

            for ( int i = 0, s0 = source.getMessages().getMessage().size(); i < s0; i++ )
            {
                final Message m = source.getMessages().getMessage().get( i );

                if ( target.getMessages().getMessage( m.getName() ) == null )
                {
                    target.getMessages().getMessage().add( m );
                }
            }
        }

        if ( source.getProperties() != null )
        {
            if ( target.getProperties() == null )
            {
                target.setProperties( new Properties() );
            }

            for ( int i = 0, s0 = source.getProperties().getProperty().size(); i < s0; i++ )
            {
                final Property p = source.getProperties().getProperty().get( i );

                if ( target.getProperties().getProperty( p.getName() ) == null )
                {
                    target.getProperties().getProperty().add( p );
                }
            }
        }

        if ( source.getDependencies() != null )
        {
            if ( target.getDependencies() == null )
            {
                target.setDependencies( new Dependencies() );
            }

            for ( int i = 0, s0 = source.getDependencies().getDependency().size(); i < s0; i++ )
            {
                final Dependency sd = source.getDependencies().getDependency().get( i );
                final Dependency td = target.getDependencies().getDependency( sd.getName() );

                if ( td == null )
                {
                    target.getDependencies().getDependency().add( sd );
                }
                else
                {
                    this.collectDependencies( sd, td );
                }
            }
        }
    }

    private Implementation collectImplementation( final Class<?> clazz ) throws ModelObjectException
    {
        Implementation i = this.getImplementation( clazz );

        if ( i == null && clazz.getSuperclass() != null )
        {
            i = this.collectImplementation( clazz.getSuperclass() );
        }

        return i;
    }

    private org.w3c.dom.Element getElement( final List<Object> list, final org.w3c.dom.Element e )
    {
        for ( int i = 0, s0 = list.size(); i < s0; i++ )
        {
            final Object o = list.get( i );

            if ( o instanceof org.w3c.dom.Element )
            {
                final org.w3c.dom.Element current = (org.w3c.dom.Element) o;
                if ( ( e.getNamespaceURI() == null
                       ? current.getNamespaceURI() == null
                       : e.getNamespaceURI().equals( current.getNamespaceURI() ) )
                     && ( e.getLocalName() == null
                          ? current.getLocalName() == null
                          : e.getLocalName().equals( current.getLocalName() ) ) )
                {
                    return current;
                }
            }
        }

        return null;
    }

    private javax.xml.bind.JAXBElement<?> getElement( final List<Object> list, final javax.xml.bind.JAXBElement<?> e )
    {
        for ( int i = 0, s0 = list.size(); i < s0; i++ )
        {
            final Object o = list.get( i );

            if ( o instanceof javax.xml.bind.JAXBElement<?> )
            {
                final javax.xml.bind.JAXBElement<?> current = (javax.xml.bind.JAXBElement<?>) o;
                if ( e.getName().equals( current.getName() ) )
                {
                    return current;
                }
            }
        }

        return null;
    }

    private void resolveClasspath( final Module cpModule, final ClassLoader classLoader )
    {
        for ( int i = 0, s0 = this.getModule().size(); i < s0; i++ )
        {
            final Module m = this.getModule().get( i );

            if ( m.getSpecifications() != null )
            {
                this.resolveClasspath( m.getSpecifications(), cpModule, classLoader );
            }

            if ( m.getImplementations() != null )
            {
                this.resolveClasspath( m.getImplementations(), cpModule, classLoader );
            }
        }
    }

    private void resolveClasspath( final SpecificationReference ref, final Module cpModule,
                                   final ClassLoader classLoader )
    {
        if ( this.getSpecification( ref.getIdentifier() ) == null )
        {
            this.resolveClasspath( ref.getIdentifier(), cpModule, classLoader );
        }
    }

    private void resolveClasspath( final Specifications specifications, final Module cpModule,
                                   final ClassLoader classLoader )
    {
        for ( int i = 0, s0 = specifications.getSpecification().size(); i < s0; i++ )
        {
            final Specification s = specifications.getSpecification().get( i );

            if ( s.getClazz() != null )
            {
                this.resolveClasspath( s, cpModule, classLoader );
            }
        }
        for ( int i = 0, s0 = specifications.getReference().size(); i < s0; i++ )
        {
            final SpecificationReference ref = specifications.getReference().get( i );
            this.resolveClasspath( ref, cpModule, classLoader );
        }
    }

    private void resolveClasspath( final Implementations implementations, final Module cpModule,
                                   final ClassLoader classLoader )
    {
        for ( int i = 0, s0 = implementations.getImplementation().size(); i < s0; i++ )
        {
            final Implementation implementation = implementations.getImplementation().get( i );

            if ( implementation.getSpecifications() != null )
            {
                this.resolveClasspath( implementation.getSpecifications(), cpModule, classLoader );
            }

            if ( implementation.getDependencies() != null )
            {
                this.resolveClasspath( implementation.getDependencies(), cpModule, classLoader );
            }
        }
    }

    private void resolveClasspath( final Dependencies dependencies, final Module cpModule,
                                   final ClassLoader classLoader )
    {
        for ( int i = 0, s0 = dependencies.getDependency().size(); i < s0; i++ )
        {
            final Dependency dependency = dependencies.getDependency().get( i );
            this.resolveClasspath( dependency, cpModule, classLoader );

            if ( dependency.getDependencies() != null )
            {
                this.resolveClasspath( dependency.getDependencies(), cpModule, classLoader );
            }
        }
    }

    private boolean resolveClasspath( final String identifier, final Module cpModule, final ClassLoader classLoader )
    {
        boolean classpathSpecification = false;
        Specification specification = cpModule.getSpecifications() == null
                                      ? null : cpModule.getSpecifications().getSpecification( identifier );

        if ( specification == null )
        {
            try
            {
                final JavaTypeName javaTypeName = JavaTypeName.parse( identifier );
                final Class<?> classpathSpec = javaTypeName.getClass( classLoader, false );

                if ( java.lang.reflect.Modifier.isPublic( classpathSpec.getModifiers() ) )
                {
                    classpathSpecification = true;
                    String vendor = null;
                    String version = null;

                    if ( classpathSpec.getPackage() != null )
                    {
                        vendor = classpathSpec.getPackage().getSpecificationVendor();
                        version = classpathSpec.getPackage().getSpecificationVersion();
                    }

                    specification = new Specification();
                    specification.setIdentifier( identifier );
                    specification.setClazz( javaTypeName.getName( true ) );
                    specification.setMultiplicity( Multiplicity.MANY );
                    specification.setVendor( vendor );
                    specification.setVersion( version );

                    if ( cpModule.getSpecifications() == null )
                    {
                        cpModule.setSpecifications( new Specifications() );
                    }

                    cpModule.getSpecifications().getSpecification().add( specification );

                    this.resolveClasspath( specification, cpModule, classLoader );
                }
            }
            catch ( final ClassNotFoundException e )
            {
                classpathSpecification = false;
            }
            catch ( final java.text.ParseException e )
            {
                classpathSpecification = false;
            }
        }

        return classpathSpecification;
    }

    private boolean resolveClasspath( final Specification specification, final Module cpModule,
                                      final ClassLoader classLoader )
    {
        boolean classpathImplementation = false;
        Implementation implementation =
            cpModule.getImplementations() == null ? null
            : cpModule.getImplementations().getImplementation( specification.getIdentifier() );

        if ( implementation == null )
        {
            implementation = this.getImplementation( specification.getIdentifier() );
        }

        if ( implementation == null )
        {
            String name = null;

            try
            {
                final JavaTypeName javaTypeName = JavaTypeName.parse( specification.getClazz() );
                final Class<?> classpathImpl = javaTypeName.getClass( classLoader, false );

                if ( java.lang.reflect.Modifier.isPublic( classpathImpl.getModifiers() ) )
                {
                    if ( !java.lang.reflect.Modifier.isAbstract( classpathImpl.getModifiers() ) )
                    {
                        try
                        {
                            classpathImpl.getConstructor( NO_CLASSES );
                            name = "init";
                            classpathImplementation = true;
                        }
                        catch ( final NoSuchMethodException e )
                        {
                            classpathImplementation = false;
                        }
                    }

                    if ( !classpathImplementation )
                    {
                        final char[] c = classpathImpl.getName().substring(
                            classpathImpl.getPackage().getName().length() + 1 ).toCharArray();

                        name = String.valueOf( c );
                        c[0] = Character.toUpperCase( c[0] );

                        if ( this.checkFactoryMethod( classpathImpl, classpathImpl, "getDefault" ) )
                        {
                            name = "default";
                            classpathImplementation = true;
                        }
                        else if ( this.checkFactoryMethod( classpathImpl, classpathImpl, "getInstance" ) )
                        {
                            name = "instance";
                            classpathImplementation = true;
                        }
                        else if ( this.checkFactoryMethod( classpathImpl, classpathImpl, "get" + String.valueOf( c ) ) )
                        {
                            classpathImplementation = true;
                        }

                    }

                    if ( classpathImplementation
                         && this.getImplementation( specification.getIdentifier(), name ) == null )
                    {
                        String vendor = null;
                        String version = null;
                        if ( classpathImpl.getPackage() != null )
                        {
                            vendor = classpathImpl.getPackage().getImplementationVendor();
                            version = classpathImpl.getPackage().getImplementationVersion();
                        }

                        implementation = new Implementation();
                        implementation.setVendor( vendor );
                        implementation.setFinal( true );
                        implementation.setName( name );
                        implementation.setIdentifier( specification.getIdentifier() );
                        implementation.setClazz( javaTypeName.getName( true ) );
                        implementation.setVersion( version );

                        final Specifications implemented = new Specifications();
                        final SpecificationReference ref = new SpecificationReference();
                        ref.setIdentifier( specification.getIdentifier() );
                        ref.setVersion( specification.getVersion() );
                        implemented.getReference().add( ref );
                        implementation.setSpecifications( implemented );

                        if ( cpModule.getImplementations() == null )
                        {
                            cpModule.setImplementations( new Implementations() );
                        }

                        cpModule.getImplementations().getImplementation().add( implementation );
                    }
                }
            }
            catch ( final ClassNotFoundException e )
            {
                classpathImplementation = false;
            }
            catch ( final java.text.ParseException e )
            {
                classpathImplementation = false;
            }
        }

        return classpathImplementation;
    }

    private boolean checkFactoryMethod( final Class<?> clazz, final Class<?> type, final String methodName )
    {
        boolean factoryMethod = false;

        try
        {
            final java.lang.reflect.Method m = clazz.getMethod( methodName, (Class[]) null );
            factoryMethod = java.lang.reflect.Modifier.isStatic( m.getModifiers() )
                            && type.isAssignableFrom( m.getReturnType() );

        }
        catch ( final NoSuchMethodException e )
        {
            factoryMethod = false;
        }

        return factoryMethod;
    }

    private static String getMessage( final Throwable t )
    {
        return t != null
               ? t.getMessage() != null && t.getMessage().trim().length() > 0
                 ? t.getMessage()
                 : getMessage( t.getCause() )
               : null;

    }

    private static String getMessage( final String key, final Object... args )
    {
        return java.text.MessageFormat.format( java.util.ResourceBundle.getBundle(
            Modules.class.getName().replace( '.', '/' ), java.util.Locale.getDefault() ).
            getString( key ), args );

    }
      
}