unotools/source/ucbhelper/xtempfile.cxx

   1 /*************************************************************************
   2  *
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * Copyright 2008 by Sun Microsystems, Inc.
   6  *
   7  * OpenOffice.org - a multi-platform office productivity suite
   8  *
   9  * $RCSfile: xtempfile.cxx,v $
  10  * $Revision: 1.16 $
  11  *
  12  * This file is part of OpenOffice.org.
  13  *
  14  * OpenOffice.org is free software: you can redistribute it and/or modify
  15  * it under the terms of the GNU Lesser General Public License version 3
  16  * only, as published by the Free Software Foundation.
  17  *
  18  * OpenOffice.org is distributed in the hope that it will be useful,
  19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21  * GNU Lesser General Public License version 3 for more details
  22  * (a copy is included in the LICENSE file that accompanied this code).
  23  *
  24  * You should have received a copy of the GNU Lesser General Public License
  25  * version 3 along with OpenOffice.org.  If not, see
  26  * <http://www.openoffice.org/license.html>
  27  * for a copy of the LGPLv3 License.
  28  *
  29  ************************************************************************/
  30 #include "precompiled_unotools.hxx"
  31 #include <XTempFile.hxx>
  32 #include <cppuhelper/factory.hxx>
  33 #include <cppuhelper/typeprovider.hxx>
  34 #ifndef _COM_SUN_STAR_REGISTRY_XREGISTRYKEY_HPP
  35 #include <com/sun/star/registry/XRegistryKey.hpp>
  36 #endif
  37 #ifndef _COM_SUN_STAR_BEANS_PROPERTYATTRIBUTE_HPP
  38 #include <com/sun/star/beans/PropertyAttribute.hpp>
  39 #endif
  40 #include <unotools/tempfile.hxx>
  41 #include <osl/file.hxx>
  42 #include <unotools/configmgr.hxx>
  43 #include <tools/urlobj.hxx>
  44 #include <tools/debug.hxx>
  45
  46 namespace css = com::sun::star;
  47
  48 // copy define from desktop\source\app\appinit.cxx
  49
  50 #define DESKTOP_TEMPNAMEBASE_DIR        "/temp/soffice.tmp"
  51
  52 OTempFileService::OTempFileService(::css::uno::Reference< ::css::uno::XComponentContext > const & context)
  53 : ::cppu::PropertySetMixin< ::css::io::XTempFile >(
  54     context
  55     , static_cast< Implements >( IMPLEMENTS_PROPERTY_SET | IMPLEMENTS_FAST_PROPERTY_SET | IMPLEMENTS_PROPERTY_ACCESS )
  56     , com::sun::star::uno::Sequence< rtl::OUString >() )
  57 , mpStream( NULL )
  58 , mbRemoveFile( sal_True )
  59 , mbInClosed( sal_False )
  60 , mbOutClosed( sal_False )
  61 , mnCachedPos( 0 )
  62 , mbHasCachedPos( sal_False )
  63
  64 {
  65     mpTempFile = new ::utl::TempFile;
  66     mpTempFile->EnableKillingFile ( sal_True );
  67 }
  68
  69 OTempFileService::~OTempFileService ()
  70 {
  71     if ( mpTempFile )
  72         delete mpTempFile;
  73 }
  74
  75
  76 // XInterface
  77
  78 ::css::uno::Any SAL_CALL OTempFileService::queryInterface( ::css::uno::Type const & aType )
  79 throw ( ::css::uno::RuntimeException )
  80 {
  81     ::css::uno::Any aResult( OTempFileBase::queryInterface( aType ) );
  82     if (!aResult.hasValue())
  83         aResult = cppu::PropertySetMixin< ::css::io::XTempFile >::queryInterface( aType ) ;
  84     return aResult;
  85 };
  86 void SAL_CALL OTempFileService::acquire(  )
  87 throw ()
  88 {
  89     OTempFileBase::acquire();
  90 }
  91 void SAL_CALL OTempFileService::release(  )
  92 throw ()
  93 {
  94     OTempFileBase::release();
  95 }
  96
  97 //      XTypeProvider
  98
  99 ::css::uno::Sequence< ::css::uno::Type > SAL_CALL OTempFileService::getTypes(  )
 100 throw ( ::css::uno::RuntimeException )
 101 {
 102     static ::cppu::OTypeCollection* pTypeCollection = NULL;
 103     if ( pTypeCollection == NULL )
 104     {
 105         ::osl::MutexGuard aGuard( ::osl::Mutex::getGlobalMutex() ) ;
 106
 107         if ( pTypeCollection == NULL )
 108         {
 109             static ::cppu::OTypeCollection aTypeCollection(
 110                 ::getCppuType( ( const ::css::uno::Reference< ::css::beans::XPropertySet >*)NULL )
 111                 ,OTempFileBase::getTypes() );
 112             pTypeCollection = &aTypeCollection;
 113         }
 114     }
 115     return pTypeCollection->getTypes();
 116 };
 117 ::css::uno::Sequence< sal_Int8 > SAL_CALL OTempFileService::getImplementationId(  )
 118 throw ( ::css::uno::RuntimeException )
 119 {
 120     return OTempFileBase::getImplementationId();
 121 }
 122
 123 //      XTempFile
 124
 125 sal_Bool SAL_CALL OTempFileService::getRemoveFile()
 126 throw ( ::css::uno::RuntimeException )
 127 {
 128     ::osl::MutexGuard aGuard( maMutex );
 129
 130     if ( !mpTempFile )
 131     {
 132         // the stream is already disconnected
 133         throw ::css::uno::RuntimeException();
 134         }
 135
 136     return mbRemoveFile;
 137 };
 138 void SAL_CALL OTempFileService::setRemoveFile( sal_Bool _removefile )
 139 throw ( ::css::uno::RuntimeException )
 140 {
 141     ::osl::MutexGuard aGuard( maMutex );
 142
 143     if ( !mpTempFile )
 144     {
 145         // the stream is already disconnected
 146         throw ::css::uno::RuntimeException();
 147     }
 148
 149     mbRemoveFile = _removefile;
 150     mpTempFile->EnableKillingFile( mbRemoveFile );
 151 };
 152 ::rtl::OUString SAL_CALL OTempFileService::getUri()
 153 throw ( ::css::uno::RuntimeException )
 154 {
 155     ::osl::MutexGuard aGuard( maMutex );
 156
 157     if ( !mpTempFile )
 158     {
 159         throw ::css::uno::RuntimeException();
 160     }
 161
 162     return ::rtl::OUString( mpTempFile->GetURL() );
 163
 164 };
 165 ::rtl::OUString SAL_CALL OTempFileService::getResourceName()
 166 throw ( ::css::uno::RuntimeException )
 167 {
 168     ::osl::MutexGuard aGuard( maMutex );
 169
 170     if ( !mpTempFile )
 171     {
 172         throw ::css::uno::RuntimeException();
 173 }
 174
 175     return ::rtl::OUString( mpTempFile->GetFileName() );
 176 };
 177
 178
 179
 180 // XInputStream
 181
 182 sal_Int32 SAL_CALL OTempFileService::readBytes( ::css::uno::Sequence< sal_Int8 >& aData, sal_Int32 nBytesToRead )
 183 throw (::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 184 {
 185     ::osl::MutexGuard aGuard( maMutex );
 186     if ( mbInClosed )
 187         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 188
 189     checkConnected();
 190     if (nBytesToRead < 0)
 191         throw ::css::io::BufferSizeExceededException( ::rtl::OUString(), static_cast< ::css::uno::XWeak * >(this));
 192
 193     aData.realloc(nBytesToRead);
 194
 195     sal_uInt32 nRead = mpStream->Read(static_cast < void* > ( aData.getArray() ), nBytesToRead);
 196     checkError();
 197
 198     if (nRead < static_cast < sal_uInt32 > ( nBytesToRead ) )
 199         aData.realloc( nRead );
 200
 201     if ( sal::static_int_cast<sal_uInt32>(nBytesToRead) > nRead )
 202     {
 203         // usually that means that the stream was read till the end
 204         // TODO/LATER: it is better to get rid of this optimization by avoiding using of multiple temporary files ( there should be only one temporary file? )
 205         mnCachedPos = mpStream->Tell();
 206         mbHasCachedPos = sal_True;
 207
 208         mpStream = NULL;
 209         if ( mpTempFile )
 210             mpTempFile->CloseStream();
 211     }
 212
 213     return nRead;
 214 }
 215 sal_Int32 SAL_CALL OTempFileService::readSomeBytes( ::css::uno::Sequence< sal_Int8 >& aData, sal_Int32 nMaxBytesToRead )
 216 throw ( ::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 217 {
 218     ::osl::MutexGuard aGuard( maMutex );
 219     if ( mbInClosed )
 220         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 221
 222     checkConnected();
 223     checkError();
 224
 225     if (nMaxBytesToRead < 0)
 226         throw ::css::io::BufferSizeExceededException( ::rtl::OUString(), static_cast < ::css::uno::XWeak * >( this ) );
 227
 228     if (mpStream->IsEof())
 229     {
 230         aData.realloc(0);
 231         return 0;
 232     }
 233     else
 234         return readBytes(aData, nMaxBytesToRead);
 235 }
 236 void SAL_CALL OTempFileService::skipBytes( sal_Int32 nBytesToSkip )
 237 throw ( ::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 238 {
 239     ::osl::MutexGuard aGuard( maMutex );
 240     if ( mbInClosed )
 241         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 242
 243     checkConnected();
 244     checkError();
 245     mpStream->SeekRel(nBytesToSkip);
 246     checkError();
 247 }
 248 sal_Int32 SAL_CALL OTempFileService::available(  )
 249 throw ( ::css::io::NotConnectedException, ::css::io::IOException, ::css::uno::RuntimeException )
 250 {
 251     ::osl::MutexGuard aGuard( maMutex );
 252     if ( mbInClosed )
 253         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 254
 255     checkConnected();
 256
 257     sal_uInt32 nPos = mpStream->Tell();
 258     checkError();
 259
 260     mpStream->Seek(STREAM_SEEK_TO_END);
 261     checkError();
 262
 263     sal_Int32 nAvailable = (sal_Int32)mpStream->Tell() - nPos;
 264     mpStream->Seek(nPos);
 265     checkError();
 266
 267     return nAvailable;
 268 }
 269 void SAL_CALL OTempFileService::closeInput(  )
 270 throw ( ::css::io::NotConnectedException, ::css::io::IOException, ::css::uno::RuntimeException )
 271 {
 272     ::osl::MutexGuard aGuard( maMutex );
 273     if ( mbInClosed )
 274         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak  * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 275
 276     mbInClosed = sal_True;
 277
 278     if ( mbOutClosed )
 279     {
 280         // stream will be deleted by TempFile implementation
 281         mpStream = NULL;
 282
 283         if ( mpTempFile )
 284         {
 285             delete mpTempFile;
 286             mpTempFile = NULL;
 287         }
 288     }
 289 }
 290
 291 // XOutputStream
 292
 293 void SAL_CALL OTempFileService::writeBytes( const ::css::uno::Sequence< sal_Int8 >& aData )
 294 throw ( ::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 295 {
 296     ::osl::MutexGuard aGuard( maMutex );
 297     if ( mbOutClosed )
 298         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 299
 300     checkConnected();
 301     sal_uInt32 nWritten = mpStream->Write(aData.getConstArray(),aData.getLength());
 302     checkError();
 303     if  ( nWritten != (sal_uInt32)aData.getLength())
 304         throw ::css::io::BufferSizeExceededException( ::rtl::OUString(),static_cast < ::css::uno::XWeak * > ( this ) );
 305 }
 306 void SAL_CALL OTempFileService::flush(  )
 307 throw ( ::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 308 {
 309     ::osl::MutexGuard aGuard( maMutex );
 310     if ( mbOutClosed )
 311         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 312
 313     checkConnected();
 314     mpStream->Flush();
 315     checkError();
 316 }
 317 void SAL_CALL OTempFileService::closeOutput(  )
 318 throw ( ::css::io::NotConnectedException, ::css::io::BufferSizeExceededException, ::css::io::IOException, ::css::uno::RuntimeException )
 319 {
 320     ::osl::MutexGuard aGuard( maMutex );
 321     if ( mbOutClosed )
 322         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 323
 324     mbOutClosed = sal_True;
 325
 326     // TODO/LATER: it is better to get rid of this optimization by avoiding using of multiple temporary files ( there should be only one temporary file? )
 327     if ( mpStream )
 328     {
 329         mnCachedPos = mpStream->Tell();
 330         mbHasCachedPos = sal_True;
 331
 332         mpStream = NULL;
 333         if ( mpTempFile )
 334             mpTempFile->CloseStream();
 335     }
 336
 337     if ( mbInClosed )
 338     {
 339         // stream will be deleted by TempFile implementation
 340         mpStream = NULL;
 341
 342         if ( mpTempFile )
 343         {
 344             delete mpTempFile;
 345             mpTempFile = NULL;
 346         }
 347     }
 348 }
 349
 350
 351 void OTempFileService::checkError () const
 352 {
 353     if (!mpStream || mpStream->SvStream::GetError () != ERRCODE_NONE )
 354         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 355 }
 356 void OTempFileService::checkConnected ()
 357 {
 358     if (!mpStream && mpTempFile)
 359     {
 360         mpStream = mpTempFile->GetStream( STREAM_STD_READWRITE );
 361         if ( mpStream && mbHasCachedPos )
 362         {
 363             mpStream->Seek( sal::static_int_cast<sal_Size>(mnCachedPos) );
 364             if ( mpStream->SvStream::GetError () == ERRCODE_NONE )
 365             {
 366                 mbHasCachedPos = sal_False;
 367                 mnCachedPos = 0;
 368             }
 369             else
 370             {
 371                 mpStream = NULL;
 372                 mpTempFile->CloseStream();
 373             }
 374         }
 375     }
 376
 377     if (!mpStream)
 378         throw ::css::io::NotConnectedException ( ::rtl::OUString(), const_cast < ::css::uno::XWeak * > ( static_cast < const ::css::uno::XWeak * > (this ) ) );
 379 }
 380
 381 // XSeekable
 382
 383 void SAL_CALL OTempFileService::seek( sal_Int64 nLocation )
 384 throw ( ::css::lang::IllegalArgumentException, ::css::io::IOException, ::css::uno::RuntimeException )
 385 {
 386     ::osl::MutexGuard aGuard( maMutex );
 387     checkConnected();
 388     if ( nLocation < 0 || nLocation > getLength() )
 389         throw ::css::lang::IllegalArgumentException();
 390
 391     mpStream->Seek((sal_uInt32) nLocation );
 392     checkError();
 393 }
 394 sal_Int64 SAL_CALL OTempFileService::getPosition(  )
 395 throw ( ::css::io::IOException, ::css::uno::RuntimeException )
 396 {
 397     ::osl::MutexGuard aGuard( maMutex );
 398     checkConnected();
 399
 400     sal_uInt32 nPos = mpStream->Tell();
 401     checkError();
 402     return (sal_Int64)nPos;
 403 }
 404 sal_Int64 SAL_CALL OTempFileService::getLength(  )
 405 throw ( ::css::io::IOException, ::css::uno::RuntimeException )
 406 {
 407     ::osl::MutexGuard aGuard( maMutex );
 408     checkConnected();
 409
 410     sal_uInt32 nCurrentPos = mpStream->Tell();
 411     checkError();
 412
 413     mpStream->Seek(STREAM_SEEK_TO_END);
 414     sal_uInt32 nEndPos = mpStream->Tell();
 415     mpStream->Seek(nCurrentPos);
 416
 417     checkError();
 418
 419     return (sal_Int64)nEndPos;
 420 }
 421
 422
 423 // XStream
 424
 425 ::css::uno::Reference< ::css::io::XInputStream > SAL_CALL OTempFileService::getInputStream()
 426 throw ( ::css::uno::RuntimeException )
 427     {
 428     return ::css::uno::Reference< ::css::io::XInputStream >( *this, ::css::uno::UNO_QUERY );
 429 }
 430
 431 ::css::uno::Reference< ::css::io::XOutputStream > SAL_CALL OTempFileService::getOutputStream()
 432 throw ( ::css::uno::RuntimeException )
 433     {
 434     return ::css::uno::Reference< ::css::io::XOutputStream >( *this, ::css::uno::UNO_QUERY );
 435     }
 436
 437 // XTruncate
 438
 439 void SAL_CALL OTempFileService::truncate()
 440 throw ( ::css::io::IOException, ::css::uno::RuntimeException )
 441 {
 442     ::osl::MutexGuard aGuard( maMutex );
 443     checkConnected();
 444     // SetStreamSize() call does not change the position
 445     mpStream->Seek( 0 );
 446     mpStream->SetStreamSize( 0 );
 447     checkError();
 448 }
 449
 450 // XServiceInfo
 451
 452 ::rtl::OUString SAL_CALL OTempFileService::getImplementationName()
 453 throw ( ::css::uno::RuntimeException )
 454 {
 455     return getImplementationName_Static();
 456 }
 457
 458 sal_Bool SAL_CALL OTempFileService::supportsService( ::rtl::OUString const & rServiceName )
 459 throw ( ::css::uno::RuntimeException )
 460 {
 461     ::css::uno::Sequence< ::rtl::OUString > aServices(getSupportedServiceNames_Static());
 462     return rServiceName == aServices[0];
 463 }
 464
 465 ::css::uno::Sequence < ::rtl::OUString > SAL_CALL OTempFileService::getSupportedServiceNames()
 466 throw ( ::css::uno::RuntimeException )
 467 {
 468     return getSupportedServiceNames_Static();
 469 }
 470
 471
 472
 473 ::rtl::OUString OTempFileService::getImplementationName_Static ()
 474 {
 475     return ::rtl::OUString ( RTL_CONSTASCII_USTRINGPARAM ( "com.sun.star.io.comp.TempFile" ) );
 476 }
 477 ::css::uno::Sequence < ::rtl::OUString > OTempFileService::getSupportedServiceNames_Static()
 478 {
 479     ::css::uno::Sequence < ::rtl::OUString > aNames ( 1 );
 480     aNames[0] = ::rtl::OUString ( RTL_CONSTASCII_USTRINGPARAM ( "com.sun.star.io.TempFile" ) );
 481     return aNames;
 482 }
 483 ::css::uno::Reference < ::css::uno::XInterface >SAL_CALL XTempFile_createInstance(
 484     css::uno::Reference< ::css::uno::XComponentContext > const & context)
 485     SAL_THROW( ( css::uno::Exception ) )
 486 {
 487     return static_cast< ::cppu::OWeakObject * >( new OTempFileService(context) );
 488 }
 489
 490 ::css::uno::Reference < ::css::lang::XSingleComponentFactory > OTempFileService::createServiceFactory_Static( ::css::uno::Reference < ::css::lang::XMultiServiceFactory > const & )
 491 {
 492     return ::cppu::createSingleComponentFactory( XTempFile_createInstance, getImplementationName_Static(), getSupportedServiceNames_Static() );
 493 }
 494
 495 static sal_Bool writeInfo( void * pRegistryKey,
 496                           const ::rtl::OUString & rImplementationName,
 497                           ::css::uno::Sequence< ::rtl::OUString > const & rServiceNames )
 498 {
 499     ::rtl::OUString aKeyName( RTL_CONSTASCII_USTRINGPARAM ( "/" ) );
 500     aKeyName += rImplementationName;
 501     aKeyName += ::rtl::OUString( RTL_CONSTASCII_USTRINGPARAM ( "/UNO/SERVICES" ) );
 502
 503     ::css::uno::Reference< ::css::registry::XRegistryKey > xKey;
 504     try
 505     {
 506         xKey = static_cast< ::css::registry::XRegistryKey * >(
 507                                     pRegistryKey )->createKey( aKeyName );
 508     }
 509     catch ( ::css::registry::InvalidRegistryException const & )
 510     {
 511     }
 512
 513     if ( !xKey.is() )
 514         return sal_False;
 515
 516     sal_Bool bSuccess = sal_True;
 517
 518     for ( sal_Int32 n = 0; n < rServiceNames.getLength(); ++n )
 519     {
 520         try
 521         {
 522             xKey->createKey( rServiceNames[ n ] );
 523         }
 524         catch ( ::css::registry::InvalidRegistryException const & )
 525         {
 526             bSuccess = sal_False;
 527             break;
 528         }
 529     }
 530     return bSuccess;
 531 }
 532 // C functions to implement this as a component
 533
 534 extern "C" SAL_DLLPUBLIC_EXPORT void SAL_CALL component_getImplementationEnvironment(
 535                 const sal_Char ** ppEnvTypeName, uno_Environment ** /*ppEnv*/ )
 536 {
 537     *ppEnvTypeName = CPPU_CURRENT_LANGUAGE_BINDING_NAME;
 538 }
 539
 540 /**
 541  * This function creates an implementation section in the registry and another subkey
 542  * for each supported service.
 543  * @param pServiceManager generic uno interface providing a service manager
 544  * @param pRegistryKey generic uno interface providing registry key to write
 545  */
 546 extern "C" SAL_DLLPUBLIC_EXPORT sal_Bool SAL_CALL component_writeInfo( void* /*pServiceManager*/, void* pRegistryKey )
 547 {
 548     return pRegistryKey &&
 549     writeInfo (pRegistryKey,
 550         OTempFileService::getImplementationName_Static(),
 551         OTempFileService::getSupportedServiceNames_Static() );
 552 }
 553
 554
 555 /**
 556  * This function is called to get service factories for an implementation.
 557  * @param pImplName name of implementation
 558  * @param pServiceManager generic uno interface providing a service manager to instantiate components
 559  * @param pRegistryKey registry data key to read and write component persistent data
 560  * @return a component factory (generic uno interface)
 561  */
 562 extern "C" SAL_DLLPUBLIC_EXPORT void * SAL_CALL component_getFactory(
 563     const sal_Char * pImplName, void * pServiceManager, void * /*pRegistryKey*/ )
 564 {
 565     void * pRet = 0;
 566     ::css::uno::Reference< ::css::lang::XMultiServiceFactory > xSMgr(
 567         reinterpret_cast< ::css::lang::XMultiServiceFactory * >( pServiceManager ) );
 568     ::css::uno::Reference< ::css::lang::XSingleComponentFactory > xFactory;
 569
 570     if (OTempFileService::getImplementationName_Static().compareToAscii( pImplName ) == 0)
 571         xFactory = OTempFileService::createServiceFactory_Static ( xSMgr );
 572
 573     if ( xFactory.is() )
 574     {
 575         xFactory->acquire();
 576         pRet = xFactory.get();
 577     }
 578     return pRet;
 579 }