blob: e1b7395cd02b110a33b6e1dc38913a048280d5c9 [file] [log] [blame]
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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_CTX_H
#define AXIS2_MSG_CTX_H
/**
* @defgroup axis2_msg_ctx message context
* @ingroup axis2_context
* message context captures all state information related to a message
* invocation. It holds information on the service and operation to be invoked
* as well as context hierarchy information related to the service and operation.
* It also has information on transports, that are to be used in invocation. The
* phase information is kept, along with the phase at which message invocation was
* paused as well as the handler in the phase from which the invocation is to be
* resumed. message context would hold the request SOAP message along the out
* path and would capture response along the in path.
* message context also has information on various engine specific information,
* such as if it should be doing MTOM, REST.
* As message context is inherited form context, it has the capability of
* storing user defined properties.
* @{
*/
/**
* @file axis2_msg_ctx.h
*/
#include <axis2_defines.h>
#include <axutil_env.h>
#include <axis2_ctx.h>
#include <axis2_relates_to.h>
#include <axutil_param.h>
#include <axis2_handler_desc.h>
#include <axutil_qname.h>
#include <axutil_stream.h>
#include <axis2_msg_info_headers.h>
#ifdef __cplusplus
extern "C"
{
#endif
/** transport headers */
#define AXIS2_TRANSPORT_HEADERS "AXIS2_TRANSPORT_HEADERS"
/** transport in */
#define AXIS2_TRANSPORT_OUT "AXIS2_TRANSPORT_OUT"
/** transport out */
#define AXIS2_TRANSPORT_IN "AXIS2_TRANSPORT_IN"
/** character set encoding */
#define AXIS2_CHARACTER_SET_ENCODING "AXIS2_CHARACTER_SET_ENCODING"
/** UTF_8; This is the 'utf-8' value for AXIS2_CHARACTER_SET_ENCODING property */
#define AXIS2_UTF_8 "UTF-8"
/** UTF_16; This is the 'utf-16' value for AXIS2_CHARACTER_SET_ENCODING property */
#define AXIS2_UTF_16 "utf-16"
/** default char set encoding; This is the default value for AXIS2_CHARACTER_SET_ENCODING property */
#define AXIS2_DEFAULT_CHAR_SET_ENCODING "UTF-8"
/** transport succeeded */
#define AXIS2_TRANSPORT_SUCCEED "AXIS2_TRANSPORT_SUCCEED"
/** HTTP Client */
#define AXIS2_HTTP_CLIENT "AXIS2_HTTP_CLIENT"
/** Transport URL */
#define AXIS2_TRANSPORT_URL "TransportURL"
/** PEER IP Address of Server */
#define AXIS2_SVR_PEER_IP_ADDR "peer_ip_addr"
/* Message flows */
/* In flow */
/*#define AXIS2_IN_FLOW 1*/
/* In fault flow */
/*#define AXIS2_IN_FAULT_FLOW 2*/
/* Out flow */
/*#define AXIS2_OUT_FLOW 3*/
/* Out fault flow */
/*#define AXIS2_OUT_FAULT_FLOW 4*/
/** Type name for struct axis2_msg_ctx */
typedef struct axis2_msg_ctx axis2_msg_ctx_t;
struct axis2_svc;
struct axis2_op;
struct axis2_conf_ctx;
struct axis2_svc_grp_ctx;
struct axis2_svc_ctx;
struct axis2_op_ctx;
struct axis2_conf;
struct axiom_soap_envelope;
struct axis2_options;
struct axis2_transport_in_desc;
struct axis2_transport_out_desc;
struct axis2_out_transport_info;
/** Type name for pointer to a function to find a service */
typedef struct axis2_svc *(
AXIS2_CALL
* AXIS2_MSG_CTX_FIND_SVC) (
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/** Type name for pointer to a function to find an operation in a service */
typedef struct axis2_op *(
AXIS2_CALL
* AXIS2_MSG_CTX_FIND_OP) (
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc * svc);
/**
* Creates a message context struct instance.
* @param env pointer to environment struct
* @param conf_ctx pointer to configuration context struct, message context
* does not assume the ownership of the struct
* @param transport_in_desc pointer to transport in description struct,
* message context does not assume the ownership of the struct
* @param transport_out_desc pointer to transport out description struct,
* message context does not assume the ownership of the struct
* @return pointer to newly created message context instance
*/
AXIS2_EXTERN axis2_msg_ctx_t *AXIS2_CALL
axis2_msg_ctx_create(
const axutil_env_t * env,
struct axis2_conf_ctx *conf_ctx,
struct axis2_transport_in_desc *transport_in_desc,
struct axis2_transport_out_desc *transport_out_desc);
/**
* Gets the base, which is of type context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to base context struct
*/
AXIS2_EXTERN axis2_ctx_t *AXIS2_CALL
axis2_msg_ctx_get_base(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets parent. Parent of a message context is of type operation
* context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to operation context which is the parent
*/
AXIS2_EXTERN struct axis2_op_ctx *AXIS2_CALL
axis2_msg_ctx_get_parent(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets parent. Parent of a message context is of type operation
* context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param parent pointer to parent operation context
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_parent(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_op_ctx *parent);
/**
* Frees message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return void
*/
AXIS2_EXTERN void AXIS2_CALL
axis2_msg_ctx_free(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Initializes the message context. Based on the transport, service and
* operation qnames set on top of message context, correct instances of
* those struct instances would be extracted from configuration and
* set within message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param conf pointer to configuration
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_init(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_conf *conf);
/**
* Gets WS-Addressing fault to address. Fault to address tells where to
* send the fault in case there is an error.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to endpoint reference struct representing the fault
* to address, returns a reference not a cloned copy
*/
AXIS2_EXTERN axis2_endpoint_ref_t *AXIS2_CALL
axis2_msg_ctx_get_fault_to(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets WS-Addressing from endpoint. From address tells where the
* request came from.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to endpoint reference struct representing the from
* address, returns a reference not a cloned copy
*/
AXIS2_EXTERN axis2_endpoint_ref_t *AXIS2_CALL
axis2_msg_ctx_get_from(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Checks if there is a SOAP fault on in flow.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if there is an in flow fault, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_in_fault_flow(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the SOAP envelope. This SOAP envelope could be either request
* SOAP envelope or the response SOAP envelope, based on the state
* the message context is in.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to SOAP envelope stored within message context
*/
AXIS2_EXTERN struct axiom_soap_envelope *AXIS2_CALL
axis2_msg_ctx_get_soap_envelope(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the SOAP envelope of the response.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to response SOAP envelope stored within message context
*/
AXIS2_EXTERN struct axiom_soap_envelope *AXIS2_CALL
axis2_msg_ctx_get_response_soap_envelope(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets fault SOAP envelope.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to fault SOAP envelope stored within message context
*/
AXIS2_EXTERN struct axiom_soap_envelope *AXIS2_CALL
axis2_msg_ctx_get_fault_soap_envelope(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets message ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param msg_id
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_msg_id(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_char_t * msg_id);
/**
* Gets message ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return message ID string corresponding to the message the message
* context is related to
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_msg_id(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets process fault status.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if process fault is on, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_process_fault(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets relates to information for the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to relates to struct
*/
AXIS2_EXTERN axis2_relates_to_t *AXIS2_CALL
axis2_msg_ctx_get_relates_to(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets WS-Addressing reply to endpoint. Reply to address tells where
* the the response should be sent to.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to endpoint reference struct representing the reply
* to address, returns a reference not a cloned copy
*/
AXIS2_EXTERN axis2_endpoint_ref_t *AXIS2_CALL
axis2_msg_ctx_get_reply_to(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Checks if it is on the server side that the message is being dealt
* with, or on the client side.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if it is server side, AXIS2_FALSE if it is client
* side
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_server_side(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets WS-Addressing to endpoint. To address tells where message should
* be sent to.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to endpoint reference struct representing the
* to address, returns a reference not a cloned copy
*/
AXIS2_EXTERN axis2_endpoint_ref_t *AXIS2_CALL
axis2_msg_ctx_get_to(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets WS-Addressing fault to endpoint. Fault to address tells where
* the fault message should be sent when there is an error.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param reference pointer to endpoint reference representing fault to
* address. message context assumes the ownership of endpoint struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_fault_to(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_endpoint_ref_t * reference);
/**
* Sets WS-Addressing from endpoint. From address tells where
* the message came from.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param reference pointer to endpoint reference representing from
* address. message context assumes the ownership of endpoint struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_from(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_endpoint_ref_t * reference);
/**
* Sets in fault flow status.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param in_fault_flow AXIS2_TRUE if there is a fault on in path,
* else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_in_fault_flow(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t in_fault_flow);
/**
* Sets SOAP envelope. The fact that if it is the request SOAP envelope
* or that of response depends on the current status represented by
* message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param soap_envelope pointer to SOAP envelope, message context
* assumes ownership of SOAP envelope
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_soap_envelope(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axiom_soap_envelope *soap_envelope);
/**
* Sets response SOAP envelope.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param soap_envelope pointer to SOAP envelope, message context
* assumes ownership of SOAP envelope
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_response_soap_envelope(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axiom_soap_envelope *soap_envelope);
/**
* Sets fault SOAP envelope.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param soap_envelope pointer to SOAP envelope, message context
* assumes ownership of SOAP envelope
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_fault_soap_envelope(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axiom_soap_envelope *soap_envelope);
/**
* Sets message ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param message_id message ID string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_message_id(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * message_id);
/**
* Sets process fault bool value.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param process_fault AXIS2_TRUE if SOAP faults are to be processed,
* else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_process_fault(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t process_fault);
/**
* Sets relates to struct.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param reference pointer to relates to struct, message context
* assumes ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_relates_to(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_relates_to_t * reference);
/**
* Sets WS-Addressing reply to address indicating the location to which
* the reply would be sent.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param reference pointer to endpoint reference representing reply to
* address
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_reply_to(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_endpoint_ref_t * reference);
/**
* Sets the bool value indicating if it is the server side or the
* client side.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param server_side AXIS2_TRUE if it is server side, AXIS2_FALSE if it
* is client side
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_server_side(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t server_side);
/**
* Sets WS-Addressing to address.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param reference pointer to endpoint reference struct representing
* the address where the request should be sent to. message context
* assumes ownership of endpoint struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_to(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_endpoint_ref_t * reference);
/**
* Gets the bool value indicating if it is required to have a new thread
* for the invocation, or if the same thread of execution could be used.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if new thread is required, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_new_thread_required(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the bool value indicating if it is required to have a new thread
* for the invocation, or if the same thread of execution could be used.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param new_thread_required AXIS2_TRUE if a new thread is required,
* else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_new_thread_required(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t new_thread_required);
/**
* Sets WS-Addressing action.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param action_uri WSA action URI string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_wsa_action(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * action_uri);
/**
* Gets WS-Addressing action.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to WSA action URI string
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_wsa_action(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets WS-Addressing message ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param message_id pointer to message ID string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_wsa_message_id(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * message_id);
/**
* Gets WS-Addressing message ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return WSA message ID string
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_wsa_message_id(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets WS-Addressing message information headers.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to message information headers struct with
* WS-Addressing information. Returns a reference, not a cloned copy
*/
AXIS2_EXTERN axis2_msg_info_headers_t *AXIS2_CALL
axis2_msg_ctx_get_msg_info_headers(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the bool value indicating the paused status. It is possible
* to pause the engine invocation by any handler. By calling this method
* one can find out if some handler has paused the invocation.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if message context is paused, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_paused(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the bool value indicating the paused status of invocation.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param paused paused
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_paused(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t paused);
/**
* Gets the bool value indicating the keep alive status. It is possible
* to keep alive the message context by any handler. By calling this method
* one can see whether it is possible to clean the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if message context is keep alive, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_is_keep_alive(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the bool value indicating the keep alive status of invocation.
* By setting this one can indicate the engine not to clean the message
* context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param keep_alive keep alive
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_keep_alive(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t keep_alive);
/**
* Gets transport in description.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to transport in description struct, returns a
* reference not a cloned copy
*/
AXIS2_EXTERN struct axis2_transport_in_desc *AXIS2_CALL
axis2_msg_ctx_get_transport_in_desc(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets transport out description.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to transport out description struct, returns a
* reference not a cloned copy
*/
AXIS2_EXTERN struct axis2_transport_out_desc *AXIS2_CALL
axis2_msg_ctx_get_transport_out_desc(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets transport in description.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param transport_in_desc pointer to transport in description struct,
* message context does not assume the ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transport_in_desc(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_transport_in_desc *transport_in_desc);
/**
* Sets transport out description.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param transport_out_desc pointer to transport out description,
* message context does not assume the ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transport_out_desc(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_transport_out_desc *transport_out_desc);
/**
* Gets operation context related to the operation that this message
* context is related to.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to operation context struct
*/
AXIS2_EXTERN struct axis2_op_ctx *AXIS2_CALL
axis2_msg_ctx_get_op_ctx(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets operation context related to the operation that this message
* context is related to.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param op_ctx pointer to operation context, message context does not
* assume the ownership of operation context
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_op_ctx(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_op_ctx *op_ctx);
/**
* Gets the bool value indicating the output written status.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if output is written, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_output_written(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the bool value indicating the output written status.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param output_written AXIS2_TRUE if output is written, else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_output_written(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t output_written);
/**
* Gets the HTTP Method that relates to the service that is
* related to the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Method string, returns a reference,
* not a cloned copy
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_rest_http_method(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the HTTP Method that relates to the service that is
* related to the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param rest_http_method HTTP Method string, msg_ctx does not assume
* ownership of rest_http_method.
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_rest_http_method(
struct axis2_msg_ctx * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * rest_http_method);
/**
* Gets the ID of service context that relates to the service that is
* related to the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return service context ID string
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_svc_ctx_id(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the ID of service context that relates to the service that is
* related to the message context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc_ctx_id The service context ID string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc_ctx_id(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * svc_ctx_id);
/**
* Gets configuration context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to configuration context
*/
AXIS2_EXTERN struct axis2_conf_ctx *AXIS2_CALL
axis2_msg_ctx_get_conf_ctx(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets service context that relates to the service that the message
* context is related to.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to message context struct
*/
AXIS2_EXTERN struct axis2_svc_ctx *AXIS2_CALL
axis2_msg_ctx_get_svc_ctx(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets configuration context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param conf_ctx pointer to configuration context struct, message
* context does not assume the ownership of struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_conf_ctx(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_conf_ctx *conf_ctx);
/**
* Sets service context.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc_ctx pointer to service context struct, message
* context does not assume the ownership of struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc_ctx(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc_ctx *svc_ctx);
/**
* Sets message information headers.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param msg_info_headers pointer to message information headers,
* message context assumes the ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_msg_info_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_msg_info_headers_t * msg_info_headers);
/**
* Gets configuration descriptor parameter with given key. This method
* recursively search the related description hierarchy for the parameter
* with given key until it is found or the parent of the description
* hierarchy is reached. The order of search is as follows:
* \n
* 1. search in operation description, if its there return
* \n
* 2. if the parameter is not found in operation or operation is NULL,
* search in service
* \n
* 3. if the parameter is not found in service or service is NULL search
* in configuration
* @param msg_ctx message context
* @param env pointer to environment struct
* @param key parameter key
* @return pointer to parameter struct corresponding to the given key
*/
AXIS2_EXTERN axutil_param_t *AXIS2_CALL
axis2_msg_ctx_get_parameter(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * key);
/**
* Gets parameters related to a named module and a given handler
* description. The order of searching for parameter is as follows:
* \n
* 1. search in module configuration stored inside corresponding operation
* description if its there
* \n
* 2. search in corresponding operation if its there
* \n
* 3. search in module configurations stored inside corresponding
* service description if its there
* \n
* 4. search in corresponding service description if its there
* \n
* 5. search in module configurations stored inside configuration
* \n
* 6. search in configuration for parameters
* \n
* 7. get the corresponding module and search for the parameters
* \n
* 8. search in handler description for the parameter
* @param msg_ctx pointer to message context
* @param env pointer to environment struct
* @param key parameter key
* @param module_name name of the module
* @param handler_desc pointer to handler description
* @return pointer to parameter
*/
AXIS2_EXTERN axutil_param_t *AXIS2_CALL
axis2_msg_ctx_get_module_parameter(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * key,
const axis2_char_t * module_name,
axis2_handler_desc_t * handler_desc);
/**
* Gets property corresponding to the given key.
* @param msg_ctx pointer to message context
* @param env pointer to environment struct
* @param key key string with which the property is stored
* @return pointer to property struct
*/
AXIS2_EXTERN axutil_property_t *AXIS2_CALL
axis2_msg_ctx_get_property(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * key);
/**
* Gets property value corresponding to the property given key.
* @param msg_ctx pointer to message context
* @param env pointer to environment struct
* @param property_str key string with which the property is stored
* @return pointer to property struct
*/
AXIS2_EXTERN void *AXIS2_CALL
axis2_msg_ctx_get_property_value(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * property_str);
/**
* Sets property with given key.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param key key string
* @param value property to be stored
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_property(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * key,
axutil_property_t * value);
/**
* Gets the QName of the handler at which invocation was paused.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to QName of the paused handler
*/
AXIS2_EXTERN const axutil_string_t *AXIS2_CALL
axis2_msg_ctx_get_paused_handler_name(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the name of the phase at which the invocation was paused.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return name string of the paused phase.
*/
AXIS2_EXTERN const axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_paused_phase_name(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the name of the phase at which the invocation was paused.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param paused_phase_name paused phase name string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_paused_phase_name(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * paused_phase_name);
/**
* Gets SOAP action.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return SOAP action string
*/
AXIS2_EXTERN axutil_string_t *AXIS2_CALL
axis2_msg_ctx_get_soap_action(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets SOAP action.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param soap_action SOAP action string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_soap_action(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_string_t * soap_action);
/**
* Gets the boolean value indicating if MTOM is enabled or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if MTOM is enabled, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_doing_mtom(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the boolean value indicating if MTOM is enabled or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param doing_mtom AXIS2_TRUE if MTOM is enabled, else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_doing_mtom(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t doing_mtom);
/**
* Gets the boolean value indicating if REST is enabled or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if REST is enabled, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_doing_rest(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the boolean value indicating if REST is enabled or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param doing_rest AXIS2_TRUE if REST is enabled, else AXIS2_FALSE
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_doing_rest(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t doing_rest);
/**
* Sets the boolean value indicating if REST should be done through
* HTTP POST or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param do_rest_through_post AXIS2_TRUE if REST is to be done with
* HTTP POST, else AXIS2_FALSE if REST is not to be done with HTTP POST
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_do_rest_through_post(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t do_rest_through_post);
/**
* Sets the boolean value indicating if REST should be done through
* HTTP POST or not.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if REST is to be done with HTTP POST, else
* AXIS2_FALSE if REST is not to be done with HTTP POST
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_do_rest_through_post(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets manage session bool value.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if session is managed, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_manage_session(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets manage session bool value.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param manage_session manage session bool value
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_manage_session(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t manage_session);
/**
* Gets the bool value indicating the SOAP version being used either
* SOAP 1.1 or SOAP 1.2
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if SOAP 1.1 is being used, else AXIS2_FALSE if
* SOAP 1.2 is being used
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_is_soap_11(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the bool value indicating the SOAP version being used either
* SOAP 1.1 or SOAP 1.2
* @param msg_ctx message context
* @param env pointer to environment struct
* @param is_soap11 AXIS2_TRUE if SOAP 1.1 is being used, else
* AXIS2_FALSE if SOAP 1.2 is being used
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_is_soap_11(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t is_soap11);
/**
* Gets service group context. The returned service group context
* relates to the service group to which the service, related to the
* message context, belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to service group struct
*/
AXIS2_EXTERN struct axis2_svc_grp_ctx *AXIS2_CALL
axis2_msg_ctx_get_svc_grp_ctx(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets service group context. The returned service group context
* relates to the service group to which the service, related to the
* message context, belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc_grp_ctx pointer to service group context
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc_grp_ctx(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc_grp_ctx *svc_grp_ctx);
/**
* Gets the operation that is to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to operation, returns a reference not a cloned copy
*/
AXIS2_EXTERN struct axis2_op *AXIS2_CALL
axis2_msg_ctx_get_op(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the operation that is to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param op pointer to operation, message context does not assume the
* ownership of operation
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_op(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_op *op);
/**
* Gets the service to which the operation to be invoked belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to service struct, returns a reference not a cloned copy
*/
AXIS2_EXTERN struct axis2_svc *AXIS2_CALL
axis2_msg_ctx_get_svc(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the service to which the operation to be invoked belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc pointer to service struct, message context does not assume
* the ownership of struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc *svc);
/**
* Gets the service group to which the service to be invoked belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to service group struct, returns a reference not
* a cloned copy
*/
AXIS2_EXTERN struct axis2_svc_grp *AXIS2_CALL
axis2_msg_ctx_get_svc_grp(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the service group to which the service to be invoked belongs.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc_grp pointer to service group struct, message context does
* not assume the ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc_grp(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc_grp *svc_grp);
/**
* Gets the service group context ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return service group context ID string
*/
AXIS2_EXTERN const axutil_string_t *AXIS2_CALL
axis2_msg_ctx_get_svc_grp_ctx_id(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the service group context ID.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc_grp_ctx_id service group context ID string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_svc_grp_ctx_id(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_string_t * svc_grp_ctx_id);
/**
* Sets function to be used to find a service. This function is used by dispatchers
* to locate the service to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param func function to be used to find an operation
* @return pointer to service to be invoked
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_find_svc(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
AXIS2_MSG_CTX_FIND_SVC func);
/**
* Sets function to be used to find an operation in the given service.
* This function is used by dispatchers to locate the operation to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param func function to be used to find an operation
* @return pointer to the operation to be invoked
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_find_op(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
AXIS2_MSG_CTX_FIND_OP func);
/**
* Finds the service to be invoked. This function is used by dispatchers
* to locate the service to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer to service to be invoked
*/
AXIS2_EXTERN struct axis2_svc *AXIS2_CALL
axis2_msg_ctx_find_svc(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Finds the operation to be invoked in the given service. This function
* is used by dispatchers to locate the operation to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param svc pointer to service to whom the operation belongs
* @return pointer to the operation to be invoked
*/
AXIS2_EXTERN struct axis2_op *AXIS2_CALL
axis2_msg_ctx_find_op(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_svc *svc);
/**
* Gets the options to be used in invocation.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return options pointer to options struct, message context does not
* assume the ownership of the struct
*/
AXIS2_EXTERN struct axis2_options *AXIS2_CALL
axis2_msg_ctx_get_options(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the bool value indicating the paused status.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if invocation is paused, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_is_paused(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the options to be used in invocation.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param options pointer to options struct, message context does not
* assume the ownership of the struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_options(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_options *options);
/**
* Sets the flow to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param flow int value indicating the flow
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_flow(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
int flow);
/**
* Gets the flow to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return int value indicating the flow
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_flow(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the list of supported REST HTTP Methods
* @param msg_ctx message context
* @param env pointer to environment struct
* @param supported_rest_http_methods pointer array list containing
* the list of HTTP Methods supported. Message context does
* assumes the ownership of the array list. Anything added to this
* array list will be freed by the msg_ctx
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_supported_rest_http_methods(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * supported_rest_http_methods);
/**
* Gets the list of supported REST HTTP Methods
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer array list containing
* the list of HTTP Methods supported. Message context does
* assumes the ownership of the array list
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_supported_rest_http_methods(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the execution chain to be invoked. The execution chain is a
* list of phases containing the handlers to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param execution_chain pointer array list containing the list of
* handlers that constitute the execution chain. Message context does
* not assume the ownership of the array list
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_execution_chain(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * execution_chain);
/**
* Gets the execution chain to be invoked. The execution chain is a
* list of phases containing the handlers to be invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return pointer array list containing the list of handlers that
* constitute the execution chain. Message context does not assume
* the ownership of the array list
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_execution_chain(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets current handler index, indicating which handler is currently
* being invoked in the execution chain
* @param msg_ctx message context
* @param env pointer to environment struct
* @param index index of currently executed handler
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_current_handler_index(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const int index);
/**
* Gets current handler index, indicating which handler is currently
* being invoked in the execution chain
* @param msg_ctx message context
* @param env pointer to environment struct
* @return index of currently executed handler
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_current_handler_index(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets paused handler index, indicating at which handler the execution
* chain was paused.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return index of handler at which invocation was paused
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_paused_handler_index(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets index of the current phase being invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param index index of current phase
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_current_phase_index(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const int index);
/**
* Gets index of the current phase being invoked.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return index of current phase
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_current_phase_index(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the phase at which the invocation was paused.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return index of paused phase
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_paused_phase_index(
const axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets character set encoding to be used.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axutil_string_t *AXIS2_CALL
axis2_msg_ctx_get_charset_encoding(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets character set encoding to be used.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param str pointer to string struct representing encoding
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_charset_encoding(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_string_t * str);
/**
* Gets the integer value indicating http status_code.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return status value
*/
AXIS2_EXTERN int AXIS2_CALL
axis2_msg_ctx_get_status_code(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the int value indicating http status code
* @param msg_ctx message context
* @param env pointer to environment struct
* @param status_code of the http response
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_status_code(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const int status_code);
/**
* Gets the Transport Out Stream
* @param msg_ctx message context
* @param env pointer to environment struct
* @return reference to Transport Out Stream
*/
AXIS2_EXTERN axutil_stream_t *AXIS2_CALL
axis2_msg_ctx_get_transport_out_stream(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the Transport Out Stream
* @param msg_ctx message context
* @param env pointer to environment struct
* @param stream reference to Transport Out Stream
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transport_out_stream(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_stream_t * stream);
/**
* Resets Transport Out Stream
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_reset_transport_out_stream(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the HTTP Out Transport Info associated
* @param msg_ctx message context
* @param env pointer to environment struct
* @return reference to HTTP Out Transport Info associated
*/
AXIS2_EXTERN struct axis2_out_transport_info *AXIS2_CALL
axis2_msg_ctx_get_out_transport_info(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the HTTP Out Transport Info associated
* @param msg_ctx message context
* @param env pointer to environment struct
* @param out_transport_info reference to HTTP Out
* Transport Info associated
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_out_transport_info(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
struct axis2_out_transport_info *out_transport_info);
/**
* Resets the HTTP Out Transport Info associated
* @param msg_ctx message context
* @param env pointer to environment struct
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_reset_out_transport_info(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves Transport Headers.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Transport Headers associated.
*/
AXIS2_EXTERN axutil_hash_t *AXIS2_CALL
axis2_msg_ctx_get_transport_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves Transport Headers, and removes them
* from the message context
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Transport Headers associated.
*/
AXIS2_EXTERN axutil_hash_t *AXIS2_CALL
axis2_msg_ctx_extract_transport_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the Transport Headers
* @param msg_ctx message context
* @param env pointer to environment struct
* @param transport_headers a Hash containing the
* Transport Headers
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transport_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_hash_t * transport_headers);
/**
* Retrieves HTTP Accept-Charset records.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept-Charset records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_http_accept_charset_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves HTTP Accept-Charset records, and removes them
* from the message context
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept-Charset records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_extract_http_accept_charset_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the HTTP Accept-Charset records
* @param msg_ctx message context
* @param env pointer to environment struct
* @param accept_charset_record_list an Array List containing the
* HTTP Accept-Charset records
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_http_accept_charset_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * accept_charset_record_list);
/**
* Retrieves HTTP Accept-Language records.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept-Language records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_http_accept_language_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves HTTP Accept-Language records, and removes them
* from the message context
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept-Language records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_extract_http_accept_language_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the HTTP Accept-Language records
* @param msg_ctx message context
* @param env pointer to environment struct
* @param accept_language_record_list an Array List containing the
* HTTP Accept-Language records
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_http_accept_language_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * accept_language_record_list);
/**
* Gets the Content Language used
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Content Language string
*/
AXIS2_EXTERN axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_content_language(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the Content Language used
* @param msg_ctx message context
* @param env pointer to environment struct
* @param str Content Language string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_content_language(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_char_t * str);
/**
* Retrieves HTTP Accept records.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_http_accept_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves HTTP Accept records, and removes them
* from the message context
* @param msg_ctx message context
* @param env pointer to environment struct
* @return HTTP Accept records associated.
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_extract_http_accept_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the HTTP Accept records
* @param msg_ctx message context
* @param env pointer to environment struct
* @param accept_record_list an Array List containing the
* HTTP Accept records
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_http_accept_record_list(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * accept_record_list);
/**
* Gets the transfer encoding used
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Transfer encoding string
*/
AXIS2_EXTERN axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_transfer_encoding(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the transfer encoding used
* @param msg_ctx message context
* @param env pointer to environment struct
* @param str Transfer encoding string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transfer_encoding(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_char_t * str);
/**
* Gets the Transport URL
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Transport URL string
*/
AXIS2_EXTERN axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_transport_url(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the Transport URL
* @param msg_ctx message context
* @param env pointer to environment struct
* @param str Transport URL string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_transport_url(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axis2_char_t * str);
/**
* Gets whether there was no content in the response.
* This will cater for a situation where the invoke
* method in a service returns NULL when no fault has
* occured.
* @param msg_ctx message context
* @param env pointer to environment struct
* @return returns AXIS2_TRUE if there was no content
* occured or AXIS2_FALSE otherwise
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_no_content(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets that there was no content in the response.
* @param msg_ctx message context
* @param env pointer to environment struct
* @param no_content expects AXIS2_TRUE if there was no
* content in the response or AXIS2_FALSE otherwise
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_no_content(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t no_content);
/**
* Gets whether an authentication failure occured
* @param msg_ctx message context
* @param env pointer to environment struct
* @return returns AXIS2_TRUE if an authentication failure
* occured or AXIS2_FALSE if not
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_auth_failed(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets whether an authentication failure occured
* @param msg_ctx message context
* @param env pointer to environment struct
* @param status expects AXIS2_TRUE if an authentication failure
* occured or AXIS2_FALSE if not
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_auth_failed(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t status);
/**
* Gets whether HTTP Authentication is required or
* whether Proxy Authentication is required
* @param msg_ctx message context
* @param env pointer to environment struct
* @return returns AXIS2_TRUE for HTTP Authentication
* and AXIS2_FALSE for Proxy Authentication
*/
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_required_auth_is_http(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets whether HTTP Authentication is required or
* whether Proxy Authentication is required
* @param msg_ctx message context
* @param env pointer to environment struct
* @param is_http use AXIS2_TRUE for HTTP Authentication
* and AXIS2_FALSE for Proxy Authentication
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_required_auth_is_http(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_bool_t is_http);
/**
* Sets the authentication type
* @param msg_ctx message context
* @param env pointer to environment struct
* @param auth_type Authentication type string
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_auth_type(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
const axis2_char_t * auth_type);
/**
* Gets the authentication type
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Authentication type string
*/
AXIS2_EXTERN axis2_char_t *AXIS2_CALL
axis2_msg_ctx_get_auth_type(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Gets the Output Header list
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Output Header list
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_http_output_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Retrieves the Output Headers, and removes them
* from the message context
* @param msg_ctx message context
* @param env pointer to environment struct
* @return Output Header list
*/
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_extract_http_output_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
/**
* Sets the Output Header list
* @param msg_ctx message context
* @param env pointer to environment struct
* @param output_headers Output Header list
* @return AXIS2_SUCCESS on success, else AXIS2_FAILURE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_http_output_headers(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t * output_headers);
AXIS2_EXTERN axutil_array_list_t *AXIS2_CALL
axis2_msg_ctx_get_mime_parts(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
AXIS2_EXTERN void AXIS2_CALL
axis2_msg_ctx_set_mime_parts(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env,
axutil_array_list_t *mime_parts);
/**
* Incrementing the msg_ctx ref count. This is necessary when
* prevent freeing msg_ctx through op_client when it is in use
* as in sandesha2.
* @param msg_ctx pointer to message context
* @param env pointer to environment struct
* @return AXIS2_TRUE if still in use, else AXIS2_FALSE
*/
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_increment_ref(
axis2_msg_ctx_t * msg_ctx,
const axutil_env_t * env);
#ifdef AXIS2_JSON_ENABLED
AXIS2_EXTERN axis2_bool_t AXIS2_CALL
axis2_msg_ctx_get_doing_json(
const axis2_msg_ctx_t *msg_ctx,
const axutil_env_t *env);
AXIS2_EXTERN axis2_status_t AXIS2_CALL
axis2_msg_ctx_set_doing_json(axis2_msg_ctx_t *msg_ctx,
const axutil_env_t *env,
const axis2_bool_t doing_json);
#endif
/** @} */
#ifdef __cplusplus
}
#endif
#endif /* AXIS2_MSG_CTX_H */