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
286
287
288
289
290
291
292
293
294
295
296
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef INCLUDED_CPPUHELPER_IMPLBASE_HXX
#define INCLUDED_CPPUHELPER_IMPLBASE_HXX
#include <osl/mutex.hxx>
#include <cppuhelper/weak.hxx>
#include <cppuhelper/weakagg.hxx>
#include <rtl/instance.hxx>
#include <com/sun/star/lang/XTypeProvider.hpp>
#include <com/sun/star/lang/XMultiServiceFactory.hpp>
#include <cppuhelper/cppuhelperdllapi.h>
/* This header should not be used anymore.
@deprecated
*/
/// @cond INTERNAL
namespace cppu
{
/** Struct used for inline template implementation helpers: type entries.
Not for public use.
*/
struct Type_Offset
{
/** binary offset of vtable pointer from object base
*/
sal_Int32 nOffset;
/** interface type description of interface entry
*/
typelib_InterfaceTypeDescription * pTD;
};
/** Struct used for inline template implementation helpers: class data of implementation.
Not for public use.
*/
struct CPPUHELPER_DLLPUBLIC ClassDataBase
{
/** determines whether the class data has been statically initialized
*/
sal_Bool bOffsetsInit;
/** length of static array ClassDataN
*/
sal_Int32 nType2Offset;
/** class code determines which standard types are supported (and returned on
com.sun.star.lang.XTypeProvider::getTypes()) by the helper:
- 1 -- com.sun.star.uno.XWeak
- 2 -- com.sun.star.uno.XWeak, com.sun.star.uno.XAggregation
- 3 -- com.sun.star.uno.XWeak, com.sun.star.uno.XAggregation, com.sun.star.lang.XComponent
- 4 -- com.sun.star.uno.XWeak, com.sun.star.lang.XComponent
*/
sal_Int32 nClassCode;
/** pointer to types sequence (com.sun.star.lang.XTypeProvider)
*/
::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > * pTypes;
/** pointer to class id (com.sun.star.lang.XTypeProvider)
*/
::com::sun::star::uno::Sequence< sal_Int8 > * pId;
/** def ctor
*/
ClassDataBase() SAL_THROW(());
/** class code ctor
@param nClassCode class code, see ClassDataBase::nClassCode
*/
ClassDataBase( sal_Int32 nClassCode ) SAL_THROW(());
/** dtor
*/
~ClassDataBase() SAL_THROW(());
};
/** Struct used for inline template implementation helpers:
There will be versions of this struct with varying arType2Offset[] array sizes, each of which
is binary compatible with this one to be casted and used uniform. The size of the varying array
is set in ClassDataBase::nType2Offset (base class).
Not for public use.
*/
struct CPPUHELPER_DLLPUBLIC ClassData : public ClassDataBase
{
/** type entries array
*/
Type_Offset arType2Offset[1];
/** init call for supporting com.sun.star.lang.XTypeProvider
*/
void SAL_CALL initTypeProvider() SAL_THROW(());
/** initial writing type offsets for vtables
@param rType type of interface
@param nOffset offset to vtable entry
*/
void SAL_CALL writeTypeOffset( const ::com::sun::star::uno::Type & rType, sal_Int32 nOffset )
SAL_THROW(());
/** Queries for an interface.
@param rType demanded interface type
@pBase base this pointer related when writing type offsets (writeTypeOffset())
@return demanded interface or empty any
*/
::com::sun::star::uno::Any SAL_CALL query(
const ::com::sun::star::uno::Type & rType, ::com::sun::star::lang::XTypeProvider * pBase )
SAL_THROW(());
/** Gets the types for supporting com.sun.star.lang.XTypeProvider
@return sequence of types supported
*/
::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes()
SAL_THROW(());
/** Gets the class id of implementation supporting com.sun.star.lang.XTypeProvider
@return class identifier (sequence< byte >)
*/
::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId()
SAL_THROW(());
};
/** Shared mutex for implementation helper initialization.
Not for public use.
*/
CPPUHELPER_DLLPUBLIC ::osl::Mutex & SAL_CALL getImplHelperInitMutex(void) SAL_THROW(());
}
// settle down beavis, here comes the macro template hell :]
#if defined _MSC_VER // public -> protected changes mangled names there
#define CPPUHELPER_DETAIL_IMPLHELPER_PROTECTED public
#else
#define CPPUHELPER_DETAIL_IMPLHELPER_PROTECTED protected
#endif
/** Implementation helper macros
Not for common use. There are expanded forms of the macro usage in implbaseN.hxx/compbaseN.hxx.
So there is commonly no need to use these macros. Though, you may need to implement more than
12 interfaces. Then you have to declare something like the following in your headers
(where N is your demanded number of interfaces):
#define __IFC3 Ifc1, Ifc2, Ifc3, ... up to N
#define __CLASS_IFC3 class Ifc1, class Ifc2, class Ifc3, ... up to N
#define __PUBLIC_IFC3 public Ifc1, public Ifc2, public Ifc3, ... up to N
__DEF_IMPLHELPER_PRE( N )
__IFC_WRITEOFFSET( 1 ) __IFC_WRITEOFFSET( 2 ) __IFC_WRITEOFFSET( 3 ), ... up to N
__DEF_IMPLHELPER_POST( N )
*/
#define __DEF_IMPLHELPER_PRE( N ) \
namespace cppu \
{ \
struct ClassData##N : public ClassDataBase \
{ \
Type_Offset arType2Offset[ N ]; \
ClassData##N( sal_Int32 nInClassCode ) SAL_THROW(()) \
: ClassDataBase( nInClassCode ) \
{} \
}; \
template< __CLASS_IFC##N > \
class SAL_NO_VTABLE SAL_DLLPUBLIC_TEMPLATE ImplHelperBase##N \
: public ::com::sun::star::lang::XTypeProvider \
, __PUBLIC_IFC##N \
{ \
CPPUHELPER_DETAIL_IMPLHELPER_PROTECTED: \
~ImplHelperBase##N() throw () {} \
protected: \
ClassData & SAL_CALL getClassData( ClassDataBase & s_aCD ) SAL_THROW(()) \
{ \
ClassData & rCD = * static_cast< ClassData * >( &s_aCD ); \
if (! rCD.bOffsetsInit) \
{ \
::osl::MutexGuard aGuard( getImplHelperInitMutex() ); \
if (! rCD.bOffsetsInit) \
{ \
char * pBase = (char *)this;
/** Implementation helper macro: have a look at __DEF_IMPLHELPER_PRE
*/
#define __IFC_WRITEOFFSET( N ) \
rCD.writeTypeOffset( ::getCppuType( (const ::com::sun::star::uno::Reference< Ifc##N > *)0 ), \
(char *)(Ifc##N *)this - pBase );
/** Implementation helper macro: have a look at __DEF_IMPLHELPER_PRE
*/
#define __DEF_IMPLHELPER_POST_A( N ) \
rCD.bOffsetsInit = sal_True; \
} \
} \
return rCD; \
} \
}; \
template< __CLASS_IFC##N > \
class SAL_NO_VTABLE SAL_DLLPUBLIC_TEMPLATE ImplHelper##N \
: public ImplHelperBase##N< __IFC##N > \
{ \
static ClassData##N s_aCD; \
public: \
virtual ::com::sun::star::uno::Any SAL_CALL queryInterface( const ::com::sun::star::uno::Type & rType ) throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).query( rType, (ImplHelperBase##N< __IFC##N > *)this ); } \
virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getTypes(); } \
virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getImplementationId(); } \
CPPUHELPER_DETAIL_IMPLHELPER_PROTECTED: \
~ImplHelper##N() throw () {} \
}; \
template< __CLASS_IFC##N > \
class SAL_NO_VTABLE SAL_DLLPUBLIC_TEMPLATE WeakImplHelper##N \
: public ::cppu::OWeakObject \
, public ImplHelperBase##N< __IFC##N > \
{ \
static ClassData##N s_aCD; \
public: \
virtual ::com::sun::star::uno::Any SAL_CALL queryInterface( const ::com::sun::star::uno::Type & rType ) throw (::com::sun::star::uno::RuntimeException) \
{ \
::com::sun::star::uno::Any aRet( this->getClassData( s_aCD ).query( rType, (ImplHelperBase##N< __IFC##N > *)this ) ); \
return (aRet.hasValue() ? aRet : OWeakObject::queryInterface( rType )); \
} \
virtual void SAL_CALL acquire() throw () \
{ OWeakObject::acquire(); } \
virtual void SAL_CALL release() throw () \
{ OWeakObject::release(); } \
virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getTypes(); } \
virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getImplementationId(); } \
}; \
template< __CLASS_IFC##N > \
class SAL_NO_VTABLE SAL_DLLPUBLIC_TEMPLATE WeakAggImplHelper##N \
: public ::cppu::OWeakAggObject \
, public ImplHelperBase##N< __IFC##N > \
{ \
static ClassData##N s_aCD; \
public: \
virtual ::com::sun::star::uno::Any SAL_CALL queryInterface( const ::com::sun::star::uno::Type & rType ) throw (::com::sun::star::uno::RuntimeException) \
{ return OWeakAggObject::queryInterface( rType ); } \
virtual ::com::sun::star::uno::Any SAL_CALL queryAggregation( const ::com::sun::star::uno::Type & rType ) throw (::com::sun::star::uno::RuntimeException) \
{ \
::com::sun::star::uno::Any aRet( this->getClassData( s_aCD ).query( rType, (ImplHelperBase##N< __IFC##N > *)this ) ); \
return (aRet.hasValue() ? aRet : OWeakAggObject::queryAggregation( rType )); \
} \
virtual void SAL_CALL acquire() throw () \
{ OWeakAggObject::acquire(); } \
virtual void SAL_CALL release() throw () \
{ OWeakAggObject::release(); } \
virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getTypes(); } \
virtual ::com::sun::star::uno::Sequence< sal_Int8 > SAL_CALL getImplementationId() throw (::com::sun::star::uno::RuntimeException) \
{ return this->getClassData( s_aCD ).getImplementationId(); } \
};
/** Implementation helper macro: have a look at __DEF_IMPLHELPER_PRE
*/
#define __DEF_IMPLHELPER_POST_B( N ) \
template< __CLASS_IFC##N > \
ClassData##N ImplHelper##N< __IFC##N >::s_aCD = ClassData##N( 0 ); \
template< __CLASS_IFC##N > \
ClassData##N WeakImplHelper##N< __IFC##N >::s_aCD = ClassData##N( 1 ); \
template< __CLASS_IFC##N > \
ClassData##N WeakAggImplHelper##N< __IFC##N >::s_aCD = ClassData##N( 2 );
/** Implementation helper macro: have a look at __DEF_IMPLHELPER_PRE
*/
#define __DEF_IMPLHELPER_POST_C( N ) \
}
/** Implementation helper macro: have a look at __DEF_IMPLHELPER_PRE
*/
#define __DEF_IMPLHELPER_POST( N ) \
__DEF_IMPLHELPER_POST_A( N ) \
__DEF_IMPLHELPER_POST_B( N ) \
__DEF_IMPLHELPER_POST_C( N )
/// @endcond
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
