src/libopensrf/osrf_app_session.c

   1 #include <opensrf/osrf_app_session.h>
   2 #include <time.h>
   3
   4 /** Send the given message */
   5 static int _osrf_app_session_send( osrfAppSession*, osrf_message* msg );
   6
   7 static int osrfAppSessionMakeLocaleRequest(
   8                 osrfAppSession* session, const jsonObject* params, const char* method_name,
   9                 int protocol, string_array* param_strings, char* locale );
  10
  11 /* the global app_session cache */
  12 osrfHash* osrfAppSessionCache = NULL;
  13
  14 // --------------------------------------------------------------------------
  15 // --------------------------------------------------------------------------
  16 // Request API
  17 // --------------------------------------------------------------------------
  18
  19 /** Allocates and initializes a new app_request object */
  20 static osrfAppRequest* _osrf_app_request_init(
  21                 osrfAppSession* session, osrf_message* msg ) {
  22
  23         osrfAppRequest* req =
  24                 (osrfAppRequest*) safe_malloc(sizeof(osrfAppRequest));
  25
  26         req->session            = session;
  27         req->request_id = msg->thread_trace;
  28         req->complete           = 0;
  29         req->payload            = msg;
  30         req->result                     = NULL;
  31         req->reset_timeout  = 0;
  32
  33         return req;
  34
  35 }
  36
  37
  38 void osrfAppSessionCleanup() {
  39         osrfHashFree(osrfAppSessionCache);
  40 }
  41
  42 /** Frees memory used by an app_request object */
  43 static void _osrf_app_request_free( void * req ){
  44         if( req == NULL ) return;
  45         osrfAppRequest* r = (osrfAppRequest*) req;
  46         if( r->payload ) osrf_message_free( r->payload );
  47         free( r );
  48 }
  49
  50 /** Pushes the given message onto the list of 'responses' to this request */
  51 static void _osrf_app_request_push_queue( osrfAppRequest* req, osrf_message* result ){
  52         if(req == NULL || result == NULL) return;
  53         osrfLogDebug( OSRF_LOG_MARK,  "App Session pushing request [%d] onto request queue", result->thread_trace );
  54         if(req->result == NULL) {
  55                 req->result = result;
  56
  57         } else {
  58
  59                 osrf_message* ptr = req->result;
  60                 osrf_message* ptr2 = req->result->next;
  61                 while( ptr2 ) {
  62                         ptr = ptr2;
  63                         ptr2 = ptr2->next;
  64                 }
  65                 ptr->next = result;
  66         }
  67 }
  68
  69 /** Removes this app_request from our session request set */
  70 void osrf_app_session_request_finish(
  71                 osrfAppSession* session, int req_id ){
  72
  73         if(session == NULL) return;
  74         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, req_id );
  75         if(req == NULL) return;
  76         osrfListRemove( req->session->request_queue, req->request_id );
  77 }
  78
  79
  80 void osrf_app_session_request_reset_timeout( osrfAppSession* session, int req_id ) {
  81         if(session == NULL) return;
  82         osrfLogDebug( OSRF_LOG_MARK, "Resetting request timeout %d", req_id );
  83         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, req_id );
  84         if(req == NULL) return;
  85         req->reset_timeout = 1;
  86 }
  87
  88 /** Checks the receive queue for messages.  If any are found, the first
  89   * is popped off and returned.  Otherwise, this method will wait at most timeout
  90   * seconds for a message to appear in the receive queue.  Once it arrives it is returned.
  91   * If no messages arrive in the timeout provided, null is returned.
  92   */
  93 static osrf_message* _osrf_app_request_recv( osrfAppRequest* req, int timeout ) {
  94
  95         if(req == NULL) return NULL;
  96
  97         if( req->result != NULL ) {
  98                 /* pop off the first message in the list */
  99                 osrf_message* tmp_msg = req->result;
 100                 req->result = req->result->next;
 101                 return tmp_msg;
 102         }
 103
 104         time_t start = time(NULL);
 105         time_t remaining = (time_t) timeout;
 106
 107         while( remaining >= 0 ) {
 108                 /* tell the session to wait for stuff */
 109                 osrfLogDebug( OSRF_LOG_MARK,  "In app_request receive with remaining time [%d]", (int) remaining );
 110
 111                 osrf_app_session_queue_wait( req->session, 0, NULL );
 112
 113                 if( req->result != NULL ) { /* if we received anything */
 114                         /* pop off the first message in the list */
 115                         osrfLogDebug( OSRF_LOG_MARK,  "app_request_recv received a message, returning it");
 116                         osrf_message* ret_msg = req->result;
 117                         osrf_message* tmp_msg = ret_msg->next;
 118                         req->result = tmp_msg;
 119                         if (ret_msg->sender_locale) {
 120                                 if (req->session->session_locale)
 121                                         free(req->session->session_locale);
 122                                 req->session->session_locale = strdup(ret_msg->sender_locale);
 123                         }
 124                         return ret_msg;
 125                 }
 126
 127                 if( req->complete )
 128                         return NULL;
 129
 130                 osrf_app_session_queue_wait( req->session, (int) remaining, NULL );
 131
 132                 if( req->result != NULL ) { /* if we received anything */
 133                         /* pop off the first message in the list */
 134                         osrfLogDebug( OSRF_LOG_MARK,  "app_request_recv received a message, returning it");
 135                         osrf_message* ret_msg = req->result;
 136                         osrf_message* tmp_msg = ret_msg->next;
 137                         req->result = tmp_msg;
 138                         if (ret_msg->sender_locale) {
 139                                 if (req->session->session_locale)
 140                                         free(req->session->session_locale);
 141                                 req->session->session_locale = strdup(ret_msg->sender_locale);
 142                         }
 143                         return ret_msg;
 144                 }
 145                 if( req->complete )
 146                         return NULL;
 147
 148                 if(req->reset_timeout) {
 149                         remaining = (time_t) timeout;
 150                         req->reset_timeout = 0;
 151                         osrfLogDebug( OSRF_LOG_MARK, "Received a timeout reset");
 152                 } else {
 153                         remaining -= (int) (time(NULL) - start);
 154                 }
 155         }
 156
 157         osrfLogInfo( OSRF_LOG_MARK, "Returning NULL from app_request_recv after timeout");
 158         return NULL;
 159 }
 160
 161 /** Resend this requests original request message */
 162 static int _osrf_app_request_resend( osrfAppRequest* req ) {
 163         if(req == NULL) return 0;
 164         if(!req->complete) {
 165                 osrfLogDebug( OSRF_LOG_MARK,  "Resending request [%d]", req->request_id );
 166                 return _osrf_app_session_send( req->session, req->payload );
 167         }
 168         return 1;
 169 }
 170
 171
 172
 173 // --------------------------------------------------------------------------
 174 // --------------------------------------------------------------------------
 175 // Session API
 176 // --------------------------------------------------------------------------
 177
 178 /** returns a session from the global session hash */
 179 char* osrf_app_session_set_locale( osrfAppSession* session, const char* locale ) {
 180         if (!session || !locale)
 181                 return NULL;
 182
 183         if(session->session_locale)
 184                 free(session->session_locale);
 185
 186         session->session_locale = strdup( locale );
 187         return session->session_locale;
 188 }
 189
 190 /** returns a session from the global session hash */
 191 osrfAppSession* osrf_app_session_find_session( const char* session_id ) {
 192         if(session_id) return osrfHashGet(osrfAppSessionCache, session_id);
 193         return NULL;
 194 }
 195
 196
 197 /** adds a session to the global session cache */
 198 static void _osrf_app_session_push_session( osrfAppSession* session ) {
 199         if(!session) return;
 200         if( osrfAppSessionCache == NULL ) osrfAppSessionCache = osrfNewHash();
 201         if( osrfHashGet( osrfAppSessionCache, session->session_id ) ) return;
 202         osrfHashSet( osrfAppSessionCache, session, session->session_id );
 203 }
 204
 205 /** Allocates and initializes a new app_session */
 206
 207 osrfAppSession* osrfAppSessionClientInit( const char* remote_service ) {
 208         return osrf_app_client_session_init( remote_service );
 209 }
 210
 211 osrfAppSession* osrf_app_client_session_init( const char* remote_service ) {
 212
 213         if (!remote_service) {
 214                 osrfLogWarning( OSRF_LOG_MARK, "No remote service specified in osrf_app_client_session_init");
 215                 return NULL;
 216         }
 217
 218         osrfAppSession* session = safe_malloc(sizeof(osrfAppSession));
 219
 220         session->transport_handle = osrfSystemGetTransportClient();
 221         if( session->transport_handle == NULL ) {
 222                 osrfLogWarning( OSRF_LOG_MARK, "No transport client for service 'client'");
 223                 free( session );
 224                 return NULL;
 225         }
 226
 227         osrfStringArray* arr = osrfNewStringArray(8);
 228         osrfConfigGetValueList(NULL, arr, "/domains/domain");
 229         char* domain = osrfStringArrayGetString(arr, 0);
 230
 231         if (!domain) {
 232                 osrfLogWarning( OSRF_LOG_MARK, "No domains specified in the OpenSRF config file");
 233                 free( session );
 234                 osrfStringArrayFree(arr);
 235                 return NULL;
 236         }
 237
 238         char* router_name = osrfConfigGetValue(NULL, "/router_name");
 239         if (!router_name) {
 240                 osrfLogWarning( OSRF_LOG_MARK, "No router name specified in the OpenSRF config file");
 241                 free( session );
 242                 osrfStringArrayFree(arr);
 243                 return NULL;
 244         }
 245
 246         char target_buf[512];
 247         target_buf[ 0 ] = '\0';
 248
 249         int len = snprintf( target_buf, sizeof(target_buf), "%s@%s/%s",
 250                         router_name ? router_name : "(null)",
 251                         domain ? domain : "(null)",
 252                         remote_service ? remote_service : "(null)" );
 253         osrfStringArrayFree(arr);
 254         //free(domain);
 255         free(router_name);
 256
 257         if( len >= sizeof( target_buf ) ) {
 258                 osrfLogWarning( OSRF_LOG_MARK, "Buffer overflow for remote_id");
 259                 free( session );
 260                 return NULL;
 261         }
 262
 263         session->request_queue = osrfNewList();
 264         session->request_queue->freeItem = &_osrf_app_request_free;
 265         session->remote_id = strdup(target_buf);
 266         session->orig_remote_id = strdup(session->remote_id);
 267         session->remote_service = strdup(remote_service);
 268         session->session_locale = NULL;
 269
 270         #ifdef ASSUME_STATELESS
 271         session->stateless = 1;
 272         osrfLogDebug( OSRF_LOG_MARK, "%s session is stateless", remote_service );
 273         #else
 274         session->stateless = 0;
 275         osrfLogDebug( OSRF_LOG_MARK, "%s session is NOT stateless", remote_service );
 276         #endif
 277
 278         /* build a chunky, random session id */
 279         char id[256];
 280
 281         snprintf(id, sizeof(id), "%f.%d%ld", get_timestamp_millis(), (int)time(NULL), (long) getpid());
 282         session->session_id = strdup(id);
 283         osrfLogDebug( OSRF_LOG_MARK,  "Building a new client session with id [%s] [%s]",
 284                         session->remote_service, session->session_id );
 285
 286         session->thread_trace = 0;
 287         session->state = OSRF_SESSION_DISCONNECTED;
 288         session->type = OSRF_SESSION_CLIENT;
 289         //session->next = NULL;
 290
 291         session->userData = NULL;
 292         session->userDataFree = NULL;
 293
 294         _osrf_app_session_push_session( session );
 295         return session;
 296 }
 297
 298 osrfAppSession* osrf_app_server_session_init(
 299                 const char* session_id, const char* our_app, const char* remote_id ) {
 300
 301         osrfLogDebug( OSRF_LOG_MARK, "Initing server session with session id %s, service %s,"
 302                         " and remote_id %s", session_id, our_app, remote_id );
 303
 304         osrfAppSession* session = osrf_app_session_find_session( session_id );
 305         if(session) return session;
 306
 307         session = safe_malloc(sizeof(osrfAppSession));
 308
 309         session->transport_handle = osrfSystemGetTransportClient();
 310         if( session->transport_handle == NULL ) {
 311                 osrfLogWarning( OSRF_LOG_MARK, "No transport client for service '%s'", our_app );
 312                 return NULL;
 313         }
 314
 315         int stateless = 0;
 316         char* statel = osrf_settings_host_value("/apps/%s/stateless", our_app );
 317         if(statel) stateless = atoi(statel);
 318         free(statel);
 319
 320
 321         session->request_queue = osrfNewList();
 322         session->request_queue->freeItem = &_osrf_app_request_free;
 323         session->remote_id = strdup(remote_id);
 324         session->orig_remote_id = strdup(remote_id);
 325         session->session_id = strdup(session_id);
 326         session->remote_service = strdup(our_app);
 327         session->stateless = stateless;
 328
 329         #ifdef ASSUME_STATELESS
 330         session->stateless = 1;
 331         #else
 332         session->stateless = 0;
 333         #endif
 334
 335         session->thread_trace = 0;
 336         session->state = OSRF_SESSION_DISCONNECTED;
 337         session->type = OSRF_SESSION_SERVER;
 338         session->session_locale = NULL;
 339
 340         session->userData = NULL;
 341         session->userDataFree = NULL;
 342
 343         _osrf_app_session_push_session( session );
 344         return session;
 345
 346 }
 347
 348
 349
 350 /** frees memory held by a session */
 351 static void _osrf_app_session_free( osrfAppSession* session ){
 352         if(session==NULL)
 353                 return;
 354
 355         if( session->userDataFree && session->userData )
 356                 session->userDataFree(session->userData);
 357
 358         if(session->session_locale)
 359                 free(session->session_locale);
 360
 361         free(session->remote_id);
 362         free(session->orig_remote_id);
 363         free(session->session_id);
 364         free(session->remote_service);
 365         osrfListFree(session->request_queue);
 366         free(session);
 367 }
 368
 369 int osrfAppSessionMakeRequest(
 370                 osrfAppSession* session, const jsonObject* params,
 371                 const char* method_name, int protocol, string_array* param_strings ) {
 372
 373         return osrfAppSessionMakeLocaleRequest( session, params,
 374                         method_name, protocol, param_strings, NULL );
 375 }
 376
 377 static int osrfAppSessionMakeLocaleRequest(
 378                 osrfAppSession* session, const jsonObject* params, const char* method_name,
 379                 int protocol, string_array* param_strings, char* locale ) {
 380
 381         if(session == NULL) return -1;
 382
 383         osrfLogMkXid();
 384
 385         osrf_message* req_msg = osrf_message_init( REQUEST, ++(session->thread_trace), protocol );
 386         osrf_message_set_method(req_msg, method_name);
 387
 388         if (locale) {
 389                 osrf_message_set_locale(req_msg, locale);
 390         } else if (session->session_locale) {
 391                 osrf_message_set_locale(req_msg, session->session_locale);
 392         }
 393
 394         if(params) {
 395                 osrf_message_set_params(req_msg, params);
 396
 397         } else {
 398
 399                 if(param_strings) {
 400                         int i;
 401                         for(i = 0; i!= param_strings->size ; i++ ) {
 402                                 osrf_message_add_param(req_msg,
 403                                         string_array_get_string(param_strings,i));
 404                         }
 405                 }
 406         }
 407
 408         osrfAppRequest* req = _osrf_app_request_init( session, req_msg );
 409         if(_osrf_app_session_send( session, req_msg ) ) {
 410                 osrfLogWarning( OSRF_LOG_MARK,  "Error sending request message [%d]", session->thread_trace );
 411                 return -1;
 412         }
 413
 414         osrfLogDebug( OSRF_LOG_MARK,  "Pushing [%d] onto request queue for session [%s] [%s]",
 415                         req->request_id, session->remote_service, session->session_id );
 416         osrfListSet( session->request_queue, req, req->request_id );
 417         return req->request_id;
 418 }
 419
 420 void osrf_app_session_set_complete( osrfAppSession* session, int request_id ) {
 421         if(session == NULL)
 422                 return;
 423
 424         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, request_id );
 425         if(req) req->complete = 1;
 426 }
 427
 428 int osrf_app_session_request_complete( const osrfAppSession* session, int request_id ) {
 429         if(session == NULL)
 430                 return 0;
 431         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, request_id );
 432         if(req)
 433                 return req->complete;
 434         return 0;
 435 }
 436
 437
 438 /** Resets the remote connection id to that of the original*/
 439 void osrf_app_session_reset_remote( osrfAppSession* session ){
 440         if( session==NULL )
 441                 return;
 442
 443         free(session->remote_id);
 444         osrfLogDebug( OSRF_LOG_MARK,  "App Session [%s] [%s] resetting remote id to %s",
 445                         session->remote_service, session->session_id, session->orig_remote_id );
 446
 447         session->remote_id = strdup(session->orig_remote_id);
 448 }
 449
 450 void osrf_app_session_set_remote( osrfAppSession* session, const char* remote_id ) {
 451         if(session == NULL)
 452                 return;
 453         if( session->remote_id )
 454                 free(session->remote_id );
 455         session->remote_id = strdup( remote_id );
 456 }
 457
 458 /** pushes the given message into the result list of the app_request
 459   with the given request_id */
 460 int osrf_app_session_push_queue(
 461                 osrfAppSession* session, osrf_message* msg ){
 462         if(session == NULL || msg == NULL) return 0;
 463
 464         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, msg->thread_trace );
 465         if(req == NULL) return 0;
 466         _osrf_app_request_push_queue( req, msg );
 467
 468         return 0;
 469 }
 470
 471 int osrfAppSessionConnect( osrfAppSession* session ) {
 472         return osrf_app_session_connect(session);
 473 }
 474
 475
 476 /** Attempts to connect to the remote service */
 477 int osrf_app_session_connect(osrfAppSession* session){
 478
 479         if(session == NULL)
 480                 return 0;
 481
 482         if(session->state == OSRF_SESSION_CONNECTED) {
 483                 return 1;
 484         }
 485
 486         int timeout = 5; /* XXX CONFIG VALUE */
 487
 488         osrfLogDebug( OSRF_LOG_MARK,  "AppSession connecting to %s", session->remote_id );
 489
 490         /* defaulting to protocol 1 for now */
 491         osrf_message* con_msg = osrf_message_init( CONNECT, session->thread_trace, 1 );
 492         osrf_app_session_reset_remote( session );
 493         session->state = OSRF_SESSION_CONNECTING;
 494         int ret = _osrf_app_session_send( session, con_msg );
 495         osrf_message_free(con_msg);
 496         if(ret) return 0;
 497
 498         time_t start = time(NULL);
 499         time_t remaining = (time_t) timeout;
 500
 501         while( session->state != OSRF_SESSION_CONNECTED && remaining >= 0 ) {
 502                 osrf_app_session_queue_wait( session, remaining, NULL );
 503                 remaining -= (int) (time(NULL) - start);
 504         }
 505
 506         if(session->state == OSRF_SESSION_CONNECTED)
 507                 osrfLogDebug( OSRF_LOG_MARK, " * Connected Successfully to %s", session->remote_service );
 508
 509         if(session->state != OSRF_SESSION_CONNECTED)
 510                 return 0;
 511
 512         return 1;
 513 }
 514
 515
 516
 517 /** Disconnects from the remote service */
 518 int osrf_app_session_disconnect( osrfAppSession* session){
 519         if(session == NULL)
 520                 return 1;
 521
 522         if(session->state == OSRF_SESSION_DISCONNECTED)
 523                 return 1;
 524
 525         if(session->stateless && session->state != OSRF_SESSION_CONNECTED) {
 526                 osrfLogDebug( OSRF_LOG_MARK,
 527                                 "Exiting disconnect on stateless session %s",
 528                                 session->session_id);
 529                 return 1;
 530         }
 531
 532         osrfLogDebug(OSRF_LOG_MARK,  "AppSession disconnecting from %s", session->remote_id );
 533
 534         osrf_message* dis_msg = osrf_message_init( DISCONNECT, session->thread_trace, 1 );
 535         _osrf_app_session_send( session, dis_msg );
 536         session->state = OSRF_SESSION_DISCONNECTED;
 537
 538         osrf_message_free( dis_msg );
 539         osrf_app_session_reset_remote( session );
 540         return 1;
 541 }
 542
 543 int osrf_app_session_request_resend( osrfAppSession* session, int req_id ) {
 544         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, req_id );
 545         return _osrf_app_request_resend( req );
 546 }
 547
 548
 549 static int osrfAppSessionSendBatch( osrfAppSession* session, osrf_message* msgs[], int size ) {
 550
 551         if( !(session && msgs && size > 0) ) return 0;
 552         int retval = 0;
 553
 554         osrfMessage* msg = msgs[0];
 555
 556         if(msg) {
 557
 558                 osrf_app_session_queue_wait( session, 0, NULL );
 559
 560                 if(session->state != OSRF_SESSION_CONNECTED)  {
 561
 562                         if(session->stateless) { /* stateless session always send to the root listener */
 563                                 osrf_app_session_reset_remote(session);
 564
 565                         } else {
 566
 567                                 /* do an auto-connect if necessary */
 568                                 if( ! session->stateless &&
 569                                         (msg->m_type != CONNECT) &&
 570                                         (msg->m_type != DISCONNECT) &&
 571                                         (session->state != OSRF_SESSION_CONNECTED) ) {
 572
 573                                         if(!osrf_app_session_connect( session ))
 574                                                 return 0;
 575                                 }
 576                         }
 577                 }
 578         }
 579
 580         char* string = osrfMessageSerializeBatch(msgs, size);
 581
 582         if( string ) {
 583
 584                 transport_message* t_msg = message_init(
 585                                 string, "", session->session_id, session->remote_id, NULL );
 586       message_set_osrf_xid( t_msg, osrfLogGetXid() );
 587
 588                 retval = client_send_message( session->transport_handle, t_msg );
 589
 590                 if( retval ) osrfLogError(OSRF_LOG_MARK, "client_send_message failed");
 591
 592                 osrfLogInfo(OSRF_LOG_MARK, "[%s] sent %d bytes of data to %s",
 593                         session->remote_service, strlen(string), t_msg->recipient );
 594
 595                 osrfLogDebug(OSRF_LOG_MARK, "Sent: %s", string );
 596
 597                 free(string);
 598                 message_free( t_msg );
 599         }
 600
 601         return retval;
 602 }
 603
 604
 605
 606 static int _osrf_app_session_send( osrfAppSession* session, osrf_message* msg ){
 607         if( !(session && msg) ) return 0;
 608         osrfMessage* a[1];
 609         a[0] = msg;
 610         return osrfAppSessionSendBatch( session, a, 1 );
 611 }
 612
 613
 614
 615
 616 /**  Waits up to 'timeout' seconds for some data to arrive.
 617   * Any data that arrives will be processed according to its
 618   * payload and message type.  This method will return after
 619   * any data has arrived.
 620   */
 621 int osrf_app_session_queue_wait( osrfAppSession* session, int timeout, int* recvd ){
 622         if(session == NULL) return 0;
 623         osrfLogDebug(OSRF_LOG_MARK,  "AppSession in queue_wait with timeout %d", timeout );
 624         return osrf_stack_entry_point(session->transport_handle, timeout, recvd);
 625 }
 626
 627 /** Disconnects (if client) and removes the given session from the global session cache
 628   * ! This free's all attached app_requests !
 629   */
 630 void osrfAppSessionFree( osrfAppSession* session ){
 631         if(session == NULL) return;
 632
 633         osrfLogDebug(OSRF_LOG_MARK,  "AppSession [%s] [%s] destroying self and deleting requests",
 634                         session->remote_service, session->session_id );
 635         if(session->type == OSRF_SESSION_CLIENT
 636                         && session->state != OSRF_SESSION_DISCONNECTED ) { /* disconnect if we're a client */
 637                 osrf_message* dis_msg = osrf_message_init( DISCONNECT, session->thread_trace, 1 );
 638                 _osrf_app_session_send( session, dis_msg );
 639                 osrf_message_free(dis_msg);
 640         }
 641
 642         osrfHashRemove( osrfAppSessionCache, session->session_id );
 643         _osrf_app_session_free( session );
 644 }
 645
 646 osrf_message* osrfAppSessionRequestRecv(
 647                 osrfAppSession* session, int req_id, int timeout ) {
 648         if(req_id < 0 || session == NULL)
 649                 return NULL;
 650         osrfAppRequest* req = OSRF_LIST_GET_INDEX( session->request_queue, req_id );
 651         return _osrf_app_request_recv( req, timeout );
 652 }
 653
 654
 655
 656 int osrfAppRequestRespond( osrfAppSession* ses, int requestId, const jsonObject* data ) {
 657         if(!ses || ! data ) return -1;
 658
 659         osrf_message* msg = osrf_message_init( RESULT, requestId, 1 );
 660         osrf_message_set_status_info( msg, NULL, "OK", OSRF_STATUS_OK );
 661         char* json = jsonObjectToJSON( data );
 662
 663         osrf_message_set_result_content( msg, json );
 664         _osrf_app_session_send( ses, msg );
 665
 666         free(json);
 667         osrf_message_free( msg );
 668
 669         return 0;
 670 }
 671
 672
 673 int osrfAppRequestRespondComplete(
 674                 osrfAppSession* ses, int requestId, const jsonObject* data ) {
 675
 676         osrf_message* payload = osrf_message_init( RESULT, requestId, 1 );
 677         osrf_message_set_status_info( payload, NULL, "OK", OSRF_STATUS_OK );
 678
 679         osrf_message* status = osrf_message_init( STATUS, requestId, 1);
 680         osrf_message_set_status_info( status, "osrfConnectStatus", "Request Complete", OSRF_STATUS_COMPLETE );
 681
 682         if (data) {
 683                 char* json = jsonObjectToJSON( data );
 684                 osrf_message_set_result_content( payload, json );
 685                 free(json);
 686
 687                 osrfMessage* ms[2];
 688                 ms[0] = payload;
 689                 ms[1] = status;
 690
 691                 osrfAppSessionSendBatch( ses, ms, 2 );
 692
 693                 osrf_message_free( payload );
 694         } else {
 695                 osrfAppSessionSendBatch( ses, &status, 1 );
 696         }
 697
 698         osrf_message_free( status );
 699
 700         return 0;
 701 }
 702
 703 int osrfAppSessionStatus( osrfAppSession* ses, int type,
 704                 const char* name, int reqId, const char* message ) {
 705
 706         if(ses) {
 707                 osrf_message* msg = osrf_message_init( STATUS, reqId, 1);
 708                 osrf_message_set_status_info( msg, name, message, type );
 709                 _osrf_app_session_send( ses, msg );
 710                 osrf_message_free( msg );
 711                 return 0;
 712         }
 713         return -1;
 714 }
 715
 716
 717
 718
 719
 720