NonStop SOAP 4.1 User's Manual

The fault Function..........................................................................................................88
The free Function...........................................................................................................88
APIs to Extract the Input Parameters and Return the Response...................................................89
Reading an AXIOM node using NonStop SOAP 4 APIs......................................................89
The axiom_element_get_qname()Function....................................................................89
The axiom_node_get_data_element()Function...............................................................90
The axiom_attribute_get_qname()Function....................................................................90
The axiom_element_get_attribute()Function...................................................................90
Creating an AXIOM node using NonStop SOAP 4 APIs.....................................................91
Creating an AXIOM node using AXIOM Node Create APIs...........................................91
Creating an AXIOM node from an XML using AXIOM Document APIs.............................93
APIs for Logging................................................................................................................95
Creating the log file structure..........................................................................................95
Developing NonStop SOAP 4 Services using Service APIs............................................................95
Defining the XML Request and Response Payload...................................................................96
Creating the SDL File for the Service.....................................................................................98
Generating the WSDL File and the services.xml File................................................................99
Generating the Service Skeleton Files.................................................................................100
Implementing the Business Logic in the Service Skeleton Files.................................................102
Compiling the Service Code and Deploying the Service........................................................102
Testing the Service...........................................................................................................103
6 NonStop SOAP 4 Client APIs...................................................................105
NonStop SOAP 4 Client APIs.................................................................................................105
APIs to Implement the Client Interface with NonStop SOAP 4.................................................105
The axis2_svc_client_create()Function.............................................................................106
The axis2_svc_client_free()Function................................................................................106
APIs to Generate the Request Node and Consume the Response Node...................................106
Generating the Request AXIOM node using NonStop SOAP 4 APIs...................................107
Creating an AXIOM node using AXIOM Node Create APIs.........................................107
Creating an AXIOM node from an XML using AXIOM Document APIs...........................110
Consuming the Response AXIOM node using NonStop SOAP 4 APIs.................................111
The axiom_element_get_qname()Function..................................................................111
The axiom_node_get_data_element()Function.............................................................112
The axiom_attribute_get_qname()Function..................................................................112
The axiom_element_get_attribute()Function.................................................................112
APIs to Invoke the Web Service..........................................................................................113
The axis2_svc_client_send_receive() Function..................................................................113
The axis2_svc_client_send_receive_non_blocking() Function..............................................113
The axis2_svc_client_send_robust() Function....................................................................114
The axis2_svc_client_fire_and_forget() Function...............................................................114
APIs for Logging..............................................................................................................115
Creating the log file structure........................................................................................115
Logging messages at different log levels.........................................................................115
The axutil_log_impl_log_warning()Function................................................................116
The axutil_log_impl_log_info() Function......................................................................116
The axutil_log_impl_log_user()Function......................................................................116
The axutil_log_impl_log_debug()Function...................................................................116
The axutil_log_impl_log_trace()Function.....................................................................116
Releasing the log structure............................................................................................116
ADB APIs for creating requests...........................................................................................117
The adb_<messagename>_create()Function....................................................................117
The adb_<messagename>_free()Function.......................................................................117
The adb_<complextype>_create_with_values() Function....................................................117
The adb_<messagename>_set_<complextype>() Function.................................................118
Contents 5