1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
|
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef _UCBHELPER_PROVIDERHELPER_HXX
#define _UCBHELPER_PROVIDERHELPER_HXX
#ifndef __LIST__
#include <list>
#endif
#include <com/sun/star/ucb/XContentProvider.hpp>
#include <com/sun/star/lang/XServiceInfo.hpp>
#include <com/sun/star/lang/XMultiServiceFactory.hpp>
#include <com/sun/star/lang/XTypeProvider.hpp>
#include <cppuhelper/weak.hxx>
#include "osl/mutex.hxx"
#include "rtl/ref.hxx"
#include <ucbhelper/macros.hxx>
#include "ucbhelper/ucbhelperdllapi.h"
//=========================================================================
namespace com { namespace sun { namespace star { namespace ucb {
class XPropertySetRegistry;
class XPersistentPropertySet;
} } } }
namespace ucbhelper_impl { struct ContentProviderImplHelper_Impl; }
namespace ucbhelper {
//=========================================================================
class ContentImplHelper;
typedef rtl::Reference< ContentImplHelper > ContentImplHelperRef;
typedef std::list< ContentImplHelperRef > ContentRefList;
/**
* This is an abstract base class for implementations of the service
* com.sun.star.ucb.ContentProvider. It provides contents derived from
* class ucb::ContentImplHelper.
*
* Features of the base class implementation:
* - standard interfaces ( XInterface, XTypeProvider, XServiceInfo )
* - maintains a set of ContentImplHelper objects, which were created by
* the provider implementation. So there will be exactly one object for
* one Content Identifier.
* - Provides access to the Additional Core PropertySet of a content.
* ( These set contains the properties added to a content using its
* XPropertyContainer interface )
*/
class UCBHELPER_DLLPUBLIC ContentProviderImplHelper : public cppu::OWeakObject,
public com::sun::star::lang::XTypeProvider,
public com::sun::star::lang::XServiceInfo,
public com::sun::star::ucb::XContentProvider
{
friend class ContentImplHelper;
ucbhelper_impl::ContentProviderImplHelper_Impl* m_pImpl;
protected:
osl::Mutex m_aMutex;
::com::sun::star::uno::Reference<
::com::sun::star::lang::XMultiServiceFactory > m_xSMgr;
private:
UCBHELPER_DLLPRIVATE void removeContent( ContentImplHelper* pContent );
UCBHELPER_DLLPRIVATE ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XPropertySetRegistry >
getAdditionalPropertySetRegistry();
UCBHELPER_DLLPRIVATE void cleanupRegisteredContents();
protected:
/**
* This method returns a content with the given id, if it already exists.
* Use this method in your "queryContent" implementation to ensure unique
* objects.
*
* @param Identifier is the content identifier, for that an existing
* content object is requested.
* @return the content with the given identifier, if it exists or 0, if it
* does not exist.
*/
rtl::Reference< ContentImplHelper >
queryExistingContent( const ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XContentIdentifier >& Identifier );
/**
* This method returns a content with the given URL, if it already exists.
*
* @param rURL is the URL ( content identifier string ), for that an
* existing content object is requested.
* @return the content with the given URL, if it exists or 0, if it
* does not exist.
*/
rtl::Reference< ContentImplHelper >
queryExistingContent( const ::rtl::OUString& rURL );
/**
* This method registers a newly created content instance with the
* content provider. It should be called directly after creating a new
* content instance. The provider can reuse a registered instance upon
* subsedent requests for content instances with an idententifier
* of a registered instance.
* Note that the provider does not hold a hard reference on the
* registered instance. If last external reference is gone, the provider
* will remove the instance from its inventory of known instances.
* Nothing will happen in case an already registered instance shall
* be registered more than once.
*
* @param the content instance that is to be registered.
*/
void registerNewContent(
const com::sun::star::uno::Reference<
::com::sun::star::ucb::XContent > & xContent );
public:
//////////////////////////////////////////////////////////////////////
// Contsruction/Destruction
//////////////////////////////////////////////////////////////////////
ContentProviderImplHelper(
const ::com::sun::star::uno::Reference<
::com::sun::star::lang::XMultiServiceFactory >& rXSMgr );
virtual ~ContentProviderImplHelper();
//////////////////////////////////////////////////////////////////////
// XInterface
//////////////////////////////////////////////////////////////////////
XINTERFACE_DECL()
//////////////////////////////////////////////////////////////////////
// XTypeProvider
//////////////////////////////////////////////////////////////////////
XTYPEPROVIDER_DECL()
//////////////////////////////////////////////////////////////////////
// XServiceInfo
//////////////////////////////////////////////////////////////////////
virtual ::rtl::OUString SAL_CALL
getImplementationName()
throw( ::com::sun::star::uno::RuntimeException ) = 0;
virtual sal_Bool SAL_CALL
supportsService( const ::rtl::OUString& ServiceName )
throw( ::com::sun::star::uno::RuntimeException );
virtual ::com::sun::star::uno::Sequence< ::rtl::OUString > SAL_CALL
getSupportedServiceNames()
throw( ::com::sun::star::uno::RuntimeException ) = 0;
//////////////////////////////////////////////////////////////////////
// XContentProvider
//////////////////////////////////////////////////////////////////////
/**
* This method returns a content with the requested id.
*
* The implementation should:
*
* - Check, whether the Identifier is valid ( URL syntax ).
* - Use queryExistingContent(...) to determine, whether there exists
* already a content with the given id.
* - Return the possibly existing content.Create and return a new
* content, otherwise
*/
virtual ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XContent > SAL_CALL
queryContent( const ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XContentIdentifier >& Identifier )
throw( ::com::sun::star::ucb::IllegalIdentifierException,
::com::sun::star::uno::RuntimeException ) = 0;
virtual sal_Int32 SAL_CALL
compareContentIds( const ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XContentIdentifier >& Id1,
const ::com::sun::star::uno::Reference<
::com::sun::star::ucb::XContentIdentifier >& Id2 )
throw( ::com::sun::star::uno::RuntimeException );
//////////////////////////////////////////////////////////////////////
// Non-interface methods.
//////////////////////////////////////////////////////////////////////
/**
* This method returns a mutex, which protects the content list of the
* provider. So you can prevent modifications of that list easyly.
*
* @return the mutex.
*/
osl::Mutex& getContentListMutex() { return m_aMutex; }
/**
* This method fills a list with all contents existing at calling time.
* Note: You may prevent modifications of the content list at any time
* by acquiring the content list mutex of the provider.
*
* @param rContents is the list to fill with the children.
*/
void queryExistingContents( ContentRefList& rContents );
/**
* This method returns the propertyset containing the Additional Core
* Properties of a content.
*
* @param rKey is the key for the propertyset.
* @param bCreate is a flag indicating whether the propertyset shall
* be created in case it does not exist.
* @return the propertyset containing the Additional Core Properties.
*/
::com::sun::star::uno::Reference<
com::sun::star::ucb::XPersistentPropertySet >
getAdditionalPropertySet( const ::rtl::OUString& rKey, sal_Bool bCreate );
/**
* This method renames the propertyset containing the Additional Core
* Properties of a content.
*
* @param rOldKey is the old key of the propertyset.
* @param rNewKey is the new key for the propertyset.
* @param bRecursive is a flag indicating whether propertysets for
* children described by rOldKey shall be renamed, too.
* @return True, if the operation succeeded - False, otherwise.
*/
sal_Bool renameAdditionalPropertySet( const ::rtl::OUString& rOldKey,
const ::rtl::OUString& rNewKey,
sal_Bool bRecursive );
/**
* This method copies the propertyset containing the Additional Core
* Properties of a content.
*
* @param rSourceKey is the key of the source propertyset.
* @param rTargetKey is the key of the target propertyset.
* @param bRecursive is a flag indicating whether propertysets for
* children described by rSourceKey shall be copied, too.
* @return True, if the operation succeeded - False, otherwise.
*/
sal_Bool copyAdditionalPropertySet( const ::rtl::OUString& rSourceKey,
const ::rtl::OUString& rTargetKey,
sal_Bool bRecursive );
/**
* This method removes the propertyset containing the Additional Core
* Properties of a content.
*
* @param rKey is the key of the propertyset.
* @param bRecursive is a flag indicating whether propertysets for
* children described by rOldKey shall be removed, too.
* @return True, if the operation succeeded - False, otherwise.
*/
sal_Bool removeAdditionalPropertySet( const ::rtl::OUString& rKey,
sal_Bool bRecursive );
};
} // namespace ucbhelper
#endif /* !_UCBHELPER_PROVIDERHELPER_HXX */
|
