odk/examples/DevelopersGuide/Database/DriverSkeleton/SDriver.cxx

   1 /*************************************************************************
   2  *
   3  *  $RCSfile: SDriver.cxx,v $
   4  *
   5  *  $Revision: 1.5 $
   6  *
   7  *  last change: $Author: kz $ $Date: 2006-11-06 15:00:59 $
   8  *
   9  *  The Contents of this file are made available subject to the terms of
  10  *  the BSD license.
  11  *
  12  *  Copyright (c) 2003 by Sun Microsystems, Inc.
  13  *  All rights reserved.
  14  *
  15  *  Redistribution and use in source and binary forms, with or without
  16  *  modification, are permitted provided that the following conditions
  17  *  are met:
  18  *  1. Redistributions of source code must retain the above copyright
  19  *     notice, this list of conditions and the following disclaimer.
  20  *  2. Redistributions in binary form must reproduce the above copyright
  21  *     notice, this list of conditions and the following disclaimer in the
  22  *     documentation and/or other materials provided with the distribution.
  23  *  3. Neither the name of Sun Microsystems, Inc. nor the names of its
  24  *     contributors may be used to endorse or promote products derived
  25  *     from this software without specific prior written permission.
  26  *
  27  *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  28  *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  29  *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  30  *  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  31  *  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  32  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  33  *  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  34  *  OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  35  *  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
  36  *  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  37  *  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38  *
  39  *************************************************************************/
  40
  41 #include "SDriver.hxx"
  42 #include "SConnection.hxx"
  43
  44 using namespace com::sun::star::uno;
  45 using namespace com::sun::star::lang;
  46 using namespace com::sun::star::beans;
  47 using namespace com::sun::star::sdbc;
  48 using namespace connectivity::skeleton;
  49
  50 namespace connectivity
  51 {
  52     namespace skeleton
  53     {
  54         //------------------------------------------------------------------
  55         ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >  SAL_CALL SkeletonDriver_CreateInstance(const ::com::sun::star::uno::Reference< ::com::sun::star::lang::XMultiServiceFactory >& _rxFactory) throw( ::com::sun::star::uno::Exception )
  56         {
  57             return *(new SkeletonDriver());
  58         }
  59     }
  60 }
  61 // --------------------------------------------------------------------------------
  62 SkeletonDriver::SkeletonDriver()
  63     : ODriver_BASE(m_aMutex)
  64 {
  65 }
  66 // --------------------------------------------------------------------------------
  67 void SkeletonDriver::disposing()
  68 {
  69     ::osl::MutexGuard aGuard(m_aMutex);
  70
  71     // when driver will be destroied so all our connections have to be destroied as well
  72     for (OWeakRefArray::iterator i = m_xConnections.begin(); m_xConnections.end() != i; ++i)
  73     {
  74         Reference< XComponent > xComp(i->get(), UNO_QUERY);
  75         if (xComp.is())
  76             xComp->dispose();
  77     }
  78     m_xConnections.clear();
  79
  80     ODriver_BASE::disposing();
  81 }
  82
  83 // static ServiceInfo
  84 //------------------------------------------------------------------------------
  85 rtl::OUString SkeletonDriver::getImplementationName_Static(  ) throw(RuntimeException)
  86 {
  87     return rtl::OUString::createFromAscii("com.sun.star.comp.sdbc.SkeletonDriver");
  88         // this name is referenced in the configuration and in the skeleton.xml
  89         // Please take care when changing it.
  90 }
  91 //------------------------------------------------------------------------------
  92 Sequence< ::rtl::OUString > SkeletonDriver::getSupportedServiceNames_Static(  ) throw (RuntimeException)
  93 {
  94     // which service is supported
  95     // for more information @see com.sun.star.sdbc.Driver
  96     Sequence< ::rtl::OUString > aSNS( 1 );
  97     aSNS[0] = ::rtl::OUString::createFromAscii("com.sun.star.sdbc.Driver");
  98     return aSNS;
  99 }
 100
 101 //------------------------------------------------------------------
 102 ::rtl::OUString SAL_CALL SkeletonDriver::getImplementationName(  ) throw(RuntimeException)
 103 {
 104     return getImplementationName_Static();
 105 }
 106
 107 //------------------------------------------------------------------
 108 sal_Bool SAL_CALL SkeletonDriver::supportsService( const ::rtl::OUString& _rServiceName ) throw(RuntimeException)
 109 {
 110     Sequence< ::rtl::OUString > aSupported(getSupportedServiceNames());
 111     const ::rtl::OUString* pSupported = aSupported.getConstArray();
 112     const ::rtl::OUString* pEnd = pSupported + aSupported.getLength();
 113     for (;pSupported != pEnd && !pSupported->equals(_rServiceName); ++pSupported)
 114         ;
 115
 116     return pSupported != pEnd;
 117 }
 118
 119 //------------------------------------------------------------------
 120 Sequence< ::rtl::OUString > SAL_CALL SkeletonDriver::getSupportedServiceNames(  ) throw(RuntimeException)
 121 {
 122     return getSupportedServiceNames_Static();
 123 }
 124
 125 // --------------------------------------------------------------------------------
 126 Reference< XConnection > SAL_CALL SkeletonDriver::connect( const ::rtl::OUString& url, const Sequence< PropertyValue >& info ) throw(SQLException, RuntimeException)
 127 {
 128     // create a new connection with the given properties and append it to our vector
 129     OConnection* pCon = new OConnection(this);
 130     Reference< XConnection > xCon = pCon;       // important here because otherwise the connection could be deleted inside (refcount goes -> 0)
 131     pCon->construct(url,info);                          // late constructor call which can throw exception and allows a correct dtor call when so
 132     m_xConnections.push_back(WeakReferenceHelper(*pCon));
 133
 134     return xCon;
 135 }
 136 // --------------------------------------------------------------------------------
 137 sal_Bool SAL_CALL SkeletonDriver::acceptsURL( const ::rtl::OUString& url )
 138         throw(SQLException, RuntimeException)
 139 {
 140     // here we have to look if we support this url format
 141     // change the URL format to your needs, but please aware that the first on who accepts the URl wins.
 142     return (!url.compareTo(::rtl::OUString::createFromAscii("sdbc:skeleton:"),14));
 143 }
 144 // --------------------------------------------------------------------------------
 145 Sequence< DriverPropertyInfo > SAL_CALL SkeletonDriver::getPropertyInfo( const ::rtl::OUString& url, const Sequence< PropertyValue >& info ) throw(SQLException, RuntimeException)
 146 {
 147     // if you have somthing special to say, return it here :-)
 148     return Sequence< DriverPropertyInfo >();
 149 }
 150 // --------------------------------------------------------------------------------
 151 sal_Int32 SAL_CALL SkeletonDriver::getMajorVersion(  ) throw(RuntimeException)
 152 {
 153     return 0; // depends on you
 154 }
 155 // --------------------------------------------------------------------------------
 156 sal_Int32 SAL_CALL SkeletonDriver::getMinorVersion(  ) throw(RuntimeException)
 157 {
 158     return 1; // depends on you
 159 }
 160 // --------------------------------------------------------------------------------
 161
 162 //.........................................................................
 163 namespace connectivity
 164 {
 165     namespace skeleton
 166     {
 167 //.........................................................................
 168
 169 void release(oslInterlockedCount& _refCount,
 170              ::cppu::OBroadcastHelper& rBHelper,
 171              ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _xInterface,
 172              ::com::sun::star::lang::XComponent* _pObject)
 173 {
 174     if (osl_decrementInterlockedCount( &_refCount ) == 0)
 175     {
 176         osl_incrementInterlockedCount( &_refCount );
 177
 178         if (!rBHelper.bDisposed && !rBHelper.bInDispose)
 179         {
 180             // remember the parent
 181             ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > xParent;
 182             {
 183                 ::osl::MutexGuard aGuard( rBHelper.rMutex );
 184                 xParent = _xInterface;
 185                 _xInterface = NULL;
 186             }
 187
 188             // First dispose
 189             _pObject->dispose();
 190
 191             // only the alive ref holds the object
 192             OSL_ASSERT( _refCount == 1 );
 193
 194             // release the parent in the ~
 195             if (xParent.is())
 196             {
 197                 ::osl::MutexGuard aGuard( rBHelper.rMutex );
 198                 _xInterface = xParent;
 199             }
 200         }
 201     }
 202     else
 203         osl_incrementInterlockedCount( &_refCount );
 204 }
 205
 206 void checkDisposed(sal_Bool _bThrow) throw ( DisposedException )
 207 {
 208     if (_bThrow)
 209         throw DisposedException();
 210
 211 }
 212 //.........................................................................
 213     }
 214 }
 215 //.........................................................................
 216