include/axis2_di_client.h

/*
 * 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_DICLIENT_H
#define AXIS2_DICLIENT_H


/**
  * @file axis2_diclient.h
  * @brief axis2 Dynamic Invocation Client interface
  */

#include <axis2_defines.h>
#include <axis2_env.h>
#include <axis2_error.h>

#ifdef __cplusplus
extern "C"
{
#endif

/** @defgroup axis2_diclient Dynamic Invocation Client 
 * @ingroup axis2_core_clientapi
 * @{
 */
    
typedef struct axis2_diclient_ops axis2_diclient_ops_t;
typedef struct axis2_diclient axis2_diclient_t; 

struct axis2_om_node;
struct axis2_op;

/** 
 * @brief Dynamic Invocation Client ops struct
 * Encapsulator struct for ops of axis2_diclient
 */  
struct axis2_diclient_ops
{
    axis2_status_t (AXIS2_CALL *
	free)(struct axis2_diclient *diclient, 
          axis2_env_t **env);

    /**
     * Invoke the operation by passing om node and axis2 operation as 
     * parameters
     * @param om node
     * @param axis2 operation
     * @return status code
     */
    axis2_status_t (AXIS2_CALL *
    invoke) (axis2_diclient_t *diclient,
             axis2_env_t **env,
             axis2_om_node_t *node,
             struct axis2_op *op);
   
    /**
     * Do the initialization work. Here wsdl parser is created and
     * Pumping of wsdl object model from Wsdl Pull Parser into the
     * Axis2 Wsdl Object modle is initiated. Also operation map and
     * endpoint map is populated
     * @param wsdl file name
     * @return status code
     */
    axis2_status_t (AXIS2_CALL *
    init) (axis2_diclient_t *diclient,
           axis2_env_t **env,
		   axis2_char_t *wsdl_file_name);

    /**
     * By passing the operation qualified name and the endpoint qualified
     * name operations action and address is set
     * @param operation qualified name
     * @param endpoint qualified name
     * @return status code
     */
    axis2_status_t *(AXIS2_CALL *
    set_address_and_action_for_op) (axis2_diclient_t *diclient,
                                    axis2_env_t **env,
                                    axis2_qname_t *op_qname);


    /**
     * Return all the endpoints associated with the wsdl
     * @return table of endpoints associated with the wsdl
     */
    axis2_hash_t *(AXIS2_CALL *
    get_endpoints) (axis2_diclient_t *diclient,
                  axis2_env_t **env);

    /**
     * Return all the services associated with the wsdl
     * @return table of services associated with the wsdl
     */
    axis2_hash_t *(AXIS2_CALL *
    get_services) (axis2_diclient_t *diclient,
                  axis2_env_t **env);

    /**
     * Return the all operations associated with the wsdl
     * @return table of operations associated with the wsdl
     */
    axis2_hash_t *(AXIS2_CALL *
    get_operations) (axis2_diclient_t *diclient,
            axis2_env_t **env);
   
    /**
     * Return the operation parameter's localname. This method
     * can be used in document style operations where operation has
     * only one parameter
     * @param operation qualified name
     * @return parameter's localname
     */
    axis2_char_t *(AXIS2_CALL *
    get_param_localname) (axis2_diclient_t *diclient,
                            axis2_env_t **env,
                            axis2_qname_t *op_qname);

    /**
     * Return the operation parameter's namespace. This method
     * can be used in document style operations where operation has
     * only one parameter
     * @param operation qualified name
     * @return parameter's namespace
     */
    axis2_char_t *(AXIS2_CALL *
    get_param_namespace) (axis2_diclient_t *diclient,
                            axis2_env_t **env,
                            axis2_qname_t *op_qname);

    /**
     * Return the set of parameters associated with the operation.
     * This can be used in rpc style operations where operation has
     * multiple parameters.
     * @param operation qualified name
     * @return set of parameters assoicated with the operation
     */
    axis2_hash_t *(AXIS2_CALL *
    get_params) (axis2_diclient_t *diclient,
                            axis2_env_t **env,
                            axis2_qname_t *op_qname);
};

/** 
 * @brief Dynamic Invocation Client struct
  *	Axis2 Dynamic Invocation Client
 */
struct axis2_diclient
{
    axis2_diclient_ops_t *ops;    
};

AXIS2_DECLARE(axis2_diclient_t*) 
axis2_diclient_create(axis2_env_t **env);

/************************** Start of function macros **************************/

#define AXIS2_DICLIENT_FREE(diclient, env) \
		((diclient)->ops->free (diclient, env))
		
#define AXIS2_DICLIENT_INVOKE(diclient, env, node, op) \
		((diclient)->ops->invoke (diclient, env, node, op))

#define AXIS2_DICLIENT_INIT(diclient, env, wsdl_file_name) \
		((diclient)->ops->init (diclient, env, wsdl_file_name))

#define AXIS2_DICLIENT_SET_ADDRESS_AND_ACTION_FOR_OP(diclient, env, op_qname) \
		((diclient)->ops->set_address_and_action_for_op (diclient, env, \
                op_qname))

#define AXIS2_DICLIENT_GET_ENDPOINTS(diclient, env) \
		((diclient)->ops->get_endpoints (diclient, env))

#define AXIS2_DICLIENT_GET_SERVICES(diclient, env) \
		((diclient)->ops->get_services (diclient, env))

#define AXIS2_DICLIENT_GET_OPERATIONS(diclient, env) \
		((diclient)->ops->get_operations (diclient, env))

#define AXIS2_DICLIENT_GET_PARAM_LOCALNAME(diclient, env, op_qname) \
		((diclient)->ops->get_param_localname (diclient, env, op_qname))

#define AXIS2_DICLIENT_GET_PARAM_NAMESPACE(diclient, env, op_qname) \
		((diclient)->ops->get_param_namespace (diclient, env, op_qname))

#define AXIS2_DICLIENT_GET_PARAMS(diclient, env, op_qname) \
		((diclient)->ops->get_params (diclient, env, op_qname))

/************************** End of function macros ****************************/    

/** @} */
#ifdef __cplusplus
}
#endif

#endif                          /* AXIS2_DICLIENT_H */