Using the SOAP monitor - HxGN EAM - Version 11.07.01 - Customization & Programming - Hexagon

HxGN EAM Web Services Toolkit Help

Language
English
Product
HxGN EAM
Search by Category
Customization & Programming
HxGN EAM Version
11.7.1

Web service developers often have the need to see the SOAP messages being used to invoke Web services along with the results of those messages. The goal of the SOAP Monitor utility is to provide a way for these developers to monitor the SOAP messages being used without requiring any special configuration or restarting of the server.

In this utility, as SOAP requests and responses are received, the SOAP message information is forwarded to a SOAP monitor service where it can be displayed using a Web browser interface.

The SOAP message information is accessed with a Web browser by going to http://localhost:<port>/axis/SOAPMonitor (where <port> is the port number where the application server is running).

The SOAP message information is displayed through a Web browser by using an applet that opens a socket connection to the SOAP monitor service. This applet requires a Java plug-in 1.3 or higher to be installed in your browser. If you do not have the correct plug-in, the browser should prompt you to install one.

The port used by the SOAP monitor service to communicate with applets is configurable. Edit the web.xml file from axis.war’s WEB-INF directory to change the port to be used.

Example

<servlet>

<servlet-name>SOAPMonitorService</servlet-name>

<display-name>SOAPMonitorService</display-name>

<servlet-class> org.apache.axis.monitor.SOAPMonitorService

</servlet-class>

<init-param>

<param-name>SOAPMonitorPort</param-name>

<param-value>5881</param-value>

</init-param>

<load-on-startup>100</load-on-startup>

</servlet>

To turn SOAP Monitor completely off, comment out the following section of the web.xml file and restart the Axis server.

<servlet-mapping>

<servlet-name>SOAPMonitorService</servlet-name>

<url-pattern>/SOAPMonitor</url-pattern>

</servlet-mapping>