Open Source Repository

Home /hibernate/hibernate-3.2.7.ga | Repository Home


org/hibernate/cfg/Configuration.java
//$Id: Configuration.java 16658 2009-06-01 21:50:00Z [email protected] $
package org.hibernate.cfg;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.ObjectInputStream;
import java.io.Serializable;
import java.io.StringReader;
import java.lang.reflect.Array;
import java.net.URL;
import java.util.ArrayList;
import java.util.Enumeration;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
import java.util.Map;
import java.util.Properties;
import java.util.Set;
import java.util.TreeMap;
import java.util.jar.JarFile;
import java.util.zip.ZipEntry;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import org.dom4j.Attribute;
import org.dom4j.DocumentException;
import org.dom4j.Element;
import org.hibernate.EmptyInterceptor;
import org.hibernate.HibernateException;
import org.hibernate.Interceptor;
import org.hibernate.InvalidMappingException;
import org.hibernate.MappingException;
import org.hibernate.MappingNotFoundException;
import org.hibernate.SessionFactory;
import org.hibernate.tuple.entity.EntityTuplizerFactory;
import org.hibernate.proxy.EntityNotFoundDelegate;
import org.hibernate.dialect.Dialect;
import org.hibernate.dialect.MySQLDialect;
import org.hibernate.dialect.function.SQLFunction;
import org.hibernate.engine.FilterDefinition;
import org.hibernate.engine.Mapping;
import org.hibernate.event.AutoFlushEventListener;
import org.hibernate.event.DeleteEventListener;
import org.hibernate.event.DirtyCheckEventListener;
import org.hibernate.event.EventListeners;
import org.hibernate.event.EvictEventListener;
import org.hibernate.event.FlushEntityEventListener;
import org.hibernate.event.FlushEventListener;
import org.hibernate.event.InitializeCollectionEventListener;
import org.hibernate.event.LoadEventListener;
import org.hibernate.event.LockEventListener;
import org.hibernate.event.MergeEventListener;
import org.hibernate.event.PersistEventListener;
import org.hibernate.event.PostDeleteEventListener;
import org.hibernate.event.PostInsertEventListener;
import org.hibernate.event.PostLoadEventListener;
import org.hibernate.event.PostUpdateEventListener;
import org.hibernate.event.PreDeleteEventListener;
import org.hibernate.event.PreInsertEventListener;
import org.hibernate.event.PreLoadEventListener;
import org.hibernate.event.PreUpdateEventListener;
import org.hibernate.event.RefreshEventListener;
import org.hibernate.event.ReplicateEventListener;
import org.hibernate.event.SaveOrUpdateEventListener;
import org.hibernate.event.PreCollectionRecreateEventListener;
import org.hibernate.event.PreCollectionRemoveEventListener;
import org.hibernate.event.PreCollectionUpdateEventListener;
import org.hibernate.event.PostCollectionUpdateEventListener;
import org.hibernate.event.PostCollectionRemoveEventListener;
import org.hibernate.event.PostCollectionRecreateEventListener;
import org.hibernate.id.IdentifierGenerator;
import org.hibernate.id.PersistentIdentifierGenerator;
import org.hibernate.impl.SessionFactoryImpl;
import org.hibernate.mapping.AuxiliaryDatabaseObject;
import org.hibernate.mapping.Collection;
import org.hibernate.mapping.ForeignKey;
import org.hibernate.mapping.IdentifierCollection;
import org.hibernate.mapping.Index;
import org.hibernate.mapping.PersistentClass;
import org.hibernate.mapping.Property;
import org.hibernate.mapping.RootClass;
import org.hibernate.mapping.SimpleValue;
import org.hibernate.mapping.Table;
import org.hibernate.mapping.UniqueKey;
import org.hibernate.secure.JACCConfiguration;
import org.hibernate.tool.hbm2ddl.DatabaseMetadata;
import org.hibernate.tool.hbm2ddl.TableMetadata;
import org.hibernate.type.SerializationException;
import org.hibernate.type.Type;
import org.hibernate.util.ArrayHelper;
import org.hibernate.util.CollectionHelper;
import org.hibernate.util.ConfigHelper;
import org.hibernate.util.ReflectHelper;
import org.hibernate.util.SerializationHelper;
import org.hibernate.util.StringHelper;
import org.hibernate.util.XMLHelper;
import org.hibernate.util.PropertiesHelper;
import org.w3c.dom.Document;
import org.xml.sax.EntityResolver;
import org.xml.sax.InputSource;

/**
 * An instance of <tt>Configuration</tt> allows the application
 * to specify properties and mapping documents to be used when
 * creating a <tt>SessionFactory</tt>. Usually an application will create
 * a single <tt>Configuration</tt>, build a single instance of
 <tt>SessionFactory</tt> and then instantiate <tt>Session</tt>s in
 * threads servicing client requests. The <tt>Configuration</tt> is meant
 * only as an initialization-time object. <tt>SessionFactory</tt>s are
 * immutable and do not retain any association back to the
 <tt>Configuration</tt>.<br>
 <br>
 * A new <tt>Configuration</tt> will use the properties specified in
 <tt>hibernate.properties</tt> by default.
 *
 @author Gavin King
 @see org.hibernate.SessionFactory
 */
public class Configuration implements Serializable {

  private static Log log = LogFactory.getLogConfiguration.class );

  protected Map classes;
  protected Map imports;
  protected Map collections;
  protected Map tables;
  protected List auxiliaryDatabaseObjects;
  protected Map sqlFunctions;
  protected Map namedQueries;
  protected Map namedSqlQueries;

  private EntityTuplizerFactory entityTuplizerFactory;
//  private ComponentTuplizerFactory componentTuplizerFactory; todo : HHH-3517 and HHH-1907

  /**
   * Map<String, SqlResultSetMapping> result set name, result set description
   */
  protected Map sqlResultSetMappings;
  protected Map filterDefinitions;
  protected List secondPasses;
  protected List propertyReferences;
//  protected List extendsQueue;
  protected Map extendsQueue;
  protected Map tableNameBinding;
  protected Map columnNameBindingPerTable;
  private Interceptor interceptor;
  private Properties properties;
  private EntityResolver entityResolver;
  private EntityNotFoundDelegate entityNotFoundDelegate;

  protected transient XMLHelper xmlHelper;
  protected transient Map typeDefs;

  protected NamingStrategy namingStrategy;

  private EventListeners eventListeners;

  protected final SettingsFactory settingsFactory;

  private transient Mapping mapping = buildMapping();

  protected Configuration(SettingsFactory settingsFactory) {
    this.settingsFactory = settingsFactory;
    reset();
  }

  public Configuration() {
    thisnew SettingsFactory() );
  }

  protected void reset() {
    classes = new HashMap();
    imports = new HashMap();
    collections = new HashMap();
    tables = new TreeMap();
    namedQueries = new HashMap();
    namedSqlQueries = new HashMap();
    sqlResultSetMappings = new HashMap();
    xmlHelper = new XMLHelper();
    typeDefs = new HashMap();
    propertyReferences = new ArrayList();
    secondPasses = new ArrayList();
    interceptor = EmptyInterceptor.INSTANCE;
    properties = Environment.getProperties();
    entityResolver = XMLHelper.DEFAULT_DTD_RESOLVER;
    eventListeners = new EventListeners();
    filterDefinitions = new HashMap();
//    extendsQueue = new ArrayList();
    extendsQueue = new HashMap();
    auxiliaryDatabaseObjects = new ArrayList();
    tableNameBinding = new HashMap();
    columnNameBindingPerTable = new HashMap();
    namingStrategy = DefaultNamingStrategy.INSTANCE;
    sqlFunctions = new HashMap();
    entityTuplizerFactory = new EntityTuplizerFactory();
//    componentTuplizerFactory = new ComponentTuplizerFactory();
  }

  public EntityTuplizerFactory getEntityTuplizerFactory() {
    return entityTuplizerFactory;
  }

