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