| /* |
| * Copyright 2004,2005 The Apache Software Foundation. |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #ifndef AXIS2_MSG_RECV_H |
| #define AXIS2_MSG_RECV_H |
| |
| /** |
| * @file axis2_msg_recv.h |
| * @brief Axis Message Receiver interface. Message Receiver struct. |
| * This interface is extended by custom message receivers |
| */ |
| |
| #ifdef __cplusplus |
| extern "C" |
| { |
| #endif |
| |
| /** @defgroup axis2_msg_recv Message Receiver |
| * @ingroup axis2_core_receivers |
| * @{ |
| */ |
| |
| #include <axis2_defines.h> |
| #include <axis2.h> |
| #include <axis2_svc_skeleton.h> |
| #include <axis2_msg_ctx.h> |
| #include <axis2_op_ctx.h> |
| #include <axis2_svr_callback.h> |
| |
| #define AXIS2_SUCCESS 1 |
| #define AXIS2_FAILURE 0 |
| |
| struct axis2_msg_ctx; |
| typedef struct axis2_msg_recv axis2_msg_recv_t; |
| typedef struct axis2_msg_recv_ops axis2_msg_recv_ops_t; |
| |
| /** |
| * @brief Message Receiver ops struct. |
| * Encapsulator struct for ops of axis2_msg_recv |
| */ |
| struct axis2_msg_recv_ops |
| { |
| /** |
| * Deallocate memory |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| free) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env); |
| |
| /** |
| * This method is called from axis2_engine_receive method. This method's |
| * actual implementation is decided from the create method of the |
| * extended message receiver object. There depending on the synchronous or |
| * asynchronous type, receive metho is assigned with the synchronous or |
| * asynchronous implementation of receive. |
| * @see raw_xml_in_out_msg_recv_create method where receive is assigned |
| * to receive_sync |
| * @ param in_msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| receive) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx); |
| |
| /** |
| * This contain synchronous receiving logic. |
| * @param in_msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| receive_sync) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx); |
| |
| /** |
| * This contain asynchronous receiving logic. |
| * @param in_msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| receive_async) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx); |
| |
| /** |
| * This contain in only synchronous business invoke logic |
| * @param in_msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| invoke_in_business_logic_sync) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx); |
| |
| /** |
| * This contain in only asynchronous business invoke logic |
| * @param in_msg_ctx |
| * @param svr_callback |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| invoke_in_business_logic_async) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx, |
| struct axis2_svr_callback *svr_callback); |
| |
| /** |
| * This contain in out synchronous business invoke logic |
| * @param in_msg_ctx |
| * @param out_msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| invoke_in_out_business_logic_sync) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx, |
| struct axis2_msg_ctx *out_msg_ctx); |
| |
| /** |
| * This contain in out asynchronous business invoke logic |
| * @param in_msg_ctx |
| * @param out_msg_ctx |
| * @param callback |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| invoke_in_out_business_logic_async) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *in_msg_ctx, |
| struct axis2_msg_ctx *out_msg_ctx, |
| struct axis2_svr_callback *callback); |
| |
| |
| /** |
| * this will create a new service skeleton object |
| * @param msg_ctx |
| * @return service skeleton object |
| */ |
| axis2_svc_skeleton_t * (AXIS2_CALL * |
| make_new_svc_obj) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *msg_ctx); |
| |
| /** |
| * This will return the service skeleton object |
| * @param msg_ctx |
| * @return service skeleton object |
| */ |
| axis2_svc_skeleton_t * (AXIS2_CALL * |
| get_impl_obj) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| struct axis2_msg_ctx *msg_ctx); |
| |
| /** |
| * Set the application scope |
| * @param scope |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| set_scope) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| axis2_char_t *scope); |
| |
| |
| /** |
| * Get the application scope |
| * @param scope |
| * @return scope |
| */ |
| axis2_char_t * (AXIS2_CALL * |
| get_scope) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env); |
| |
| /** |
| * Delete the service skeleton object created by make_new_svc_obj |
| * @param msg_ctx |
| * @return status code |
| */ |
| axis2_status_t (AXIS2_CALL * |
| delete_svc_obj) (axis2_msg_recv_t *msg_recv, |
| axis2_env_t **env, |
| axis2_msg_ctx_t *msg_ctx); |
| }; |
| |
| /** |
| * @brief Message Receiver struct. |
| * This is the base message receiver struct extended by other message receiver |
| * structs. |
| * @see axis2_raw_xml_in_out_msg_recv struct |
| */ |
| struct axis2_msg_recv |
| { |
| axis2_msg_recv_ops_t *ops; |
| }; |
| |
| /** |
| * Create new message receiver object. usually this will be called from the |
| * extended message receiver object. |
| * @see create method of raw_xml_in_out_msg_recv |
| * @return newly created message receiver object |
| **/ |
| AXIS2_DECLARE(axis2_msg_recv_t *) |
| axis2_msg_recv_create (axis2_env_t **env); |
| |
| /************************** Start of function macros **************************/ |
| |
| #define AXIS2_MSG_RECV_FREE(msg_recv, env) ((msg_recv)->ops->free (msg_recv, env)) |
| |
| #define AXIS2_MSG_RECV_RECEIVE(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->receive (msg_recv, env, msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_RECEIVE_SYNC(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->receive_sync (msg_recv, env, msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_RECEIVE_ASYNC(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->receive_async (msg_recv, env, msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_INVOKE_IN_BUSINESS_LOGIC_SYNC(msg_recv, env, in_msg_ctx) \ |
| ((msg_recv)->ops->invoke_in_business_logic_sync(msg_recv, env, in_msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_INVOKE_IN_BUSINESS_LOGIC_ASYNC(msg_recv, env, \ |
| in_msg_ctx, callback) \ |
| ((msg_recv)->ops->invoke_in_business_logic_async(msg_recv, env, \ |
| in_msg_ctx, callback)) |
| |
| #define AXIS2_MSG_RECV_INVOKE_IN_OUT_BUSINESS_LOGIC_SYNC(msg_recv, env, \ |
| in_msg_ctx, out_msg_ctx) \ |
| ((msg_recv)->ops->invoke_in_out_business_logic_sync (msg_recv, env, \ |
| in_msg_ctx, out_msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_INVOKE_IN_OUT_BUSINESS_LOGIC_ASYNC(msg_recv, env, \ |
| in_msg_ctx, out_msg_ctx, callback) \ |
| ((msg_recv)->ops->invoke_in_out_business_logic_async(msg_recv, env, \ |
| in_msg_ctx, out_msg_ctx, callback)) |
| |
| #define AXIS2_MSG_RECV_MAKE_NEW_SVC_OBJ(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->make_new_svc_obj(msg_recv, env, msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_GET_IMPL_OBJ(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->get_impl_obj(msg_recv, env, msg_ctx)) |
| |
| #define AXIS2_MSG_RECV_SET_SCOPE(msg_recv, env, scope) \ |
| ((msg_recv)->ops->set_scope(msg_recv, env, scope)) |
| |
| #define AXIS2_MSG_RECV_GET_SCOPE(msg_recv, env) \ |
| ((msg_recv)->ops->get_scope(msg_recv, env)) |
| |
| #define AXIS2_MSG_RECV_DELETE_SVC_OBJ(msg_recv, env, msg_ctx) \ |
| ((msg_recv)->ops->delete_svc_obj(msg_recv, env, msg_ctx)) |
| |
| /************************** End of function macros ****************************/ |
| |
| /** @} */ |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif /* AXIS2_MSG_RECV_H */ |