1 /*************************************************************************
2  *
3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4  *
5  * Copyright 2000, 2010 Oracle and/or its affiliates.
6  *
7  * OpenOffice.org - a multi-platform office productivity suite
8  *
9  * This file is part of OpenOffice.org.
10  *
11  * OpenOffice.org is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU Lesser General Public License version 3
13  * only, as published by the Free Software Foundation.
14  *
15  * OpenOffice.org is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU Lesser General Public License version 3 for more details
19  * (a copy is included in the LICENSE file that accompanied this code).
20  *
21  * You should have received a copy of the GNU Lesser General Public License
22  * version 3 along with OpenOffice.org.  If not, see
23  * <http://www.openoffice.org/license.html>
24  * for a copy of the LGPLv3 License.
25  *
26  ************************************************************************/
27 #ifndef CONNECTIVITY_POOLCOLLECTION_HXX
28 #define CONNECTIVITY_POOLCOLLECTION_HXX
29 
30 #include <cppuhelper/implbase5.hxx>
31 #include <com/sun/star/beans/XPropertyChangeListener.hpp>
32 #include <com/sun/star/sdbc/XDriverManager.hpp>
33 #include <com/sun/star/sdbc/XDriver.hpp>
34 #include <com/sun/star/sdbc/XDriverAccess.hpp>
35 #include <com/sun/star/sdbc/XPooledConnection.hpp>
36 #include <com/sun/star/sdbc/XConnection.hpp>
37 #include <com/sun/star/lang/XMultiServiceFactory.hpp>
38 #include <com/sun/star/lang/XServiceInfo.hpp>
39 #include <com/sun/star/lang/XEventListener.hpp>
40 #include <com/sun/star/frame/XDesktop.hpp>
41 #include <com/sun/star/frame/XTerminateListener.hpp>
42 #include <com/sun/star/reflection/XProxyFactory.hpp>
43 #include <comphelper/stl_types.hxx>
44 #include <osl/mutex.hxx>
45 
46 namespace connectivity
47 {
48 	class OConnectionPool;
49 	//==========================================================================
50 	//= OPoolCollection - the one-instance service for PooledConnections
51 	//= manages the active connections and the connections in the pool
52 	//==========================================================================
53 	typedef	::cppu::WeakImplHelper5<	::com::sun::star::sdbc::XDriverManager,
54 										::com::sun::star::sdbc::XDriverAccess,
55 										::com::sun::star::lang::XServiceInfo,
56 										::com::sun::star::frame::XTerminateListener,
57 										::com::sun::star::beans::XPropertyChangeListener
58 										>	OPoolCollection_Base;
59 
60 	/// OPoolCollection: controll the whole connection pooling for oo
61 	class OPoolCollection : public OPoolCollection_Base
62 	{
63 
64 		//==========================================================================
65 		typedef ::comphelper::OInterfaceCompare< ::com::sun::star::sdbc::XDriver >	ODriverCompare;
66 		DECLARE_STL_USTRINGACCESS_MAP(OConnectionPool*,	OConnectionPools);
67 
68 		DECLARE_STL_MAP(
69 				::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriver >,
70 				::com::sun::star::uno::WeakReference< ::com::sun::star::sdbc::XDriver >,
71 				ODriverCompare,
72 				MapDriver2DriverRef );
73 
74 		MapDriver2DriverRef																	m_aDriverProxies;
75 		::osl::Mutex																		m_aMutex;
76 		OConnectionPools																	m_aPools;		   // the driver pools
77 		::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >	m_xServiceFactory;
78 		::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriverManager >			m_xManager;
79 		::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriverAccess >			m_xDriverAccess;
80 		::com::sun::star::uno::Reference< ::com::sun::star::reflection::XProxyFactory >		m_xProxyFactory;
81 		::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >				m_xConfigNode;		// config node for generel connection pooling
82 		::com::sun::star::uno::Reference< ::com::sun::star::frame::XDesktop>				m_xDesktop;
83 
84 	private:
85 		OPoolCollection();							// never implemented
86 		OPoolCollection(const OPoolCollection&);	// never implemented
87 		int operator= (const OPoolCollection&);			// never implemented
88 
89 		OPoolCollection(
90 			const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >&	_rxFactory);
91 
92 		// some configuration helper methods
93 		::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > createWithServiceFactory(const ::rtl::OUString& _rPath) const;
94 		::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > getConfigPoolRoot();
95 		::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > createWithProvider(	const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rxConfProvider,
96 																									const ::rtl::OUString& _rPath) const;
97 		::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > openNode(	const ::rtl::OUString& _rPath,
98 																						const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _xTreeNode) const throw();
99 		sal_Bool isPoolingEnabled();
100 		sal_Bool isDriverPoolingEnabled(const ::rtl::OUString& _sDriverImplName,
101 										::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxDriverNode);
102 		sal_Bool isPoolingEnabledByUrl(	const ::rtl::OUString& _sUrl,
103 										::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriver >& _rxDriver,
104 										::rtl::OUString& _rsImplName,
105 										::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxDriverNode);
106 
107 		OConnectionPool* getConnectionPool(	const ::rtl::OUString& _sImplName,
108 											const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriver >& _xDriver,
109 											const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxDriverNode);
110 		void clearConnectionPools(sal_Bool _bDispose);
111 		void clearDesktop();
112 	protected:
113 		virtual ~OPoolCollection();
114 	public:
115 
116 		static ::com::sun::star::uno::Any getNodeValue(	const ::rtl::OUString& _rPath,
117 														const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface>& _xTreeNode)throw();
118 
119 	// XDriverManager
120 		virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection > SAL_CALL getConnection( const ::rtl::OUString& url ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException);
121 		virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection > SAL_CALL getConnectionWithInfo( const ::rtl::OUString& url, const ::com::sun::star::uno::Sequence< ::com::sun::star::beans::PropertyValue >& info ) throw(::com::sun::star::sdbc::SQLException, ::com::sun::star::uno::RuntimeException);
122 		virtual void SAL_CALL setLoginTimeout( sal_Int32 seconds ) throw(::com::sun::star::uno::RuntimeException);
123 		virtual sal_Int32 SAL_CALL getLoginTimeout(  ) throw(::com::sun::star::uno::RuntimeException);
124 
125 	//XDriverAccess
126 		virtual ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XDriver > SAL_CALL getDriverByURL( const ::rtl::OUString& url ) throw (::com::sun::star::uno::RuntimeException);
127 	// XServiceInfo
128 		virtual ::rtl::OUString SAL_CALL getImplementationName(  ) throw(::com::sun::star::uno::RuntimeException);
129 		virtual sal_Bool SAL_CALL supportsService( const ::rtl::OUString& ServiceName ) throw(::com::sun::star::uno::RuntimeException);
130 		virtual ::com::sun::star::uno::Sequence< ::rtl::OUString > SAL_CALL getSupportedServiceNames(  ) throw(::com::sun::star::uno::RuntimeException);
131 
132 	// XServiceInfo - static methods
133 		static ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > SAL_CALL CreateInstance(const::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >&);
134 		static ::rtl::OUString SAL_CALL getImplementationName_Static(  ) throw(::com::sun::star::uno::RuntimeException);
135 		static ::com::sun::star::uno::Sequence< ::rtl::OUString > SAL_CALL getSupportedServiceNames_Static(  ) throw(::com::sun::star::uno::RuntimeException);
136 
137 		// XEventListener
138 		virtual void SAL_CALL disposing( const ::com::sun::star::lang::EventObject& Source ) throw (::com::sun::star::uno::RuntimeException);
139 		// XPropertyChangeListener
140 		virtual void SAL_CALL propertyChange( const ::com::sun::star::beans::PropertyChangeEvent& evt ) throw (::com::sun::star::uno::RuntimeException);
141 
142 		// XTerminateListener
143 		virtual void SAL_CALL queryTermination( const ::com::sun::star::lang::EventObject& Event ) throw (::com::sun::star::frame::TerminationVetoException, ::com::sun::star::uno::RuntimeException);
144 		virtual void SAL_CALL notifyTermination( const ::com::sun::star::lang::EventObject& Event ) throw (::com::sun::star::uno::RuntimeException);
145 	};
146 }
147 #endif // CONNECTIVITY_POOLCOLLECTION_HXX
148 
149