Google Git
Sign in
apache / axis-site / 3093048f5b6dcd87d976050a42adfd57786946ac / . / axis / ja / java / soapmonitor-user-guide.html
blob: d079674df18434683217de24b82b2862b328c294 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
<link rel="stylesheet" href="../skin/site.css" type="text/css">
<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
<title>WebServices - Axis</title>
</head>
<body bgcolor="white" class="composite">
<div id="banner">
<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
<tbody>
<tr>
<td align="left">
<div class="groupLogo">
<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
</div>
</td><td align="right">
<div class="projectLogo">
<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
</div>
</td><td valign="top" rowspan="2" align="right" class="search">
<form target="_blank" action="http://www.google.co.jp/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0">
<tr>
<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input value="ja" name="hl" type="hidden"><input value="UTF-8" name="ie" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="検索" type="submit">
<br>WS を検索
</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
</tr>
</table>
</form>
</td>
</tr>
</tbody>
</table>
</div>
<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
<tbody>
<tr class="status">
<td><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a></td><td id="tabs">
<div class="tab">
<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
</div>
</td>
</tr>
</tbody>
</table>
<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
<tbody>
<tr valign="top">
<td id="leftcol">
<div id="navcolumn">
<div class="menuBar">
<div class="menu">
<span class="menuLabel">Axis</span>
<div class="menuItem">
<a href="../index.html">はじめに</a>
</div>
<div class="menuItem">
<a href="../news.html">お知らせ</a>
</div>
<div class="menuItem">
<a href="http://wiki.apache.org/ws/ja/axis">FAQ/Wiki</a>
</div>
<div class="menu">
<span class="menuLabel">活動に参加</span>
<div class="menuItem">
<a href="../overview.html">概要</a>
</div>
<div class="menuItem">
<a href="../cvs.html">CVS リポジトリ</a>
</div>
<div class="menuItem">
<a href="../mail.html">メーリングリスト</a>
</div>
<div class="menuItem">
<a href="../ref.html">リファレンスライブラリ</a>
</div>
<div class="menuItem">
<a href="../bugs.html">バグ</a>
</div>
<div class="menuItem">
<a href="../howtobuild.html">サイト構築方法</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">Axis (Java)</span>
<div class="menuItem">
<a href="../java/index.html">ドキュメント</a>
</div>
<div class="menuItem">
<a href="../java/install.html">インストール</a>
</div>
<div class="menuItem">
<a href="../java/user-guide.html">ユーザガイド</a>
</div>
<div class="menuItem">
<a href="../java/developers-guide.html">開発者ガイド</a>
</div>
<div class="menuItem">
<a href="../java/integration-guide.html">統合ガイド</a>
</div>
<div class="menuItem">
<a href="../java/architecture-guide.html">アーキテクチャガイド</a>
</div>
<div class="menuItem">
<a href="../java/reference.html">リファレンスガイド</a>
</div>
<div class="menuItem">
<a href="../java/reading.html">読書ガイド</a>
</div>
<div class="menuItem">
<a href="../java/requirements.html">要件</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">Axis (C++)</span>
<div class="menuItem">
<a href="../cpp/index.html">Axis C++ 最新版</a>
</div>
<div class="menuItem">
<a href="../cpp/documentation.html">ドキュメント</a>
</div>
<div class="menuItem">
<a href="../cpp/download.html">ダウンロード</a>
</div>
<div class="menuItem">
<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki ページ [英語]</a>
</div>
<div class="menuItem">
<a href="../cpp/who.html">メンバ紹介</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">ダウンロード</span>
<div class="menuItem">
<a href="../releases.html">リリース</a>
</div>
<div class="menuItem">
<a href="../interim.html">暫定版</a>
</div>
<div class="menuItem">
<a href="http://cvs.apache.org/viewcvs/ws-axis/">ソースコード [英語]</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">翻訳</span>
<div class="menuItem">
<a href="http://ws.apache.org/axis/jp/">日本語</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">関連プロジェクト</span>
<div class="menuItem">
<a href="http://ws.apache.org/wsif/">WSIF [英語]</a>
</div>
<div class="menuItem">
<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL [英語]</a>
</div>
<div class="menuItem">
<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J [英語]</a>
</div>
<div class="menuItem">
<a href="http://www.uddi4j.org/">UDDI4J [英語]</a>
</div>
</div>
<div class="menu">
<span class="menuLabel">その他</span>
<div class="menuItem">
<a href="../who.html">メンバ紹介</a>
</div>
<div class="menuItem">
<a href="../contact.html">連絡先</a>
</div>
<div class="menuItem">
<a href="../legal.html">法関連</a>
</div>
<div class="menuItem">
<a href="../docs.html">メモ/ドキュメント</a>
</div>
</div>
</div>
</div>
</div>
</td><td>
<div id="bodycol">
<div class="app">
<div align="center">
<h1>WebServices - Axis</h1>
</div>
<div class="h3">
<a name="SOAPMonitorUsersGuide"></a>
<div class="h3">
<h3>SOAPMonitor ユーザガイド</h3>
</div>
<p>
<i>バージョン 1.0</i>
<br>
<i>フィードバック:</i> <a href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a>
</p>
<p>内容</p>
<ul>
<li>
<a href="#Introduction">はじめに</a>
</li>
<ul>
<li>
<a href="#WhatIsSOAPMonitor">SOAPMonitor とは</a>
</li>
<li>
<a href="#WhenShouldIUseIt">いつ SOAPMonitor を利用するのか</a>
</li>
</ul>
<li>
<a href="#Usage">利用方法</a>
</li>
<ul>
<li>
<a href="#Preparation">準備</a>
</li>
<li>
<a href="#HowToUseIt">どのように SOAPMonitor を利用するのか</a>
</li>
</ul>
<li>
<a href="#Appendixes">付録</a>
</li>
<ul>
<li>
<a href="#VersionComparisonChart">バージョン比較チャート</a>
</li>
<li>
<a href="#ErrorMessages">エラーメッセージ</a>
</li>
</ul>
</ul>
<a name="Introduction"></a>
<div class="h4">
<h4>はじめに</h4>
</div>
<p>Webサービス開発者はしばしば、Webサービスを呼び出すために利用される SOAP メッセージと、それらのメッセージの結果を調べる必要性がでてきます。SOAP Monitor ユーティリティの目標は、特別な設定やサーバの再起動なしに、利用されている SOAP メッセージを監視する方法を、これらの開発者に提供することです。</p>
<a name="WhatIsSOAPMonitor"></a>
<div class="h2">
<h2>SOAPMonitor とは</h2>
</div>
<p>SOAPMonitor は、org.apache.axis.utils パッケージにあるユーティリティです。Webサービス開発者に上記で説明した監視機能を提供します。</p>
<a name="WhenShouldIUseIt"></a>
<div class="h2">
<h2>いつ SOAPMonitor を利用するのか</h2>
</div>
<p>デバッグのために SOAP メッセージを監視したい時が、このユーティリティを利用する良い機会でしょう。追加的な開発、特別な設定、アプリケーションサーバの再起動なしに、監視したい全ての SOAP メッセージを監視することができます。</p>
<p>
<b>SOAPMonitor は、HTTP プロトコルヘッダのようなプロトコル特有のデータを一切表示しないことに注意してください。これを行うには TCP Monitor (tcpmon) を利用すべきです。tcpmon の詳細については <a href="user-guide.html">Axis ユーザガイド</a>をご覧下さい。</b>.</p>
<a name="Usage"></a>
<div class="h4">
<h4>利用方法</h4>
</div>
<a name="Preparation"></a>
<div class="h2">
<h2>準備</h2>
</div>
<ul>
<li>
<b>ステップ 1:</b> 管理者アカウントを作成する
<p>"webapps/axis/WEB-INF/users.lst" を開いて編集します。<br>
管理者のデフォルトのアカウントは "admin" です。パスワードは好きなものを設定してください。</p>
<p>例) 以下の通りです。 - 例えば、"admin password" です。</p>
<pre class="code">user1 pass1
user2
user3 pass3
admin password</pre>
</li>
<li>
<b>ステップ 2:</b> CLASSPATH を設定する
<p>このユーティリティを実行する前に、CLASSPATH に以下のものが含まれていることを確かめる必要があります。</p>
<ul>
<li>axis.jar</li>
<li>jaxrpc.jar</li>
<li>saaj.jar</li>
<li>commons-logging.jar</li>
<li>commons-discovery.jar</li>
<li>activation.jar</li>
<li>mail.jar</li>
<li>Xerces や Crimson のような JAXP-1.1 準拠の XML パーサ</li>
</ul>
</li>
<li>
<b>これで終わりです。</b>
</li>
</ul>
<a name="HowToUseIt"></a>
<div class="h2">
<h2>どのように SOAPMonitor を利用するのか</h2>
</div>
<ul>
<li>
<b>ステップ 0:</b> <a href="#prepare">準備段階</a>が完了したことを確かめてください</li>
<li>
<b>ステップ 1:</b> SOAPMonitor アプリケーションを起動します
<p>
<span class="codefrag">% java org.apache.axis.utils.SOAPMonitor [-u admin] [-w password] [-l axisURL]</span>
</p>
<p>または</p>
<p>
<span class="codefrag">% javaw org.apache.axis.utils.SOAPMonitor [-u admin] [-w password] [-l axisURL]</span>
</p>
</li>
<li>
<b>ステップ 2:</b> ログインします
<p>管理者として指定したアカウントでログインしてください。</p>
<p>
<img src="images/LoginDialog.jpg"></p>
</li>
<li>
<b>ステップ 3:</b> しばらくお待ちください
<p>
<img src="images/DataLoading.jpg" width="400"></p>
</li>
<li>
<b>ステップ 4:</b> 管理者画面が表示されます
<p>
<img src="images/InitialScreen.jpg"></p>
</li>
<li>
<b>ステップ 5-a:</b> 監視を有効にするには
<p>監視を有効にするサービスをクリックし、"Turn On" ボタンを押します。</p>
<p>
<img src="images/ToEnableMonitoring.jpg"></p>
<p>以下の画面が表示されるはずです。</p>
<p>
<img src="images/AfterTurnOn.jpg"></p>
</li>
<li>
<b>ステップ 5-b:</b> 監視を無効にするには
<p>監視を無効にするサービスをクリックし、"Turn Off" ボタンを押します。</p>
<p>
<img src="images/ToDisableMonitoring.jpg"></p>
<p>以下の画面が表示されるはずです。</p>
<p>
<img src="images/AfterTurnOff.jpg"></p>
</li>
<li>
<b>ステップ 6:</b> 変更を保存する
<p>現在の状態を保存するには "Save changes" ボタンを押します。</p>
<p>以下の画面が表示されるはずです。</p>
<p>
<img src="images/DeployStatus.jpg"></p>
</li>
<li>
<b>ステップ 7:</b> 監視する
<p>現在の設定で監視を開始するには "Monitoring" タブを押します。</p>
<p>以下の画面が表示されるはずです。</p>
<p>
<img src="images/MonitoringScreen.jpg"></p>
</li>
</ul>
<a name="Appendixes"></a>
<div class="h4">
<h4>付録</h4>
</div>
<a name="VersionComparisonChart"></a>
<div class="h2">
<h2>バージョン比較チャート</h2>
</div>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<tr class="b">
<th colspan="1" rowspan="1">項目</th>
<th colspan="1" rowspan="1">SOAPMonitorApplet(古いバージョン)</th>
<th colspan="1" rowspan="1">SOAPMonitor(<a href="http://cvs.apache.org/viewcvs.cgi/ws-axis/java/src/org/apache/axis/utils/SOAPMonitor.java?view=markup">このバージョン</a>)</th>
</tr>
<tr class="a">
<td colspan="1" rowspan="1">アプリケーション形式</td>
<td colspan="1" rowspan="1">アプレット</td>
<td colspan="1" rowspan="1">Swing アプリケーション</td>
</tr>
<tr class="b">
<td colspan="1" rowspan="1">セキュリティ</td>
<td colspan="1" rowspan="1">N/A (認証なし)</td>
<td colspan="1" rowspan="1">OK (認証が追加されました)</td>
</tr>
<tr class="a">
<td colspan="1" rowspan="1">インストール &amp; 利用</td>
<td colspan="1" rowspan="1">
<ol>
<li>まず最初にコンポーネントをコンパイルします。</li>
<li>soapmonitor ハンドラを "server-config.wsdd" にデプロイします。</li>
<li>soapmonitor ハンドラで監視するサービスをデプロイします。</li>
<li>"http://localhost:8080/axis/SOAPMonitor" にアクセスします。</li>
<li>監視を無効にするには soapmonitor なしでサービスを再デプロイします。</li>
</ol>
<ul>
<li>詳細については<a href="http://www.sosnoski.com/presents/java-xml/axis/axis-monitor.html">こちら</a>をご覧下さい。</li>
<li>全てのステップは非 GUI に基づいた操作で、これらのプロセスはユーザにとって複雑です。</li>
</ul>
</td>
<td colspan="1" rowspan="1">(axis.jar 内で) "java org.apache.axis.utils.SOAPMonitor" を実行するだけです。
<ul>
<li>全てのステップは GUI に基づいた操作です。</li>
</ul>
</td>
</tr>
</table>
<a name="ErrorMessages"></a>
<div class="h2">
<h2>エラーメッセージ</h2>
</div>
<p>アクセス拒否の場合、以下の画面が出るでしょう。</p>
<ul>
<li>
<b>"未知のホスト" の場合:</b>
<p>
<img src="images/UnknownHost.jpg"></p>
</li>
<li>
<b>"ポート不一致" の場合:</b>
<p>
<img src="images/ConnectionRefused.jpg"></p>
</li>
<li>
<b>"認証失敗" の場合:</b>
<p>
<img src="images/Unauthorized.jpg"></p>
</li>
</ul>
<div id="pdf" align="right">
<a href="soapmonitor-user-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
</div>
</div>
</div>
</div>
</td>
</tr>
</tbody>
</table>
<div id="footer">
<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
<tbody>
<tr>
<td colspan="2">
<div align="center">
<div class="copyright">
Copyright &copy; 2000-2005&nbsp;The Apache Software Foundation. All rights reserved.
</div>
</div>
</td>
</tr>
<tr>
<td align="left"></td><td align="right">
<div align="right">
<div class="credit"></div>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>