Merge from HEAD to WCM-DEV2.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/BRANCHES/WCM-DEV2/root@3659 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/repo/domain/NodeStatus.java

@@ -41,9 +41,9 @@ public interface NodeStatus
     
     public void setNode(Node node);
     
-    public String getChangeTxnId();
+    public Transaction getTransaction();
     
-    public void setChangeTxnId(String txnId);
+    public void setTransaction(Transaction transaction);
     
     public boolean isDeleted();
 }

source/java/org/alfresco/repo/domain/Server.java

@@ -0,0 +1,33 @@
+/*
+ * Copyright (C) 2006 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+package org.alfresco.repo.domain;
+
+/**
+ * Interface for persistent <b>server</b> objects.  These persist
+ * details of the servers that have committed transactions to the
+ * database, for instance.
+ * 
+ * @author Derek Hulley
+ */
+public interface Server
+{
+    public Long getId();
+    
+    public String getIpAddress();
+    
+    public void setIpAddress(String ipAddress);
+}

source/java/org/alfresco/repo/domain/Transaction.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright (C) 2006 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+package org.alfresco.repo.domain;
+
+/**
+ * Interface for persistent <b>transaction</b> objects.
+ * 
+ * @author Derek Hulley
+ */
+public interface Transaction
+{
+    public Long getId();
+    
+    public String getChangeTxnId();
+    
+    public void setChangeTxnId(String changeTxnId);
+    
+    public Server getServer();
+    
+    public void setServer(Server server);
+}

source/java/org/alfresco/repo/domain/hibernate/HibernateNodeTest.java

@@ -31,8 +31,10 @@ import org.alfresco.repo.domain.Node;
 import org.alfresco.repo.domain.NodeKey;
 import org.alfresco.repo.domain.NodeStatus;
 import org.alfresco.repo.domain.PropertyValue;
+import org.alfresco.repo.domain.Server;
 import org.alfresco.repo.domain.Store;
 import org.alfresco.repo.domain.StoreKey;
+import org.alfresco.repo.domain.Transaction;
 import org.alfresco.repo.transaction.AlfrescoTransactionSupport;
 import org.alfresco.service.cmr.dictionary.DataTypeDefinition;
 import org.alfresco.service.cmr.repository.StoreRef;
