src/hs-proxy.cpp

   1 /*
   2  * Copyright (c) 2019 TOYOTA MOTOR CORPORATION
   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 #include "homescreen.h"
  18 #include "hs-proxy.h"
  19
  20 struct closure_data {
  21         std::string appid;
  22         HS_ClientCtxt *clientCtx;
  23         struct hs_instance *hs_instance;
  24 };
  25
  26 const char _afm_main[] = "afm-main";
  27
  28
  29 /**
  30  * the callback function
  31  *
  32  * #### Parameters
  33  *  - closure : the user defined closure pointer 'closure'
  34  *  - object : a JSON object returned (can be NULL)
  35  *  - error : a string not NULL in case of error but NULL on success
  36  *  - info : a string handling some info (can be NULL)
  37  *  - api : the api
  38  *
  39  * #### Return
  40  *  None
  41  *
  42  */
  43 static void api_callback(void *closure, struct json_object *object, const char *error, const char *info, afb_api_t api)
  44 {
  45     AFB_INFO("asynchronous call, error=%s, info=%s, object=%s.", error, info, json_object_get_string(object));
  46     struct closure_data *cdata = static_cast<struct closure_data *>(closure);
  47
  48     if (!cdata->hs_instance) {
  49            return;
  50     }
  51
  52     struct HS_ClientManager *clientManager = cdata->hs_instance->client_manager;
  53     if (!clientManager) {
  54            return;
  55     }
  56
  57     /* if we have an error then we couldn't start the application so we remove it */
  58     if (error) {
  59            clientManager->removeClient(cdata->appid);
  60     }
  61
  62     free(cdata);
  63 }
  64
  65 /**
  66  * call api asynchronous
  67  *
  68  * #### Parameters
  69  *  - api : the api serving the request
  70  *  - service : the api name of service
  71  *  - verb : the verb of service
  72  *  - args : parameter
  73  *
  74  * #### Return
  75  *  None
  76  *
  77  */
  78 static void api_call(afb_api_t api, const char *service, const char *verb, struct json_object *args, struct closure_data *cdata)
  79 {
  80     AFB_INFO("service=%s verb=%s, args=%s.", service, verb, json_object_get_string(args));
  81     afb_api_call(api, service, verb, args, api_callback, cdata);
  82 }
  83
  84 /**
  85  * call api synchronous
  86  *
  87  * #### Parameters
  88  *  - api : the api serving the request
  89  *  - service : the api name of service
  90  *  - verb : the verb of afm-main
  91  *  - args : parameter
  92  *  - object : return the details of application
  93  *
  94  * #### Return
  95  *  0 : success
  96  *  1 : fail
  97  *
  98  */
  99 static int api_call_sync(afb_api_t api, const char *service, const char *verb, struct json_object *args, struct json_object **object)
 100 {
 101     char *error = nullptr, *info = nullptr;
 102     int ret = afb_api_call_sync(api, service, verb, args, object, &error, &info);
 103     AFB_INFO("synchronous call, error=%s, info=%s.", error, info);
 104     return ret;
 105 }
 106
 107 /**
 108  * get runnables application list
 109  *
 110  * #### Parameters
 111  *  - api : the api serving the request
 112  *  - object : return the details of appid
 113  *
 114  * #### Return
 115  *  0 : success
 116  *  1 : fail
 117  *
 118  */
 119 int HS_AfmMainProxy::runnables(afb_api_t api, struct json_object **object)
 120 {
 121     return api_call_sync(api, _afm_main, __FUNCTION__, nullptr, object);
 122 }
 123
 124 /**
 125  * get details of application
 126  *
 127  * #### Parameters
 128  *  - api : the api serving the request
 129  *  - id : the id to get details,liked "dashboard@0.1"
 130  *  - object : return the details of application
 131  *
 132  * #### Return
 133  *  0 : success
 134  *  1 : fail
 135  *
 136  */
 137 int HS_AfmMainProxy::detail(afb_api_t api, const std::string &id, struct json_object **object)
 138 {
 139     struct json_object *args = json_object_new_string(id.c_str());
 140     return api_call_sync(api, _afm_main, __FUNCTION__, args, object);
 141 }
 142
 143 /**
 144  * start application
 145  *
 146  * #### Parameters
 147  *  - request : the request
 148  *  - id : the application id liked "dashboard@0.1"
 149  *
 150  * #### Return
 151  *  None
 152  *
 153  */
 154 void HS_AfmMainProxy::start(struct hs_instance *instance, afb_req_t request, const std::string &id)
 155 {
 156     struct closure_data *cdata;
 157
 158     /* tentatively store the client and client context, as the afb_req_t
 159      * request will no longer be available in the async callback handler. This
 160      * is similar to that is done showWindow(), handleRequest() in
 161      * homescreen.cpp, but allows to fake the subscription here as well to
 162      * avoid clients create/install dummy event handlers as to 'register' (or
 163      * to keep track of applications started).
 164      *
 165      * In case api_callback() does return an error we'll remove then the client
 166      * and client context there. We pass the closure_data with the client context
 167      * and the application id to remove it.
 168      */
 169     if (!instance)
 170             return;
 171
 172     cdata = static_cast<struct closure_data *>(calloc(1, sizeof(*cdata)));
 173     cdata->hs_instance = instance;
 174     cdata->appid = id;
 175
 176     struct HS_ClientManager *clientManager = instance->client_manager;
 177     if (!clientManager) {
 178             return;
 179     }
 180
 181     clientManager->addClient(request, id);
 182     api_call(request->api, _afm_main, __FUNCTION__, json_object_new_string(id.c_str()), cdata);
 183 }