xr-call.h

Go to the documentation of this file.

/* 
 * Copyright 2006-2008 Ondrej Jirman <ondrej.jirman@zonio.net>
 * 
 * This file is part of libxr.
 *
 * Libxr is free software: you can redistribute it and/or modify it under the
 * terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation, either version 2 of the License, or (at your option) any
 * later version.
 *
 * Libxr is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 * A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with libxr.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef __XR_CALL_H__
#define __XR_CALL_H__

#include "xr-value.h"

typedef enum {
  XR_CALL_XML_RPC = 0,
#ifdef XR_JSON_ENABLED
  XR_CALL_JSON_RPC,
#endif
  XR_CALL_TRANSPORT_COUNT /* must be last, not a real transport */
} xr_call_transport;

typedef struct _xr_call xr_call;

G_BEGIN_DECLS

xr_call* xr_call_new(const char* method);

void xr_call_free(xr_call* call);

void xr_call_set_transport(xr_call* call, xr_call_transport transport);

const char* xr_call_get_method(xr_call* call);

const char* xr_call_get_method_full(xr_call* call);

char* xr_call_get_servlet_name(xr_call* call, const char* fallback);

void xr_call_add_param(xr_call* call, xr_value* val);

xr_value* xr_call_get_param(xr_call* call, unsigned int pos);

void xr_call_set_retval(xr_call* call, xr_value* val);

xr_value* xr_call_get_retval(xr_call* call);

void xr_call_set_error(xr_call* call, int code, const char* msg, ...);

gboolean xr_call_error_set(xr_call* call);

int xr_call_get_error_code(xr_call* call);

const char* xr_call_get_error_message(xr_call* call);

void xr_call_serialize_request(xr_call* call, char** buf, int* len);

void xr_call_serialize_response(xr_call* call, char** buf, int* len);

gboolean xr_call_unserialize_request(xr_call* call, const char* buf, int len);

gboolean xr_call_unserialize_response(xr_call* call, const char* buf, int len);

void xr_call_free_buffer(xr_call* call, char* buf);

char* xr_call_dump_string(xr_call* call, int indent);

void xr_call_dump(xr_call* call, int indent);

G_END_DECLS

#endif