framework/inc/services/dispatchhelper.hxx

   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: dispatchhelper.hxx,v $
  10  * $Revision: 1.5 $
  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
  31 #ifndef __FRAMEWORK_SERVICES_DISPATCHHELPER_HXX_
  32 #define __FRAMEWORK_SERVICES_DISPATCHHELPER_HXX_
  33
  34 //_______________________________________________
  35 // my own includes
  36
  37 #include <threadhelp/threadhelpbase.hxx>
  38 #include <macros/generic.hxx>
  39 #include <macros/debug.hxx>
  40 #include <macros/xinterface.hxx>
  41 #include <macros/xtypeprovider.hxx>
  42 #include <macros/xserviceinfo.hxx>
  43 #include <general.h>
  44
  45 //_______________________________________________
  46 // interface includes
  47 #include <com/sun/star/lang/XMultiServiceFactory.hpp>
  48 #include <com/sun/star/frame/XDispatchHelper.hpp>
  49 #include <com/sun/star/frame/XDispatchResultListener.hpp>
  50 #include <com/sun/star/frame/DispatchResultEvent.hpp>
  51
  52 //_______________________________________________
  53 // other includes
  54 #include <cppuhelper/implbase3.hxx>
  55 #include <osl/conditn.hxx>
  56
  57 //_______________________________________________
  58 // namespace
  59
  60 namespace framework{
  61
  62 //_______________________________________________
  63 // exported const
  64
  65 //_______________________________________________
  66 // exported definitions
  67
  68 /**
  69     @short      implements an easy way for dispatches
  70     @descr      Dispatches are splitted into different parts:
  71                     - parsing of the URL
  72                     - searching for a dispatcgh object
  73                     - dispatching of the URL
  74                 All these steps are done inside one method call here.
  75 */
  76
  77 class DispatchHelper : public ThreadHelpBase                      // must be the first base class!
  78                       ,public ::cppu::WeakImplHelper3< ::com::sun::star::lang::XServiceInfo,::com::sun::star::frame::XDispatchHelper,::com::sun::star::frame::XDispatchResultListener >
  79 {
  80
  81     //-------------------------------------------
  82     // member
  83
  84     private:
  85
  86         /** global uno service manager.
  87             Can be used to create own needed services. */
  88         css::uno::Reference< css::lang::XMultiServiceFactory > m_xSMGR;
  89
  90         /** used to wait for asynchronous listener callbacks. */
  91         ::osl::Condition m_aBlock;
  92
  93         css::uno::Any m_aResult;
  94
  95         css::uno::Reference< css::uno::XInterface > m_xBroadcaster;
  96
  97     //-------------------------------------------
  98     // interface
  99
 100     public:
 101
 102         //---------------------------------------
 103         // ctor/dtor
 104
 105                  DispatchHelper( const css::uno::Reference< css::lang::XMultiServiceFactory >& xSMGR );
 106         virtual ~DispatchHelper(                                                                     );
 107
 108         //---------------------------------------
 109         // XInterface, XTypeProvider, XServiceInfo
 110
 111         DECLARE_XSERVICEINFO
 112
 113         //---------------------------------------
 114         // XDispatchHelper
 115         virtual css::uno::Any SAL_CALL executeDispatch(
 116                                         const css::uno::Reference< css::frame::XDispatchProvider >& xDispatchProvider ,
 117                                         const ::rtl::OUString&                                      sURL              ,
 118                                         const ::rtl::OUString&                                      sTargetFrameName  ,
 119                                               sal_Int32                                             nSearchFlags      ,
 120                                         const css::uno::Sequence< css::beans::PropertyValue >&      lArguments        )
 121         throw(css::uno::RuntimeException);
 122
 123         //---------------------------------------
 124         // XDispatchResultListener
 125         virtual void SAL_CALL dispatchFinished(
 126                                 const css::frame::DispatchResultEvent& aResult )
 127         throw(css::uno::RuntimeException);
 128
 129         //---------------------------------------
 130         // XEventListener
 131         virtual void SAL_CALL disposing(
 132                                 const css::lang::EventObject& aEvent )
 133         throw(css::uno::RuntimeException);
 134 };
 135
 136 }
 137
 138 #endif