INTEGRATION: CWS dba201b (1.3.34); FILE MERGED

2005/09/22 17:52:57 oj 1.3.34.2: RESYNC: (1.3-1.4); FILE MERGED
2005/07/20 11:14:37 fs 1.3.34.1: #i51255# +XCloseable, for life time control

1 files changed, 20 insertions, 2 deletions

diff --git a/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl b/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
index 9c60391007e8..f1a575042a15 100644
--- a/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
+++ b/offapi/com/sun/star/sdb/OfficeDatabaseDocument.idl
@@ -4,9 +4,9 @@
  *
  *  $RCSfile: OfficeDatabaseDocument.idl,v $
  *
- *  $Revision: 1.4 $
+ *  $Revision: 1.5 $
  *
- *  last change: $Author: rt $ $Date: 2005-09-08 03:19:38 $
+ *  last change: $Author: hr $ $Date: 2005-09-23 11:54:11 $
  *
  *  The Contents of this file are made available subject to
  *  the terms of GNU Lesser General Public License Version 2.1.
@@ -38,6 +38,9 @@
 #ifndef __com_sun_star_sdb_XOfficeDatabaseDocument_idl__
 #include <com/sun/star/sdb/XOfficeDatabaseDocument.idl>
 #endif
+#ifndef __com_sun_star_util_XCloseable_idl__
+#include <com/sun/star/util/XCloseable.idl>
+#endif
 
 module com {  module sun {  module star {  module sdb {
 
@@ -79,6 +82,21 @@ service OfficeDatabaseDocument
     service com::sun::star::document::OfficeDocument;
 
     interface XOfficeDatabaseDocument;
+
+    /** implements life time control
+
+        <p>Whoever retrieves a <type>OfficeDatabaseDocument</type> should be aware of
+        life time issues, since a document needs to be closed when nobody needs it anymore.</p>
+
+        <p>This implies that clients of a document need to ensure that as soon as they don't
+        need, they invoke <member scope="com::sun::star::util">XCloseable::close</member>.</p>
+
+        <p>Since this can be done by multiple clients, every client is additionally required
+        to register itself as <type scope="com::sun::star::util">XCloseListener</type> at
+        the document, to prevent some other client closing the model while it's still needed
+        by the first client.</p>
+    */
+    interface com::sun::star::util::XCloseable;
 };
 
 //=============================================================================