Branch data 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 : :
20 : : #ifndef _DBA_COREDATAACCESS_DOCUMENTDEFINITION_HXX_
21 : : #define _DBA_COREDATAACCESS_DOCUMENTDEFINITION_HXX_
22 : :
23 : : #include <cppuhelper/propshlp.hxx>
24 : : #include <cppuhelper/implbase4.hxx>
25 : : #include "ContentHelper.hxx"
26 : : #include <comphelper/propertystatecontainer.hxx>
27 : : #include <comphelper/proparrhlp.hxx>
28 : : #include "apitools.hxx"
29 : : #include <comphelper/uno3.hxx>
30 : : #include <com/sun/star/sdbc/XConnection.hpp>
31 : : #include <com/sun/star/frame/XComponentLoader.hpp>
32 : : #include <com/sun/star/frame/XController.hpp>
33 : : #include <com/sun/star/embed/XStateChangeListener.hpp>
34 : : #include <com/sun/star/sdb/XSubDocument.hpp>
35 : : #include <com/sun/star/util/XCloseListener.hpp>
36 : : #include <com/sun/star/container/XHierarchicalName.hpp>
37 : :
38 : : namespace comphelper
39 : : {
40 : : class NamedValueCollection;
41 : : }
42 : :
43 : : //........................................................................
44 : : namespace dbaccess
45 : : {
46 : : //........................................................................
47 : :
48 : : class OInterceptor;
49 : : class OEmbeddedClientHelper;
50 : : //==========================================================================
51 : : //= ODocumentDefinition - a database "document" which is simply a link to a real
52 : : //= document
53 : : //==========================================================================
54 : :
55 : : typedef ::cppu::ImplHelper4 < ::com::sun::star::embed::XComponentSupplier
56 : : , ::com::sun::star::sdb::XSubDocument
57 : : , ::com::sun::star::util::XCloseListener
58 : : , ::com::sun::star::container::XHierarchicalName
59 : : > ODocumentDefinition_Base;
60 : :
61 : : class ODocumentDefinition
62 : : :public OContentHelper
63 : : ,public ::comphelper::OPropertyStateContainer
64 : : ,public ::comphelper::OPropertyArrayUsageHelper< ODocumentDefinition >
65 : : ,public ODocumentDefinition_Base
66 : : {
67 : : ::com::sun::star::uno::Reference< ::com::sun::star::embed::XEmbeddedObject> m_xEmbeddedObject;
68 : : ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStateChangeListener > m_xListener;
69 : : ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection > m_xLastKnownConnection;
70 : :
71 : : OInterceptor* m_pInterceptor;
72 : : sal_Bool m_bForm; // <TRUE/> if it is a form
73 : : sal_Bool m_bOpenInDesign;
74 : : sal_Bool m_bInExecute;
75 : : sal_Bool m_bRemoveListener;
76 : : OEmbeddedClientHelper* m_pClientHelper;
77 : :
78 : : protected:
79 : : virtual ~ODocumentDefinition();
80 : :
81 : : public:
82 : :
83 : : ODocumentDefinition(
84 : : const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxContainer,
85 : : const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >&,
86 : : const TContentPtr& _pImpl,
87 : : sal_Bool _bForm
88 : : );
89 : :
90 : : void initialLoad(
91 : : const ::com::sun::star::uno::Sequence< sal_Int8 >& i_rClassID,
92 : : const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& i_rCreationArgs,
93 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& i_rConnection
94 : : );
95 : :
96 : : // com::sun::star::lang::XTypeProvider
97 : : DECLARE_TYPEPROVIDER( );
98 : :
99 : : // ::com::sun::star::uno::XInterface
100 : : DECLARE_XINTERFACE( )
101 : :
102 : : // ::com::sun::star::lang::XServiceInfo
103 : : DECLARE_SERVICE_INFO_STATIC();
104 : :
105 : : // ::com::sun::star::beans::XPropertySet
106 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySetInfo > SAL_CALL getPropertySetInfo( ) throw(::com::sun::star::uno::RuntimeException);
107 : :
108 : : // OPropertySetHelper
109 : : virtual void SAL_CALL getFastPropertyValue(
110 : : ::com::sun::star::uno::Any& o_rValue,
111 : : sal_Int32 i_nHandle
112 : : ) const;
113 : :
114 : : // XComponentSupplier
115 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::util::XCloseable > SAL_CALL getComponent( ) throw (::com::sun::star::uno::RuntimeException);
116 : :
117 : : // XSubDocument
118 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::lang::XComponent > SAL_CALL open( ) throw (::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException);
119 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::lang::XComponent > SAL_CALL openDesign( ) throw (::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException);
120 : : virtual void SAL_CALL store( ) throw (::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException);
121 : : virtual ::sal_Bool SAL_CALL close( ) throw (::com::sun::star::lang::WrappedTargetException, ::com::sun::star::uno::RuntimeException);
122 : :
123 : : // XHierarchicalName
124 : : virtual ::rtl::OUString SAL_CALL getHierarchicalName( ) throw (::com::sun::star::uno::RuntimeException);
125 : : virtual ::rtl::OUString SAL_CALL composeHierarchicalName( const ::rtl::OUString& aRelativeName ) throw (::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::lang::NoSupportException, ::com::sun::star::uno::RuntimeException);
126 : :
127 : : // OPropertySetHelper
128 : : virtual ::cppu::IPropertyArrayHelper& SAL_CALL getInfoHelper();
129 : :
130 : : // XCommandProcessor
131 : : virtual ::com::sun::star::uno::Any SAL_CALL execute( const ::com::sun::star::ucb::Command& aCommand, sal_Int32 CommandId, const ::com::sun::star::uno::Reference< ::com::sun::star::ucb::XCommandEnvironment >& Environment ) throw (::com::sun::star::uno::Exception, ::com::sun::star::ucb::CommandAbortedException, ::com::sun::star::uno::RuntimeException) ;
132 : :
133 : : // XRename
134 : : virtual void SAL_CALL rename( const ::rtl::OUString& newName ) throw (::com::sun::star::sdbc::SQLException, ::com::sun::star::container::ElementExistException, ::com::sun::star::uno::RuntimeException);
135 : :
136 : : // XCloseListener
137 : : virtual void SAL_CALL queryClosing( const ::com::sun::star::lang::EventObject& Source, ::sal_Bool GetsOwnership ) throw (::com::sun::star::util::CloseVetoException, ::com::sun::star::uno::RuntimeException);
138 : : virtual void SAL_CALL notifyClosing( const ::com::sun::star::lang::EventObject& Source ) throw (::com::sun::star::uno::RuntimeException);
139 : :
140 : : // XEventListener
141 : : virtual void SAL_CALL disposing( const ::com::sun::star::lang::EventObject& Source ) throw (::com::sun::star::uno::RuntimeException);
142 : :
143 : : /** returns the forms/reports container storage, depending on m_bForm. Our own storage
144 : : inside this container storage is the one with the name as indicated by m_pImpl->m_aProps.sPersistentName.
145 : : */
146 : : ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage >
147 : : getContainerStorage() const;
148 : :
149 : : sal_Bool save(sal_Bool _bApprove);
150 : : sal_Bool saveAs();
151 : : void closeObject();
152 : : sal_Bool isModified();
153 [ # # ][ # # ]: 0 : inline sal_Bool isNewReport() const { return !m_bForm && !m_pImpl->m_aProps.bAsTemplate; }
154 : :
155 : : static void fillReportData(
156 : : const ::comphelper::ComponentContext& _rContext,
157 : : const ::com::sun::star::uno::Reference< ::com::sun::star::util::XCloseable >& _rxComponent,
158 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& _rxActiveConnection
159 : : );
160 : :
161 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >&
162 : 0 : getConnection() const { return m_xLastKnownConnection; }
163 : :
164 : : /** prepares closing the document component
165 : :
166 : : The method suspends the controller associated with the document, and saves the document
167 : : if necessary.
168 : :
169 : : @return
170 : : <TRUE/> if and only if the document component can be closed
171 : : */
172 : : bool prepareClose();
173 : :
174 : : static ::com::sun::star::uno::Sequence< sal_Int8 > getDefaultDocumentTypeClassId();
175 : :
176 : : static ::rtl::OUString GetDocumentServiceFromMediaType(
177 : : const ::rtl::OUString& _rMediaType,
178 : : const ::comphelper::ComponentContext& _rContext,
179 : : ::com::sun::star::uno::Sequence< sal_Int8 >& _rClassId
180 : : );
181 : : static ::rtl::OUString GetDocumentServiceFromMediaType(
182 : : const ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage >& _rxContainerStorage,
183 : : const ::rtl::OUString& _rEntityName,
184 : : const ::comphelper::ComponentContext& _rContext,
185 : : ::com::sun::star::uno::Sequence< sal_Int8 >& _rClassId
186 : : );
187 : :
188 : 0 : struct NotifierAccess { friend class NameChangeNotifier; private: NotifierAccess() { } };
189 : 0 : const ::rtl::OUString& getCurrentName() const { return m_pImpl->m_aProps.aTitle; }
190 : : void firePropertyChange(
191 : : sal_Int32 i_nHandle,
192 : : const ::com::sun::star::uno::Any& i_rNewValue,
193 : : const ::com::sun::star::uno::Any& i_rOldValue,
194 : : sal_Bool i_bVetoable,
195 : : const NotifierAccess
196 : : );
197 : :
198 : : private:
199 : : /** does necessary initializations after our embedded object has been switched to ACTIVE
200 : : */
201 : : void impl_onActivateEmbeddedObject_nothrow( const bool i_bReactivated );
202 : :
203 : : /** initializes a newly created view/controller of a form which is displaying our embedded object
204 : :
205 : : Has only to be called if the respective embedded object has been loaded for design (and
206 : : not for data entry)
207 : :
208 : : @param _rxController
209 : : the controller which belongs to the XModel of our (active) embedded object
210 : : */
211 : : static void impl_initFormEditView( const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XController >& _rxController );
212 : :
213 : : /** removes the given frame from the desktop's frame collection
214 : : @raises ::com::sun::star::uno::RuntimeException
215 : : */
216 : : static void impl_removeFrameFromDesktop_throw(
217 : : const ::comphelper::ComponentContext& _rContxt,
218 : : const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XFrame >& _rxFrame
219 : : );
220 : :
221 : : /** opens the UI for this sub document
222 : : */
223 : : ::com::sun::star::uno::Reference< ::com::sun::star::lang::XComponent >
224 : : impl_openUI_nolck_throw( bool _bForEditing );
225 : :
226 : : /** stores our document, if it's already loaded
227 : : */
228 : : void impl_store_throw();
229 : :
230 : : /** closes our document, if it's open
231 : : */
232 : : bool impl_close_throw();
233 : :
234 : : /** returns our component, creates it if necessary
235 : : */
236 : : ::com::sun::star::uno::Reference< ::com::sun::star::util::XCloseable >
237 : : impl_getComponent_throw( const bool i_ForceCreate = true );
238 : :
239 : : /** shows or hides our component
240 : :
241 : : The embedded object must exist, and be in state LOADED, at least.
242 : : */
243 : : void impl_showOrHideComponent_throw( const bool i_bShow );
244 : :
245 : : // OPropertyArrayUsageHelper
246 : : virtual ::cppu::IPropertyArrayHelper* createArrayHelper( ) const;
247 : :
248 : : virtual void getPropertyDefaultByHandle( sal_Int32 _nHandle, ::com::sun::star::uno::Any& _rDefault ) const;
249 : :
250 : : // helper
251 : : virtual void SAL_CALL disposing();
252 : :
253 : : // OContentHelper overridables
254 : : virtual ::rtl::OUString determineContentType() const;
255 : :
256 : : /** fills the load arguments
257 : : */
258 : : ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >
259 : : fillLoadArgs(
260 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection>& _xConnection,
261 : : const bool _bSuppressMacros,
262 : : const bool _bReadOnly,
263 : : const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& i_rOpenCommandArguments,
264 : : ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& _out_rEmbeddedObjectDescriptor
265 : : );
266 : :
267 : : /** splits the given arguments to an "open*" command into arguments for loading the document, and arguments to be
268 : : put into the EmbeddedObjectDescriptor
269 : :
270 : : Any values already present in <code>o_rDocumentLoadArgs</code> and <code>o_rEmbeddedObjectDescriptor</code>
271 : : will be overwritten by values from <code>i_rOpenCommandArguments</code>, if applicable, otherwise they will
272 : : be preserved.
273 : :
274 : : @param i_rOpenCommandArguments
275 : : the arguments passed to the "open*" command at the content
276 : : @param o_rDocumentLoadArgs
277 : : the arguments to be passed when actually loading the embedded document.
278 : : @param o_rEmbeddedObjectDescriptor
279 : : the EmbeddedObjectDescriptor to be passed when initializing the embedded object
280 : : */
281 : : void separateOpenCommandArguments(
282 : : const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& i_rOpenCommandArguments,
283 : : ::comphelper::NamedValueCollection& o_rDocumentLoadArgs,
284 : : ::comphelper::NamedValueCollection& o_rEmbeddedObjectDescriptor
285 : : );
286 : :
287 : : /** loads the EmbeddedObject if not already loaded
288 : : @param _aClassID
289 : : If set, it will be used to create the embedded object.
290 : : */
291 : : void loadEmbeddedObject(
292 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection>& _xConnection,
293 : : const ::com::sun::star::uno::Sequence< sal_Int8 >& _aClassID,
294 : : const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& _rAdditionalArgs,
295 : : const bool _bSuppressMacros,
296 : : const bool _bReadOnly
297 : : );
298 : :
299 : : /** loads the embedded object, if not already loaded. No new object can be created with this method.
300 : : */
301 : : void loadEmbeddedObject( bool _bSuppressMacros = false )
302 : : {
303 : : loadEmbeddedObject(
304 : : NULL,
305 : : ::com::sun::star::uno::Sequence< sal_Int8 >(),
306 : : ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >(),
307 : : _bSuppressMacros,
308 : : false
309 : : );
310 : : }
311 : :
312 : : /** loads the embedded object for preview. Macros will be suppressed, and the document will
313 : : be read-only.
314 : : */
315 : 0 : void loadEmbeddedObjectForPreview()
316 : : {
317 : : loadEmbeddedObject(
318 : : NULL,
319 : : ::com::sun::star::uno::Sequence< sal_Int8 >(),
320 : : ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >(),
321 : : true,
322 : : true
323 [ # # ][ # # ]: 0 : );
[ # # ][ # # ]
324 : 0 : }
325 : :
326 : : /** searches for read-only flag in the args of the model and sets it to the given value,
327 : : if the value was not found, it will be appended.
328 : : @param _bReadOnly
329 : : If <TRUE/> the document will be switched to readonly mode
330 : : */
331 : : void updateDocumentTitle();
332 : :
333 : : void registerProperties();
334 : :
335 : : /** determines whether the document we represent supports embedded scripts and macros
336 : : */
337 : : sal_Bool objectSupportsEmbeddedScripts() const;
338 : :
339 : : //- commands
340 : :
341 : : void onCommandGetDocumentProperties( ::com::sun::star::uno::Any& _rProps );
342 : : void onCommandInsert( const ::rtl::OUString& _sURL, const ::com::sun::star::uno::Reference< ::com::sun::star::ucb::XCommandEnvironment >& Environment ) throw( ::com::sun::star::uno::Exception );
343 : : void onCommandPreview( ::com::sun::star::uno::Any& _rImage );
344 : : ::com::sun::star::uno::Any
345 : : onCommandOpenSomething(
346 : : const ::com::sun::star::uno::Any& _rArgument,
347 : : const bool _bActivate,
348 : : const ::com::sun::star::uno::Reference< ::com::sun::star::ucb::XCommandEnvironment >& _rxEnvironment
349 : : );
350 : : private:
351 : : using ::cppu::OPropertySetHelper::getFastPropertyValue;
352 : : };
353 : :
354 : : class NameChangeNotifier
355 : : {
356 : : public:
357 : : NameChangeNotifier(
358 : : ODocumentDefinition& i_rDocumentDefinition,
359 : : const ::rtl::OUString& i_rNewName,
360 : : ::osl::ResettableMutexGuard& i_rClearForNotify
361 : : );
362 : : ~NameChangeNotifier();
363 : :
364 : : private:
365 : : ODocumentDefinition& m_rDocumentDefinition;
366 : : const ::com::sun::star::uno::Any m_aOldValue;
367 : : const ::com::sun::star::uno::Any m_aNewValue;
368 : : ::osl::ResettableMutexGuard& m_rClearForNotify;
369 : :
370 : : void impl_fireEvent_throw( const sal_Bool i_bVetoable );
371 : : };
372 : :
373 : : } // namespace dbaccess
374 : :
375 : : #endif // _DBA_COREDATAACCESS_DOCUMENTDEFINITION_HXX_
376 : :
377 : : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|