//  public ComponentTuplizerFactory getComponentTuplizerFactory() {
//    return componentTuplizerFactory;
//  }

  /**
   * Iterate the entity mappings
   *
   @return Iterator of the entity mappings currently contained in the configuration.
   */
  public Iterator getClassMappings() {
    return classes.values().iterator();
  }

  /**
   * Iterate the collection mappings
   *
   @return Iterator of the collection mappings currently contained in the configuration.
   */
  public Iterator getCollectionMappings() {
    return collections.values().iterator();
  }

  /**
   * Iterate the table mappings
   *
   @return Iterator of the table mappings currently contained in the configuration.
   */
  public Iterator getTableMappings() {
    return tables.values().iterator();
  }

  /**
   * Get the mapping for a particular entity
   *
   @param entityName An entity name.
   @return the entity mapping information
   */
  public PersistentClass getClassMapping(String entityName) {
    return (PersistentClassclasses.getentityName );
  }

  /**
   * Get the mapping for a particular collection role
   *
   @param role a collection role
   @return The collection mapping information
   */
  public Collection getCollectionMapping(String role) {
    return (Collectioncollections.getrole );
  }

  /**
   * Set a custom entity resolver. This entity resolver must be
   * set before addXXX(misc) call.
   * Default value is {@link org.hibernate.util.DTDEntityResolver}
   *
   @param entityResolver entity resolver to use
   */
  public void setEntityResolver(EntityResolver entityResolver) {
    this.entityResolver = entityResolver;
  }

  public EntityResolver getEntityResolver() {
    return entityResolver;
  }

  /**
   * Retrieve the user-supplied delegate to handle non-existent entity
   * scenarios.  May be null.
   *
   @return The user-supplied delegate
   */
  public EntityNotFoundDelegate getEntityNotFoundDelegate() {
    return entityNotFoundDelegate;
  }

  /**
   * Specify a user-supplied delegate to be used to handle scenarios where an entity could not be
   * located by specified id.  This is mainly intended for EJB3 implementations to be able to
   * control how proxy initialization errors should be handled...
   *
   @param entityNotFoundDelegate The delegate to use
   */
  public void setEntityNotFoundDelegate(EntityNotFoundDelegate entityNotFoundDelegate) {
    this.entityNotFoundDelegate = entityNotFoundDelegate;
  }

  /**
   * Read mappings from a particular XML file
   *
   @param xmlFile a path to a file
   @return this (for method chaining purposes)
   @throws org.hibernate.MappingException Indicates inability to locate or parse
   * the specified mapping file.
   @see #addFile(java.io.File)
   */
  public Configuration addFile(String xmlFilethrows MappingException {
    return addFilenew FilexmlFile ) );
  }

  /**
   * Read mappings from a particular XML file
   *
   @param xmlFile a path to a file
   @return this (for method chaining purposes)
   @throws org.hibernate.MappingException Indicates inability to locate or parse
   * the specified mapping file.
   */
  public Configuration addFile(File xmlFilethrows MappingException {
    log.info"Reading mappings from file: " + xmlFile.getPath() );
    if !xmlFile.exists() ) {
      throw new MappingNotFoundException"file", xmlFile.toString() );
    }
    try {
      List errors = new ArrayList();
      org.dom4j.Document doc = xmlHelper.createSAXReaderxmlFile.toString(), errors, entityResolver ).readxmlFile );
      if errors.size() != ) {
        throw new InvalidMappingException"file", xmlFile.toString()Throwable errors.get) );
      }
      adddoc );
      return this;
    }
    catch InvalidMappingException e ) {
      throw e;
    }
    catch  MappingNotFoundException e ) {
      throw e;
    }
    catch Exception e ) {
      throw new InvalidMappingException"file", xmlFile.toString(), e );
    }
  }

  /**
   * Add a cached mapping file.  A cached file is a serialized representation
   * of the DOM structure of a particular mapping.  It is saved from a previous
   * call as a file with the name <tt>xmlFile + ".bin"</tt> where xmlFile is
   * the name of the original mapping file.
   </p>
   * If a cached <tt>xmlFile + ".bin"</tt> exists and is newer than
   <tt>xmlFile</tt> the <tt>".bin"</tt> file will be read directly. Otherwise
   * xmlFile is read and then serialized to <tt>xmlFile + ".bin"</tt> for use
   * the next time.
   *
   @param xmlFile The cacheable mapping file to be added.
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the cached file or processing
   * the non-cached file.
   */
  public Configuration addCacheableFile(File xmlFilethrows MappingException {
    try {
      File cachedFile = new FilexmlFile.getAbsolutePath() ".bin" );
      org.dom4j.Document doc = null;

      final boolean useCachedFile = xmlFile.exists() &&
          cachedFile.exists() &&
          xmlFile.lastModified() < cachedFile.lastModified();

      if useCachedFile ) {
        try {
          log.info"Reading mappings from cache file: " + cachedFile );
          doc = org.dom4j.Document SerializationHelper.deserializenew FileInputStreamcachedFile ) );
        }
        catch SerializationException e ) {
          log.warn"Could not deserialize cache file: " + cachedFile.getPath(), e );
        }
        catch FileNotFoundException e ) {
          log.warn"I/O reported cached file could not be found : " + cachedFile.getPath(), e );
        }
      }

      // if doc is null, then for whatever reason, the cached file cannot be used...
      if doc == null ) {
        if !xmlFile.exists() ) {
          throw new MappingNotFoundException"file", xmlFile.toString() );
        }

        log.info"Reading mappings from file: " + xmlFile );
        List errors = new ArrayList();
        try {
          doc = xmlHelper.createSAXReaderxmlFile.getAbsolutePath(), errors, entityResolver ).readxmlFile );
          if errors.size() != ) {
            throw new MappingException"invalid mapping"Throwable errors.get) );
          }
        }
        catchDocumentException e){
          throw new MappingException"invalid mapping", e );
        }

        try {
          log.debug"Writing cache file for: " + xmlFile + " to: " + cachedFile );
          SerializationHelper.serialize( ( Serializable doc, new FileOutputStreamcachedFile ) );
        }
        catch SerializationException e ) {
          log.warn"Could not write cached file: " + cachedFile, e );
        }
        catch FileNotFoundException e ) {
          log.warn"I/O reported error writing cached file : " + cachedFile.getPath(), e );
        }
      }

      adddoc );
      return this;

    }
    catch InvalidMappingException e ) {
      throw e;
    }
    catch  MappingNotFoundException e ) {
      throw e;
    }
    catch Exception e ) {
      throw new InvalidMappingException"file", xmlFile.toString(), e );
    }
  }

  /**
   * Add a cacheable mapping file.
   *
   @param xmlFile The name of the file to be added.  This must be in a form
   * useable to simply construct a {@link java.io.File} instance.
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the cached file or processing
   * the non-cached file.
   @see #addCacheableFile(java.io.File)
   */
  public Configuration addCacheableFile(String xmlFilethrows MappingException {
    return addCacheableFilenew FilexmlFile ) );
  }


  /**
   * Read mappings from a <tt>String</tt>
   *
   @param xml an XML string
   @return this (for method chaining purposes)
   @throws org.hibernate.MappingException Indicates problems parsing the
   * given XML string
   */
  public Configuration addXML(String xmlthrows MappingException {
    if log.isDebugEnabled() ) {
      log.debug"Mapping XML:\n" + xml );
    }
    try {
      List errors = new ArrayList();
      org.dom4j.Document doc = xmlHelper.createSAXReader"XML String", errors, entityResolver )
          .readnew StringReaderxml ) );
      if errors.size() != ) {
        throw new MappingException"invalid mapping"(Throwableerrors.get) );
      }
      adddoc );
    }
    catch (DocumentException e) {
      throw new MappingException"Could not parse mapping document in XML string", e );
    }
    return this;
  }

  /**
   * Read mappings from a <tt>URL</tt>
   *
   @param url The url for the mapping document to be read.
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the URL or processing
   * the mapping document.
   */
  public Configuration addURL(URL urlthrows MappingException {
    if log.isDebugEnabled() ) {
      log.debug"Reading mapping document from URL:" + url.toExternalForm() );
    }
    try {
      addInputStreamurl.openStream() );
    }
    catch InvalidMappingException e ) {
      throw new InvalidMappingException"URL", url.toExternalForm(), e.getCause() );
    }
    catch (Exception e) {
      throw new InvalidMappingException"URL", url.toExternalForm(), e );
    }
    return this;
  }

  /**
   * Read mappings from a DOM <tt>Document</tt>
   *
   @param doc The DOM document
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the DOM or processing
   * the mapping document.
   */
  public Configuration addDocument(Document docthrows MappingException {
    if log.isDebugEnabled() ) {
      log.debug"Mapping document:\n" + doc );
    }
    addxmlHelper.createDOMReader().readdoc ) );
    return this;
  }

  /**
   * Read mappings from an {@link java.io.InputStream}.
   *
   @param xmlInputStream The input stream containing a DOM.
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the stream, or
   * processing the contained mapping document.
   */
  public Configuration addInputStream(InputStream xmlInputStreamthrows MappingException {
    try {
      List errors = new ArrayList();
      org.dom4j.Document doc = xmlHelper.createSAXReader"XML InputStream", errors, entityResolver )
          .readnew InputSourcexmlInputStream ) );
      if errors.size() != ) {
        throw new InvalidMappingException"invalid mapping", null, (Throwableerrors.get) );
      }
      adddoc );
      return this;
    }
    catch (DocumentException e) {
      throw new InvalidMappingException"input stream", null, e );
    }
    finally {
      try {
        xmlInputStream.close();
      }
      catch (IOException ioe) {
        log.warn"Could not close input stream", ioe );
      }
    }
  }

  /**
   * Read mappings as a application resource (i.e. classpath lookup).
   *
   @param resourceName The resource name
   @param classLoader The class loader to use.
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems locating the resource or
   * processing the contained mapping document.
   */
  public Configuration addResource(String resourceName, ClassLoader classLoaderthrows MappingException {
    log.info"Reading mappings from resource: " + resourceName );
    InputStream rsrc = classLoader.getResourceAsStreamresourceName );
    if rsrc == null ) {
      throw new MappingNotFoundException"resource", resourceName );
    }
    try {
      return addInputStreamrsrc );
    }
    catch (MappingException me) {
      throw new InvalidMappingException"resource", resourceName, me );
    }
  }

  /**
   * Read mappings as a application resourceName (i.e. classpath lookup)
   * trying different classloaders.
   *
   @param resourceName The resource name
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems locating the resource or
   * processing the contained mapping document.
   */
  public Configuration addResource(String resourceNamethrows MappingException {
    log.info"Reading mappings from resource : " + resourceName );
    ClassLoader contextClassLoader = Thread.currentThread().getContextClassLoader();
    InputStream rsrc = null;
    if (contextClassLoader!=null) {
      rsrc = contextClassLoader.getResourceAsStreamresourceName );
    }
    if rsrc == null ) {
      rsrc = Environment.class.getClassLoader().getResourceAsStreamresourceName );
    }
    if rsrc == null ) {
      throw new MappingNotFoundException"resource", resourceName );
    }
    try {
      return addInputStreamrsrc );
    }
    catch (MappingException me) {
      throw new InvalidMappingException"resource", resourceName, me );
    }
  }

  /**
   * Read a mapping as an application resouurce using the convention that a class
   * named <tt>foo.bar.Foo</tt> is mapped by a file <tt>foo/bar/Foo.hbm.xml</tt>
   * which can be resolved as a classpath resource.
   *
   @param persistentClass The mapped class
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems locating the resource or
   * processing the contained mapping document.
   */
  public Configuration addClass(Class persistentClassthrows MappingException {
    String mappingResourceName = persistentClass.getName().replace'.''/' ".hbm.xml";
    log.info"Reading mappings from resource: " + mappingResourceName );
    return addResourcemappingResourceName, persistentClass.getClassLoader() );
  }

  /**
   * Read all mappings from a jar file
   <p/>
   * Assumes that any file named <tt>*.hbm.xml</tt> is a mapping document.
   *
   @param jar a jar file
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the jar file or
   * processing the contained mapping documents.
   */
  public Configuration addJar(File jarthrows MappingException {
    log.info"Searching for mapping documents in jar: " + jar.getName() );
    JarFile jarFile = null;
    try {
      try {
        jarFile = new JarFilejar );
      }
      catch (IOException ioe) {
        throw new InvalidMappingException(
            "Could not read mapping documents from jar: " + jar.getName()"jar", jar.getName(),
            ioe
        );
      }
      Enumeration jarEntries = jarFile.entries();
      while jarEntries.hasMoreElements() ) {
        ZipEntry ze = (ZipEntryjarEntries.nextElement();
        if ze.getName().endsWith".hbm.xml" ) ) {
          log.info"Found mapping document in jar: " + ze.getName() );
          try {
            addInputStreamjarFile.getInputStreamze ) );
          }
          catch (Exception e) {
            throw new InvalidMappingException(
                "Could not read mapping documents from jar: " + jar.getName(),
                "jar",
                jar.getName(),
                e
            );
          }
        }
      }
    }
    finally {
      try {
        if jarFile != null ) {
          jarFile.close();
        }
      }
      catch (IOException ioe) {
        log.error("could not close jar", ioe);
      }
    }

    return this;
  }

  /**
   * Read all mapping documents from a directory tree.
   <p/>
   * Assumes that any file named <tt>*.hbm.xml</tt> is a mapping document.
   *
   @param dir The directory
   @return this (for method chaining purposes)
   @throws MappingException Indicates problems reading the jar file or
   * processing the contained mapping documents.
   */
  public Configuration addDirectory(File dirthrows MappingException {
    File[] files = dir.listFiles();
    for int i = 0; i < files.length ; i++ ) {
      if files[i].isDirectory() ) {
        addDirectoryfiles[i] );
      }
      else if files[i].getName().endsWith".hbm.xml" ) ) {
        addFilefiles[i] );
      }
    }
    return this;
  }

  protected void add(org.dom4j.Document docthrows MappingException {
    HbmBinder.bindRootdoc, createMappings(), CollectionHelper.EMPTY_MAP );
  }

  /**
   * Create a new <tt>Mappings</tt> to add class and collection
   * mappings to.
   */
  public Mappings createMappings() {
    return new Mappings(
        classes,
        collections,
        tables,
        namedQueries,
        namedSqlQueries,
        sqlResultSetMappings,
        imports,
        secondPasses,
        propertyReferences,
        namingStrategy,
        typeDefs,
        filterDefinitions,
        extendsQueue,
        auxiliaryDatabaseObjects,
        tableNameBinding,
        columnNameBindingPerTable
      );
  }


  private Iterator iterateGenerators(Dialect dialectthrows MappingException {

    TreeMap generators = new TreeMap();
    String defaultCatalog = properties.getPropertyEnvironment.DEFAULT_CATALOG );
    String defaultSchema = properties.getPropertyEnvironment.DEFAULT_SCHEMA );

    Iterator iter = classes.values().iterator();
    while iter.hasNext() ) {
      PersistentClass pc = (PersistentClassiter.next();

      if !pc.isInherited() ) {

        IdentifierGenerator ig = pc.getIdentifier()
            .createIdentifierGenerator(
                dialect,
                defaultCatalog,
                defaultSchema,
                (RootClasspc
              );

        if ig instanceof PersistentIdentifierGenerator ) {
          generators.put( ( (PersistentIdentifierGeneratorig ).generatorKey(), ig );
        }

      }
    }

    iter = collections.values().iterator();
    while iter.hasNext() ) {
      Collection collection = (Collectioniter.next();

      if collection.isIdentified() ) {

        IdentifierGenerator ig = ( (IdentifierCollectioncollection ).getIdentifier()
            .createIdentifierGenerator(
                dialect,
                defaultCatalog,
                defaultSchema,
                null
              );

        if ig instanceof PersistentIdentifierGenerator ) {
          generators.put( ( (PersistentIdentifierGeneratorig ).generatorKey(), ig );
        }

      }
    }

    return generators.values().iterator();
  }

  /**
   * Generate DDL for dropping tables
   *
   @see org.hibernate.tool.hbm2ddl.SchemaExport
   */
  public String[] generateDropSchemaScript(Dialect dialectthrows HibernateException {

    secondPassCompile();

    String defaultCatalog = properties.getPropertyEnvironment.DEFAULT_CATALOG );
    String defaultSchema = properties.getPropertyEnvironment.DEFAULT_SCHEMA );

    ArrayList script = new ArrayList50 );

    // drop them in reverse order in case db needs it done that way...
    ListIterator itr = auxiliaryDatabaseObjects.listIteratorauxiliaryDatabaseObjects.size() );
    while itr.hasPrevious() ) {
      AuxiliaryDatabaseObject object = (AuxiliaryDatabaseObjectitr.previous();
      if object.appliesToDialectdialect ) ) {
        script.addobject.sqlDropStringdialect, defaultCatalog, defaultSchema ) );
      }
    }

    if dialect.dropConstraints() ) {
      Iterator iter = getTableMappings();
      while iter.hasNext() ) {
        Table table = (Tableiter.next();
        if table.isPhysicalTable() ) {
          Iterator subIter = table.getForeignKeyIterator();
          while subIter.hasNext() ) {
            ForeignKey fk = (ForeignKeysubIter.next();
            if fk.isPhysicalConstraint() ) {
              script.add(
                  fk.sqlDropString(
                      dialect,
                      defaultCatalog,
                      defaultSchema
                    )
                );
            }
          }
        }
      }
    }


    Iterator iter = getTableMappings();
    while iter.hasNext() ) {

      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {

        /*Iterator subIter = table.getIndexIterator();
        while ( subIter.hasNext() ) {
          Index index = (Index) subIter.next();
          if ( !index.isForeignKey() || !dialect.hasImplicitIndexForForeignKey() ) {
            script.add( index.sqlDropString(dialect) );
          }
        }*/

        script.add(
            table.sqlDropString(
                dialect,
                defaultCatalog,
                defaultSchema
              )
          );

      }

    }

    iter = iterateGeneratorsdialect );
    while iter.hasNext() ) {
      String[] lines = ( (PersistentIdentifierGeneratoriter.next() ).sqlDropStringsdialect );
      for int i = 0; i < lines.length ; i++ ) {
        script.addlines[i] );
      }
    }

    return ArrayHelper.toStringArrayscript );
  }

  /**
   * Generate DDL for creating tables
   *
   @see org.hibernate.tool.hbm2ddl.SchemaExport
   */
  public String[] generateSchemaCreationScript(Dialect dialectthrows HibernateException {
    secondPassCompile();

    ArrayList script = new ArrayList50 );
    String defaultCatalog = properties.getPropertyEnvironment.DEFAULT_CATALOG );
    String defaultSchema = properties.getPropertyEnvironment.DEFAULT_SCHEMA );

    Iterator iter = getTableMappings();
    while iter.hasNext() ) {
      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {
        script.add(
            table.sqlCreateString(
                dialect,
                mapping,
                defaultCatalog,
                defaultSchema
              )
          );
        Iterator comments = table.sqlCommentStringsdialect, defaultCatalog, defaultSchema );
        while comments.hasNext() ) {
          script.addcomments.next() );
        }
      }
    }

    iter = getTableMappings();
    while iter.hasNext() ) {
      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {

        if !dialect.supportsUniqueConstraintInCreateAlterTable() ) {
          Iterator subIter = table.getUniqueKeyIterator();
          while subIter.hasNext() ) {
            UniqueKey uk = (UniqueKeysubIter.next();
            String constraintString = uk.sqlCreateStringdialect, mapping, defaultCatalog, defaultSchema );
            if (constraintString != nullscript.addconstraintString );
          }
        }


        Iterator subIter = table.getIndexIterator();
        while subIter.hasNext() ) {
          Index index = (IndexsubIter.next();
          script.add(
              index.sqlCreateString(
                  dialect,
                  mapping,
                  defaultCatalog,
                  defaultSchema
                )
            );
        }

        if dialect.hasAlterTable() ) {
          subIter = table.getForeignKeyIterator();
          while subIter.hasNext() ) {
            ForeignKey fk = (ForeignKeysubIter.next();
            if fk.isPhysicalConstraint() ) {
              script.add(
                  fk.sqlCreateString(
                      dialect, mapping,
                      defaultCatalog,
                      defaultSchema
                    )
                );
            }
          }
        }

      }
    }

    iter = iterateGeneratorsdialect );
    while iter.hasNext() ) {
      String[] lines = ( (PersistentIdentifierGeneratoriter.next() ).sqlCreateStringsdialect );
      for int i = 0; i < lines.length ; i++ ) {
        script.addlines[i] );
      }
    }

    Iterator itr = auxiliaryDatabaseObjects.iterator();
    while itr.hasNext() ) {
      AuxiliaryDatabaseObject object = (AuxiliaryDatabaseObjectitr.next();
      if object.appliesToDialectdialect ) ) {
        script.addobject.sqlCreateStringdialect, mapping, defaultCatalog, defaultSchema ) );
      }
    }

    return ArrayHelper.toStringArrayscript );
  }

  /**
   * Generate DDL for altering tables
   *
   @see org.hibernate.tool.hbm2ddl.SchemaUpdate
   */
  public String[] generateSchemaUpdateScript(Dialect dialect, DatabaseMetadata databaseMetadata)
      throws HibernateException {
    secondPassCompile();

    String defaultCatalog = properties.getPropertyEnvironment.DEFAULT_CATALOG );
    String defaultSchema = properties.getPropertyEnvironment.DEFAULT_SCHEMA );

    ArrayList script = new ArrayList50 );

    Iterator iter = getTableMappings();
    while iter.hasNext() ) {
      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {
        
        TableMetadata tableInfo = databaseMetadata.getTableMetadata(
            table.getName(),
            table.getSchema() == null ? defaultSchema : table.getSchema(),
            table.getCatalog() == null ? defaultCatalog : table.getCatalog(),
                table.isQuoted()

          );
        if tableInfo == null ) {
          script.add(
              table.sqlCreateString(
                  dialect,
                  mapping,
                  defaultCatalog,
                  defaultSchema
                )
            );
        }
        else {
          Iterator subiter = table.sqlAlterStrings(
              dialect,
              mapping,
              tableInfo,
              defaultCatalog,
              defaultSchema
            );
          while subiter.hasNext() ) {
            script.addsubiter.next() );
          }
        }

        Iterator comments = table.sqlCommentStringsdialect, defaultCatalog, defaultSchema );
        while comments.hasNext() ) {
          script.addcomments.next() );
        }

      }
    }

    iter = getTableMappings();
    while iter.hasNext() ) {
      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {

        TableMetadata tableInfo = databaseMetadata.getTableMetadata(
            table.getName(),
            table.getSchema(),
            table.getCatalog(),
            table.isQuoted()
          );

        if dialect.hasAlterTable() ) {
          Iterator subIter = table.getForeignKeyIterator();
          while subIter.hasNext() ) {
            ForeignKey fk = (ForeignKeysubIter.next();
            if fk.isPhysicalConstraint() ) {
              boolean create = tableInfo == null || (
                  tableInfo.getForeignKeyMetadatafk == null && (
                      //Icky workaround for MySQL bug:
                      !dialect instanceof MySQLDialect ||
                          tableInfo.getIndexMetadatafk.getName() ) == null
                    )
                );
              if create ) {
                script.add(
                    fk.sqlCreateString(
                        dialect,
                        mapping,
                        defaultCatalog,
                        defaultSchema
                      )
                  );
              }
            }
          }
        }

      }

      /*//broken, 'cos we don't generate these with names in SchemaExport
      subIter = table.getIndexIterator();
      while ( subIter.hasNext() ) {
        Index index = (Index) subIter.next();
        if ( !index.isForeignKey() || !dialect.hasImplicitIndexForForeignKey() ) {
          if ( tableInfo==null || tableInfo.getIndexMetadata( index.getFilterName() ) == null ) {
            script.add( index.sqlCreateString(dialect, mapping) );
          }
        }
      }
      //broken, 'cos we don't generate these with names in SchemaExport
      subIter = table.getUniqueKeyIterator();
      while ( subIter.hasNext() ) {
        UniqueKey uk = (UniqueKey) subIter.next();
        if ( tableInfo==null || tableInfo.getIndexMetadata( uk.getFilterName() ) == null ) {
          script.add( uk.sqlCreateString(dialect, mapping) );
        }
      }*/
    }

    iter = iterateGeneratorsdialect );
    while iter.hasNext() ) {
      PersistentIdentifierGenerator generator = (PersistentIdentifierGeneratoriter.next();
      Object key = generator.generatorKey();
      if !databaseMetadata.isSequencekey && !databaseMetadata.isTablekey ) ) {
        String[] lines = generator.sqlCreateStringsdialect );
        for int i = 0; i < lines.length ; i++ ) {
          script.addlines[i] );
        }
      }
    }

    return ArrayHelper.toStringArrayscript );
  }

  public void validateSchema(Dialect dialect, DatabaseMetadata databaseMetadata)
      throws HibernateException {
    secondPassCompile();

    String defaultCatalog = properties.getPropertyEnvironment.DEFAULT_CATALOG );
    String defaultSchema = properties.getPropertyEnvironment.DEFAULT_SCHEMA );
    
    Iterator iter = getTableMappings();
    while iter.hasNext() ) {
      Table table = (Tableiter.next();
      if table.isPhysicalTable() ) {
        

        TableMetadata tableInfo = databaseMetadata.getTableMetadata(
            table.getName(),
            table.getSchema() == null ? defaultSchema : table.getSchema(),
            table.getCatalog() == null ? defaultCatalog : table.getCatalog(),
                table.isQuoted());
        if tableInfo == null ) {
          throw new HibernateException"Missing table: " + table.getName() );
        }
        else {
          table.validateColumnsdialect, mapping, tableInfo );
        }

      }
    }

    iter = iterateGeneratorsdialect );
    while iter.hasNext() ) {
      PersistentIdentifierGenerator generator = (PersistentIdentifierGeneratoriter.next();
      Object key = generator.generatorKey();
      if !databaseMetadata.isSequencekey && !databaseMetadata.isTablekey ) ) {
        throw new HibernateException"Missing sequence or table: " + key );
      }
    }
  }

  private void validate() throws MappingException {
    Iterator iter = classes.values().iterator();
    while iter.hasNext() ) {
      ( (PersistentClassiter.next() ).validatemapping );
    }
    iter = collections.values().iterator();
    while iter.hasNext() ) {
      ( (Collectioniter.next() ).validatemapping );
    }
  }

  /**
   * Call this to ensure the mappings are fully compiled/built. Usefull to ensure getting
   * access to all information in the metamodel when calling e.g. getClassMappings().
   */
  public void buildMappings() {
    secondPassCompile();
  }

  // This method may be called many times!!
  protected void secondPassCompile() throws MappingException {
    log.debug"processing extends queue" );

    processExtendsQueue();

    log.debug"processing collection mappings" );

    Iterator iter = secondPasses.iterator();
    while iter.hasNext() ) {
      SecondPass sp = (SecondPassiter.next();
      if (sp instanceof QuerySecondPass) ) {
        sp.doSecondPassclasses )
        iter.remove();
      }
    }

    log.debug"processing native query and ResultSetMapping mappings" );
    iter = secondPasses.iterator();
    while iter.hasNext() ) {
      SecondPass sp = (SecondPassiter.next();
      sp.doSecondPassclasses )
      iter.remove();
    }

    log.debug"processing association property references" );

    iter = propertyReferences.iterator();
    while iter.hasNext() ) {
      Mappings.PropertyReference upr = (Mappings.PropertyReferenceiter.next();

      PersistentClass clazz = getClassMappingupr.referencedClass );
      if clazz == null ) {
        throw new MappingException(
            "property-ref to unmapped class: " +
            upr.referencedClass
          );
      }

      Property prop = clazz.getReferencedPropertyupr.propertyName );
      if upr.unique ) {
        ( (SimpleValueprop.getValue() ).setAlternateUniqueKeytrue );
      }
    }

    //TODO: Somehow add the newly created foreign keys to the internal collection

    log.debug"processing foreign key constraints" );

    iter = getTableMappings();
    Set done = new HashSet();
    while iter.hasNext() ) {
      secondPassCompileForeignKeys( (Tableiter.next(), done );
    }

  }

  /**
   * Try to empty the extends queue.
   */
  private void processExtendsQueue() {
    // todo : would love to have this work on a notification basis
    //    where the successful binding of an entity/subclass would
    //    emit a notification which the extendsQueue entries could
    //    react to...
    org.dom4j.Document document = findPossibleExtends();
    while document != null ) {
      adddocument );
      document = findPossibleExtends();
    }

    if extendsQueue.size() ) {
//      Iterator iterator = extendsQueue.iterator();
      Iterator iterator = extendsQueue.keySet().iterator();
      StringBuffer buf = new StringBuffer"Following superclasses referenced in extends not found: " );
      while iterator.hasNext() ) {
        final ExtendsQueueEntry entry = ExtendsQueueEntry iterator.next();
        buf.appendentry.getExplicitName() );
        if entry.getMappingPackage() != null ) {
          buf.append"[" ).appendentry.getMappingPackage() ).append"]" );
        }
        if iterator.hasNext() ) {
          buf.append"," );
        }
      }
      throw new MappingExceptionbuf.toString() );
    }
  }

  /**
   * Find the first possible element in the queue of extends.
   */
  protected org.dom4j.Document findPossibleExtends() {
//    Iterator iter = extendsQueue.iterator();
    Iterator iter = extendsQueue.keySet().iterator();
    while iter.hasNext() ) {
      final ExtendsQueueEntry entry = ExtendsQueueEntry iter.next();
      if getClassMappingentry.getExplicitName() ) != null ) {
        // found
        iter.remove();
        return entry.getDocument();
      }
      else if getClassMappingHbmBinder.getClassNameentry.getExplicitName(), entry.getMappingPackage() ) ) != null ) {
        // found
        iter.remove();
        return entry.getDocument();
      }
    }
    return null;
  }

  protected void secondPassCompileForeignKeys(Table table, Set donethrows MappingException {

    table.createForeignKeys();

    Iterator iter = table.getForeignKeyIterator();
    while iter.hasNext() ) {

      ForeignKey fk = (ForeignKeyiter.next();
      if !done.containsfk ) ) {
        done.addfk );
        final String referencedEntityName = fk.getReferencedEntityName();
        if referencedEntityName == null ) {
          throw new MappingException(
              "An association from the table " +
              fk.getTable().getName() +
              " does not specify the referenced entity"
            );
        }
        if log.isDebugEnabled() ) {
          log.debug"resolving reference to class: " + referencedEntityName );
        }
        PersistentClass referencedClass = (PersistentClassclasses.getreferencedEntityName );
        if referencedClass == null ) {
          throw new MappingException(
              "An association from the table " +
              fk.getTable().getName() +
              " refers to an unmapped class: " +
              referencedEntityName
            );
        }
        if referencedClass.isJoinedSubclass() ) {
          secondPassCompileForeignKeysreferencedClass.getSuperclass().getTable(), done );
        }
        fk.setReferencedTablereferencedClass.getTable() );
        fk.alignColumns();
      }
    }
  }

  /**
   * Get the named queries
   */
  public Map getNamedQueries() {
    return namedQueries;
  }

  /**
   * Instantiate a new <tt>SessionFactory</tt>, using the properties and
   * mappings in this configuration. The <tt>SessionFactory</tt> will be
   * immutable, so changes made to the <tt>Configuration</tt> after
   * building the <tt>SessionFactory</tt> will not affect it.
   *
   @return a new factory for <tt>Session</tt>s
   @see org.hibernate.SessionFactory
   */
  public SessionFactory buildSessionFactory() throws HibernateException {
    log.debug"Preparing to build session factory with filters : " + filterDefinitions );
    secondPassCompile();
    validate();
    Environment.verifyPropertiesproperties );
    Properties copy = new Properties();
    copy.putAllproperties );
    PropertiesHelper.resolvePlaceHolderscopy );
    Settings settings = buildSettingscopy );

    return new SessionFactoryImpl(
        this,
        mapping,
        settings,
        getInitializedEventListeners()
      );
  }

  private EventListeners getInitializedEventListeners() {
    EventListeners result = (EventListenerseventListeners.shallowCopy();
    result.initializeListenersthis );
    return result;
  }

  /**
   * Return the configured <tt>Interceptor</tt>
   */
  public Interceptor getInterceptor() {
    return interceptor;
  }

  /**
   * Get all properties
   */
  public Properties getProperties() {
    return properties;
  }

  /**
   * Configure an <tt>Interceptor</tt>
   */
  public Configuration setInterceptor(Interceptor interceptor) {
    this.interceptor = interceptor;
    return this;
  }

  /**
   * Specify a completely new set of properties
   */
  public Configuration setProperties(Properties properties) {
    this.properties = properties;
    return this;
  }

  /**
   * Set the given properties
   */
  public Configuration addProperties(Properties extraProperties) {
    this.properties.putAllextraProperties );
    return this;
  }

  /**
   * Adds the incoming properties to the internap properties structure,
   * as long as the internal structure does not already contain an
   * entry for the given key.
   *
   @param properties
   @return this
   */
  public Configuration mergeProperties(Properties properties) {
    Iterator itr = properties.entrySet().iterator();
    while itr.hasNext() ) {
      final Map.Entry entry = Map.Entry itr.next();
      if this.properties.containsKeyentry.getKey() ) ) {
        continue;
      }
      this.properties.setProperty( ( String entry.getKey()String entry.getValue() );
    }
    return this;
  }

  /**
   * Set a property
   */
  public Configuration setProperty(String propertyName, String value) {
    properties.setPropertypropertyName, value );
    return this;
  }

  /**
   * Get a property
   */
  public String getProperty(String propertyName) {
    return properties.getPropertypropertyName );
  }

  private void addProperties(Element parent) {
    Iterator iter = parent.elementIterator"property" );
    while iter.hasNext() ) {
      Element node = (Elementiter.next();
      String name = node.attributeValue"name" );
      String value = node.getText().trim();
      log.debugname + "=" + value );
      properties.setPropertyname, value );
      if !name.startsWith"hibernate" ) ) {
        properties.setProperty"hibernate." + name, value );
      }
    }
    Environment.verifyPropertiesproperties );
  }

  /**
   * Get the configuration file as an <tt>InputStream</tt>. Might be overridden
   * by subclasses to allow the configuration to be located by some arbitrary
   * mechanism.
   */
  protected InputStream getConfigurationInputStream(String resourcethrows HibernateException {

    log.info"Configuration resource: " + resource );

    return ConfigHelper.getResourceAsStreamresource );

  }

  /**
   * Use the mappings and properties specified in an application
   * resource named <tt>hibernate.cfg.xml</tt>.
   */
  public Configuration configure() throws HibernateException {
    configure"/hibernate.cfg.xml" );
    return this;
  }

  /**
   * Use the mappings and properties specified in the given application
   * resource. The format of the resource is defined in
   <tt>hibernate-configuration-3.0.dtd</tt>.
   <p/>
   * The resource is found via <tt>getConfigurationInputStream(resource)</tt>.
   */
  public Configuration configure(String resourcethrows HibernateException {
    log.info"configuring from resource: " + resource );
    InputStream stream = getConfigurationInputStreamresource );
    return doConfigurestream, resource );
  }

  /**
   * Use the mappings and properties specified in the given document.
   * The format of the document is defined in
   <tt>hibernate-configuration-3.0.dtd</tt>.
   *
   @param url URL from which you wish to load the configuration
   @return A configuration configured via the file
   @throws HibernateException
   */
  public Configuration configure(URL urlthrows HibernateException {
    log.info"configuring from url: " + url.toString() );
    try {
      return doConfigureurl.openStream(), url.toString() );
    }
    catch (IOException ioe) {
      throw new HibernateException"could not configure from URL: " + url, ioe );
    }
  }

  /**
   * Use the mappings and properties specified in the given application
   * file. The format of the file is defined in
   <tt>hibernate-configuration-3.0.dtd</tt>.
   *
   @param configFile <tt>File</tt> from which you wish to load the configuration
   @return A configuration configured via the file
   @throws HibernateException
   */
  public Configuration configure(File configFilethrows HibernateException {
    log.info"configuring from file: " + configFile.getName() );
    try {
      return doConfigurenew FileInputStreamconfigFile ), configFile.toString() );
    }
    catch (FileNotFoundException fnfe) {
      throw new HibernateException"could not find file: " + configFile, fnfe );
    }
  }

  /**
   * Use the mappings and properties specified in the given application
   * resource. The format of the resource is defined in
   <tt>hibernate-configuration-3.0.dtd</tt>.
   *
   @param stream     Inputstream to be read from
   @param resourceName The name to use in warning/error messages
   @return A configuration configured via the stream
   @throws HibernateException
   */
  protected Configuration doConfigure(InputStream stream, String resourceNamethrows HibernateException {

    org.dom4j.Document doc;
    try {
      List errors = new ArrayList();
      doc = xmlHelper.createSAXReaderresourceName, errors, entityResolver )
          .readnew InputSourcestream ) );
      if errors.size() != ) {
        throw new MappingException(
            "invalid configuration",
            (Throwableerrors.get)
          );
      }
    }
    catch (DocumentException e) {
      throw new HibernateException(
          "Could not parse configuration: " + resourceName,
          e
        );
    }
    finally {
      try {
        stream.close();
      }
      catch (IOException ioe) {
        log.warn"could not close input stream for: " + resourceName, ioe );
      }
    }

    return doConfiguredoc );

  }

  /**
   * Use the mappings and properties specified in the given XML document.
   * The format of the file is defined in
   <tt>hibernate-configuration-3.0.dtd</tt>.
   *
   @param document an XML document from which you wish to load the configuration
   @return A configuration configured via the <tt>Document</tt>
   @throws HibernateException if there is problem in accessing the file.
   */
  public Configuration configure(Document documentthrows HibernateException {
    log.info"configuring from XML document" );
    return doConfigurexmlHelper.createDOMReader().readdocument ) );
  }

  protected Configuration doConfigure(org.dom4j.Document docthrows HibernateException {

    Element sfNode = doc.getRootElement().element"session-factory" );
    String name = sfNode.attributeValue"name" );
    if name != null ) {
      properties.setPropertyEnvironment.SESSION_FACTORY_NAME, name );
    }
    addPropertiessfNode );
    parseSessionFactorysfNode, name );

    Element secNode = doc.getRootElement().element"security" );
    if secNode != null ) {
      parseSecuritysecNode );
    }

    log.info"Configured SessionFactory: " + name );
    log.debug"properties: " + properties );

    return this;

  }


  private void parseSessionFactory(Element sfNode, String name) {
    Iterator elements = sfNode.elementIterator();
    while elements.hasNext() ) {
      Element subelement = (Elementelements.next();
      String subelementName = subelement.getName();
      if "mapping".equalssubelementName ) ) {
        parseMappingElementsubelement, name );
      }
      else if "class-cache".equalssubelementName ) ) {
        String className = subelement.attributeValue"class" );
        Attribute regionNode = subelement.attribute"region" );
        final String region = regionNode == null ? className : regionNode.getValue();
        boolean includeLazy = !"non-lazy".equalssubelement.attributeValue"include" ) );
        setCacheConcurrencyStrategyclassName, subelement.attributeValue"usage" ), region, includeLazy );
      }
      else if "collection-cache".equalssubelementName ) ) {
        String role = subelement.attributeValue"collection" );
        Attribute regionNode = subelement.attribute"region" );
        final String region = regionNode == null ? role : regionNode.getValue();
        setCollectionCacheConcurrencyStrategyrole, subelement.attributeValue"usage" ), region );
      }
      else if "listener".equalssubelementName ) ) {
        parseListenersubelement );
      }
      else if "event".equalssubelementName ) ) {
        parseEventsubelement );
      }
    }
  }

  protected void parseMappingElement(Element subelement, String name) {
    Attribute rsrc = subelement.attribute"resource" );
    Attribute file = subelement.attribute"file" );
    Attribute jar = subelement.attribute"jar" );
    Attribute pkg = subelement.attribute"package" );
    Attribute clazz = subelement.attribute"class" );
    if rsrc != null ) {
      log.debugname + "<-" + rsrc );
      addResourcersrc.getValue() );
    }
    else if jar != null ) {
      log.debugname + "<-" + jar );
      addJarnew Filejar.getValue() ) );
    }
    else if pkg != null ) {
      throw new MappingException(
          "An AnnotationConfiguration instance is required to use <mapping package=\"" +
          pkg.getValue() "\"/>"
        );
    }
    else if clazz != null ) {
      throw new MappingException(
          "An AnnotationConfiguration instance is required to use <mapping class=\"" +
          clazz.getValue() "\"/>"
        );
    }
    else {
      if file == null ) {
        throw new MappingException(
            "<mapping> element in configuration specifies no attributes"
          );
      }
      log.debugname + "<-" + file );
      addFilefile.getValue() );
    }
  }

  private void parseSecurity(Element secNode) {
    String contextId = secNode.attributeValue"context" );
      setProperty(Environment.JACC_CONTEXTID, contextId);
    log.info"JACC contextID: " + contextId );
    JACCConfiguration jcfg = new JACCConfigurationcontextId );
    Iterator grantElements = secNode.elementIterator();
    while grantElements.hasNext() ) {
      Element grantElement = (ElementgrantElements.next();
      String elementName = grantElement.getName();
      if "grant".equalselementName ) ) {
        jcfg.addPermission(
            grantElement.attributeValue"role" ),
            grantElement.attributeValue"entity-name" ),
            grantElement.attributeValue"actions" )
          );
      }
    }
  }

  private void parseEvent(Element element) {
    String type = element.attributeValue"type" );
    List listeners = element.elements();
    String[] listenerClasses = new Stringlisteners.size() ];
    for int i = 0; i < listeners.size() ; i++ ) {
      listenerClasses[i( (Elementlisteners.get) ).attributeValue"class" );
    }
    log.debug"Event listeners: " + type + "=" + StringHelper.toStringlistenerClasses ) );
    setListenerstype, listenerClasses );
  }

  private void parseListener(Element element) {
    String type = element.attributeValue"type" );
    if type == null ) {
      throw new MappingException"No type specified for listener" );
    }
    String impl = element.attributeValue"class" );
    log.debug"Event listener: " + type + "=" + impl );
    setListenerstype, new String[]{impl} );
  }

  public void setListener(String type, String listener) {
    String[] listeners = null;
    if listener != null ) {
      listeners = (String[]) Array.newInstanceString.class, );
      listeners[0= listener;
    }
    setListenerstype, listeners );
  }

  public void setListeners(String type, String[] listenerClasses) {
    Object[] listeners = null;
    if listenerClasses != null ) {
      listeners = (Object[]) Array.newInstanceeventListeners.getListenerClassFor(type), listenerClasses.length );
      for int i = 0; i < listeners.length ; i++ ) {
        try {
          listeners[i= ReflectHelper.classForNamelistenerClasses[i] ).newInstance();
        }
        catch (Exception e) {
          throw new MappingException(
              "Unable to instantiate specified event (" + type + ") listener class: " + listenerClasses[i],
              e
            );
        }
      }
    }
    setListenerstype, listeners );
  }

  public void setListener(String type, Object listener) {
    Object[] listeners = null;
    if listener != null ) {
      listeners = (Object[]) Array.newInstanceeventListeners.getListenerClassFor(type));
      listeners[0= listener;
    }
    setListenerstype, listeners );
  }

  public void setListeners(String type, Object[] listeners) {
    if "auto-flush".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setAutoFlushEventListenersnew AutoFlushEventListener[]{} );
      }
      else {
        eventListeners.setAutoFlushEventListeners( (AutoFlushEventListener[]) listeners );
      }
    }
    else if "merge".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setMergeEventListenersnew MergeEventListener[]{} );
      }
      else {
        eventListeners.setMergeEventListeners( (MergeEventListener[]) listeners );
      }
    }
    else if "create".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPersistEventListenersnew PersistEventListener[]{} );
      }
      else {
        eventListeners.setPersistEventListeners( (PersistEventListener[]) listeners );
      }
    }
    else if "create-onflush".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPersistOnFlushEventListenersnew PersistEventListener[]{} );
      }
      else {
        eventListeners.setPersistOnFlushEventListeners( (PersistEventListener[]) listeners );
      }
    }
    else if "delete".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setDeleteEventListenersnew DeleteEventListener[]{} );
      }
      else {
        eventListeners.setDeleteEventListeners( (DeleteEventListener[]) listeners );
      }
    }
    else if "dirty-check".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setDirtyCheckEventListenersnew DirtyCheckEventListener[]{} );
      }
      else {
        eventListeners.setDirtyCheckEventListeners( (DirtyCheckEventListener[]) listeners );
      }
    }
    else if "evict".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setEvictEventListenersnew EvictEventListener[]{} );
      }
      else {
        eventListeners.setEvictEventListeners( (EvictEventListener[]) listeners );
      }
    }
    else if "flush".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setFlushEventListenersnew FlushEventListener[]{} );
      }
      else {
        eventListeners.setFlushEventListeners( (FlushEventListener[]) listeners );
      }
    }
    else if "flush-entity".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setFlushEntityEventListenersnew FlushEntityEventListener[]{} );
      }
      else {
        eventListeners.setFlushEntityEventListeners( (FlushEntityEventListener[]) listeners );
      }
    }
    else if "load".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setLoadEventListenersnew LoadEventListener[]{} );
      }
      else {
        eventListeners.setLoadEventListeners( (LoadEventListener[]) listeners );
      }
    }
    else if "load-collection".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setInitializeCollectionEventListeners(
            new InitializeCollectionEventListener[]{}
          );
      }
      else {
        eventListeners.setInitializeCollectionEventListeners(
            (InitializeCollectionEventListener[]) listeners
          );
      }
    }
    else if "lock".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setLockEventListenersnew LockEventListener[]{} );
      }
      else {
        eventListeners.setLockEventListeners( (LockEventListener[]) listeners );
      }
    }
    else if "refresh".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setRefreshEventListenersnew RefreshEventListener[]{} );
      }
      else {
        eventListeners.setRefreshEventListeners( (RefreshEventListener[]) listeners );
      }
    }
    else if "replicate".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setReplicateEventListenersnew ReplicateEventListener[]{} );
      }
      else {
        eventListeners.setReplicateEventListeners( (ReplicateEventListener[]) listeners );
      }
    }
    else if "save-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setSaveOrUpdateEventListenersnew SaveOrUpdateEventListener[]{} );
      }
      else {
        eventListeners.setSaveOrUpdateEventListeners( (SaveOrUpdateEventListener[]) listeners );
      }
    }
    else if "save".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setSaveEventListenersnew SaveOrUpdateEventListener[]{} );
      }
      else {
        eventListeners.setSaveEventListeners( (SaveOrUpdateEventListener[]) listeners );
      }
    }
    else if "update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setUpdateEventListenersnew SaveOrUpdateEventListener[]{} );
      }
      else {
        eventListeners.setUpdateEventListeners( (SaveOrUpdateEventListener[]) listeners );
      }
    }
    else if "pre-load".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreLoadEventListenersnew PreLoadEventListener[]{} );
      }
      else {
        eventListeners.setPreLoadEventListeners( (PreLoadEventListener[]) listeners );
      }
    }
    else if "pre-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreUpdateEventListenersnew PreUpdateEventListener[]{} );
      }
      else {
        eventListeners.setPreUpdateEventListeners( (PreUpdateEventListener[]) listeners );
      }
    }
    else if "pre-delete".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreDeleteEventListenersnew PreDeleteEventListener[]{} );
      }
      else {
        eventListeners.setPreDeleteEventListeners( (PreDeleteEventListener[]) listeners );
      }
    }
    else if "pre-insert".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreInsertEventListenersnew PreInsertEventListener[]{} );
      }
      else {
        eventListeners.setPreInsertEventListeners( (PreInsertEventListener[]) listeners );
      }
    }
    else if "pre-collection-recreate".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreCollectionRecreateEventListenersnew PreCollectionRecreateEventListener[]{} );
      }
      else {
        eventListeners.setPreCollectionRecreateEventListeners( (PreCollectionRecreateEventListener[]) listeners );
      }
    }
    else if "pre-collection-remove".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreCollectionRemoveEventListenersnew PreCollectionRemoveEventListener[]{} );
      }
      else {
        eventListeners.setPreCollectionRemoveEventListeners( ( PreCollectionRemoveEventListener[]) listeners );
      }
    }
    else if "pre-collection-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPreCollectionUpdateEventListenersnew PreCollectionUpdateEventListener[]{} );
      }
      else {
        eventListeners.setPreCollectionUpdateEventListeners( ( PreCollectionUpdateEventListener[]) listeners );
      }
    }
    else if "post-load".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostLoadEventListenersnew PostLoadEventListener[]{} );
      }
      else {
        eventListeners.setPostLoadEventListeners( (PostLoadEventListener[]) listeners );
      }
    }
    else if "post-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostUpdateEventListenersnew PostUpdateEventListener[]{} );
      }
      else {
        eventListeners.setPostUpdateEventListeners( (PostUpdateEventListener[]) listeners );
      }
    }
    else if "post-delete".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostDeleteEventListenersnew PostDeleteEventListener[]{} );
      }
      else {
        eventListeners.setPostDeleteEventListeners( (PostDeleteEventListener[]) listeners );
      }
    }
    else if "post-insert".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostInsertEventListenersnew PostInsertEventListener[]{} );
      }
      else {
        eventListeners.setPostInsertEventListeners( (PostInsertEventListener[]) listeners );
      }
    }
    else if "post-commit-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCommitUpdateEventListeners(
            new PostUpdateEventListener[]{}
          );
      }
      else {
        eventListeners.setPostCommitUpdateEventListeners( (PostUpdateEventListener[]) listeners );
      }
    }
    else if "post-commit-delete".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCommitDeleteEventListeners(
            new PostDeleteEventListener[]{}
          );
      }
      else {
        eventListeners.setPostCommitDeleteEventListeners( (PostDeleteEventListener[]) listeners );
      }
    }
    else if "post-commit-insert".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCommitInsertEventListeners(
            new PostInsertEventListener[]{}
        );
      }
      else {
        eventListeners.setPostCommitInsertEventListeners( (PostInsertEventListener[]) listeners );
      }
    }
    else if "post-collection-recreate".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCollectionRecreateEventListenersnew PostCollectionRecreateEventListener[]{} );
      }
      else {
        eventListeners.setPostCollectionRecreateEventListeners( (PostCollectionRecreateEventListener[]) listeners );
      }
    }
    else if "post-collection-remove".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCollectionRemoveEventListenersnew PostCollectionRemoveEventListener[]{} );
      }
      else {
        eventListeners.setPostCollectionRemoveEventListeners( ( PostCollectionRemoveEventListener[]) listeners );
      }
    }
    else if "post-collection-update".equalstype ) ) {
      if listeners == null ) {
        eventListeners.setPostCollectionUpdateEventListenersnew PostCollectionUpdateEventListener[]{} );
      }
      else {
        eventListeners.setPostCollectionUpdateEventListeners( ( PostCollectionUpdateEventListener[]) listeners );
      }
    }
    else {
      throw new MappingException("Unrecognized listener type [" + type + "]");
    }
  }

  public EventListeners getEventListeners() {
    return eventListeners;
  }

  RootClass getRootClassMapping(String clazzthrows MappingException {
    try {
      return (RootClassgetClassMappingclazz );
    }
    catch (ClassCastException cce) {
      throw new MappingException"You may only specify a cache for root <class> mappings" );
    }
  }

  /**
   * Set up a cache for an entity class
   *
   @param clazz
   @param concurrencyStrategy
   @return Configuration
   @throws MappingException
   */
  public Configuration setCacheConcurrencyStrategy(String clazz, String concurrencyStrategy)
      throws MappingException {
    setCacheConcurrencyStrategyclazz, concurrencyStrategy, clazz );
    return this;
  }

  public void setCacheConcurrencyStrategy(String clazz, String concurrencyStrategy, String region)
      throws MappingException {
    setCacheConcurrencyStrategyclazz, concurrencyStrategy, region, true );
  }

  void setCacheConcurrencyStrategy(String clazz, String concurrencyStrategy, String region, boolean includeLazy)
      throws MappingException {
    RootClass rootClass = getRootClassMappingclazz );
    if rootClass == null ) {
      throw new MappingException"Cannot cache an unknown entity: " + clazz );
    }
    rootClass.setCacheConcurrencyStrategyconcurrencyStrategy );
    rootClass.setCacheRegionNameregion );
    rootClass.setLazyPropertiesCacheableincludeLazy );
  }

  /**
   * Set up a cache for a collection role
   *
   @param collectionRole
   @param concurrencyStrategy
   @return Configuration
   @throws MappingException
   */
  public Configuration setCollectionCacheConcurrencyStrategy(String collectionRole, String concurrencyStrategy)
      throws MappingException {
    setCollectionCacheConcurrencyStrategycollectionRole, concurrencyStrategy, collectionRole );
    return this;
  }

  public void setCollectionCacheConcurrencyStrategy(String collectionRole, String concurrencyStrategy, String region)
      throws MappingException {
    Collection collection = getCollectionMappingcollectionRole );
    if collection == null ) {
      throw new MappingException"Cannot cache an unknown collection: " + collectionRole );
    }
    collection.setCacheConcurrencyStrategyconcurrencyStrategy );
    collection.setCacheRegionNameregion );
  }

  /**
   * Get the query language imports
   *
   @return a mapping from "import" names to fully qualified class names
   */
  public Map getImports() {
    return imports;
  }

  /**
   * Create an object-oriented view of the configuration properties
   */
  public Settings buildSettings() throws HibernateException {
    Properties clone = Properties properties.clone();
    PropertiesHelper.resolvePlaceHoldersclone );
    return buildSettingsInternalclone );
  }

  public Settings buildSettings(Properties propsthrows HibernateException {
    return buildSettingsInternalprops );
  }

  private Settings buildSettingsInternal(Properties props) {
    final Settings settings = settingsFactory.buildSettingsprops );
    settings.setEntityTuplizerFactorythis.getEntityTuplizerFactory() );
