These are the changes that happened to the Cactus web site for the past 15 days since the last site update (excluding the todo and changes pages which are modified too often) :
(頻繁に変更されるTodoおよび変更履歴のページを除き) Cactus ウェブサイトで最近 15 日間で行われた変更をここにまとめます :
&cvslog;cactus.jar in your
WEB-INF/lib directory).
WEB-INF/lib ディレクトリに
cactus.jar を置く必要がある。)
ResinRun Cactus Ant
task that is used to start/stop Resin has been modified to support
both Resin 2.0 and Resin 2.1 (Resin 2.1 has changed its API to start
it).
ResinRun Cactus Ant タスクが、
Resin 2.0 と Resin 2.1 を共にサポートするよう変更された
(Resin 2.1 は、その起動のためのAPIが変更された)
cactus.enableLogging=true property that needs to be either
defined in cactus.properties (which also needs to be part
of the server WAR if you wish to turn on logging on the server side) or
by using a java parameter (-Dcactus.enableLogging=true).
If Log4J is not in the classpath, then logging is disabled.
cactus.properties において、
あるいはまた、
Java のパラメータをを用いて
(-Dcactus.enableLogging=true)
定義される必要がある
cactus.enableLogging=true、
プロパティにより
Cactus のロギングが可能となる。
Log4J がクラスパスに無い場合、ログは取られない。
HttpServletContextWrapper.getRequestDispatcher()
now throws null when the wrapped servlet context returns
null when asked for a request dispatcher.
HttpServletContextWrapper.getRequestDispatcher() は、
ラップされたサーブレットコンテキストが返される時、
null をスローし、
リクエストディスパッチャに問い合わせを受けた時、
null をスローするようになった。
HttpServletRequest.getRequestURL() (Servlet API
2.3 only) to take into account the simulated URL (if any).
HttpServletRequest.getRequestURL() をラップした。
(Servlet API 2.3 のみ)
getNamedDispatcher() not returning
null when called with a servlet name that cannot be found,
as is expected by the spec. Added test cases to verify the behaviour.
getNamedDispatcher() が null を返さない問題の修正。
振舞いを検証するためにテストケースの追加。
assertXXX() methods of JUnit instead of
the assert() one, which is now a reserved keyword in
JDK 1.4.
assert() は、
JDK 1.4 での予約語となったので、
JUnit のメソッドとして、その代わりに
assertXXX() メソッドの使用をサポートするという変更のみ。
TestServletTestCase_Authentication in the sample unit
tests for an example on how to use it.
TestServletTestCase_Authentication クラスを参照の事
WebRequest.setRedirectorName(String redirectorName)
to override default cactus.servletRedirectorName parameter
that you define in cactus.properties. This lets you
define a redirector per test case if you wish. It is useful when you
want to test some servlet methods that are secured and others that are
not, for example.
cactus.properties で定義する
デフォルト cactus.servletRedirectorName パラメータを上書きするために、WebRequest.setRedirectorName(String redirectorName) を追加。
これによりテストケース毎にリダイレクタの設定が可能。
例えば、一部がユーザー認証が必要で、残りは必要としないようなサーブレットメソッドのテストを行いたい場合に有用。
cactus.properties configuration parameters. For
example, where you previously were writing
cactus.servletRedirectorURL = http://localhost:8080/test/ServletRedirector
you would now have 2 parameters :
cactus.contextURL = http://localhost:8080/test and
cactus.servletRedirectorName = ServletRedirector.
cactus.properties 設定パラメータの変更。
例えば、以前は
cactus.servletRedirectorURL = http://localhost:8080/test/ServletRedirector と書いていたのを、今後は 2 つのパラメータが必要 :
cactus.contextURL = http://localhost:8080/test および
cactus.servletRedirectorName = ServletRedirector
META-INF/
directory.
META-INF/ ディレクトリ中の全ての
Cactus jar ファイルにライセンスファイルを追加
delaySocketClose="true",
which is a new attribute of Tomcat 3.3.1. The reason is that on fast
CPU Tomcat 3.3.0 is releasing too quickly opened sockets and the Cactus
client side gets a "socket closed by peer" exception.
delaySocketClose="true" を追加。
速い CPU では、Tomcat 3.3.0 が開いたソケットの解放が早すぎ、
クライアント側 Cactus で "socket closed by peer" 例外が発生するため。
AbstractHttpServletRequestWrapper.getPathTranslated() which
was not returning null when getRealPath("/")
was returning null. It is allowed by the spec. to return
null upon certain conditions (see section SRV.4.5 of the
Servlet 2.3 spec.).
getRealPath("/") が
null を返した時に、
AbstractHttpServletRequestWrapper.getPathTranslated() が
null を返していなかったバグ修正。
ある条件では null を返すことが仕様で認められている。
(Servlet 2.3 仕様書の SRV.4.5 の節を参照)
URL.getPath() in HttpClientHelper. It is now
fixed and should work both for JDK 1.2 and 1.3.
URL.getPath() in HttpClientHelper.
HttpClientHelper において
URL.getPath() を使っていた事により、
JDK 1.2 との互換性が無くなっていた。
現在修正され、JDK 1.2 と 1.3 で動くはず。
AbstractTestCase.getLogger() method that lets any
test case class get access to a logger to perform its own logging. Logs
will go into the Cactus log files.
AbstractTestCase.getLogger() メソッドの追加。
これにより、どのテストケースクラスからも
テストケース自身のログを取るために、ロガーへアクセスできる。
aspectjrt.jar
jar in their classpaths (both client side and server side). It is a
small jar (25ko) that is packaged in the cactus distribution.
aspectjrt.jar jar ファイルを
(クライアント側、サーバ側双方に)
クラスパスに入れる必要がある。
これは Cactus ディストリビューションのパッケージに入っている小さい
jar ファイル(25KB)である。
cactus.config" to specify location
of cactus properties file (you pass it on the command line, ex:
"java -Dcactus.config=conf/mycactus.properties"). If not
specified, Cactus will look for a "cactus.properties" file
in the classpath.
cactus.config" に追加。
(例えば次のようにコマンドラインで指定する:
"java -Dcactus.config=conf/mycactus.properties")
指定しない場合、Cactus はクラスパスにある
"cactus.properties"ファイルを探す。
MockHttpURLConnection that was triggered by
some modification in HttpUnit. It means that some Cactus 1.2 unit tests
will fail if run with HttpUnit 1.2.8 (still in CVS on the 12/11/01).
MockHttpURLConnection のバグの修正。
これは HttpUnit 1.2.8 で実行した場合、
Cactus 1.2 単体テストは失敗することを意味する。
(2001年12月11日のCVSにまだある)
getHost() method of the ServletURL class
returns the ":" signifing the start of the port number of the host.
This has side effects in Cactus in that passing
in the host name and port into the WebRequest method as "127.0.0.1:7001"
will cause Cactus to use this url "http://127.0.0.1::7001".
ServletURL クラスの
getHost() メソッドは、
ホストのポート番号の始めを意味する ":" を返す。
これにより、
ホスト名とポート番号を
WebRequest メソッドに
"127.0.0.1:7001" のように渡すと、
"http://127.0.0.1::7001" というようなURLを使うことになるという副作用が起こる。
name()
method by a getName() one). Note that Cactus is still
supporting earlier versions of JUnit.
name() メソッドを getName() に置き換えた)
Cactus は以前のバージョンの JUnit もサポートしている事に注意
WebRequest.setContentType(String)
(if you don't specify anything it default to
"application/x-www-form-urlencoded"). This will set the
content type HTTP header for the request. You can get this value from
your server code by calling
HttpServletRequest.getContentType().
WebRequest.setContentType(String)
(何も指定しない、デフォルトは
"application/x-www-form-urlencoded")
これはリクエストのHTTPヘッダの content type を設定する。
サーバーコードから
HttpServletRequest.getContentType() の呼び出しにより
この値は得られる。
WebRequest.setUserData(InputStream) to
allow sending arbitrary data in the request body. Note that calling this
method will invalidate any parameters that were set to be sent in the
request body.
WebRequest.setUserData(InputStream)。
リクエストのボディに任意のデータを送れるようにするため。
このメソッドの呼び出しにより、
リクエストのボディで送られるように設定されたパラメータを全て無効化する事に注意
HttpServletRequest.getReader(). Note: there seems to be
a bug in Orion 1.4 for using getReader(). It runs fine
on Orion 1.5 however.
HttpServletRequest.getReader() を使ったテストコードのサポートの追加。
メモ :
Orion 1.4 では
getReader() の使用にバグがあるようだ。
Orion 1.5 では正常動作する。
WebRequest.setMethod() has been removed as deprecating
it would have led to potential error difficult to locate (as Cactus
default behaviour is now to pass parameter using GET, whereas before
it was passing them using POST).
WebRequest.setMethod() を削除。
(従って、以前は POST を使って渡していたが、
現在は GET を使ってパラメータを渡すのが
Cactus のデフォルトの振舞いとなる。)
WebRequest.addParameter(name, value) is
now passing the parameter in the URL query string by default (same as
calling WebRequest.addParameter(name, value,
WebRequest.GET_METHOD).
WebRequest.addParameter(name, value) は、
現在デフォルトで URL クエリ文字列によりパラメータを渡す。
(WebRequest.GET_METHOD も同様)
WebRequest.addParameter(name, value, method)
where method is either "GET" or "POST". This let you choose on a fine
grain level, which method you'd like to use to pass a given parameter.
WebRequest.addParameter(name, value, method) の新規追加。
これにより、与えられたパラメータをどちらのメソッドで送信するか、
細かい粒度で選択できる。
ServletTestRequest. It was deprecated in version
1.2 and is now removed in 1.3. You should use WebRequest
instead.
ServletTestRequest を削除。
バージョン 1.2 で使用不可とし、
1.3 で削除される。
代わりにWebRequestを使用の事。
HttpServletRequestWrapper.getPathTranslated() now takes
into account any path info set up in WebRequest.setURL().
HttpServletRequestWrapper.getPathTranslated() では
WebRequest.setURL() で設定された全ての path info を
考慮する必要がある。
WebResponse.getText() and
WebResponse.getTestAsArray() so that they can be called
repeatably and produce the same results. Previously the data were
read from the server output stream and thus the second read was not
returning anything (as it has already been read).
WebResponse.getText() および
WebResponse.getTestAsArray() を変更。
以前は、データはサーバ出力ストリームから読み込まれていたので、
2 回目読み込んだ時には(既に一度読み込んだので)何も返されなかった。
org.apache.commons.cactus to
org.apache.cactus.
org.apache.commons.cactus から
org.apache.cactus に変更された。
getRequest(), getServletContext()
and getServletConfig() methods on the
pageContext implicit object (available in
JspTestCase) now returns the Cactus wrapped versions of
these objects, thus taking into account the simulated URL.
JspTestCaseで利用可能な)暗黙オブジェクト中の
getRequest()、getServletContext()、
getServletConfig() メソッドは、
Cactus のラップされたバージョンのオブジェクトを返すようになった。
従って、シミュレートされたURLを考慮する必要がある。
FilterTestCase test case class. Also
added some filter unit testing samples in the distribution.
FilterTestCase テストケースクラスを提供することにより、
サーブレットフィルタ(Servlet API 2.3 のみ)の単体テストのサポートを追加。
また、ディストリビューションにフィルターの単体テストの例題を追加。
WebRequest.addCookie(String theDomain, String
theName, String theValue) and
WebRequest.addCookie(Cookie theCookie) methods for
adding cookies to the request.
WebRequest.addCookie(String theDomain, String
theName, String theValue) および
WebRequest.addCookie(Cookie theCookie) 新規メソッド
org.apache.cactus.Cookie class that replaces
the old org.apache.cactus.util.ClientCookie one
which has been deprecated. The new Cookie class can be used in
beginXXX() and endXXX() methods to
manipulate cookies.
org.apache.cactus.util.ClientCookieクラスに置き換わる
org.apache.cactus.Cookie新クラス。
新しいクッキークラスは、
beginXXX() と endXXX() メソッドにおいてクッキーを扱うのに使われる。
setURL(), otherwise
the cookie won't get sent. If no domain is used when adding a cookie
to WebRequest then "locahost" domain is used. The cookie
path is optional and can be null. If not null, the cookie is only
sent for requests starting with the path URL.
setURL() の呼び出しで指定されたホストのいずれかにマッチしなければならず、
マッチしない場合クッキーは送信されないことを意味する。
WebRequest を付加する際にドメインが使われなかった場合、
"localhost" ドメインが使われる。
クッキーのパスはオプションであり、
null であることもありえる。
null でない場合、クッキーはパスURLで始るリクエストに対してのみ送られる。
cactus.properties and web.xml
mappings (by adding a trailing forward slash to redirector URL and
mappings) to support test cases that returns an HTTP status code
greater than 400. Otherwise HttpURLConnection returns
a FileNotFoundException.
cactus.properties および web.xml のマッピングを変更。
そうでない場合、
HttpURLConnection は
FileNotFoundException を返す。
Vector getLogs() method to
ServletContextWrapper that returns a vector of the log
messages generated by calls to ServletContext.log().
This is to easily assert the content of these calls when writing
test cases.
ServletContext.log()
の呼び出しにより生成されるログメッセージのベクタを返す
Vector getLogs() を
ServletContextWrapper に追加。
これにより、テストケースを書く際に、
これらの呼び出しの内容を簡単にアサーションできるようになる。
ServletContext scope was not serializable, causing errors
on IPlanet 6.x
ServletContext のスコープにある
テスト結果オブジェクトはシリアル化できず、
IPlanet 6.x ではエラーが発生する。
endXXX(com.meterware.httpunit.WebResponse). If you don't
need that power and only want to do simple asserts you can use the
endXXX(org.apache.cactus.WebResponse) signature
which will let you do simple assertions (cookies, headers, content as
a String, ...).
endXXX(com.meterware.httpunit.WebResponse)。
全機能を必要とせず、シンプルなアサーションを行いたい場合には、
簡潔なアサーション(クッキー、ヘッダー、コンテンツを文字列として扱う)ができる
endXXX(org.apache.cactus.WebResponse) の
形式が利用可能。
endXXX(org.apache.cactus.WebResponse theResponse)
(it was endXXX(HttpURLConnection theConnection)
previously). All helper methods of AssertUtils have been
included in WebResponse and AssertUtils is
now deprecated.
endXXX(org.apache.cactus.WebResponse theResponse) である。
(以前は
endXXX(HttpURLConnection theConnection)
だったもの)
全ての AssertUtils 中のヘルパーメソッドは
WebResponse に含まれ、
現在、AssertUtils は使用不可となった。
ServletTestRequest. New correct way of writing
a begin method is beginXXX(WebRequest theRequest). The
class methods are the same.
ServletTestRequest の廃止。
begin メソッドを記述する新しい正規の方法は、
beginXXX(WebRequest theRequest) である。
クラスメソッドも同様である。
runservertests custom Ant task will now not
stop the server if it was running before the task was executed. This
is to allow to run and rerun Cactus tests without starting/stopping
the server every time you run the tests.
runservertests
カスタム Ant タスクはサーバを停止しないようにした。
テストを実行する度にサーバーを起動/停止せずに、
Cactus テストを実行、および再実行できるようになる。
HttpServletRequestWrapper.getRequestDispatcher() was not
returning a wrapped request dispatcher, thus causing error when
forward() or include() was used afterwards.
HttpServletRequestWrapper.getRequestDispatcher() が、
ラップされたリクエストディスパッチャを帰さなかったので、
後に forward() や include() が使われた時にエラーを発生する。
ServletTestRequest.setURL() method are automatically
passed as real HTTP parameters to the server side, meaning you don't
have to manually call addParameters().
ServletTestRequest.setURL() メソッドを使ったときの
URL で指定された全てのHTTPパラメータは、
自動的にサーバ側に本当のHTTPパラメータとして渡されるようになった。
これは、マニュアルでaddParameters()を呼び出す必要が無いことを意味する。
AssertUtils.getResponseAsStringArray()
that returns the servlet output stream as an array of string (each
line terminated by a end of line is a string) in the
same spirit as the AssertUtils.getResponseAsString()
method which returnes the result as a single string.
AssertUtils.getResponseAsString()
メソッドと同じ考えに基づき、
サーブレットの出力ストリームを文字列の配列
(行末記号で終る各行が文字列となる)
で返す新規メソッド
AssertUtils.getResponseAsStringArray() の追加。
AssertUtils.getResponseAsString() which was not handling
correctly line terminators (they were skipped).
AssertUtils.getResponseAsString() における
複数行のテキストの正しい処理
deploy-site that automatically
deploy the generated web site to it's home page on the Jakarta server.
This will be very useful when integrated with GUMP nightly builds so
that the web site is always up to date.
deploy-site と呼ばれる新規ターゲットを追加。
ウェブサイトが常に最新状態になっているように、
GUMP ナイトビルドと組み合わせた時に、とても便利である。
ChangeLogTask work even when not connected to the
Internet (i.e. use previous cvslog.xml file or generate
an empty one if non already exists).
ChangeLogTask タスクが動作するようにした。
(即ち、既存のものが無い場合には、
前の cvslog.xml を使うか、
空のファイルを生成するようにした)
AbstractTestCase,
modified AbstractHttpClient, JspHttpClient,
ServletHttpClient).
AbstractTestCaseの追加、
AbstractHttpClient、JspHttpClient、
ServletHttpClientの変更)
ServletTestRequest.
ServletTestRequest において、
複数値を持てる HTTP ヘッダ
(同じ名前のヘッダで異なる値が持てる)
の処理の追加
setUp() and tearDown()
protected on the server side so that it is consistent with JUnit.
setUp() および tearDown()
メソッドを protected にした。
runservertest task so that it also works
when a servlet engine is already up and running and when a server is
already stopped prior. This is to support intensive debugging mode when
we don't want to start/stop the server all the time.
runservertest の変更
これは、
いつでもサーバの起動/停止をしたくない場合に、
集約したデバッグモードをサポートするため。
CLASSPATH prior to running the build.
CLASSPATH に junit, stylebook, jar が無くても動作するよう、
ビルド手続きの改良
misc/ directory and JBuilder files from CVS
and source distribution.
j2eeunit.* to org.apache.commons.cactus.*.
j2eeunit.*からorg.apache.commons.cactus.*
へ変更。
j2eeunit.* to org.apache.commons.j2eeunit.*
and changed copyrights
j2eeunit.* からorg.apache.commons.j2eeunit.*
へパッケージを変更し、著作権表示を変更。