provides developper files
[src/app-framework-binder.git] / plugins / session / token-api.c
1 /*
2  * Copyright (C) 2015, 2016 "IoT.bzh"
3  * Author "Fulup Ar Foll"
4  *
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
8  *
9  *   http://www.apache.org/licenses/LICENSE-2.0
10  *
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.
16  */
17
18 #define _GNU_SOURCE
19 #include <stdio.h>
20 #include <json-c/json.h>
21
22 #include <afb/afb-plugin.h>
23
24 // Dummy sample of Client Application Context
25 typedef struct {
26   int  something;       
27   void *whateveryouwant;
28 } MyClientApplicationHandle;
29
30
31 // This function is call when Client Session Context is removed
32 // Note: when freeCtxCB==NULL standard free/malloc is called
33 static void clientContextFree(void *context) {
34     fprintf (stderr,"Plugin[token] Closing Session\n");
35     free (context);
36 }
37
38 // Request Creation of new context if it does not exist
39 static void clientContextCreate (struct afb_req request)
40 {
41     json_object *jresp;
42
43     // add an application specific client context to session
44     afb_req_context_set(request, malloc (sizeof (MyClientApplicationHandle)), clientContextFree);
45     
46     // Send response to UI
47     jresp = json_object_new_object();               
48     json_object_object_add(jresp, "token", json_object_new_string ("A New Token and Session Context Was Created"));
49
50     afb_req_success(request, jresp, NULL);
51 }
52
53 // Before entering here token will be check and renew
54 static void clientContextRefresh (struct afb_req request) {
55     json_object *jresp;
56
57   
58     jresp = json_object_new_object();
59     json_object_object_add(jresp, "token", json_object_new_string ("Token was refreshed"));              
60     
61     afb_req_success(request, jresp, NULL);
62 }
63
64
65 // Session token will we verified before entering here
66 static void clientContextCheck (struct afb_req request) {
67     
68     json_object *jresp = json_object_new_object();    
69     json_object_object_add(jresp, "isvalid", json_object_new_boolean (TRUE));       
70         
71     afb_req_success(request, jresp, NULL);
72 }
73
74
75 // Close and Free context
76 static void clientContextReset (struct afb_req request) {
77     json_object *jresp;
78    
79     /* after this call token will be reset
80      *  - no further access to API will be possible 
81      *  - every context from any used plugin will be freed
82      */
83     
84     jresp = json_object_new_object();
85     json_object_object_add(jresp, "info", json_object_new_string ("Token and all resources are released"));
86     
87     // WARNING: if you free context resource manually here do not forget to set *request.context=NULL; 
88     afb_req_success(request, jresp, NULL);
89 }
90 // Close and Free context
91 static void clientGetPing (struct afb_req request) {
92     static int count=0;
93     json_object *jresp;
94
95     jresp = json_object_new_object();
96     json_object_object_add(jresp, "count", json_object_new_int (count ++));
97     
98     afb_req_success(request, jresp, NULL);
99 }
100
101
102 static const struct AFB_restapi pluginApis[]= {
103   {"ping"    , AFB_SESSION_NONE  , clientGetPing       ,"Ping Rest Test Service"},
104   {"create"  , AFB_SESSION_CREATE, clientContextCreate ,"Request Client Context Creation"},
105   {"refresh" , AFB_SESSION_RENEW , clientContextRefresh,"Refresh Client Context Token"},
106   {"check"   , AFB_SESSION_CHECK , clientContextCheck  ,"Check Client Context Token"},
107   {"reset"   , AFB_SESSION_CLOSE , clientContextReset  ,"Close Client Context and Free resources"},
108   {NULL}
109 };
110
111 static const struct AFB_plugin plugin_desc = {
112         .type = AFB_PLUGIN_JSON,
113         .info = "Application Framework Binder Service",
114         .prefix = "token",
115         .apis = pluginApis
116 };
117
118 const struct AFB_plugin *pluginRegister (const struct AFB_interface *itf)
119 {
120         return &plugin_desc;
121 }