//    settings.setComponentTuplizerFactory( this.getComponentTuplizerFactory() );
    return settings;
  }

  public Map getNamedSQLQueries() {
    return namedSqlQueries;
  }

  public Map getSqlResultSetMappings() {
    return sqlResultSetMappings;
  }

  /**
   @return the NamingStrategy.
   */
  public NamingStrategy getNamingStrategy() {
    return namingStrategy;
  }

  /**
   * Set a custom naming strategy
   *
   @param namingStrategy the NamingStrategy to set
   */
  public Configuration setNamingStrategy(NamingStrategy namingStrategy) {
    this.namingStrategy = namingStrategy;
    return this;
  }

  public Mapping buildMapping() {
    return new Mapping() {
      /**
       * Returns the identifier type of a mapped class
       */
      public Type getIdentifierType(String persistentClassthrows MappingException {
        PersistentClass pc = ( (PersistentClassclasses.getpersistentClass ) );
        if pc == null ) {
          throw new MappingException"persistent class not known: " + persistentClass );
        }
        return pc.getIdentifier().getType();
      }

      public String getIdentifierPropertyName(String persistentClassthrows MappingException {
        final PersistentClass pc = (PersistentClassclasses.getpersistentClass );
        if pc == null ) {
          throw new MappingException"persistent class not known: " + persistentClass );
        }
        if !pc.hasIdentifierProperty() ) {
          return null;
        }
        return pc.getIdentifierProperty().getName();
      }

      public Type getReferencedPropertyType(String persistentClass, String propertyNamethrows MappingException {
        final PersistentClass pc = (PersistentClassclasses.getpersistentClass );
        if pc == null ) {
          throw new MappingException"persistent class not known: " + persistentClass );
        }
        Property prop = pc.getReferencedPropertypropertyName );
        if prop == null ) {
          throw new MappingException(
              "property not known: " 
              persistentClass + '.' + propertyName
            );
        }
        return prop.getType();
      }
    };
  }

  private void readObject(ObjectInputStream oisthrows IOException, ClassNotFoundException {
    ois.defaultReadObject();
    this.mapping = buildMapping();
    xmlHelper = new XMLHelper();
  }

  public Map getFilterDefinitions() {
    return filterDefinitions;
  }

  public void addFilterDefinition(FilterDefinition definition) {
    filterDefinitions.putdefinition.getFilterName(), definition );
  }

  public void addAuxiliaryDatabaseObject(AuxiliaryDatabaseObject object) {
    auxiliaryDatabaseObjects.addobject );
  }

  public Map getSqlFunctions() {
    return sqlFunctions;
  }
  
  public void addSqlFunction(String functionName, SQLFunction function) {
    sqlFunctions.putfunctionName, function );
  }
}