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_AppManagerEvent.h"
  38 #include "FApp_IAppManagerServiceEventListener.h"
  39 #include "FApp_RequestManagerT.h"
  40 #include "FApp_IAppControlResponseEventListener.h"
  41 #include "FApp_LaunchInfo.h"
  42
  43 namespace Tizen { namespace Base
  44 {
  45 class String;
  46 namespace Collection
  47 {
  48 class IMap;
  49 class IList;
  50 }
  51 }}
  52 namespace Tizen { namespace Io
  53 {
  54 class DataControlResultSet;
  55 class _DataControlResultSetImpl;
  56 }}
  57
  58 namespace Tizen { namespace App
  59 {
  60
  61 class _IAppManager;
  62 class _ConditionManagerProxy;
  63 class _AppArg;
  64 class _AppControlEventArg;
  65 class _IAppManagerEventListener;
  66 class _AppManagerEventArg;
  67 class _AppMessageImpl;
  68 class _AppControlResponseEvent;
  69 class IAppControlEventListener;
  70 class IAppControlResponseListener;
  71
  72 typedef void (*AppSvcResFn)(void* b, int requestCode, service_result_e res, void* data);
  73
  74
  75 const int RESPONSE_EVENT_REQID_MAGIC = 65536;
  76
  77
  78 class _OSP_EXPORT_ _AppControlManager
  79         : public Tizen::Base::Object
  80         , public _IAppControlSysEventListener
  81         , public _IAppControlResponseEventListener
  82         , virtual public Tizen::Base::Runtime::IEventListener
  83 {
  84 public:
  85         class _RequestGuard
  86         {
  87         public:
  88                 _RequestGuard(_AppControlManager& mgr, _AppArg* pArg, LaunchCbType pCb, void* pData, int prop)
  89                         : __mgr(mgr)
  90                         , __req(mgr.AddLaunchRequest(pArg, pCb, pData, prop))
  91                 {
  92                 }
  93
  94                 ~_RequestGuard(void)
  95                 {
  96                 }
  97
  98                 int
  99                 GetRequestNumber(void) const
 100                 {
 101                         return __req;
 102                 }
 103
 104                 void
 105                 Invalidate(void)
 106                 {
 107                         __mgr.RemoveLaunchRequest(__req);
 108                 }
 109
 110         private:
 111                 _AppControlManager& __mgr;
 112                 const int __req;
 113         };
 114
 115         static _AppControlManager* GetInstance(void);
 116
 117         virtual void OnAppControlEventReceivedN(int reqId, _AppArg* pAppArg, int res);
 118
 119         virtual void OnAppControlEventReceivedN(int reqId, int res, const Tizen::Base::Collection::IMap* pArgs, int prop);
 120
 121         virtual void OnAppControlEventReceivedN(int reqId, const AppId& appId, const Tizen::Base::String& operationId);
 122
 123         _OSP_LOCAL_ result SendAppControlEvent(Tizen::Base::Runtime::IEventArg& arg);
 124
 125         _OSP_LOCAL_ Tizen::Base::Collection::IMapT<int,_AppControlResponseEvent*>* GetAppControlResponseEventContainer(void);
 126
 127         _OSP_LOCAL_ result RegisterRequest(service_s* service, int& req, _AppHandler& handler);
 128
 129         _OSP_LOCAL_ void RemoveResultRequest(int reqId);
 130
 131         const _AppArg* FindResultRequest(int reqId) const;
 132
 133         void FinishAppControl(int reqId, int res, Tizen::Base::Collection::IMap* pArg);
 134
 135         result LaunchApp(const AppId& appId, _AppArg* pArg, int req = -1);
 136
 137         int Launch(const AppId& appId, _AppArg* pArg, int req = -1);
 138
 139         int Launch(const AppId& appId, _AppArg* pArg, AppSvcResFn pCb, void* pData, int req);
 140
 141         int Launch(const _AppMessageImpl& msg, const AppId& aId, const Tizen::Base::String& oId, const Tizen::Base::String* pUriData, const Tizen::Base::String* pMimeType, AppSvcResFn pCb, void* pData);
 142
 143         result LaunchAppImplicit(_AppArg* pArg, int req);
 144
 145         result LaunchPkg(const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 146
 147         result LaunchPkg(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 148
 149         int LaunchPkg(_AppMessageImpl& msg, const AppId& appId, const Tizen::Base::String& opId, const Tizen::Base::String* pUri, const Tizen::Base::String* pMime, AppSvcResFn pCb, void* data);
 150
 151         int Launch(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
 152
 153         result LaunchAppWithCondition(const AppId& appId, const Tizen::Base::String& condition, Tizen::Base::Collection::IList* pArgs);
 154
 155         result SendAppControlStartResponse(int req, const char* pValue, const char* pOp);
 156
 157         static bool IsAllowedAppControl(const char aTable[][2][96], int count, const Tizen::Base::String& aId, const Tizen::Base::String& oId);
 158
 159         static AppId GetAliasAppId(const AppId& appId);
 160
 161         static result GetMimeFromExt(const Tizen::Base::String& ext, Tizen::Base::String& out);
 162
 163         void RemoveLaunchRequest(int req);
 164
 165         virtual void OnAppControlResponseEventReceivedN(const Tizen::Base::Runtime::IEventArg* arg);
 166
 167         static AppCtrlResult ConvertAppControlResultCode(int res);
 168
 169         static void InvokeAppControlCompleteListener(IAppControlResponseListener& listener, const AppId& appId, const Tizen::Base::String& op, AppCtrlResult res, const Tizen::Base::Collection::IMap* pExtraData, bool isSubMode);
 170
 171         static void InvokeLegacyAppControlCompleteListener(IAppControlEventListener& listener, const AppId& appId, const Tizen::Base::String& op, const Tizen::Base::Collection::IList* pList, bool isSubMode);
 172
 173 private:
 174         _OSP_LOCAL_ _AppControlManager(void);
 175
 176         _OSP_LOCAL_ virtual ~_AppControlManager(void);
 177
 178         _AppControlManager(const _AppControlManager& rhs);
 179
 180         _AppControlManager& operator =(const _AppControlManager& rhs);
 181
 182         _OSP_LOCAL_ int AddLaunchRequest(_AppArg* pArg, LaunchCbType pCb, void* data, int prop = -1);
 183
 184 private:
 185         _AppControlEvent __appControlEvent;
 186         _RequestManagerT<_LaunchInfo> __launchManager;
 187         _RequestManagerT<_InProcessInfo> __inAppManager;
 188         _RequestManagerT<_ResultInfo> __resultManager;
 189         Tizen::Base::Collection::ArrayListT<void*> __listenerList;
 190
 191         Tizen::Base::Collection::HashMapT<int, _AppControlResponseEvent*> __appControlResponseEventContainer;
 192         Tizen::Base::Collection::ArrayListT<int> __appControlResponseEventList;
 193         friend class _AppControlImpl;
 194         friend class _DataControlProviderManagerImpl;
 195         friend class _AppControlProviderManagerImpl;
 196         friend class Tizen::Io::_DataControlResultSetImpl;
 197 }; // _AppControlManager
 198
 199 }} // Tizen::App
 200
 201 #endif // _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_