1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * Copyright 2008 by Sun Microsystems, Inc.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * $RCSfile: XBackendEntities.idl,v $
12 * This file is part of OpenOffice.org.
14 * OpenOffice.org is free software: you can redistribute it and/or modify
15 * it under the terms of the GNU Lesser General Public License version 3
16 * only, as published by the Free Software Foundation.
18 * OpenOffice.org is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU Lesser General Public License version 3 for more details
22 * (a copy is included in the LICENSE file that accompanied this code).
24 * You should have received a copy of the GNU Lesser General Public License
25 * version 3 along with OpenOffice.org. If not, see
26 * <http://www.openoffice.org/license.html>
27 * for a copy of the LGPLv3 License.
29 ************************************************************************/
30 #ifndef __com_sun_star_configuration_backend_XBackendEntities_idl__
31 #define __com_sun_star_configuration_backend_XBackendEntities_idl__
33 #ifndef __com_sun_star_uno_XInterface_idl__
34 #include
<com
/sun
/star
/uno
/XInterface.idl
>
37 #ifndef __com_sun_star_lang_IllegalArgumentException_idl__
38 #include
<com
/sun
/star
/lang
/IllegalArgumentException.idl
>
40 #ifndef __com_sun_star_configuration_backend_BackendAccessException_idl__
41 #include
<com
/sun
/star
/configuration
/backend
/BackendAccessException.idl
>
44 //=============================================================================
46 module com
{ module sun
{ module star
{ module configuration
{ module backend
{
48 //=============================================================================
51 Provides functionality relating to common and supported entities
52 for a configuration data backend.
54 @see com::sun::star::configuration::backend::XBackend
55 @see com::sun::star::configuration::backend::XMultiLayerStratum
59 published
interface XBackendEntities
: ::com
::sun
::star
::uno
::XInterface
61 //-------------------------------------------------------------------------
64 provides the entity id of the owner entity of the backend.
67 an entity identifier for the owner entity.
68 <p> The owner entity is the default entity for the backend.
69 For normal configuration data access the owner entity
70 should always be used.
73 @see com::sun::star::configuration::backend::XBackend::listOwnLayers()
74 @see com::sun::star::configuration::backend::XBackend::getOwnUpdateHandler()
76 string getOwnerEntity
() ;
78 //-------------------------------------------------------------------------
81 provides the entity id of an entity for general administrative access.
83 <p> The admin entity is an entity that should be used to
84 read and manage configuration data that applies to all entities
89 an entity identifier for the admin entity or
90 an empty string, if there is no entity that can be used for
91 general administrative access.
94 string getAdminEntity
() ;
96 //-------------------------------------------------------------------------
99 determines, if a given entity id exists in this backend.
102 The name of an entity.
104 @throws com::sun::star::configuration::backend::BackendAccessException
105 if an error occurs while accessing the backend.
108 <TRUE/>, if aEntity is a valid, existing entity for this backend,
111 boolean supportsEntity
([in] string aEntity
)
112 raises
( BackendAccessException
);
114 //-------------------------------------------------------------------------
117 determines, if two given entity ids denote the same entity.
120 The name of an entity.
123 The name of another entity.
126 <TRUE/>, if aEntity and aOtherEntity denote the same entity
127 within this backend, <FALSE/> otherwise.
129 @throws com::sun::star::configuration::backend::BackendAccessException
130 if an error occurs while accessing the backend.
132 @throws com::sun::star::lang::IllegalArgumentException
133 if either entity does not exist.
135 boolean isEqualEntity
([in] string aEntity
, [in] string aOtherEntity
)
136 raises
( BackendAccessException
, com
::sun
::star
::lang
::IllegalArgumentException
) ;
138 //-------------------------------------------------------------------------
141 //=============================================================================