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 DBAUI_SUBCOMPONENTCONTROLLER_HXX
21 : : #define DBAUI_SUBCOMPONENTCONTROLLER_HXX
22 : :
23 : : #include "genericcontroller.hxx"
24 : :
25 : : #include <com/sun/star/document/XScriptInvocationContext.hpp>
26 : : #include <com/sun/star/sdbc/XConnection.hpp>
27 : : #include <com/sun/star/sdbc/XDatabaseMetaData.hpp>
28 : : #include <com/sun/star/sdbc/XDataSource.hpp>
29 : : #include <com/sun/star/util/XNumberFormatter.hpp>
30 : : #include <com/sun/star/util/XModifiable.hpp>
31 : :
32 : : #include <comphelper/broadcasthelper.hxx>
33 : : #include <comphelper/proparrhlp.hxx>
34 : : #include <comphelper/propertycontainer.hxx>
35 : : #include <connectivity/dbmetadata.hxx>
36 : : #include <cppuhelper/implbase2.hxx>
37 : :
38 : : #include <memory>
39 : :
40 : : //........................................................................
41 : : namespace dbaui
42 : : {
43 : : //........................................................................
44 : :
45 : : //====================================================================
46 : : //= DBSubComponentController
47 : : //====================================================================
48 : : class DBSubComponentController;
49 : :
50 : : typedef ::cppu::ImplInheritanceHelper2 < OGenericUnoController
51 : : , ::com::sun::star::document::XScriptInvocationContext
52 : : , ::com::sun::star::util::XModifiable
53 : : > DBSubComponentController_Base;
54 : :
55 : : struct DBSubComponentController_Impl;
56 : : class DBACCESS_DLLPUBLIC DBSubComponentController : public DBSubComponentController_Base
57 : : {
58 : : private:
59 : : ::std::auto_ptr<DBSubComponentController_Impl> m_pImpl;
60 : :
61 : : private:
62 : : /** forces usage of a connection which we do not own
63 : : <p>To be used from within XInitialization::initialize, resp. impl_initialize, only.</p>
64 : : */
65 : : void initializeConnection( const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& _rxForeignConn );
66 : :
67 : : protected:
68 : : // OGenericUnoController - initialization
69 : : virtual void impl_initialize();
70 : :
71 : : // OGenericUnoController
72 : : virtual void Execute(sal_uInt16 nId, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue>& aArgs);
73 : :
74 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > getPrivateModel() const;
75 : :
76 : : sal_Bool impl_isModified() const;
77 : : virtual void impl_onModifyChanged();
78 : :
79 : : public:
80 : :
81 : : sal_Bool isReadOnly() const;
82 : : sal_Bool isEditable() const;
83 : : void setEditable(sal_Bool _bEditable);
84 : :
85 : : // ----------------------------------------------------------------
86 : : // asking for connection-related stuff
87 : :
88 : : sal_Bool isConnected() const;
89 : :
90 : : ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDatabaseMetaData >
91 : : getMetaData( ) const;
92 : :
93 : : // ----------------------------------------------------------------
94 : : // access to the data source / document
95 : : ::rtl::OUString getDataSourceName() const;
96 : : const ::com::sun::star::uno::Reference< ::com::sun::star::beans::XPropertySet >&
97 : : getDataSource() const;
98 : : sal_Bool haveDataSource() const;
99 : :
100 : : ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel >
101 : : getDatabaseDocument() const;
102 : :
103 : : /** provides access to the SDB-level database meta data of the current connection
104 : : */
105 : : const ::dbtools::DatabaseMetaData& getSdbMetaData() const;
106 : :
107 : : /** appends an error in the current environment.
108 : : */
109 : : void appendError(
110 : : const ::rtl::OUString& _rErrorMessage,
111 : : const ::dbtools::StandardSQLState _eSQLState = ::dbtools::SQL_GENERAL_ERROR,
112 : : const sal_Int32 _nErrorCode = 1000
113 : : );
114 : :
115 : : /** clears the error state.
116 : : */
117 : : void clearError();
118 : :
119 : : /** @return
120 : : <TRUE/> when an error was set otherwise <FALSE/>
121 : : */
122 : : sal_Bool hasError() const;
123 : :
124 : : /** returns the current error
125 : : */
126 : : const ::dbtools::SQLExceptionInfo& getError() const;
127 : :
128 : : /** displays the current error, or does nothing if there is no current error
129 : : */
130 : : void displayError();
131 : :
132 : : /** shows an info box with the string conntection lost.
133 : : */
134 : : void connectionLostMessage() const;
135 : :
136 : : /** gives access to the currently used connection
137 : : @return
138 : : the currently used connection.
139 : : */
140 : : const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >&
141 : : getConnection() const;
142 : :
143 : : /** returns the number formatter
144 : : */
145 : : ::com::sun::star::uno::Reference< ::com::sun::star::util::XNumberFormatter > getNumberFormatter() const;
146 : :
147 : : // ::com::sun::star::frame::XController
148 : : virtual sal_Bool SAL_CALL suspend(sal_Bool bSuspend) throw( ::com::sun::star::uno::RuntimeException );
149 : : virtual sal_Bool SAL_CALL attachModel(const ::com::sun::star::uno::Reference< ::com::sun::star::frame::XModel > & xModel) throw( ::com::sun::star::uno::RuntimeException );
150 : :
151 : : // XScriptInvocationContext
152 : : virtual ::com::sun::star::uno::Reference< ::com::sun::star::document::XEmbeddedScripts > SAL_CALL getScriptContainer() throw (::com::sun::star::uno::RuntimeException);
153 : :
154 : : // XModifiable
155 : : virtual ::sal_Bool SAL_CALL isModified( ) throw (::com::sun::star::uno::RuntimeException);
156 : : virtual void SAL_CALL setModified( ::sal_Bool bModified ) throw (::com::sun::star::beans::PropertyVetoException, ::com::sun::star::uno::RuntimeException);
157 : :
158 : : // XModifyBroadcaster
159 : : virtual void SAL_CALL addModifyListener( const ::com::sun::star::uno::Reference< ::com::sun::star::util::XModifyListener >& aListener ) throw (::com::sun::star::uno::RuntimeException);
160 : : virtual void SAL_CALL removeModifyListener( const ::com::sun::star::uno::Reference< ::com::sun::star::util::XModifyListener >& aListener ) throw (::com::sun::star::uno::RuntimeException);
161 : :
162 : : // XTitle
163 : : virtual ::rtl::OUString SAL_CALL getTitle( ) throw (::com::sun::star::uno::RuntimeException);
164 : :
165 : : protected:
166 : : DBSubComponentController(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory>& _rxORB);
167 : : virtual ~DBSubComponentController();
168 : :
169 : : virtual void disconnect();
170 : : virtual void reconnect( sal_Bool _bUI );
171 [ # # ]: 0 : sal_Bool ensureConnected( sal_Bool _bUI ) { if ( !isConnected() ) reconnect( _bUI ); return isConnected(); }
172 : :
173 : : /** called when our connection is beeing disposed
174 : : <p>The default implementation does a reconnect</p>
175 : : */
176 : : virtual void losingConnection( );
177 : :
178 : : protected:
179 : : // XEventListener
180 : : virtual void SAL_CALL disposing(const ::com::sun::star::lang::EventObject& Source) throw( ::com::sun::star::uno::RuntimeException );
181 : :
182 : : // OComponentHelper
183 : : virtual void SAL_CALL disposing();
184 : :
185 : : // XInterface
186 : : virtual ::com::sun::star::uno::Any SAL_CALL queryInterface(const ::com::sun::star::uno::Type& _rType) throw (::com::sun::star::uno::RuntimeException);
187 : :
188 : : // XTypeProvider
189 : : virtual ::com::sun::star::uno::Sequence< ::com::sun::star::uno::Type > SAL_CALL getTypes( ) throw (::com::sun::star::uno::RuntimeException);
190 : :
191 : : protected:
192 : : sal_Int32 getCurrentStartNumber() const;
193 : :
194 : : private:
195 : : DBSubComponentController(); // never implemented
196 : : };
197 : :
198 : : //........................................................................
199 : : } // namespace dbaui
200 : : //........................................................................
201 : :
202 : : #endif // DBAUI_SUBCOMPONENTCONTROLLER_HXX
203 : :
204 : : /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|