src/app/inc/FApp_AppControlManager.h

   1 //
   2 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
   3 //
   4 // Licensed under the Apache License, Version 2.0 (the License);
   5 // you may not use this file except in compliance with the License.
   6 // You may obtain a copy of the License at
   7 //
   8 //     http://www.apache.org/licenses/LICENSE-2.0
   9 //
  10 // Unless required by applicable law or agreed to in writing, software
  11 // distributed under the License is distributed on an "AS IS" BASIS,
  12 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 // See the License for the specific language governing permissions and
  14 // limitations under the License.
  15 //
  16
  17 /**
  18  * @file        FApp_AppControlManager.h
  19  * @brief       This is the header file for the _AppControlManager class.
  20  */
  21
  22 #ifndef _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_
  23 #define _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_
  24
  25 #include <app_service.h>
  26
  27 #include <FOspConfig.h>
  28 #include <FBaseColArrayListT.h>
  29 #include <FBaseObject.h>
  30 #include <FBaseRtIEventListener.h>
  31 #include <FAppTypes.h>
  32 #include <FBaseSysLog.h>
  33
  34 #include "FApp_Types.h"
  35 #include "FApp_AppControlEvent.h"
  36 #include "FApp_IAppControlSysEventListener.h"
  37 #include "FApp_IAppManagerServiceEventListener.h"
  38 #include "FApp_RequestManagerT.h"
  39 #include "FApp_IAppControlResponseEventListener.h"
  40 #include "FApp_LaunchInfo.h"
  41
  42 namespace Tizen { namespace Base
  43 {
  44 class String;
  45 namespace Collection
  46 {
  47 class IMap;
  48 class IList;
  49 }
  50 }}
  51 namespace Tizen { namespace Io
  52 {
  53 class DataControlResultSet;
  54 class _DataControlResultSetImpl;
  55 }}
  56
  57 namespace Tizen { namespace App
  58 {
  59
  60 class _IAppManager;
  61 class _ConditionManagerProxy;
  62 class _AppArg;
  63 class _AppMessageImpl;
  64 class _AppControlResponseEvent;
  65 class IAppControlEventListener;
  66 class IAppControlResponseListener;
  67
  68 typedef void (*AppSvcResFn)(void* b, int requestCode, service_result_e res, void* data);
  69
  70
  71 const int RESPONSE_EVENT_REQID_MAGIC = 65536;
  72
  73
  74 class _OSP_EXPORT_ _AppControlManager
  75         : public Tizen::Base::Object
  76         , public _IAppControlSysEventListener
  77         , public _IAppControlResponseEventListener
  78         , virtual public Tizen::Base::Runtime::IEventListener
  79 {
  80 public:
  81         class _RequestGuard
  82         {
  83         public:
  84                 _RequestGuard(_AppControlManager& mgr, _AppArg* pArg, LaunchCbType pCb, void* pData, int prop)
  85                         : __mgr(mgr)
  86                         , __req(mgr.AddLaunchRequest(pArg, pCb, pData, prop))
  87                 {
  88                 }
  89
  90                 ~_RequestGuard(void)
  91                 {
  92                 }
  93
  94                 int
  95                 GetRequestNumber(void) const
  96                 {
  97                         return __req;
  98                 }
  99
 100                 void
 101                 Invalidate(void)
 102                 {
 103                         __mgr.RemoveLaunchRequest(__req);
 104                 }
 105
 106         private:
 107                 _AppControlManager& __mgr;
 108                 const int __req;
 109         };
 110
 111         static _AppControlManager* GetInstance(void);
 112
 113         virtual void OnAppControlEventReceivedN(int reqId, _AppArg* pAppArg, int res);
 114
 115         virtual void OnAppControlPluginEventReceivedN(int reqId, int res, const AppId& appId, const Tizen::Base::String& oId, const Tizen::Base::Collection::IMap* pArgs, int prop);
 116
 117         virtual void OnAppControlEventReceivedN(int reqId, const AppId& appId, const Tizen::Base::String& operationId);
 118
 119         _OSP_LOCAL_ result SendAppControlEvent(Tizen::Base::Runtime::IEventArg& arg);
 120
 121         _OSP_LOCAL_ Tizen::Base::Collection::IMapT<int,_AppControlResponseEvent*>* GetAppControlResponseEventContainer(void);
 122
 123         _OSP_LOCAL_ result RegisterRequest(service_s* service, int& req, _AppHandler& handler);
 124
 125         _OSP_LOCAL_ void RemoveResultRequest(int reqId);
 126
 127         const _AppArg* FindResultRequest(int reqId) const;
 128
 129         void FinishAppControl(int reqId, int res, Tizen::Base::Collection::IMap* pArg);
 130
 131         void FinishAppControl(int reqId, int res, const AppId& appId, const Tizen::Base::String& oId, Tizen::Base::Collection::IMap* pArg, int prop = 0);
 132
 133         result LaunchApp(const AppId& appId, _AppArg* pArg, int req = -1);
 134
 135         int Launch(const AppId& appId, _AppArg* pArg, int req = -1);
 136
 137         int Launch(const AppId& appId, _AppArg* pArg, AppSvcResFn pCb, void* pData, int req);
 138
 139         int Launch(const _AppMessageImpl& msg, AppSvcResFn pCb, void* pData, int req = -1);
 140
 141         /**
 142          * Launch with pkgname.(osp-app-service : AppService.cpp)
 143          */
 144         result LaunchPkg(const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 145
 146         /**
 147          * Launch with pkgname.(osp-uifw : FUiCtrl_EditCopyPasteManager.cpp)
 148          */
 149         result LaunchPkg(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 150
 151         /**
 152          * Launch with pkgname.(osp-app-controls)
 153          */
 154         int LaunchPkg(_AppMessageImpl& msg, AppSvcResFn pCb, void* data);
 155
 156         int Launch(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 157
 158         result LaunchAppWithCondition(const AppId& appId, const Tizen::Base::String& condition, Tizen::Base::Collection::IList* pArgs);
 159
 160         result SendAppControlStartResponse(int req, const char* pValue, const char* pOp);
 161
 162         _OSP_LOCAL_ static Tizen::Base::String GetMimeTypeFromDataType(const Tizen::Base::String& dataType);
 163
 164         static result GetMimeFromExt(const Tizen::Base::String& ext, Tizen::Base::String& out);
 165
 166         void RemoveLaunchRequest(int req);
 167
 168         virtual void OnAppControlResponseEventReceivedN(const Tizen::Base::Runtime::IEventArg* arg);
 169
 170         static AppCtrlResult ConvertAppControlResultCode(int res);
 171
 172         void StopAppControlResponseListener(IAppControlResponseListener* pLisetener);
 173
 174         static void InvokeAppControlCompleteListener(IAppControlResponseListener& listener, const AppId& appId, const Tizen::Base::String& op, AppCtrlResult res, const Tizen::Base::Collection::IMap* pExtraData, bool noRaise);
 175
 176         static void InvokeLegacyAppControlCompleteListener(IAppControlEventListener& listener, const AppId& appId, const Tizen::Base::String& op, const Tizen::Base::Collection::IList* pList, bool noRaise);
 177
 178 private:
 179         _OSP_LOCAL_ _AppControlManager(void);
 180
 181         _OSP_LOCAL_ virtual ~_AppControlManager(void);
 182
 183         _AppControlManager(const _AppControlManager& rhs);
 184
 185         _AppControlManager& operator =(const _AppControlManager& rhs);
 186
 187         _OSP_LOCAL_ int AddLaunchRequest(_AppArg* pArg, LaunchCbType pCb, void* data, int prop = -1);
 188
 189 private:
 190         _AppControlEvent __appControlEvent;
 191         _RequestManagerT<_DataControlInfo> __launchManager;
 192         _RequestManagerT<_InProcessInfo> __inAppManager;
 193         _RequestManagerT<_ResultInfo> __resultManager;
 194
 195         Tizen::Base::Collection::HashMapT<int, _AppControlResponseEvent*> __appControlResponseEventContainer;
 196         Tizen::Base::Collection::ArrayListT<int> __appControlResponseEventList;
 197         friend class _AppControlImpl;
 198         friend class _DataControlProviderManagerImpl;
 199         friend class _AppControlProviderManagerImpl;
 200         friend class Tizen::Io::_DataControlResultSetImpl;
 201 }; // _AppControlManager
 202
 203 }} // Tizen::App
 204
 205 #endif // _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_