You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by ch...@apache.org on 2007/04/23 13:13:55 UTC
svn commit: r531433 - /webservices/axis2/site/1_1_1/soapmonitor-module.html
Author: chatra
Date: Mon Apr 23 04:13:51 2007
New Revision: 531433
URL: http://svn.apache.org/viewvc?view=rev&rev=531433
Log:
made corrections with reference to https://issues.apache.org/jira/browse/AXIS2-1868
Modified:
webservices/axis2/site/1_1_1/soapmonitor-module.html
Modified: webservices/axis2/site/1_1_1/soapmonitor-module.html
URL: http://svn.apache.org/viewvc/webservices/axis2/site/1_1_1/soapmonitor-module.html?view=diff&rev=531433&r1=531432&r2=531433
==============================================================================
--- webservices/axis2/site/1_1_1/soapmonitor-module.html (original)
+++ webservices/axis2/site/1_1_1/soapmonitor-module.html Mon Apr 23 04:13:51 2007
@@ -1,37 +1,154 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Axis2/Java - The SOAP Monitor Module</title><style type="text/css" media="all">
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+ <title>Axis2/Java - The SOAP Monitor Module</title>
+ <style type="text/css" media="all">
@import url("../style/maven-base.css");
- @import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 12 January 2007
- | Doc for 1.1.1</div><div class="xright">
-
- <a href="../index.html">Axis2/Java</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="http://ws.apache.org/axis2/c" class="externalLink" title="External Link">Axis2/C</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="http://ws.apache.org" class="externalLink" title="External Link">Apache WS</a>
-
-
-
- <span class="separator">|</span>
-
-
- <a href="http://www.apache.org" class="externalLink" title="External Link">Apache </a>
- </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis2_Java"><h5>Axis2/Java</h5><ul><li class="none"><a href="../index.html">Home</a></li></ul></div><div id="menuDownloads"><h5>Downloads</h5><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../tools/index.html">Tools</a></li></ul></div><div id="menuDocumentation"><h5>Documentation</h5><ul><li class="expanded"><a href="../1_1_1/contents.html">Version 1.1.1</a><ul><li class="none"><a href="../1_1_1/toc.html">Table of Contents</a></li><li class="none"><a href="../1_1_1/installationguide.html">Installation Guide</a></li><li class="none"><a href="../1_1_1/quickstartguide.html">QuickStart Guide</a></li><li class="none"><a href="../1_1_1/userguide.html">User Guide</a></li><li class="none"><a href="../1_1_1/pojoguide.html">POJO Guide</a></li><li class="none"><a href="../1_1
_1/spring.html">Spring Guide</a></li><li class="none"><a href="../1_1_1/webadminguide.html">Web Administrator's Guide</a></li><li class="none"><a href="../1_1_1/migration.html">Migration Guide (from Axis1)</a></li></ul></li><li class="none"><a href="../1_1/contents.html">Version 1.1</a></li><li class="none"><a href="../1_0/index.html">Version 1.0</a></li><li class="none"><a href="../0_95/index.html">Version 0.95</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li><li class="none"><a href="../0_93/index.html">Version 0.93</a></li></ul></div><div id="menuResources"><h5>Resources</h5><ul><li class="none"><a href="../faq.html">FAQ</a></li><li class="none"><a href="../articles.html">Articles</a></li><li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2/" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="http://ws.apache.org/axis2/1_1_1/api/index
.html" class="externalLink" title="External Link">Online Java Docs</a></li></ul></div><div id="menuGet_Involved"><h5>Get Involved</h5><ul><li class="none"><a href="../overview.html">Overview</a></li><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../guidelines.html">Developer Guidelines</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li></ul></div><div id="menuProject_Information"><h5>Project Information</h5><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE
-2.0.html" class="externalLink" title="External Link">License</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Using_the_SOAP_Monitor"></a><h2>Using the SOAP Monitor</h2><p>Web service developers often have the need to see the SOAP messages being
+ @import url("../style/maven-theme.css");</style>
+ <link rel="stylesheet" href="../style/print.css" type="text/css"
+ media="print" />
+ <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
+</head>
+
+<body class="composite">
+
+<div id="banner">
+<a href="http://www.apache.org/" id="organizationLogo"><img
+alt="Apache Software Foundation"
+src="http://www.apache.org/images/asf-logo.gif" /></a><a
+href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis2"
+src="http://ws.apache.org/axis2/images/axis.jpg" /></a>
+
+<div class="clear">
+<hr />
+</div>
+</div>
+
+<div id="breadcrumbs">
+
+<div class="xleft">
+Last published: 12 January 2007 | Doc for 1.1.1</div>
+
+<div class="xright">
+<a href="../index.html">Axis2/Java</a> <span class="separator">|</span> <a
+href="http://ws.apache.org/axis2/c" class="externalLink"
+title="External Link">Axis2/C</a> <span class="separator">|</span> <a
+href="http://ws.apache.org" class="externalLink" title="External Link">Apache
+WS</a> <span class="separator">|</span> <a href="http://www.apache.org"
+class="externalLink" title="External Link">Apache</a></div>
+
+<div class="clear">
+<hr />
+</div>
+</div>
+
+<div id="leftColumn">
+
+<div id="navcolumn">
+
+<div id="menuAxis2_Java">
+<h5>Axis2/Java</h5>
+<ul>
+ <li class="none"><a href="../index.html">Home</a></li>
+</ul>
+</div>
+
+<div id="menuDownloads">
+<h5>Downloads</h5>
+<ul>
+ <li class="none"><a href="../download.cgi">Releases</a></li>
+ <li class="none"><a href="../modules/index.html">Modules</a></li>
+ <li class="none"><a href="../tools/index.html">Tools</a></li>
+</ul>
+</div>
+
+<div id="menuDocumentation">
+<h5>Documentation</h5>
+<ul>
+ <li class="expanded"><a href="../1_1_1/contents.html">Version 1.1.1</a>
+ <ul>
+ <li class="none"><a href="../1_1_1/toc.html">Table of Contents</a></li>
+ <li class="none"><a href="../1_1_1/installationguide.html">Installation
+ Guide</a></li>
+ <li class="none"><a href="../1_1_1/quickstartguide.html">QuickStart
+ Guide</a></li>
+ <li class="none"><a href="../1_1_1/userguide.html">User Guide</a></li>
+ <li class="none"><a href="../1_1_1/pojoguide.html">POJO Guide</a></li>
+ <li class="none"><a href="../1_1_1/spring.html">Spring Guide</a></li>
+ <li class="none"><a href="../1_1_1/webadminguide.html">Web
+ Administrator's Guide</a></li>
+ <li class="none"><a href="../1_1_1/migration.html">Migration Guide
+ (from Axis1)</a></li>
+ </ul>
+ </li>
+ <li class="none"><a href="../1_1/contents.html">Version 1.1</a></li>
+ <li class="none"><a href="../1_0/index.html">Version 1.0</a></li>
+ <li class="none"><a href="../0_95/index.html">Version 0.95</a></li>
+ <li class="none"><a href="../0_94/index.html">Version 0.94</a></li>
+ <li class="none"><a href="../0_93/index.html">Version 0.93</a></li>
+</ul>
+</div>
+
+<div id="menuResources">
+<h5>Resources</h5>
+<ul>
+ <li class="none"><a href="../faq.html">FAQ</a></li>
+ <li class="none"><a href="../articles.html">Articles</a></li>
+ <li class="none"><a href="http://wiki.apache.org/ws/FrontPage/Axis2/"
+ class="externalLink" title="External Link">Wiki</a></li>
+ <li class="none"><a href="../refLib.html">Reference Library</a></li>
+ <li class="none"><a href="http://ws.apache.org/axis2/1_1_1/api/index.html"
+ class="externalLink" title="External Link">Online Java Docs</a></li>
+</ul>
+</div>
+
+<div id="menuGet_Involved">
+<h5>Get Involved</h5>
+<ul>
+ <li class="none"><a href="../overview.html">Overview</a></li>
+ <li class="none"><a href="../svn.html">Checkout the Source</a></li>
+ <li class="none"><a href="../mail-lists.html">Mailing Lists</a></li>
+ <li class="none"><a href="../guidelines.html">Developer Guidelines</a></li>
+ <li class="none"><a href="../siteHowTo.html">Build the Site</a></li>
+</ul>
+</div>
+
+<div id="menuProject_Information">
+<h5>Project Information</h5>
+<ul>
+ <li class="none"><a href="../team-list.html">Project Team</a></li>
+ <li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li>
+ <li class="none"><a
+ href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN"
+ class="externalLink" title="External Link">Source Code</a></li>
+ <li class="none"><a href="../thanks.html">Acknowledgements</a></li>
+ <li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0.html"
+ class="externalLink" title="External Link">License</a></li>
+</ul>
+</div>
+<a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img
+alt="Built by Maven" src="../images/logos/maven-button-1.png" /></a></div>
+</div>
+
+<div id="bodyColumn">
+
+<div class="contentBox">
+
+<div class="section">
+<a name="Using_the_SOAP_Monitor"></a>
+
+<h2>Using the SOAP Monitor</h2>
+
+<p>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.</p><p>In this utility, a handler has been written and added to the global
+configuration or restarting of the server.</p>
+
+<p>In this utility, a handler has been written and added to the global
handler chain. 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 by a
@@ -42,19 +159,29 @@
plug-in 1.3 or higher to be installed in your browser. If you do not have a
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 to change the port used by Axis2 Web application.</p><p>The SOAP Monitor module (soapmonitor.mar) is available in the axis2.war
+the web.xml file to change the port used by Axis2 Web application.</p>
+
+<p>The SOAP Monitor module (soapmonitor.mar) is available in the axis2.war
but it is not engaged by default. The SOAP Monitor is NOT enabled by default
-for security reasons.</p><p>The SOAP Monitor can be engaged by inserting the following in the
+for security reasons.</p>
+
+<p>The SOAP Monitor can be engaged by inserting the following in the
axis2.xml file.</p>
- <div class="source"><pre><pre> <module ref="soapmonitor"/></pre>
-</pre></div>
- <p>Then in the axis2.xml file define your phase orders for 'soapmonitorPhase'
+
+<div class="source">
+<pre><pre> <module ref="soapmonitor"/></pre>
+</pre>
+</div>
+
+<p>Then in the axis2.xml file define your phase orders for 'soapmonitorPhase'
referenced in the module.xml of soapmonitor.mars. Below is an example which
should NOT be copied exactly, since the default phases change occasionally.
The important point here is that 'soapmonitorPhase' should be placed under
the 'user can add his own phases to this area' comment in the 'inflow',
'outflow', 'INfaultflow', and 'Outfaultflow' sections.</p>
- <div class="source"><pre> <phaseOrder type="inflow">
+
+<div class="source">
+<pre> <phaseOrder type="inflow">
<!--System pre defined phases-->
<phase name="TransportIn"/>
<phase name="PreDispatch"/>
@@ -105,12 +232,14 @@
<phase name="soapmonitorPhase"/>
<phase name="PolicyDetermination"/>
<phase name="MessageOut"/>
- </phaseOrder>
+ </phaseOrder></pre>
+</div>
+
+<p>To configure the servlet to communicate with the applet, add the following
+to web.xml (the SOAPMonitorPort is configurable):</p>
-</pre></div>
- <p>To configure the servlet to communicate with the applet, add the following
-to web.xml (the SOAPMonitorPort is configurable): </p>
- <div class="source"><pre> <servlet>
+<div class="source">
+<pre> <servlet>
<servlet-name>SOAPMonitorService</servlet-name>
<display-name>SOAPMonitorService</display-name>
<servlet-class>
@@ -126,19 +255,45 @@
<servlet-mapping>
<servlet-name>SOAPMonitorService</servlet-name>
<url-pattern>/SOAPMonitor</url-pattern>
- </servlet-mapping>
+ </servlet-mapping></pre>
+</div>
-</pre></div>
- <p>Finally, compile the applet classes and place them at the root of the war
+<p>Finally, compile the applet classes and place them at the root of the war
- for example axis2/SOAPMonitorApplet*.class/WEB-INF :</p>
- <div class="source"><pre>javac -classpath axis2-soapmonitor.jar SOAPMonitorApplet.java
-</pre></div>
- <p>You can find the SOAPMonitorApplet.java in the source distribution. </p><p>Alternatively, you can get the compiled applet classes from the
+<div class="source">
+<pre>javac -classpath axis2-soapmonitor.jar SOAPMonitorApplet.java</pre>
+</div>
+
+<p>You can find the SOAPMonitorApplet.java in the source distribution.</p>
+
+<p>Alternatively, you can get the compiled applet classes from the
axis2-soapmonitor-*.jar from inside the expanded axis2.war under WEB-INF/lib
-. Simply execute 'jar -xf axis2-soapmonitor-*.jar' and place the applet
-classes as axis2/SOAPMonitorApplet*.class/WEB-INF. </p><p>Using a Web browser, go to http[s]://host[:port][/webapp]/SOAPMonitor
-(e.g.http://localhost:8080/axis2/SOAPMonitor) substituting the correct
-values for your Web application. This will show the SOAP Monitor applet for
-viewing service requests and responses. Any requests to services that have
-been configured and deployed correctly should show up in the applet.</p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
+. Simply execute 'jar -xf axis2-soapmonitor-*.jar' and place the applet
+classes, for example, in
+/home/myuser/tomcat/axis2/SOAPMonitorApplet*.class/WEB-INF .</p>
+
+<p>Using a Web browser, go to http[s]://host[:port][/webapp]/SOAPMonitor
+(e.g.http://localhost:8080/axis2/SOAPMonitor) substituting the correct values
+for your Web application. This will show the SOAP Monitor applet for viewing
+service requests and responses. Any requests to services that have been
+configured and deployed correctly should show up in the applet.</p>
+</div>
+</div>
+</div>
+
+<div class="clear">
+<hr />
+</div>
+
+<div id="footer">
+
+<div class="xright">
+© 2004-2007, Apache Software Foundation</div>
+
+<div class="clear">
+<hr />
+</div>
+</div>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: axis-cvs-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-cvs-help@ws.apache.org