/**
@brief Turn a single osrfMessage into a JSON string.
@param msg Pointer to the osrfMessage to be serialized.
@return Pointer to the resulting JSON string.
Translate the osrfMessage into JSON, wrapped in a JSON array.
This function is equivalent to osrfMessageSerializeBatch() for an array of one pointer.
The calling code is responsible for freeing the returned string.
*/
char* osrf_message_serialize(const osrfMessage* msg) {
if( msg == NULL ) return NULL;
char* j = NULL;
jsonObject* json = osrfMessageToJSON( msg );
if(json) {
jsonObject* wrapper = jsonNewObjectType(JSON_ARRAY);
jsonObjectPush(wrapper, json);
j = jsonObjectToJSON(wrapper);
jsonObjectFree(wrapper);
}
return j;
}
/**
@brief Turn a collection of osrfMessages into one big JSON string.
@param msgs Pointer to an array of osrfMessages.
@param count Maximum number of messages to serialize.
@return Pointer to the JSON string.
Traverse the array, adding each osrfMessage in turn to a JSON_ARRAY. Stop when you have added
the maximum number of messages, or when you encounter a NULL pointer in the array. Then
translate the JSON_ARRAY into a JSON string.
The calling code is responsible for freeing the returned string.
*/
char* osrfMessageSerializeBatch( osrfMessage* msgs [], int count ) {
if( !msgs ) return NULL;
jsonObject* wrapper = jsonNewObjectType(JSON_ARRAY);
int i = 0;
while( (i < count) && msgs[i] ) {
jsonObjectPush(wrapper, osrfMessageToJSON( msgs[i] ));
++i;
}
char* j = jsonObjectToJSON(wrapper);
jsonObjectFree(wrapper);
return j;
}
/**
@brief Either send or enqueue a response to a client, optionally with a completion notice.
@param ctx Pointer to the method context.
@param data Pointer to the response, in the form of a jsonObject.
@param complete Boolean: if true, we will accompany the RESULT message with a STATUS
message indicating that the response is complete.
@return Zero if successful, or -1 upon error.
For an atomic method, add a copy of the response data to a cache within the method
context, to be sent later. In this case the @a complete parameter has no effect,
because we'll send the STATUS message later when we send the cached results.
If the method is not atomic, translate the message into JSON and append it to a buffer,
flushing the buffer as needed to avoid overflow. If @a complete is true, append
a STATUS message (as JSON) to the buffer and flush the buffer.
*/
static int _osrfAppRespond( osrfMethodContext* ctx, const jsonObject* data, int complete ) {
if(!(ctx && ctx->method)) return -1;
if( ctx->method->options & OSRF_METHOD_ATOMIC ) {
osrfLogDebug( OSRF_LOG_MARK,
"Adding responses to stash for atomic method %s", ctx->method->name );
// If we don't already have one, create a JSON_ARRAY to serve as a cache.
if( ctx->responses == NULL )
ctx->responses = jsonNewObjectType( JSON_ARRAY );
// Add a copy of the data object to the cache.
if ( data != NULL )
jsonObjectPush( ctx->responses, jsonObjectClone(data) );
} else {
osrfLogDebug( OSRF_LOG_MARK,
"Adding responses to stash for method %s", ctx->method->name );
if( data ) {
// If you want to flush the intput buffers for every output message,
// this is the place to do it.
//osrf_app_session_queue_wait( ctx->session, 0, NULL );
// Create an OSRF message
osrfMessage* msg = osrf_message_init( RESULT, ctx->request, 1 );
osrf_message_set_status_info( msg, NULL, "OK", OSRF_STATUS_OK );
osrf_message_set_result( msg, data );
// Serialize the OSRF message into JSON text
char* json = jsonObjectToJSON( osrfMessageToJSON( msg ));
osrfMessageFree( msg );
// If the new message would overflow the buffer, flush the output buffer first
int len_so_far = buffer_length( ctx->session->outbuf );
if( len_so_far && (strlen( json ) + len_so_far + 3 >= ctx->method->bufsize )) {
if( flush_responses( ctx->session, ctx->session->outbuf ))
return -1;
}
// Append the JSON text to the output buffer
append_msg( ctx->session->outbuf, json );
free( json );
}
if(complete) {
// Create a STATUS message
osrfMessage* status_msg = osrf_message_init( STATUS, ctx->request, 1 );
osrf_message_set_status_info( status_msg, "osrfConnectStatus", "Request Complete",
OSRF_STATUS_COMPLETE );
// Serialize the STATUS message into JSON text
char* json = jsonObjectToJSON( osrfMessageToJSON( status_msg ));
osrfMessageFree( status_msg );
// Add the STATUS message to the output buffer.
// It's short, so don't worry about avoiding overflow.
append_msg( ctx->session->outbuf, json );
free( json );
// Flush the output buffer, sending any accumulated messages.
if( flush_responses( ctx->session, ctx->session->outbuf ))
return -1;
}
}
return 0;
}
