diff -r e68342f9b906 xml.xam/apichanges.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml.xam/apichanges.xml	Fri Apr 03 23:07:40 2009 +0400
@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Search for CHANGEME in this document when copying and using it: -->
+<!--
+DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
+
+Copyright 1997-2009 Sun Microsystems, Inc. All rights reserved.
+
+The contents of this file are subject to the terms of either the GNU
+General Public License Version 2 only ("GPL") or the Common
+Development and Distribution License("CDDL") (collectively, the
+"License"). You may not use this file except in compliance with the
+License. You can obtain a copy of the License at
+http://www.netbeans.org/cddl-gplv2.html
+or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
+specific language governing permissions and limitations under the
+License.  When distributing the software, include this License Header
+Notice in each file and include the License file at
+nbbuild/licenses/CDDL-GPL-2-CP.  Sun designates this
+particular file as subject to the "Classpath" exception as provided
+by Sun in the GPL Version 2 section of the License file that
+accompanied this code. If applicable, add the following below the
+License Header, with the fields enclosed by brackets [] replaced by
+your own identifying information:
+"Portions Copyrighted [year] [name of copyright owner]"
+
+Contributor(s):
+
+The Original Software is NetBeans. The Initial Developer of the Original
+Software is Sun Microsystems, Inc. Portions Copyright 1997-2009 Sun
+Microsystems, Inc. All Rights Reserved.
+
+If you wish your version of this file to be governed by only the CDDL
+or only the GPL Version 2, indicate your decision by adding
+"[Contributor] elects to include this software in this distribution
+under the [CDDL or GPL Version 2] license." If you do not indicate a
+single choice of license, a recipient has the option to distribute
+your version of this file under either the CDDL, the GPL Version 2 or
+to extend the choice of license to its licensees as provided above.
+However, if you add GPL Version 2 code and therefore, elected the GPL
+Version 2 license, then the option applies only if the new code is
+made subject to such option by the copyright holder.
+-->
+<?xml-stylesheet type="text/xml" href="../nbbuild/javadoctools/apichanges.xsl"?>
+<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">
+
+<!--
+
+INFO FOR PEOPLE ADDING CHANGES:
+
+Check the DTD (apichanges.dtd) for details on the syntax. You do not
+need to regenerate the HTML, as this is part of Javadoc generation; just
+change the XML. Rough syntax of a change (several parts optional):
+
+<change>
+    <api name="compiler"/>
+    <summary>Some brief description here, can use <b>XHTML</b></summary>
+    <version major="1" minor="99"/>
+    <date day="13" month="6" year="2001"/>
+    <author login="jrhacker"/>
+    <compatibility addition="yes"/>
+    <description>
+        The main description of the change here.
+        Again can use full <b>XHTML</b> as needed.
+    </description>
+    <class package="org.openide.compiler" name="DoWhatIWantCompiler"/>
+    <issue number="14309"/>
+</change>
+
+Also permitted elements: <package>, <branch>. <version> is API spec
+version, recommended for all new changes. <compatibility> should say
+if things were added/modified/deprecated/etc. and give all information
+related to upgrading old code. List affected top-level classes and
+link to issue numbers if applicable. See the DTD for more details.
+
+Changes need not be in any particular order, they are sorted in various
+ways by the stylesheet anyway.
+
+Dates are assumed to mean "on the trunk". If you *also* make the same
+change on a stabilization branch, use the <branch> tag to indicate this
+and explain why the change was made on a branch in the <description>.
+
+Please only change this file on the trunk! Rather: you can change it
+on branches if you want, but these changes will be ignored; only the
+trunk version of this file is important.
+
+Deprecations do not count as incompatible, assuming that code using the
+deprecated calls continues to see their documented behavior. But do
+specify deprecation="yes" in <compatibility>.
+
+This file is not a replacement for Javadoc: it is intended to list changes,
+not describe the complete current behavior, for which ordinary documentation
+is the proper place.
+
+-->
+
+<apichanges>
+
+    <!-- First, a list of API names you may use: -->
+    <apidefs>
+        <apidef name="org.netbeans.modules.xml.xam">Extansible Abstract Model (XAM)</apidef>
+        <!-- etc. -->
+    </apidefs>
+
+    <!-- ACTUAL CHANGES BEGIN HERE: -->
+    <changes>
+        
+        <change id="model-changes-notification">
+            <api name="org.netbeans.modules.xml.xam"/>
+            <summary>A new String constant MODEL_CHANGED_PROPERTY is added</summary>
+            <version major="1" minor="6"/>
+            <date day="3" month="4" year="2009"/>
+            <author login="supernikita"/>
+            <compatibility binary="compatible" source="compatible" addition="yes"/>
+            <description>
+                <p>
+                The new constant {@link org.netbeans.modules.xml.xam.Model#MODEL_CHANGED_PROPERTY}
+                is intended to be used as a <code>propertyName</code> attribute of the
+                {@link java.beans.PropertyChangeEvent#getPropertyName PropertyChangeEvent}.
+                </p>
+                <p>
+                The corresponding event means that the model has changed.
+                Only one event is sent per a model's transaction.
+                </p>
+            </description>
+            <class package="org.netbeans.modules.xml.xam" name="Model"/>
+            <issue number="134153"/>
+        </change>
+
+    </changes>
+
+    <!-- Now the surrounding HTML text and document structure: -->
+
+    <htmlcontents>
+<!-- Generated from apichanges.xml -->
+    <head>
+      <title>Change History for the Extansible Abstract Model (XAM)</title>
+      <link rel="stylesheet" href="prose.css" type="text/css"/>
+    </head>
+    <body>
+
+<p class="overviewlink"><a href="@TOP@/overview-summary.html">Overview</a></p>
+
+<h1>Introduction</h1>
+
+<p>This document lists changes made to the <a href="@TOP@/overview-summary.html">Extansible Abstract Model (XAM)</a>.</p>
+      <hr/>
+      <standard-changelists module-code-name="org.netbeans.modules.xml.xam/1"/>
+      <hr/><p>@FOOTER@</p>
+    </body>
+  </htmlcontents>
+
+</apichanges>


diff -r e68342f9b906 xml.xam/src/org/netbeans/modules/xml/xam/Model.java
--- a/xml.xam/src/org/netbeans/modules/xml/xam/Model.java	Thu Mar 26 14:00:55 2009 +0300
+++ b/xml.xam/src/org/netbeans/modules/xml/xam/Model.java	Fri Apr 03 23:01:17 2009 +0400
@@ -53,6 +53,19 @@ import javax.swing.event.UndoableEditLis
  */
 public interface Model<C extends Component<C>> extends Referenceable {
     public static final String STATE_PROPERTY = "state";
+
+    /**
+     * The constant is intended to be used as a <code>propertyName</code> attribute of the
+     * {@link java.beans.PropertyChangeEvent#getPropertyName PropertyChangeEvent}.
+     * <p>
+     * The corresponding event means that the model has changed.
+     * Only one event is sent per a model's transaction.
+     * <p>
+     * Such event is convenient to do a cumulative update of a model's UI client.
+     *
+     * @since 1.5.1
+     */
+    public static final String MODEL_CHANGED_PROPERTY = "model_changed";
     
     /**
      * Add coarse-grained change listener for events on model components.


diff -r e68342f9b906 xml.xam/src/org/netbeans/modules/xml/xam/AbstractModel.java
--- a/xml.xam/src/org/netbeans/modules/xml/xam/AbstractModel.java	Thu Mar 26 14:00:55 2009 +0300
+++ b/xml.xam/src/org/netbeans/modules/xml/xam/AbstractModel.java	Fri Apr 03 23:01:17 2009 +0400
@@ -312,7 +312,7 @@ public abstract class AbstractModel<T ex
     public synchronized void endTransaction() {
         endTransaction(false);
     }
-    
+
     protected synchronized void endTransaction(boolean quiet) {
         if (transaction == null) return;  // just no-op when not in transaction
         validateWrite(); // ensures that the releasing thread really owns trnx
@@ -329,6 +329,12 @@ public abstract class AbstractModel<T ex
                 ues.endUpdate();
             }
         } finally {
+            if (transaction.hasEvents()) {
+                PropertyChangeEvent event = new PropertyChangeEvent(
+                        this, MODEL_CHANGED_PROPERTY, null, null);
+                pcs.firePropertyChange(event);
+            }
+            //
             transaction = null;
             setInSync(false);
             setInUndoRedo(false);


diff -r e68342f9b906 xml.xam/test/unit/src/org/netbeans/modules/xml/xam/AbstractModelTest.java
--- a/xml.xam/test/unit/src/org/netbeans/modules/xml/xam/AbstractModelTest.java	Thu Mar 26 14:00:55 2009 +0300
+++ b/xml.xam/test/unit/src/org/netbeans/modules/xml/xam/AbstractModelTest.java	Fri Apr 03 23:01:17 2009 +0400
@@ -170,7 +170,61 @@ public class AbstractModelTest extends T
         model.endTransaction();
         plistener.assertEvent(Model.STATE_PROPERTY, Model.State.VALID, Model.State.NOT_WELL_FORMED);
     }
-    
+
+    /**
+     * Tests that only one Model.MODEL_CHANGED_PROPERTY comes
+     * when a model is changed through the API.
+     * @throws java.lang.Exception
+     */
+    public void testTransactionCompleteEvent() throws Exception {
+
+        class EventCounter {
+            // Counts all Propery Change Events
+            public int total = 0;
+
+            // Counts only MODEL_CHANGED Propery Change Events
+            public int modelChanged = 0;
+        };
+        
+        final EventCounter eventCounter = new EventCounter();
+
+        model.addPropertyChangeListener(new PropertyChangeListener() {
+            public void propertyChange(PropertyChangeEvent evt) {
+               eventCounter.total++;
+               //
+               if (Model.MODEL_CHANGED_PROPERTY.equals(evt.getPropertyName())) {
+                   eventCounter.modelChanged++;
+               }
+            }
+        });
+
+        model.startTransaction();
+        try {
+            TestComponent r = model.getRootComponent();
+            List<TestComponent.A> children = r.getChildren(TestComponent.A.class);
+            TestComponent.A atc = children.get(2);
+            //
+            TestComponent.B b1 = new TestComponent.B(model, 1);
+            model.addChildComponent(atc, b1, -1);
+            //
+            TestComponent.B b2 = new TestComponent.B(model, 2);
+            model.addChildComponent(atc, b2, -1);
+            //
+            TestComponent.B b3 = new TestComponent.B(model, 3);
+            model.addChildComponent(atc, b3, -1);
+            //
+        } finally {
+            model.endTransaction();
+        }
+        plistener.assertEvent(Model.MODEL_CHANGED_PROPERTY, null, null);
+        //
+        // Total amount of events should be equal to number of atomic changes + 1
+        assertEquals(eventCounter.total, 4);
+        //
+        // Only one MODEL_CHANGED event should come per a transaciton
+        assertEquals(eventCounter.modelChanged, 1);
+    }
+
     private class FlushListener implements PropertyChangeListener {
         long flushTime = 0;
         public FlushListener() {