Line data    Source code

       1             : /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
       2             : /*
       3             :  * This file is part of the LibreOffice project.
       4             :  *
       5             :  * This Source Code Form is subject to the terms of the Mozilla Public
       6             :  * License, v. 2.0. If a copy of the MPL was not distributed with this
       7             :  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
       8             :  *
       9             :  * This file incorporates work covered by the following license notice:
      10             :  *
      11             :  *   Licensed to the Apache Software Foundation (ASF) under one or more
      12             :  *   contributor license agreements. See the NOTICE file distributed
      13             :  *   with this work for additional information regarding copyright
      14             :  *   ownership. The ASF licenses this file to you under the Apache
      15             :  *   License, Version 2.0 (the "License"); you may not use this file
      16             :  *   except in compliance with the License. You may obtain a copy of
      17             :  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
      18             :  */
      19             : #ifndef _CPPUHELPER_SERVICEFACTORY_HXX_
      20             : #define _CPPUHELPER_SERVICEFACTORY_HXX_
      21             : 
      22             : #include <rtl/ustring.hxx>
      23             : 
      24             : #include <com/sun/star/lang/XMultiServiceFactory.hpp>
      25             : #include <com/sun/star/lang/XMultiComponentFactory.hpp>
      26             : #include "cppuhelperdllapi.h"
      27             : 
      28             : 
      29             : namespace cppu
      30             : {
      31             : 
      32             : /** Deprecated.  Use cppuhelper/bootstrap.hxx functions instead.
      33             : 
      34             :     This bootstraps an initial service factory working on a registry. If the first or both
      35             :     parameters contain a value then the service factory is initialized with a simple registry
      36             :     or a nested registry. Otherwise the service factory must be initialized later with a valid
      37             :     registry.
      38             : 
      39             :     @param rWriteRegistryFile
      40             :     file name of the simple registry or the first registry file of
      41             :     the nested registry which will be opened with read/write rights. This
      42             :     file will be created if necessary.
      43             :     @param rReadRegistryFile
      44             :     file name of the second registry file of the nested registry
      45             :     which will be opened with readonly rights.
      46             :     @param bReadOnly
      47             :     flag which specify that the first registry file will be opened with
      48             :     readonly rights. Default is FALSE. If this flag is used the registry
      49             :     will not be created if not exist.
      50             :     @param rBootstrapPath
      51             :     specifies a path where the bootstrap components could be find. If this
      52             :     parameter is an empty string the compoents will be searched in the system
      53             :     path.
      54             :     @deprecated
      55             : */
      56             : CPPUHELPER_DLLPUBLIC ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >
      57             : SAL_CALL createRegistryServiceFactory(
      58             :     const ::rtl::OUString & rWriteRegistryFile,
      59             :     const ::rtl::OUString & rReadRegistryFile,
      60             :     sal_Bool bReadOnly = sal_False,
      61             :     const ::rtl::OUString & rBootstrapPath = ::rtl::OUString() )
      62             :     SAL_THROW( (::com::sun::star::uno::Exception) );
      63             : 
      64             : 
      65             : /** Deprecated.  Use cppuhelper/bootstrap.hxx functions instead.
      66             : 
      67             :     This bootstraps an initial service factory working on a registry file.
      68             : 
      69             :     @param rRegistryFile
      70             :     file name of the registry to use/ create; if this is an empty
      71             :     string, the default registry is used instead
      72             :     @param bReadOnly
      73             :     flag which specify that the registry file will be opened with
      74             :     readonly rights. Default is FALSE. If this flag is used the registry
      75             :     will not be created if not exist.
      76             :     @param rBootstrapPath
      77             :     specifies a path where the bootstrap components could be find. If this
      78             :     parameter is an empty string the compoents will be searched in the system
      79             :     path.
      80             :     @deprecated
      81             : */
      82             : inline ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >
      83           0 : SAL_CALL createRegistryServiceFactory(
      84             :     const ::rtl::OUString & rRegistryFile,
      85             :     sal_Bool bReadOnly = sal_False,
      86             :     const ::rtl::OUString & rBootstrapPath = ::rtl::OUString() )
      87             :     SAL_THROW( (::com::sun::star::uno::Exception) )
      88             : {
      89             :     return ::cppu::createRegistryServiceFactory(
      90           0 :         rRegistryFile, ::rtl::OUString(), bReadOnly, rBootstrapPath );
      91             : }
      92             : 
      93             : /** Deprecated.  Use cppuhelper/bootstrap.hxx functions instead.
      94             : 
      95             :     This bootstraps a service factory without initialize a registry.
      96             : 
      97             :     @param rBootstrapPath
      98             :     specifies a path where the bootstrap components could be find. If this
      99             :     parameter is an empty string the compoents will be searched in the system
     100             :     path.
     101             :     @deprecated
     102             : */
     103             : inline ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >
     104           0 : SAL_CALL createServiceFactory(
     105             :     const ::rtl::OUString & rBootstrapPath = ::rtl::OUString() )
     106             :     SAL_THROW( (::com::sun::star::uno::Exception) )
     107             : {
     108             :     return ::cppu::createRegistryServiceFactory(
     109           0 :         ::rtl::OUString(), ::rtl::OUString(), sal_False, rBootstrapPath );
     110             : }
     111             : 
     112             : } // end namespace cppu
     113             : 
     114             : #endif
     115             : 
     116             : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */