=encoding utf8 =head1 NAME =begin original HTTP::WebTest::ReportPlugin - Subclass for HTTP::WebTest report plugins. =end original HTTP::WebTest::ReportPlugin - HTTP::WebTest レポート用のプラグインのサブクラス =head1 SYNOPSIS =begin original Not applicable. =end original なし. =head1 DESCRIPTION =begin original This is a subclass of L. L report plugin classes can inherit from this class. It handles some test parameters common to report plugins by providing implementation of the method C. =end original このクラスは L のサブクラスです. L のレポートプラグインはこのクラスを 継承させます. ここではメソッド C の実装を提供することで レポートプラグインに共通するいくつかのテストパラメータを処理しています. =head1 TEST PARAMETERS (テストパラメータ) =head2 output_ref I =begin original A reference to a scalar that accumulates text of test report. If this test parameter is specified then value of test parameter C is ignore. =end original テストレポートのテキストを蓄積させるためのスカラーへのリファレンスを 指定します. このパラメータが指定されて多時は C テスト パラメータの値は無視されます. =begin original This parameter can be used only when passing the test parameters as arguments from a calling Perl script. =end original このパラメータは Perl スクリプトのテストパラメータ引数として 渡されたときのみ使われます. =head2 fh_out I =begin original A filehandle (or anything else that supports C) to use for test report output. This parameter is ignored if test parameter C is specified also. =end original テストレポートを出力するために使うファイルハンドル(もしくは C をサポートする何か). このパラメータは テストパラメータ C が指定されているときには無視されます. =begin original This parameter can be used only when passing the test parameters as arguments from a calling Perl script. =end original このパラメータは Perl スクリプトのテストパラメータ引数として 渡されたときのみ使われます. =head2 mail I =begin original Option to e-mail output to one or more addresses specified by C test parameter. =end original C テストパラメータで指定されている1つまたはそれ以上の アドレスに e-mail で出力を送るかの設定. =head2 mail_success_subject I =begin original Sets C header for test report e-mails when all tests are passed successfully. In this string some character sequences have special meaning (see C parameter for their description). =end original 全てのテストが成功した時のテストレポートe-mailの C ヘッダの 設定. この文字列には特別な意味を持つ文字並びがあります (C パラメータを参照してください). =head3 Default Value (デフォルト値) C =head2 mail_failure_subject I =begin original Sets C header for test report e-mails when some tests fail. In this string some character sequences have special meaning: =end original 失敗したテストがあったときに e-mail テストレポートの C ヘッダを設定します. この文字列には特別な意味を持つ文字並びが あります. =over 4 =item %f =begin original the number of failed tests =end original 失敗したテストの数 =item %s =begin original the number of successful tests =end original 成功したテストの数 =item %t =begin original the total number of tests =end original テストの総数 =item %% =begin original replaced with single C<%> =end original 1つの C<%> に置換されます =back =head3 Default Value (デフォルト値) C =head2 mail_addresses I =begin original A list of e-mail addresses where report will be send (if sending report is enabled with C test parameter). =end original レポートを送る e-mail アドレスのリスト(C テストパラメータで レポートの送信が有効にされているときだけ送られます). =over 4 =item * all =begin original Send e-mail containing test results. =end original テスト結果を含んだ e-mail を送ります. =item * errors =begin original Send e-mail only if one or more tests fails. =end original 1つまたはそれ以上のテストが失敗したときにだけ e-mail を送ります. =item * no =begin original Do not send e-mail. =end original e-mail を送信しません. =over 8 =item Default value デフォルト値 C =back =back =head2 mail_server I =begin original Fully-qualified name of of the mail server (e.g., mailhost.mycompany.com). =end original メールサーバの完全修飾ドメイン名(例えば mailhost.mycompany.com). =head3 Default value (デフォルト値) C =head2 mail_from I =begin original Sets From: header for test report e-mails. =end original e-mail テストレポートの From: ヘッダを設定します. =head3 Default Value (デフォルト値) =begin original Name of user under which test script runs. =end original テストスクリプトを実行したユーザの名前. =head1 CLASS METHODS (クラスメソッド) =head2 test_output () =head3 Returns (復帰値) =begin original Returns a reference to buffer that stores copy of test output. =end original テスト出力のコピーを格納するバッファへのリファレンスを返します. =head2 print (@array) =begin original Prints data in <@array> either into string (if test parameter C is set) or to some filehandle (if test parameter C is set) or to standard output. =end original <@array> の中のデータを文字列の中(テストパラメータ C が 設定されていたとき)もしくはファイルハンドル(テストパラメータ C が設定されていたとき)もしくは標準出力に 出力します. =begin original Also stores this data into buffer accessible via method C. =end original このデータは C メソッドを通してバッファへの格納も できます. =head2 start_tests () =begin original This method is called by L at the beginning of the test run. Its implementation in this class initializes the output buffer for the test report. =end original このメソッドはテストの開始時に L から 呼び出されます. このクラスの実装ではテストレポート用の出力バッファを 初期化します. =begin original If you redefine this method in a subclass, be sure to call the superclass method in the new method: =end original もしサブクラスでこのメソッドを再定義するのなら, 新しいメソッドの中でスーパークラスのメソッドを呼び出してください: sub start_tests { my $self = shift; $self->SUPER::start_tests; # your code here .... } =head2 end_tests () =begin original This method is called by L at the end of a test run. Its implementation in this class e-mails the test report according test parameters C. =end original このメソッドはテストの終了時に L から 呼び出されます. このクラスの実装ではテストパラメータ C に従ってテストレポートを e-mail で送信します. =begin original If you redefine this method in subclass be sure to call the superclass method in the new method: =end original もしサブクラスでこのメソッドを再定義するのなら, 新しいメソッドの中でスーパークラスのメソッドを呼び出してください: sub end_tests { my $self = shift; # your code here .... $self->SUPER::end_tests; } =head1 COPYRIGHT Copyright (c) 2001-2003 Ilya Martynov. All rights reserved. =begin original This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =end original このプログラムはフリーソフトウェアです. このプログラムは Perl 自身と同じ条件下で再配布・改変可能です. =head1 SEE ALSO L L L L