Interstage Application Server J2EE ユーザーズガイド

8.6.3 トレース情報の詳細

■トレース情報の取得方法

　トレース情報を取得するには、トレース機能を有効にします。
　トレース機能の有効/無効は、サーブレット・コンテナ単位に、“サーブレット・コンテナ環境定義ファイル”の“サーブレットおよびJSPのアプリケーション間トレース機能のタグ(APITracer)”で設定します。
　トレース機能を有効にすると、サーブレット・コンテナのログ(コンテナの標準出力、標準エラー出力のログ)にトレース情報が出力されます。

■出力形式

　トレース情報の出力形式を示します。

［メソッド呼び出し時］

［日時］ スレッド名:URI:in クラス名.メソッド名(引数の型, 引数の型,...)[:PARAM:引数の情報]

［メソッドからの復帰時］

［日時］ スレッド名:URI:out クラス名.メソッド名(引数の型, 引数の型,...)[:RET :戻り値の情報]

■出力項目について

◆日時

　“日時”は、“サーブレット・コンテナ環境定義ファイル”の“サーブレット・コンテナのログ(Loggerタグ)”でタイムスタンプを有効にしている場合に出力されます。

◆URI

　下記のメソッドの呼び出し時および復帰時には、URIは出力されません。
　また、URIの代わりにそれぞれ該当する文字列が出力されます。

クラス（インターフェース）	メソッド	表示
Servlet	init	@init
	destroy	@destroy
ServletContextListener	contextInitialized	ServletContextListener@contextInitialized
	contextDestroyed	ServletContextListener@contextDestroyed
Filter	init	Filter@init
	destroy	Filter@destroy
TagLibraryValidator	setInitParameters	TagLibraryValidator@setInitParameters
Tag(TagPooling有効時だけ)	validate	TagLibraryValidator@validate
	release	TagLibraryValidator@release
	release	Tag@release

◆引数の情報、戻り値の情報

　以下は、出力の有効、無効を“サーブレット・コンテナ環境定義ファイル”の“サーブレットおよびJSPのアプリケーション間トレース機能のタグ(APITracer)”で指定することができます。

• 引数の情報（メソッド呼び出し時の“[:PARAM:引数の情報]”部分）
• 戻り値の情報（メソッドからの復帰時の“[:RET :戻り値の情報]”部分）

　ただし、メソッドにおいてExceptionやErrorが発生した場合、メソッドからの復帰時の出力および戻り値の情報は出力されません。

　引数の情報、戻り値の情報は、その内容により以下を出力します。

• 型
• 長さ
• 値
• そのオブジェクトの情報を取得するメソッド名と取得した値

　引数の情報および戻り値の情報のうち、以下の型については値をコード値で出力します。

• byte[]

　以下の型については、文字(文字列)としての出力と、コード値としての出力の両方を出力します。
　ただし、文字（文字列）としての出力は、文字コードを変換して出力されます。
　また、改行文字はエスケープシーケンスで出力されます。

• String
• String[]
• char
• char[]

値をUNICODEとみなしてOSの標準の文字コードに変換します。

値をUNICODEとみなして“JServlet環境定義ファイル”の“default.envまたは[containername].env”に環境変数LANGとして指定された文字コードに変換します。

■対象メソッド

　トレース情報を出力する対象となるJava(TM) Servlet APIのメソッドを以下に示します。

• サーブレットのserviceメソッド
• サーブレットのinitメソッド
• サーブレットのdestroyメソッド
• Tagのreleaseメソッド(TagPooling機能有効時)
• 下記表のクラスのメソッド

パッケージ	クラス
javax.servlet	RequestDispatcher
	ServletConfig
	ServletContext
	ServletInputStream
	ServletOutputStream
	ServletContextListener
	ServletContextAttributeListener
	HttpSessionListener
	HttpSessionAttributeListener
	Filter
	FilterConfig
javax.servlet.http	HttpServletRequest
	HttpServletResponse
	HttpSession
	HttpSessionContext
javax.servlet.jsp	JspEngineInfo
	JspFactory
	JspWriter
	PageContext
javax.servlet.jsp.tagext	BodyContent
	TagLibraryValidator

　また、以下のメソッドも対象となります。

• ServletRequestクラスのgetReader()メソッドで取得したBufferedReaderオブジェクトのメソッド
• ServletResponseクラスのgetWriter()メソッドで取得したPrintWriterオブジェクトのメソッド

　JSPの場合には、実行時に変換して生成されるサーブレットが対象となります。

• クラスメソッドは対象となりません。
• HttpServletクラスが実装または継承しているメソッドについては、呼び出したメソッドではなく、メソッド内部で呼ばれるメソッドの情報が出力される場合があります。詳細については、“トレース情報”を参照してください。