INTEGRATION: CWS unopkg2 (1.2.10); FILE MERGED

2004/05/06 16:03:46 dbo 1.2.10.1: #i20304# API revision
Issue number:
Submitted by:
Reviewed by:

2 files changed, 37 insertions, 46 deletions

diff --git a/offapi/com/sun/star/deployment/XPackageManagerFactory.idl b/offapi/com/sun/star/deployment/XPackageManagerFactory.idl
index fca7c2628129..37098bda09b7 100644
--- a/offapi/com/sun/star/deployment/XPackageManagerFactory.idl
+++ b/offapi/com/sun/star/deployment/XPackageManagerFactory.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPackageManagerFactory.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: hr $ $Date: 2004-04-13 11:54:44 $
+ *  last change: $Author: kz $ $Date: 2004-06-11 11:51:01 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -63,19 +63,27 @@
 #define INCLUDED_com_sun_star_deployment_XPackageManagerFactory_idl
 
 #include <com/sun/star/lang/IllegalArgumentException.idl>
-#include <com/sun/star/deployment/PackageManager.idl>
+#include <com/sun/star/deployment/XPackageManager.idl>
 
 
 module com { module sun { module star { module deployment {
 
-/** Interface to obtain a package manager object.
+/** The <type>XPackageManagerFactory</type> interface is used to obtain
+    <type>XPackageManager</type> instances.
+    <p>
+    You have to use the singleton
+    <code>
+    /singletons/com.sun.star.deployment.thePackageManagerFactory
+    </code>
+    exclusively.
+    </p>
 
     @since #i20304#
- */
-interface XPackageManagerFactory : com::sun::star::uno::XInterface
+*/
+interface XPackageManagerFactory
 {
     /** Method to create (or reusing and already existing)
-        <type>PackageManager</type> object to add or remove UNO packages
+        <type>XPackageManager</type> object to add or remove UNO packages
         persistently.
         <p>
         Packages for context strings <code>"user"</code> and
@@ -86,7 +94,7 @@ interface XPackageManagerFactory : com::sun::star::uno::XInterface
         <p>
         Document contexts (<code>"vnd.sun.star.pkg:..."</code>,
         <code>"vnd.sun.star.tdoc:..."</code>) will get a
-        <type>PackageManager</type> object that stores packages
+        <type>XPackageManager</type> object that stores packages
         in the given document and modify the manifest.
         </p>
         <p>
@@ -119,13 +127,11 @@ interface XPackageManagerFactory : com::sun::star::uno::XInterface
                </li>
                </ul>
         @return
-               <type>PackageManager</type> object
+               <type>XPackageManager</type> object
         @throw <type scope="com::sun::star::lang">
-               IllegalArgumentException</type>
-               in case of an invalid context
+               IllegalArgumentException</type> in case of an invalid context
     */
-    XPackageManager /* service PackageManager */ getPackageManager(
-        [in] string context )
+    XPackageManager getPackageManager( [in] string context )
         raises (com::sun::star::lang::IllegalArgumentException);
 };
 
diff --git a/offapi/com/sun/star/deployment/XPackageRegistry.idl b/offapi/com/sun/star/deployment/XPackageRegistry.idl
index eb0eff062dad..0e779c9829ad 100644
--- a/offapi/com/sun/star/deployment/XPackageRegistry.idl
+++ b/offapi/com/sun/star/deployment/XPackageRegistry.idl
@@ -2,9 +2,9 @@
  *
  *  $RCSfile: XPackageRegistry.idl,v $
  *
- *  $Revision: 1.2 $
+ *  $Revision: 1.3 $
  *
- *  last change: $Author: hr $ $Date: 2004-04-13 11:54:54 $
+ *  last change: $Author: kz $ $Date: 2004-06-11 11:51:16 $
  *
  *  The Contents of this file are made available subject to the terms of
  *  either of the following licenses
@@ -62,60 +62,45 @@
 #if ! defined INCLUDED_com_sun_star_deployment_XPackageRegistry_idl
 #define INCLUDED_com_sun_star_deployment_XPackageRegistry_idl
 
-#include <com/sun/star/deployment/DeploymentException.idl>
-#include <com/sun/star/ucb/XCommandEnvironment.idl>
-#include <com/sun/star/deployment/Package.idl>
+#include <com/sun/star/deployment/XPackage.idl>
 
 
 module com { module sun { module star { module deployment {
 
-/** Interface to register or revoke an UNO package.
+/** Interface to bind an UNO package.
 
     @since #i20304#
- */
-interface XPackageRegistry : com::sun::star::uno::XInterface
+*/
+interface XPackageRegistry
 {
     /** binds a package URL to a <type>Package</type> handle.
+        The returned UNO package handle ought to late-initialize itself,
+        thus the process of binding must not be an expensive operation, because
+        it is not abortable.
 
-        @param xPackage
-               <type>Package</type> handle
         @param url
                package URL, must be UCB conform
         @param mediaType
-               MediaType of package
+               media type of package, empty string if to be detected
         @param xCmdEnv
                command environment for error and progress handling
         @return
-               <TRUE/> if successful, <FALSE/> if ignored errors occured
+               <type>XPackage</type> handle
     */
-    boolean bindPackage(
-        [out] XPackage /* service Package */ xPackage,
+    XPackage bindPackage(
         [in] string url,
         [in] string mediaType,
         [in] com::sun::star::ucb::XCommandEnvironment xCmdEnv )
-        raises (DeploymentException);
+        raises (DeploymentException,
+                com::sun::star::ucb::CommandFailedException,
+                com::sun::star::lang::IllegalArgumentException);
 
-    /** detects the media-type of an URL.
+    /** gets the supported media types of this registry(backend).
 
-        @param url
-               URL
-        @return
-               MediaType of URL, or empty string
-    */
-    string detectMediaType( [in] string url );
-
-    /** Expert feature: Tries to repair a registry.
-        <p>
-        Please use this in case of suspected inconsistencies only.
-        </p>
-
-        @param xCmdEnv
-               command environment for error and progress handling
         @return
-               <TRUE/> if successful, <FALSE/> if ignored errors occured
+                supported media types
     */
-    boolean repair( [in] com::sun::star::ucb::XCommandEnvironment xCmdEnv )
-        raises (DeploymentException);
+    sequence<string> getSupportedMediaTypes();
 };
 
 }; }; }; };