@@ -53,8 +55,11 @@ import org.hibernate.exception.ConstraintViolationException;
 public class HibernateNodeTest extends BaseSpringTest
 {
     private static final String TEST_NAMESPACE = "http://www.alfresco.org/test/HibernateNodeTest";
+    private static int i = 0;
     
     private Store store;
+    private Server server;
+    private Transaction transaction;
     
     public HibernateNodeTest()
     {
@@ -68,6 +73,18 @@ public class HibernateNodeTest extends BaseSpringTest
 		store.setKey(storeKey);
         // persist so that it is present in the hibernate cache
         getSession().save(store);
+        
+        server = (Server) getSession().get(ServerImpl.class, new Long(1));
+        if (server == null)
+        {
+            server = new ServerImpl();
+            server.setIpAddress("" + "i_" + System.currentTimeMillis());
+            getSession().save(server);
+        }
+        transaction = new TransactionImpl();
+        transaction.setServer(server);
+        transaction.setChangeTxnId(AlfrescoTransactionSupport.getTransactionId());
+        getSession().save(transaction);
     }
     
     protected void onTearDownInTransaction()
@@ -108,7 +125,7 @@ public class HibernateNodeTest extends BaseSpringTest
         // create the node status
         NodeStatus nodeStatus = new NodeStatusImpl();
         nodeStatus.setKey(key);
-        nodeStatus.setChangeTxnId("txn:123");
+        nodeStatus.setTransaction(transaction);
         getSession().save(nodeStatus);
         
         // create a new Node
@@ -131,7 +148,7 @@ public class HibernateNodeTest extends BaseSpringTest
         node = nodeStatus.getNode();
         assertNotNull("Node was not attached to status", node);
         // change the values
-        nodeStatus.setChangeTxnId("txn:456");
+        transaction.setChangeTxnId("txn:456");
         // delete the node
         getSession().delete(node);
         
@@ -351,7 +368,7 @@ public class HibernateNodeTest extends BaseSpringTest
         NodeStatus containerNodeStatus = new NodeStatusImpl();
         containerNodeStatus.setKey(containerNodeKey);
         containerNodeStatus.setNode(containerNode);
-        containerNodeStatus.setChangeTxnId(AlfrescoTransactionSupport.getTransactionId());
+        containerNodeStatus.setTransaction(transaction);
         getSession().save(containerNodeStatus);
         // make content node 1
         Node contentNode1 = new NodeImpl();
@@ -366,7 +383,7 @@ public class HibernateNodeTest extends BaseSpringTest
         NodeStatus contentNodeStatus1 = new NodeStatusImpl();
         contentNodeStatus1.setKey(contentNodeKey1);
         contentNodeStatus1.setNode(contentNode1);
-        contentNodeStatus1.setChangeTxnId(AlfrescoTransactionSupport.getTransactionId());
+        contentNodeStatus1.setTransaction(transaction);
         getSession().save(contentNodeStatus1);
         // make content node 2
         Node contentNode2 = new NodeImpl();
@@ -381,7 +398,7 @@ public class HibernateNodeTest extends BaseSpringTest
         NodeStatus contentNodeStatus2 = new NodeStatusImpl();
         contentNodeStatus2.setKey(contentNodeKey2);
         contentNodeStatus2.setNode(contentNode2);
-        contentNodeStatus2.setChangeTxnId(AlfrescoTransactionSupport.getTransactionId());
+        contentNodeStatus2.setTransaction(transaction);
         getSession().save(contentNodeStatus2);
         // create an association to content 1
         ChildAssoc assoc1 = new ChildAssocImpl();

source/java/org/alfresco/repo/domain/hibernate/Node.hbm.xml

@@ -113,6 +113,16 @@
          <key-property name="identifier" length="100" />
          <key-property name="guid" length="36" />
       </composite-id>
+      <!-- forward assoc to transaction -->
+      <many-to-one
+            name="transaction"
+            class="org.alfresco.repo.domain.hibernate.TransactionImpl"
+            column="transaction_id"
+            lazy="proxy"
+            fetch="select"
+            unique="false"
+            not-null="true"
+            cascade="none" />
       <!-- forward assoc to node (optional) -->
       <many-to-one
             name="node"
@@ -122,7 +132,6 @@
             fetch="join"
             unique="false"
             not-null="false" />
-      <property name="changeTxnId" column="change_txn_id" type="string" length="56" not-null="true" index="CHANGE_TXN_ID"/>
    </class>
    
    <class
@@ -137,33 +146,31 @@
       <id name="id" column="id" type="long" >
          <generator class="native" />
       </id>
-      <natural-id mutable="true">
-         <!-- forward assoc to parent node -->
-         <many-to-one 
-               name="parent"
-               class="org.alfresco.repo.domain.hibernate.NodeImpl"
-               lazy="proxy"
-               fetch="select"
-               optimistic-lock="true"
-               not-null="true"
-               unique-key="UIDX_CHILD_NAME" >
-            <column name="parent_node_id" />
-         </many-to-one>
-         <!-- forward assoc to child node -->
-         <many-to-one
-               name="child" 
-               lazy="proxy"
-               fetch="select"
-               class="org.alfresco.repo.domain.hibernate.NodeImpl"
-               optimistic-lock="true"
-               not-null="true" >
-            <column name="child_node_id" />
-         </many-to-one>
-         <property name="typeQName" column="type_qname" type="QName" length="255" not-null="true" unique-key="UIDX_CHILD_NAME" />
-      </natural-id>
+      <!-- forward assoc to parent node -->
+      <many-to-one 
+            name="parent"
+            class="org.alfresco.repo.domain.hibernate.NodeImpl"
+            lazy="proxy"
+            fetch="select"
+            optimistic-lock="true"
+            not-null="true"
+            unique-key="UIDX_CHILD_NAME" >
+         <column name="parent_node_id" />
+      </many-to-one>
+      <!-- forward assoc to child node -->
+      <many-to-one
+            name="child" 
+            lazy="proxy"
+            fetch="select"
+            class="org.alfresco.repo.domain.hibernate.NodeImpl"
+            optimistic-lock="true"
+            not-null="true" >
+         <column name="child_node_id" />
+      </many-to-one>
+      <property name="typeQName" column="type_qname" type="QName" length="255" not-null="true" unique-key="UIDX_CHILD_NAME" />
+      <property name="qname" column="qname" type="QName" length="255" not-null="true" />
       <property name="childNodeName" column="child_node_name" type="string" length="50" not-null="true" unique-key="UIDX_CHILD_NAME" />
       <property name="childNodeNameCrc" column="child_node_name_crc" type="long" not-null="true" unique-key="UIDX_CHILD_NAME" />
-      <property name="qname" column="qname" type="QName" length="255" not-null="true" />
       <property name="isPrimary" column="is_primary" />
       <property name="index" column="assoc_index" />
    </class>
@@ -309,25 +316,26 @@
    
    <query name="node.GetNextChangeTxnIds">
       select distinct
-         status.changeTxnId
+         transaction.changeTxnId
       from
-         org.alfresco.repo.domain.hibernate.NodeStatusImpl as status
+         org.alfresco.repo.domain.hibernate.TransactionImpl as transaction
       where
-         status.changeTxnId > :currentTxnId
+         transaction.changeTxnId > :currentTxnId
       order by
-         status.changeTxnId
+         transaction.changeTxnId
    </query>
 
    <query name="node.GetChangedNodeStatusesCount">
       select
-         count(status.changeTxnId)
+         count(transaction.changeTxnId)
       from
          org.alfresco.repo.domain.hibernate.NodeStatusImpl as status
+         join status.transaction as transaction
       where
          status.key.protocol = :storeProtocol and
          status.key.identifier = :storeIdentifier and
          status.node.id is not null and
-         status.changeTxnId = :changeTxnId
+         transaction.changeTxnId = :changeTxnId
    </query>
 
    <query name="node.GetChangedNodeStatuses">
@@ -335,11 +343,12 @@
          status
       from
          org.alfresco.repo.domain.hibernate.NodeStatusImpl as status
+         join status.transaction as transaction
       where
          status.key.protocol = :storeProtocol and
          status.key.identifier = :storeIdentifier and
          status.node.id is not null and
-         status.changeTxnId = :changeTxnId
+         transaction.changeTxnId = :changeTxnId
    </query>
 
    <query name="node.GetDeletedNodeStatuses">
@@ -347,11 +356,12 @@
          status
       from
          org.alfresco.repo.domain.hibernate.NodeStatusImpl as status
+         join status.transaction as transaction
       where
          status.key.protocol = :storeProtocol and
          status.key.identifier = :storeIdentifier and
          status.node.id is null and
-         status.changeTxnId = :changeTxnId
+         transaction.changeTxnId = :changeTxnId
    </query>
 
    <query name="node.GetContentDataStrings">

source/java/org/alfresco/repo/domain/hibernate/NodeStatusImpl.java

@@ -21,6 +21,7 @@ import java.io.Serializable;
 import org.alfresco.repo.domain.Node;
 import org.alfresco.repo.domain.NodeKey;
 import org.alfresco.repo.domain.NodeStatus;
+import org.alfresco.repo.domain.Transaction;
 import org.alfresco.util.EqualsHelper;
 
 /**
@@ -34,15 +35,16 @@ public class NodeStatusImpl implements NodeStatus, Serializable
 
     private NodeKey key;
     private Node node;
-    private String changeTxnId;
+    private Transaction transaction;
     
+    @Override
     public String toString()
     {
         StringBuilder sb = new StringBuilder(50);
         sb.append("NodeStatus")
           .append("[key=").append(key)
           .append(", node=").append(node == null ? null : node.getNodeRef())
-          .append(", txn=").append(changeTxnId)
+          .append(", txn=").append(transaction)
           .append("]");
         return sb.toString();
     }
@@ -85,14 +87,14 @@ public class NodeStatusImpl implements NodeStatus, Serializable
         this.node = node;
     }
 
-    public String getChangeTxnId()
+    public Transaction getTransaction()
     {
-        return changeTxnId;
+        return transaction;
     }
 
-    public void setChangeTxnId(String txnId)
+    public void setTransaction(Transaction transaction)
     {
-        this.changeTxnId = txnId;
+        this.transaction = transaction;
     }
 
     public boolean isDeleted()

source/java/org/alfresco/repo/domain/hibernate/ServerImpl.java

@@ -0,0 +1,76 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+package org.alfresco.repo.domain.hibernate;
+
+import java.io.Serializable;
+
+import org.alfresco.repo.domain.Server;
+
+/**
+ * Bean containing all the persistence data representing a <b>Server</b>.
+ * <p>
+ * This implementation of the {@link org.alfresco.repo.domain.Service Service} interface is
+ * Hibernate specific.
+ * 
+ * @author Derek Hulley
+ */
+public class ServerImpl extends LifecycleAdapter implements Server, Serializable
+{
+    private static final long serialVersionUID = 8063452519040344479L;
+
+    private Long id;
+    private String ipAddress;
+    
+    public ServerImpl()
+    {
+    }
+
+    @Override
+    public String toString()
+    {
+        StringBuilder sb = new StringBuilder(50);
+        sb.append("Server")
+          .append("[id=").append(id)
+          .append(", ipAddress=").append(ipAddress)
+          .append("]");
+        return sb.toString();
+    }
+    
+    public Long getId()
+    {
+        return id;
+    }
+
+    /**
+     * For Hibernate use
+     */
+    @SuppressWarnings("unused")
+    private void setId(Long id)
+    {
+        this.id = id;
+    }
+
+    public String getIpAddress()
+    {
+        return ipAddress;
+    }
+
+    public void setIpAddress(String ipAddress)
+    {
+        this.ipAddress = ipAddress;
+    }
+}

source/java/org/alfresco/repo/domain/hibernate/Transaction.hbm.xml

@@ -0,0 +1,62 @@
+<?xml version='1.0' encoding='UTF-8'?>
+
+<!DOCTYPE hibernate-mapping PUBLIC
+    '-//Hibernate/Hibernate Mapping DTD 3.0//EN' 
+    'http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd'>
+
+<hibernate-mapping>
+
+   <class
+         name="org.alfresco.repo.domain.hibernate.TransactionImpl"
+         proxy="org.alfresco.repo.domain.Transaction"
+         table="alf_transaction"
+         dynamic-update="false"
+         dynamic-insert="false"
+         select-before-update="false" 
+         lazy="true" 
+         optimistic-lock="version"  >
+      <!-- auto-generated ID -->
+      <id name="id" column="id" type="long" >
+         <generator class="native" />
+      </id>
+      <!-- forward assoc to server IP -->
+      <many-to-one
+            name="server"
+            class="org.alfresco.repo.domain.hibernate.ServerImpl"
+            column="server_id"
+            lazy="proxy"
+            fetch="select"
+            unique="false"
+            not-null="false"
+            cascade="none" />
+      <property name="changeTxnId" column="change_txn_id" type="string" length="56" not-null="true" index="CHANGE_TXN_ID"/>
+   </class>
+
+   <class
+         name="org.alfresco.repo.domain.hibernate.ServerImpl"
+         proxy="org.alfresco.repo.domain.Server"
+         table="alf_server"
+         dynamic-update="false"
+         dynamic-insert="false"
+         select-before-update="false" 
+         lazy="true" 
+         optimistic-lock="version"  >
+      <!-- auto-generated ID -->
+      <id name="id" column="id" type="long" >
+         <generator class="native" />
+      </id>
+      <natural-id>
+         <property name="ipAddress" column="ip_address" type="string" length="15" not-null="true" />
+      </natural-id>
+   </class>
+
+   <query name="server.getServerByIpAddress">
+      select
+         server
+      from
+         org.alfresco.repo.domain.hibernate.ServerImpl as server
+      where
+         server.ipAddress = :ipAddress
+   </query>
+
+</hibernate-mapping>

source/java/org/alfresco/repo/domain/hibernate/TransactionImpl.java

@@ -0,0 +1,88 @@
+/*
+ * Copyright (C) 2005 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+package org.alfresco.repo.domain.hibernate;
+
+import java.io.Serializable;
+
+import org.alfresco.repo.domain.Server;
+import org.alfresco.repo.domain.Transaction;
+
+/**
+ * Bean containing all the persistence data representing a <b>Transaction</b>.
+ * <p>
+ * This implementation of the {@link org.alfresco.repo.domain.Transaction Transaction} interface is
+ * Hibernate specific.
+ * 
+ * @author Derek Hulley
+ */
+public class TransactionImpl extends LifecycleAdapter implements Transaction, Serializable
+{
+    private static final long serialVersionUID = -8264339795578077552L;
+
+    private Long id;
+    private String changeTxnId;
+    private Server server;
+    
+    public TransactionImpl()
+    {
+    }
+
+    @Override
+    public String toString()
+    {
+        StringBuilder sb = new StringBuilder(50);
+        sb.append("Transaction")
+          .append("[id=").append(id)
+          .append(", changeTxnId=").append(changeTxnId)
+          .append("]");
+        return sb.toString();
+    }
+    
+    public Long getId()
+    {
+        return id;
+    }
+
+    /**
+     * For Hibernate use
+     */
+    @SuppressWarnings("unused")
+    private void setId(Long id)
+    {
+        this.id = id;
+    }
+
+    public String getChangeTxnId()
+    {
+        return changeTxnId;
+    }
+
+    public void setChangeTxnId(String changeTransactionId)
+    {
+        this.changeTxnId = changeTransactionId;
+    }
+
+    public Server getServer()
+    {
+        return server;
+    }
+
+    public void setServer(Server server)
+    {
+        this.server = server;
+    }
+}

source/java/org/alfresco/repo/domain/schema/SchemaBootstrap.java

@@ -0,0 +1,529 @@
+/*
+ * Copyright (C) 2006 Alfresco, Inc.
+ *
+ * Licensed under the Mozilla Public License version 1.1 
+ * with a permitted attribution clause. You may obtain a
+ * copy of the License at
+ *
+ *   http://www.alfresco.org/legal/license.txt
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+ * either express or implied. See the License for the specific
+ * language governing permissions and limitations under the
+ * License.
+ */
+package org.alfresco.repo.domain.schema;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.FileWriter;
+import java.io.InputStreamReader;
+import java.io.Writer;
+import java.sql.Connection;
+import java.sql.ResultSet;
+import java.sql.Statement;
+import java.util.ArrayList;
+import java.util.List;
+
+import org.alfresco.error.AlfrescoRuntimeException;
+import org.alfresco.i18n.I18NUtil;
+import org.alfresco.repo.admin.patch.impl.SchemaUpgradeScriptPatch;
+import org.alfresco.util.TempFileProvider;
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+import org.hibernate.Session;
+import org.hibernate.SessionFactory;
+import org.hibernate.Transaction;
+import org.hibernate.cfg.Configuration;
+import org.hibernate.dialect.Dialect;
+import org.hibernate.tool.hbm2ddl.DatabaseMetadata;
+import org.hibernate.tool.hbm2ddl.SchemaExport;
+import org.springframework.beans.BeansException;
+import org.springframework.context.ApplicationEvent;
+import org.springframework.context.ApplicationListener;
+import org.springframework.context.event.ContextRefreshedEvent;
+import org.springframework.orm.hibernate3.LocalSessionFactoryBean;
+import org.springframework.util.ResourceUtils;
+
+/**
+ * Bootstraps the schema and schema update.  The schema is considered missing if the applied patch table
+ * is not present, and the schema is considered empty if the applied patch table is empty.
+ * 
+ * @author Derek Hulley
+ */
+public class SchemaBootstrap implements ApplicationListener
+{
+    /** The placeholder for the configured <code>Dialect</code> class name: <b>${db.script.dialect}</b> */
+    private static final String PLACEHOLDER_SCRIPT_DIALECT = "\\$\\{db\\.script\\.dialect\\}";
+
+    private static final String MSG_EXECUTING_SCRIPT = "schema.update.msg.executing_script";
+    private static final String ERR_UPDATE_FAILED = "schema.update.err.update_failed";
+    private static final String ERR_VALIDATION_FAILED = "schema.update.err.validation_failed";
+    private static final String ERR_SCRIPT_NOT_RUN = "schema.update.err.update_script_not_run";
+    private static final String ERR_SCRIPT_NOT_FOUND = "schema.update.err.script_not_found";
+    private static final String ERR_STATEMENT_TERMINATOR = "schema.update.err.statement_terminator";
+    
+    private static Log logger = LogFactory.getLog(SchemaBootstrap.class);
+    
+    private LocalSessionFactoryBean localSessionFactory;
+    private String schemaOuputFilename;
+    private boolean updateSchema;
+    private List<String> postCreateScriptUrls;
+    private List<SchemaUpgradeScriptPatch> validateUpdateScriptPatches;
+    private List<SchemaUpgradeScriptPatch> applyUpdateScriptPatches;
+
+    public SchemaBootstrap()
+    {
+        postCreateScriptUrls = new ArrayList<String>(1);
+        validateUpdateScriptPatches = new ArrayList<SchemaUpgradeScriptPatch>(4);
+        applyUpdateScriptPatches = new ArrayList<SchemaUpgradeScriptPatch>(4);
+    }
+    
+    public void setLocalSessionFactory(LocalSessionFactoryBean localSessionFactory) throws BeansException
+    {
+        this.localSessionFactory = localSessionFactory;
+    }
+
+    /**
+     * Set this to output the full database creation script
+     * 
+     * @param schemaOuputFilename the name of a file to dump the schema to, or null to ignore
+     */
+    public void setSchemaOuputFilename(String schemaOuputFilename)
+    {
+        this.schemaOuputFilename = schemaOuputFilename;
+    }
+
+    /**
+     * Set whether to modify the schema or not.  Either way, the schema will be validated.
+     * 
+     * @param updateSchema true to update and validate the schema, otherwise false to just
+     *      validate the schema.  Default is <b>true</b>.
+     */
+    public void setUpdateSchema(boolean updateSchema)
+    {
+        this.updateSchema = updateSchema;
+    }
+
+    /**
+     * Set the scripts that must be executed after the schema has been created.
+     * 
+     * @param postCreateScriptUrls file URLs
+     * 
+     * @see #PLACEHOLDER_SCRIPT_DIALECT
+     */
+    public void setPostCreateScriptUrls(List<String> postUpdateScriptUrls)
+    {
+        this.postCreateScriptUrls = postUpdateScriptUrls;
+    }
+
+    /**
+     * Set the schema script patches that must have been applied.  These will not be
+     * applied to the database.  These can be used where the script <u>cannot</u> be
+     * applied automatically or where a particular upgrade path is no longer supported.
+     * For example, at version 3.0, the upgrade scripts for version 1.4 may be considered
+     * unsupported - this doesn't prevent the manual application of the scripts, though.
+     * 
+     * @param applyUpdateScriptPatches a list of schema patches to check
+     */
+    public void setValidateUpdateScriptPatches(List<SchemaUpgradeScriptPatch> scriptPatches)
+    {
+        this.validateUpdateScriptPatches = scriptPatches;
+    }
+
+    /**
+     * Set the schema script patches that may be executed during an update.
+     * 
+     * @param applyUpdateScriptPatches a list of schema patches to check
+     */
+    public void setApplyUpdateScriptPatches(List<SchemaUpgradeScriptPatch> scriptPatches)
+    {
+        this.applyUpdateScriptPatches = scriptPatches;
+    }
+
+    public void onApplicationEvent(ApplicationEvent event)
+    {
+        if (!(event instanceof ContextRefreshedEvent))
+        {
+            // only work on startup
+            return;
+        }
+
+        // do everything in a transaction
+        Session session = getLocalSessionFactory().openSession();
+        Transaction transaction = session.beginTransaction();
+        try
+        {
+            // make sure that we don't autocommit
+            Connection connection = session.connection();
+            connection.setAutoCommit(false);
+            
+            Configuration cfg = localSessionFactory.getConfiguration();
+            // dump the schema, if required
+            if (schemaOuputFilename != null)
+            {
+                File schemaOutputFile = new File(schemaOuputFilename);
+                dumpSchemaCreate(cfg, schemaOutputFile);
+            }
+            
+            // update the schema, if required
+            if (updateSchema)
+            {
+                updateSchema(cfg, session, connection);
+            }
+            
+            // verify that all patches have been applied correctly 
+            checkSchemaPatchScripts(cfg, session, connection, validateUpdateScriptPatches, false);   // check scripts
+            checkSchemaPatchScripts(cfg, session, connection, applyUpdateScriptPatches, false);      // check scripts
+
+            // all done successfully
+            transaction.commit();
+        }
+        catch (Throwable e)
+        {
+            try { transaction.rollback(); } catch (Throwable ee) {}
+            if (updateSchema)
+            {
+                throw new AlfrescoRuntimeException(ERR_UPDATE_FAILED, e);
+            }
+            else
+            {
+                throw new AlfrescoRuntimeException(ERR_VALIDATION_FAILED, e);
+            }
+        }
+    }
+    
+    private void dumpSchemaCreate(Configuration cfg, File schemaOutputFile)
+    {
+        // if the file exists, delete it
+        if (schemaOutputFile.exists())
+        {
+            schemaOutputFile.delete();
+        }
+        SchemaExport schemaExport = new SchemaExport(cfg)
+                .setFormat(true)
+                .setHaltOnError(true)
+                .setOutputFile(schemaOutputFile.getAbsolutePath())
+                .setDelimiter(";");
+        schemaExport.execute(false, false, false, true);
+    }
+    
+    private SessionFactory getLocalSessionFactory()
+    {
+        return (SessionFactory) localSessionFactory.getObject();
+    }
+    
+    /**
+     * @return Returns the number of applied patches
+     */
+    private int countAppliedPatches(Connection connection) throws Exception
+    {
+        Statement stmt = connection.createStatement();
+        try
+        {
+            ResultSet rs = stmt.executeQuery("select count(id) from alf_applied_patch");
+            rs.next();
+            int count = rs.getInt(1);
+            return count;
+        }
+        catch (Throwable e)
+        {
+            // we'll try another table name
+        }
+        finally
+        {
+            try { stmt.close(); } catch (Throwable e) {}
+        }
+        // for pre-1.4 databases, the table was named differently
+        stmt = connection.createStatement();
+        try
+        {
+            ResultSet rs = stmt.executeQuery("select count(id) from applied_patch");
+            rs.next();
+            int count = rs.getInt(1);
+            return count;
+        }
+        finally
+        {
+            try { stmt.close(); } catch (Throwable e) {}
+        }
+    }
+    
+    /**
+     * @return Returns the number of applied patches
+     */
+    private boolean didPatchSucceed(Connection connection, String patchId) throws Exception
+    {
+        Statement stmt = connection.createStatement();
+        try
+        {
+            ResultSet rs = stmt.executeQuery("select succeeded from alf_applied_patch where id = '" + patchId + "'");
+            if (!rs.next())
+            {
+                return false;
+            }
+            boolean succeeded = rs.getBoolean(1);
+            return succeeded;
+        }
+        catch (Throwable e)
+        {
+            // we'll try another table name
+        }
+        finally
+        {
+            try { stmt.close(); } catch (Throwable e) {}
+        }
+        // for pre-1.4 databases, the table was named differently
+        stmt = connection.createStatement();
+        try
+        {
+            ResultSet rs = stmt.executeQuery("select succeeded from applied_patch where id = '" + patchId + "'");
+            if (!rs.next())
+            {
+                return false;
+            }
+            boolean succeeded = rs.getBoolean(1);
+            return succeeded;
+        }
+        finally
+        {
+            try { stmt.close(); } catch (Throwable e) {}
+        }
+    }
+    
+    /**
+     * Builds the schema from scratch or applies the necessary patches to the schema.
+     */
+    private void updateSchema(Configuration cfg, Session session, Connection connection) throws Exception
+    {
+        boolean create = false;
+        try
+        {
+            countAppliedPatches(connection);
+        }
+        catch (Throwable e)
+        {
+            create = true;
+        }
+        if (create)
+        {
+            // the applied patch table is missing - we assume that all other tables are missing
+            // perform a full update using Hibernate-generated statements
+            File tempFile = TempFileProvider.createTempFile("AlfrescoSchemaCreate", ".sql");
+            dumpSchemaCreate(cfg, tempFile);
+            executeScriptFile(cfg, connection, tempFile);
+            // execute post-create scripts (not patches)
+            for (String scriptUrl : this.postCreateScriptUrls)
+            {
+                executeScriptUrl(cfg, connection, scriptUrl);
+            }
+        }
+        else
+        {
+            // we have a database, so just run the update scripts
+            checkSchemaPatchScripts(cfg, session, connection, validateUpdateScriptPatches, false);   // check for scripts that must have been run
+            checkSchemaPatchScripts(cfg, session, connection, applyUpdateScriptPatches, true);       // execute scripts as required
+            // let Hibernate do any required updates
+            File tempFile = null;
+            Writer writer = null;
+            try
+            {
+                final Dialect dialect = Dialect.getDialect(cfg.getProperties());
+                DatabaseMetadata metadata = new DatabaseMetadata(connection, dialect);
+                String[] sqls = cfg.generateSchemaUpdateScript(dialect, metadata);
+                if (sqls.length > 0)
+                {
+                    tempFile = TempFileProvider.createTempFile("AlfrescoSchemaUpdate", ".sql");
+                    writer = new BufferedWriter(new FileWriter(tempFile));
+                    for (String sql : sqls)
+                    {
+                        writer.append(sql);
+                        writer.append(";\n");
+                    }
+                }
+            }
+            finally
+            {
+                if (writer != null)
+                {
+                    try {writer.close();} catch (Throwable e) {}
+                }
+            }
+            // execute if there were changes raised by Hibernate
+            if (tempFile != null)
+            {
+                executeScriptFile(cfg, connection, tempFile);
+            }
+        }
+    }
+    
+    /**
+     * Check that the necessary scripts have been executed against the database
+     */
+    private void checkSchemaPatchScripts(
+            Configuration cfg,
+            Session session,
+            Connection connection,
+            List<SchemaUpgradeScriptPatch> scriptPatches,
+            boolean apply) throws Exception
+    {
+        // first check if there have been any applied patches
+        int appliedPatchCount = countAppliedPatches(connection);
+        if (appliedPatchCount == 0)
+        {
+            // This is a new schema, so upgrade scripts are irrelevant
+            // and patches will not have been applied yet
+            return;
+        }
+        
+        for (SchemaUpgradeScriptPatch patch : scriptPatches)
+        {
+            final String patchId = patch.getId();
+            final String scriptUrl = patch.getScriptUrl();
+
+            // check if the script was successfully executed
+            boolean wasSuccessfullyApplied = didPatchSucceed(connection, patchId);
+            if (wasSuccessfullyApplied)
+            {
+                // nothing to do - it has been done before
+                continue;
+            }
+            else if (!apply)
+            {
+                // the script was not run and may not be run automatically
+                throw AlfrescoRuntimeException.create(ERR_SCRIPT_NOT_RUN, scriptUrl);
+            }
+            // it wasn't run and it can be run now
+            executeScriptUrl(cfg, connection, scriptUrl);
+        }
+    }
+    
+    private void executeScriptUrl(Configuration cfg, Connection connection, String scriptUrl) throws Exception
+    {
+        Dialect dialect = Dialect.getDialect(cfg.getProperties());
+        File scriptFile = getScriptFile(dialect.getClass(), scriptUrl);
+        // check that it exists
+        if (scriptFile == null)
+        {
+            throw AlfrescoRuntimeException.create(ERR_SCRIPT_NOT_FOUND, scriptUrl);
+        }
+        // now execute it
+        executeScriptFile(cfg, connection, scriptFile);
+    }
+    
+    /**
+     * Replaces the dialect placeholder in the script URL and attempts to find a file for
+     * it.  If not found, the dialect hierarchy will be walked until a compatible script is
+     * found.  This makes it possible to have scripts that are generic to all dialects.
+     * 
+     * @return Returns the file if found, otherwise null
+     */
+    private File getScriptFile(Class dialectClazz, String scriptUrl) throws Exception
+    {
+        // replace the dialect placeholder
+        String dialectScriptUrl = scriptUrl.replaceAll(PLACEHOLDER_SCRIPT_DIALECT, dialectClazz.getName());
+        // get a handle on the resource
+        try
+        {
+            File scriptFile = ResourceUtils.getFile(dialectScriptUrl);
+            if (scriptFile.exists())
+            {
+                // found a compatible dialect version
+                return scriptFile;
+            }
+        }
+        catch (FileNotFoundException e)
+        {
+            // doesn't exist
+        }
+        // it wasn't found.  Get the superclass of the dialect and try again
+        Class superClazz = dialectClazz.getSuperclass();
+        if (Dialect.class.isAssignableFrom(superClazz))
+        {
+            // we still have a Dialect - try again
+            return getScriptFile(superClazz, scriptUrl);
+        }
+        else
+        {
+            // we have exhausted all options
+            return null;
+        }
+    }
+    
+    private void executeScriptFile(Configuration cfg, Connection connection, File scriptFile) throws Exception
+    {
+        logger.info(I18NUtil.getMessage(MSG_EXECUTING_SCRIPT, scriptFile));
+        
+        BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(scriptFile), "UTF8"));
+        try
+        {
+            int line = 0;
+            // loop through all statements
+            StringBuilder sb = new StringBuilder(1024);
+            while(true)
+            {
+                String sql = reader.readLine();
+                line++;
+                
+                if (sql == null)
+                {
+                    // nothing left in the file
+                    break;
+                }
+                
+                // trim it
+                sql = sql.trim();
+                if (sql.length() == 0 ||
+                    sql.startsWith( "--" ) ||
+                    sql.startsWith( "//" ) ||
+                    sql.startsWith( "/*" ) )
+                {
+                    if (sb.length() > 0)
+                    {
+                        // we have an unterminated statement
+                        throw AlfrescoRuntimeException.create(ERR_STATEMENT_TERMINATOR, (line - 1), scriptFile);
+                    }
+                    // there has not been anything to execute - it's just a comment line
+                    continue;
+                }
+                // have we reached the end of a statement?
+                boolean execute = false;
+                if (sql.endsWith(";"))
+                {
+                    sql = sql.substring(0, sql.length() - 1);
+                    execute = true;
+                }
+                // append to the statement being built up
+                sb.append(" ").append(sql);
+                // execute, if required
+                if (execute)
+                {
+                    Statement stmt = connection.createStatement();
+                    try
+                    {
+                        sql = sb.toString();
+                        if (logger.isDebugEnabled())
+                        {
+                            logger.debug("Executing statment: " + sql);
+                        }
+                        stmt.execute(sql);
+                        sb = new StringBuilder(1024);
+                    }
+                    finally
+                    {
+                        try { stmt.close(); } catch (Throwable e) {}
+                    }
+                }
+            }
+        }
+        finally
+        {
+            try { reader.close(); } catch (Throwable e) {}
+        }
+    }
+}