2 // Open Service Platform
3 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 // Licensed under the Apache License, Version 2.0 (the License);
6 // you may not use this file except in compliance with the License.
7 // You may obtain a copy of the License at
9 // http://www.apache.org/licenses/LICENSE-2.0
11 // Unless required by applicable law or agreed to in writing, software
12 // distributed under the License is distributed on an "AS IS" BASIS,
13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 // See the License for the specific language governing permissions and
15 // limitations under the License.
19 * @file FApp_AppControlManager.h
20 * @brief This is the header file for the _AppControlManager class.
23 #ifndef _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_
24 #define _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_
26 #include <app_service.h>
28 #include <FOspConfig.h>
29 #include <FBaseColIListT.h>
30 #include <FBaseColIList.h>
31 #include <FBaseObject.h>
32 #include <FBaseString.h>
33 #include <FBaseRtIEventListener.h>
34 #include <FAppAppManager.h>
35 #include <FAppIAppControlEventListener.h>
36 #include <FBaseSysLog.h>
38 #include "FApp_Types.h"
39 #include "FApp_AppControlEvent.h"
40 #include "FApp_IAppControlSysEventListener.h"
41 #include "FApp_AppManagerEvent.h"
42 #include "FApp_IAppManagerServiceEventListener.h"
43 #include "FApp_RequestManagerT.h"
44 #include "FApp_IAppControlResponseEventListener.h"
46 namespace Tizen { namespace Base
58 namespace Tizen { namespace Io
60 class DataControlResultSet;
61 class _DataControlResultSetImpl;
64 namespace Tizen { namespace App
68 class _ConditionManagerProxy;
70 class _AppControlEventArg;
71 class _IAppManagerEventListener;
72 class _AppManagerEventArg;
73 class _AppMessageImpl;
74 class _AppControlResponseEvent;
76 typedef result (*LaunchCbType)(void* data, _AppArg* pArg, _AppArg* pResArg, service_result_e res, int prop, int reqId);
78 typedef void (*AppSvcResFn)(void* b, int requestCode, service_result_e res, void* data);
81 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
82 // _LaunchInfo handles the launch request from this process
83 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
84 const long LAUNCH_INFO_MAGIC = 0x494C;
85 const int RESPONSE_EVENT_REQID_MAGIC = 65536;
90 _LaunchInfo(_AppArg* pArg, LaunchCbType pCb, void* pData, int prop)
91 : magic(LAUNCH_INFO_MAGIC)
103 _LaunchInfo(const _LaunchInfo& rhs);
104 _LaunchInfo& operator =(const _LaunchInfo& rhs);
110 const LaunchCbType launchCb;
116 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
117 // _InAppRequestManager manges In-process AppControl request
118 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
119 struct _InProcessInfo
122 _InProcessInfo(const Tizen::Base::String& aId, const Tizen::Base::String& oId, int prop, bool legacy, Tizen::Base::Runtime::_LibraryImpl& lib, Tizen::Base::Runtime::IEventListener* pListener)
128 , pListener(pListener)
133 ~_InProcessInfo(void);
136 _InProcessInfo(const _InProcessInfo& rhs);
137 _InProcessInfo& operator =(const _InProcessInfo& rhs);
141 const Tizen::Base::String providerId;
142 const Tizen::Base::String operationId;
144 Tizen::Base::Runtime::_LibraryImpl* pLib; // non-empty
145 Tizen::Base::Runtime::IEventListener* pListener;
150 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
151 // _RequestManager manges out-of-process launch request and handles the return arguments
152 ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
156 _ResultInfo(_AppArg& arg)
167 _ResultInfo(const _ResultInfo& rhs);
168 _ResultInfo& operator =(const _ResultInfo& rhs);
175 // partial specialization
176 template<> inline void _RequestManagerT<_ResultInfo>::RemoveItem(int reqId)
178 // 1st request is launch request itself and do not remove it ever.
184 _ResultInfo* pItem = FindItem(reqId);
187 __requestList.Remove(reqId);
193 class _OSP_EXPORT_ _AppControlManager
194 : public Tizen::Base::Object
195 , public _IAppControlSysEventListener
196 , public _IAppControlResponseEventListener
197 , virtual public Tizen::Base::Runtime::IEventListener
203 _RequestGuard(_AppControlManager& mgr, _AppArg* pArg, LaunchCbType pCb, void* pData, int prop)
205 , __req(mgr.AddLaunchRequest(pArg, pCb, pData, prop))
214 GetRequestNumber(void) const
222 __mgr.RemoveLaunchRequest(__req);
226 _AppControlManager& __mgr;
230 static _AppControlManager* GetInstance(void);
232 virtual void OnAppControlEventReceivedN(int reqId, _AppArg* pAppArg, int res);
234 virtual void OnAppControlEventReceivedN(int reqId, int res, const Tizen::Base::Collection::IMap* pArgs);
236 virtual void OnAppControlEventReceivedN(int reqId, const AppId& appId, const Tizen::Base::String& operationId);
238 _OSP_LOCAL_ result SendAppControlEvent(Tizen::Base::Runtime::IEventArg& arg);
240 _OSP_LOCAL_ Tizen::Base::Collection::IMapT<int,_AppControlResponseEvent*>* GetAppControlResponseEventContainer(void);
241 _OSP_LOCAL_ result RegisterRequest(service_s* service, int& req, _AppHandler& handler);
243 _OSP_LOCAL_ void RemoveResultRequest(int reqId)
245 __resultManager.RemoveItem(reqId);
248 const _AppArg* FindResultRequest(int reqId) const;
250 void FinishAppControl(int reqId, int res, Tizen::Base::Collection::IMap* pArg);
252 result LaunchApp(const AppId& appId, _AppArg* pArg, int req = -1);
254 int Launch(const AppId& appId, _AppArg* pArg, int req = -1);
256 int Launch(const AppId& appId, _AppArg* pArg, AppSvcResFn pCb, void* pData, int req);
258 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);
260 result LaunchAppImplicit(_AppArg* pArg, int req);
262 result LaunchPkg(const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
264 result LaunchPkg(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
266 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);
268 int Launch(_AppMessageImpl& msg, const char* pkg_name, const char* op, const char* mime, const char* uri, AppSvcResFn pCb, void* data);
270 result LaunchAppWithCondition(const AppId& appId, const Tizen::Base::String& condition, Tizen::Base::Collection::IList* pArgs);
272 result SendAppControlStartResponse(int req, const char* pValue, const char* pOp);
274 static bool IsAllowedAppControl(const char aTable[][2][96], int count, const Tizen::Base::String& aId, const Tizen::Base::String& oId);
276 static AppId GetAliasAppId(const AppId& appId);
278 static result GetMimeFromExt(const Tizen::Base::String& ext, Tizen::Base::String& out);
280 void RemoveLaunchRequest(int req);
282 int GetLaunchRequestCount(void);
283 virtual void OnAppControlResponseEventReceivedN(const Tizen::Base::Runtime::IEventArg* arg);
285 static AppCtrlResult ConvertAppControlResultCode(int res);
288 _OSP_LOCAL_ _AppControlManager(void);
290 _OSP_LOCAL_ virtual ~_AppControlManager(void);
292 _AppControlManager(const _AppControlManager& rhs);
294 _AppControlManager& operator =(const _AppControlManager& rhs);
296 _OSP_LOCAL_ int AddLaunchRequest(_AppArg* pArg, LaunchCbType pCb, void* data, int prop = -1);
299 _AppControlEvent __appControlEvent;
300 _RequestManagerT<_LaunchInfo> __launchManager;
301 _RequestManagerT<_InProcessInfo> __inAppManager;
302 _RequestManagerT<_ResultInfo> __resultManager;
303 Tizen::Base::Collection::ArrayListT<void*> __listenerList;
305 Tizen::Base::Collection::HashMapT<int, _AppControlResponseEvent*>* __pAppControlResponseEventContainer;
306 Tizen::Base::Collection::ArrayListT<int> __appControlResponseEventList;
307 //friend class AppManager;
308 friend class _AppControlImpl;
309 //friend class _SqlDataControlImpl;
310 //friend class _MapDataControlImpl;
311 friend class _DataControlProviderManagerImpl;
312 friend class _AppControlProviderManagerImpl;
313 friend class Tizen::Io::_DataControlResultSetImpl;
314 }; // _AppControlManager
318 #endif // _FAPP_INTERNAL_APP_CONTROL_MANAGER_H_