]> git.evergreen-ils.org Git - OpenSRF.git/blob - src/gateway/osrf_json_gateway.c
Added support for the opensrf XID, which is a transaction string that's passed
[OpenSRF.git] / src / gateway / osrf_json_gateway.c
1 #include "apachetools.h"
2 #include "opensrf/osrf_app_session.h"
3 #include "opensrf/osrf_system.h"
4 #include "opensrf/osrfConfig.h"
5 #include "objson/object.h"
6 #include "objson/json2xml.h"
7 #include <sys/time.h>
8 #include <sys/resource.h>
9 #include <unistd.h>
10
11
12 #define MODULE_NAME "osrf_json_gateway_module"
13 #define GATEWAY_CONFIG "OSRFGatewayConfig"
14 #define CONFIG_CONTEXT "gateway"
15
16 #define GATEWAY_DEFAULT_CONFIG "/openils/conf/opensrf_core.xml"
17
18
19 /* our config structure */
20 typedef struct { 
21         char* configfile;  /* our bootstrap config file */
22 } osrf_json_gateway_config;
23
24 module AP_MODULE_DECLARE_DATA osrf_json_gateway_module;
25
26 char* osrf_json_gateway_config_file = NULL;
27 int bootstrapped = 0;
28 int numserved = 0;
29 osrfStringArray* allowedServices = NULL;
30
31 static const char* osrf_json_gateway_set_config(cmd_parms *parms, void *config, const char *arg) {
32         osrf_json_gateway_config  *cfg;
33         cfg = ap_get_module_config(parms->server->module_config, &osrf_json_gateway_module);
34         cfg->configfile = (char*) arg;
35         osrf_json_gateway_config_file = (char*) arg;
36         return NULL;
37 }
38
39 /* tell apache about our commands */
40 static const command_rec osrf_json_gateway_cmds[] = {
41         AP_INIT_TAKE1( GATEWAY_CONFIG, osrf_json_gateway_set_config, 
42                         NULL, RSRC_CONF, "osrf json gateway config file"),
43         {NULL}
44 };
45
46 /* build the config object */
47 static void* osrf_json_gateway_create_config( apr_pool_t* p, server_rec* s) {
48         osrf_json_gateway_config* cfg = (osrf_json_gateway_config*) 
49                         apr_palloc(p, sizeof(osrf_json_gateway_config));
50         cfg->configfile = GATEWAY_DEFAULT_CONFIG;
51         return (void*) cfg;
52 }
53
54
55 static void osrf_json_gateway_child_init(apr_pool_t *p, server_rec *s) {
56
57         char* cfg = osrf_json_gateway_config_file;
58         char buf[32];
59         memset(buf, 0x0, 32);
60         int t = time(NULL);
61         snprintf(buf, 32, "%d", t);
62
63         if( ! osrfSystemBootstrapClientResc( cfg, CONFIG_CONTEXT, buf ) ) {
64                 ap_log_error( APLOG_MARK, APLOG_ERR, 0, s, 
65                         "Unable to Bootstrap OpenSRF Client with config %s..", cfg);
66                 return;
67         }
68
69         bootstrapped = 1;
70         allowedServices = osrfNewStringArray(8);
71         osrfLogInfo(OSRF_LOG_MARK, "Bootstrapping gateway child for requests");
72         osrfConfigGetValueList( NULL, allowedServices, "/services/service" );
73
74         int i;
75         for( i = 0; i < allowedServices->size; i++ ) {
76                 ap_log_error( APLOG_MARK, APLOG_DEBUG, 0, s, 
77                         "allowed service: %s\n", osrfStringArrayGetString(allowedServices, i));
78         }
79 }
80
81 static int osrf_json_gateway_method_handler (request_rec *r) {
82
83         /* make sure we're needed first thing*/
84         if (strcmp(r->handler, MODULE_NAME )) return DECLINED;
85
86         osrfLogDebug(OSRF_LOG_MARK, "osrf gateway: entered request handler");
87
88         /* verify we are connected */
89         if( !bootstrapped || !osrf_system_get_transport_client()) {
90                 ap_log_rerror( APLOG_MARK, APLOG_ERR, 0, r, "Cannot process request "
91                                 "because the OpenSRF JSON gateway has not been bootstrapped...");
92                 usleep( 100000 ); /* 100 milliseconds */
93                 exit(1);
94         }
95
96         osrfLogSetAppname("osrf_json_gw");
97
98         char* service           = NULL; /* service to connect to */
99         char* method            = NULL; /* method to perform */
100         char* format            = NULL; /* method to perform */
101         char* a_l                       = NULL; /* request api level */
102         int   isXML                     = 0;
103         int   api_level = 1;
104
105         r->allowed |= (AP_METHOD_BIT << M_GET);
106         r->allowed |= (AP_METHOD_BIT << M_POST);
107
108         osrfLogDebug(OSRF_LOG_MARK, "osrf gateway: parsing URL params");
109         string_array* mparams   = NULL;
110         string_array* params            = apacheParseParms(r); /* free me */
111         service         = apacheGetFirstParamValue( params, "service" );
112         method          = apacheGetFirstParamValue( params, "method" ); 
113         format          = apacheGetFirstParamValue( params, "format" ); 
114         a_l                     = apacheGetFirstParamValue( params, "api_level" ); 
115         mparams         = apacheGetParamValues( params, "param" ); /* free me */
116
117         if (a_l)
118                 api_level = atoi(a_l);
119
120         if (format && !strcasecmp(format, "xml" )) {
121                 isXML = 1;
122                 ap_set_content_type(r, "application/xml");
123         } else {
124                 ap_set_content_type(r, "text/plain");
125         }
126
127         int ret = OK;
128
129         if(!(service && method) || 
130                 !osrfStringArrayContains(allowedServices, service)) {
131
132                 osrfLogError(OSRF_LOG_MARK, 
133                         "Service [%s] not found or not allowed", service);
134                 ret = HTTP_NOT_FOUND;
135
136         } else {
137
138                 /* This will log all heaers to the apache error log 
139                 const apr_array_header_t* arr = apr_table_elts(r->headers_in);
140                 const void* ptr;
141
142                 while( (ptr = apr_array_pop(arr)) ) {
143                         apr_table_entry_t* e = (apr_table_entry_t*) ptr;
144                         fprintf(stderr, "Table entry: %s : %s\n", e->key, e->val );
145                 }
146                 fflush(stderr);
147                 */
148
149                 osrfAppSession* session = osrf_app_client_session_init(service);
150
151                 double starttime = get_timestamp_millis();
152                 int req_id = osrf_app_session_make_req( session, NULL, method, api_level, mparams );
153
154
155                 if( req_id == -1 ) {
156                         osrfLogError(OSRF_LOG_MARK, "I am unable to communcate with opensrf..going away...");
157                         /* we don't want to spawn an intense re-forking storm 
158                          * if there is no jabber server.. so give it some time before we die */
159                         usleep( 100000 ); /* 100 milliseconds */
160                         exit(1);
161                 }
162
163
164                 /* ----------------------------------------------------------------- */
165                 /* log all requests to the activity log */
166                 const char* authtoken = apr_table_get(r->headers_in, "X-OILS-Authtoken");
167                 if(!authtoken) authtoken = "";
168                 growing_buffer* act = buffer_init(128); 
169                 buffer_fadd(act, "[%s] [%s] %s %s", r->connection->remote_ip, authtoken, service, method );
170                 char* str; int i = 0;
171                 while( (str = osrfStringArrayGetString(mparams, i++)) ) {
172                         if( i == 1 ) {
173             OSRF_BUFFER_ADD(act, " ");
174                                 OSRF_BUFFER_ADD(act, str);
175                         } else {
176                                 OSRF_BUFFER_ADD(act, ", ");
177                                 OSRF_BUFFER_ADD(act, str);
178                         }
179                 }
180
181                 osrfLogActivity( OSRF_LOG_MARK, act->buf );
182                 buffer_free(act);
183                 /* ----------------------------------------------------------------- */
184
185
186                 osrf_message* omsg = NULL;
187
188                 int statuscode = 200;
189
190                 /* kick off the object */
191                 if (isXML)
192                         ap_rputs("<response xmlns=\"http://opensrf.org/-/namespaces/gateway/v1\"><payload>", r);
193                 else
194                         ap_rputs("{\"payload\":[", r);
195
196                 int morethan1           = 0;
197                 char* statusname        = NULL;
198                 char* statustext        = NULL;
199                 char* output            = NULL;
200
201                 while((omsg = osrfAppSessionRequestRecv( session, req_id, 60 ))) {
202         
203                         statuscode = omsg->status_code;
204                         jsonObject* res;        
205
206                         if( ( res = osrfMessageGetResult(omsg)) ) {
207
208                                 if (isXML) {
209                                         output = jsonObjectToXML( res );
210                                 } else {
211                                         output = jsonObjectToJSON( res );
212                                         if( morethan1 ) ap_rputs(",", r); /* comma between JSON array items */
213                                 }
214                                 ap_rputs(output, r);
215                                 free(output);
216                                 morethan1 = 1;
217                 
218                         } else {
219         
220                                 if( statuscode > 299 ) { /* the request returned a low level error */
221                                         statusname = omsg->status_name ? strdup(omsg->status_name) : strdup("Unknown Error");
222                                         statustext = omsg->status_text ? strdup(omsg->status_text) : strdup("No Error Message");
223                                         osrfLogError( OSRF_LOG_MARK,  "Gateway received error: %s", statustext );
224                                 }
225                         }
226         
227                         osrf_message_free(omsg);
228                         if(statusname) break;
229                 }
230
231                 double duration = get_timestamp_millis() - starttime;
232                 osrfLogDebug(OSRF_LOG_MARK, "gateway request took %lf seconds", duration);
233
234
235                 if (isXML)
236                         ap_rputs("</payload>", r);
237                 else
238                         ap_rputs("]",r); /* finish off the payload array */
239
240                 if(statusname) {
241
242                         /* add a debug field if the request died */
243                         ap_log_rerror( APLOG_MARK, APLOG_INFO, 0, r, 
244                                         "OpenSRF JSON Request returned error: %s -> %s", statusname, statustext );
245                         int l = strlen(statusname) + strlen(statustext) + 32;
246                         char buf[l];
247                         bzero(buf,l);
248
249                         if (isXML)
250                                 snprintf( buf, l, "<debug>\"%s : %s\"</debug>", statusname, statustext );
251
252                         else {
253                                 char bb[l];
254                                 bzero(bb, l);
255                                 snprintf(bb, l,  "%s : %s", statusname, statustext);
256                                 jsonObject* tmp = jsonNewObject(bb);
257                                 char* j = jsonObjectToJSON(tmp);
258                                 snprintf( buf, l, ",\"debug\": %s", j);
259                                 free(j);
260                                 jsonObjectFree(tmp);
261                         }
262
263                         ap_rputs(buf, r);
264
265                         free(statusname);
266                         free(statustext);
267                 }
268
269                 /* insert the status code */
270                 char buf[32];
271                 bzero(buf,32);
272
273                 if (isXML)
274                         snprintf(buf, 32, "<status>%d</status>", statuscode );
275                 else
276                         snprintf(buf, 32, ",\"status\":%d", statuscode );
277
278                 ap_rputs( buf, r );
279
280                 if (isXML)
281                         ap_rputs("</response>", r);
282                 else
283                         ap_rputs( "}", r ); /* finish off the object */
284
285                 osrf_app_session_destroy(session);
286         }
287
288         osrfLogInfo(OSRF_LOG_MARK, "Completed processing service=%s, method=%s", service, method);
289         string_array_destroy(params);
290         string_array_destroy(mparams);
291
292         osrfLogDebug(OSRF_LOG_MARK, "Gateway served %d requests", ++numserved);
293    osrfLogClearXid();
294
295         return ret;
296 }
297
298
299
300 static void osrf_json_gateway_register_hooks (apr_pool_t *p) {
301         ap_hook_handler(osrf_json_gateway_method_handler, NULL, NULL, APR_HOOK_MIDDLE);
302         ap_hook_child_init(osrf_json_gateway_child_init,NULL,NULL,APR_HOOK_MIDDLE);
303 }
304
305
306 module AP_MODULE_DECLARE_DATA osrf_json_gateway_module = {
307         STANDARD20_MODULE_STUFF,
308         NULL,
309         NULL,
310         osrf_json_gateway_create_config,
311         NULL,
312         osrf_json_gateway_cmds,
313         osrf_json_gateway_register_hooks,
314 };
315
316
317
318