X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fafb-xreq.h;h=4978f0a577cd882fa54b3c51f156d9e92636de41;hb=770ca7e254bba07bb7d1ade4fa95afed7a7f7693;hp=d2eae99cab23525a1a12f3cc1098fdd27af53841;hpb=a88ecb472d5a82c80b0ccf8f0ef1594ec0d6c878;p=src%2Fapp-framework-binder.git diff --git a/src/afb-xreq.h b/src/afb-xreq.h index d2eae99c..4978f0a5 100644 --- a/src/afb-xreq.h +++ b/src/afb-xreq.h @@ -17,50 +17,134 @@ #pragma once - -#define NO_BINDING_VERBOSE_MACRO -#include #include "afb-context.h" -#include "afb-evt.h" struct json_object; struct afb_evt_listener; +struct afb_xreq; +struct afb_cred; +struct afb_apiset; +struct afb_event; +struct afb_verb_desc_v1; +struct afb_verb_v2; +struct afb_req; +struct afb_req_itf; +struct afb_request; +struct afb_stored_req; struct afb_xreq_query_itf { - struct json_object *(*json)(void *closure); - struct afb_arg (*get)(void *closure, const char *name); - void (*success)(void *closure, struct json_object *obj, const char *info); - void (*fail)(void *closure, const char *status, const char *info); - void (*reply)(void *closure, int iserror, struct json_object *obj); - void (*unref)(void *closure); - int (*subscribe)(void *closure, struct afb_event event); - int (*unsubscribe)(void *closure, struct afb_event event); - void (*subcall)(void *closure, const char *api, const char *verb, struct json_object *args, void (*callback)(void*, int, struct json_object*), void *cb_closure); + struct json_object *(*json)(struct afb_xreq *xreq); + struct afb_arg (*get)(struct afb_xreq *xreq, const char *name); + void (*success)(struct afb_xreq *xreq, struct json_object *obj, const char *info); + void (*fail)(struct afb_xreq *xreq, const char *status, const char *info); + void (*reply)(struct afb_xreq *xreq, int status, struct json_object *obj); + void (*unref)(struct afb_xreq *xreq); + int (*subscribe)(struct afb_xreq *xreq, struct afb_event event); + int (*unsubscribe)(struct afb_xreq *xreq, struct afb_event event); + void (*subcall)( + struct afb_xreq *xreq, + const char *api, + const char *verb, + struct json_object *args, + void (*callback)(void*, int, struct json_object*), + void *cb_closure); }; - /** * Internal data for requests */ struct afb_xreq { - struct afb_context context; /**< context of the request */ - const char *api; /**< the requested API */ - const char *verb; /**< the requested VERB */ - void *query; /**< closure for the query */ - const struct afb_xreq_query_itf *queryitf; - int refcount; /**< current ref count */ - int replied; /**< is replied? */ - int timeout; /**< timeout */ - int sessionflags; /**< flags to check */ - void *group; - void (*callback)(struct afb_req req); - struct afb_evt_listener *listener; + const struct afb_req_itf *itf; /**< interface functions */ + struct afb_context context; /**< context of the request */ + struct afb_apiset *apiset; /**< apiset of the xreq */ + const char *api; /**< the requested API */ + const char *verb; /**< the requested VERB */ + struct json_object *json; /**< the json object (or NULL) */ + const struct afb_xreq_query_itf *queryitf; /**< interface of xreq implmentation functions */ + int refcount; /**< current ref count */ + int replied; /**< is replied? */ + int hookflags; /**< flags for hooking */ + int hookindex; /**< hook index of the request if hooked */ + struct afb_evt_listener *listener; /**< event listener for the request */ + struct afb_cred *cred; /**< client credential if revelant */ + struct afb_xreq *caller; /**< caller request if any */ }; +/** + * Macro for retrieve the pointer of a structure of 'type' having a field named 'field' + * of adress 'ptr'. + * @param type the type that has the 'field' (ex: "struct mystruct") + * @param field the name of the field within the structure 'type' + * @param ptr the pointer to an element 'field' + * @return the pointer to the structure that contains the 'field' at address 'ptr' + */ +#define CONTAINER_OF(type,field,ptr) ((type*)(((intptr_t)(ptr))-((intptr_t)&(((type*)NULL)->field)))) + +/** + * Macro for retrieve the pointer of a structure of 'type' having a field named "xreq" + * of adress 'x'. + * @param type the type that has the field "xreq" (ex: "struct mystruct") + * @param x the pointer to the field "xreq" + * @return the pointer to the structure that contains the field "xreq" of address 'x' + */ +#define CONTAINER_OF_XREQ(type,x) CONTAINER_OF(type,xreq,x) + +/* req wrappers for xreq */ +extern struct afb_req afb_xreq_unstore(struct afb_stored_req *sreq); extern void afb_xreq_addref(struct afb_xreq *xreq); extern void afb_xreq_unref(struct afb_xreq *xreq); -extern void afb_xreq_fail_f(struct afb_xreq *xreq, const char *status, const char *info, ...); +extern void afb_xreq_unhooked_addref(struct afb_xreq *xreq); +extern void afb_xreq_unhooked_unref(struct afb_xreq *xreq); + +extern struct json_object *afb_xreq_json(struct afb_xreq *xreq); + +extern void afb_xreq_success(struct afb_xreq *xreq, struct json_object *obj, const char *info); extern void afb_xreq_success_f(struct afb_xreq *xreq, struct json_object *obj, const char *info, ...); -extern void afb_xreq_call(struct afb_xreq *xreq); + +extern void afb_xreq_fail(struct afb_xreq *xreq, const char *status, const char *info); +extern void afb_xreq_fail_f(struct afb_xreq *xreq, const char *status, const char *info, ...); +extern void afb_xreq_fail_unknown_api(struct afb_xreq *xreq); +extern void afb_xreq_fail_unknown_verb(struct afb_xreq *xreq); + +extern const char *afb_xreq_raw(struct afb_xreq *xreq, size_t *size); + +extern int afb_xreq_subscribe(struct afb_xreq *xreq, struct afb_event event); +extern int afb_xreq_unsubscribe(struct afb_xreq *xreq, struct afb_event event); + +extern void afb_xreq_subcall( + struct afb_xreq *xreq, + const char *api, + const char *verb, + struct json_object *args, + void (*callback)(void*, int, struct json_object*), + void *cb_closure); +extern void afb_xreq_unhooked_subcall( + struct afb_xreq *xreq, + const char *api, + const char *verb, + struct json_object *args, + void (*callback)(void*, int, struct json_object*), + void *cb_closure); + +extern int afb_xreq_unhooked_subcall_sync( + struct afb_xreq *xreq, + const char *api, + const char *verb, + struct json_object *args, + struct json_object **result); +extern int afb_xreq_subcall_sync( + struct afb_xreq *xreq, + const char *api, + const char *verb, + struct json_object *args, + struct json_object **result); + +/* initialisation and processing of xreq */ +extern void afb_xreq_init(struct afb_xreq *xreq, const struct afb_xreq_query_itf *queryitf); + +extern void afb_xreq_process(struct afb_xreq *xreq, struct afb_apiset *apiset); + +extern void afb_xreq_call_verb_v1(struct afb_xreq *xreq, const struct afb_verb_desc_v1 *verb); +extern void afb_xreq_call_verb_v2(struct afb_xreq *xreq, const struct afb_verb_v2 *verb);