* Apache Struts [#h7bf9e85]
Struts導入メモ。
#contents
** バージョン1.2以前と1.3との相違 [#x89c3bf1]
この時期にStrutsを導入する場合に注意しなければならないのは、
バージョン1.2と1.3では、その構成が大分変わっていること。
（今では、1.2以前をStrutsクラシックと呼ぶらしい。）
- [[Struts リリースノート(英語):http://struts.apache.org/1.x/userGuide/release-notes.html]]
- [[Struts Wiki:http://wiki.apache.org/struts/StrutsUpgradeNotes12to13]]
*** 互換性 [#w5b814e9]
1.2以前でコンパイルされたアプリケーションは、一応動作する模様。
ただやはり、1.3で構築しなおす方が無難。
*** struts.jar はどこいった？ [#d8f4fb60]
1.2以前で struts.jar としてまとまっていたライブラリが、
1.3では struts-*.jar のような名前になって機能ごとに分割されている。
ということで、struts-*.jar と名前のつくライブラリを全部参照設定してしまえば、
1.2以前で作成したソースはコンパイルできるはずである。
（本当は、必要なものだけ参照設定する方がスマートだけど。）
*** TLD の URI [#d3a1c8f7]
Struts が Jakarta プロジェクトじゃなくなったらしい（？）ので、
ドメインが変更になっている。
|バージョン1.2以前|バージョン1.3|h
|http://jakarta.apache.org/struts/tags-bean|http://struts.apache.org/tags-bean|
|http://jakarta.apache.org/struts/tags-html|http://struts.apache.org/tags-html|
|http://jakarta.apache.org/struts/tags-logic|http://struts.apache.org/tags-logic|
|http://jakarta.apache.org/struts/tags-nested|http://struts.apache.org/tags-nested|
|http://jakarta.apache.org/struts/tags-tiles|http://struts.apache.org/tags-tiles|
*** struts-config.xml の設定 [#f0722986]
struts-config.xml の DOCTYPE に記述する宣言は変更になっているっぽい。
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.3//EN"
"http://struts.apache.org/dtds/struts-config_1_3.dtd">
変更されたのは、
- バージョンが 1.3（当然）。
- URIが jakarta.apache.org/struts から struts.apache.org になっている。
というところ。
*** 1.3でなくなったもの [#i8560571]
- ActionError
- DataSourceConfig
これらはなくなったらしい。ActionError は ActionMessage に置き換えるべし。
** Struts の罠 [#qc6e683c]
作業をしていてぶち当たった問題とその解決方法をメモ。
*** データソースの初期化に失敗する件 [#v0dba777]
struts-config.xml の data-source に次のように設定したとする。
<struts-config>
<data-sources>
<data-source key="oracle">
<set-property property="driverClass" value="oracle.jdbc.driver.OracleDriver" />
<set-property property="url" value="jdbc:oracle:thin:@127.0.0.1:1521:ORCL" />
<set-property property="user" value="user" />
<set-property property="password" value="passwd" />
<set-property property="maxCount" value="64" />
<set-property property="minCount" value="10" />
<set-property property="autoCommit" value="false" />
</data-source>
</data-sources>
(以下略)
一見設定は正しいように見える（というか、設定自体は正しい）。
しかし、これで、あるとき突然次のようなエラーを吐いて、action サーブレットが使えなくなることがある。
:
:
2007/03/16 19:42:19 org.apache.catalina.core.ApplicationContext log
情報: サーブレット action を利用不可能にマークします
2007/03/16 19:42:19 org.apache.catalina.core.StandardContext loadOnStartup
致命的: サーブレット /app_hoge がload()例外を投げました
javax.servlet.UnavailableException: Initializing application data source oracle
at org.apache.struts.action.ActionServlet.initModuleDataSources(ActionServlet.java:1091)
at org.apache.struts.action.ActionServlet.init(ActionServlet.java:472)
at jp.co.hoge.MyActionServlet.init(MyActionServlet.java:62)
at javax.servlet.GenericServlet.init(GenericServlet.java:212)
at org.apache.catalina.core.StandardWrapper.loadServlet(StandardWrapper.java:1161)
at org.apache.catalina.core.StandardWrapper.load(StandardWrapper.java:981)
at org.apache.catalina.core.StandardContext.loadOnStartup(StandardContext.java:4044)
at org.apache.catalina.core.StandardContext.start(StandardContext.java:4350)
at org.apache.catalina.core.ContainerBase.addChildInternal(ContainerBase.java:760)
at org.apache.catalina.core.ContainerBase.addChild(ContainerBase.java:740)
at org.apache.catalina.core.StandardHost.addChild(StandardHost.java:525)
at org.apache.catalina.startup.HostConfig.deployDescriptor(HostConfig.java:626)
at org.apache.catalina.startup.HostConfig.deployDescriptors(HostConfig.java:553)
at org.apache.catalina.startup.HostConfig.deployApps(HostConfig.java:488)
at org.apache.catalina.startup.HostConfig.start(HostConfig.java:1138)
at org.apache.catalina.startup.HostConfig.lifecycleEvent(HostConfig.java:311)
at org.apache.catalina.util.LifecycleSupport.fireLifecycleEvent(LifecycleSupport.java:120)
at org.apache.catalina.core.ContainerBase.start(ContainerBase.java:1022)
at org.apache.catalina.core.StandardHost.start(StandardHost.java:719)
at org.apache.catalina.core.ContainerBase.start(ContainerBase.java:1014)
at org.apache.catalina.core.StandardEngine.start(StandardEngine.java:443)
at org.apache.catalina.core.StandardService.start(StandardService.java:451)
at org.apache.catalina.core.StandardServer.start(StandardServer.java:710)
at org.apache.catalina.startup.Catalina.start(Catalina.java:552)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:585)
at org.apache.catalina.startup.Bootstrap.start(Bootstrap.java:288)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:413)
(以下略)
これは、data-source の設定が不味い（接続先の情報、ユーザ名、パスワードなど）ときにも出るエラーなのだけど、
コンソール（Oracle の場合は SQLPlus ）などで接続すると、ちゃんとつながったりする。
つまり、DBMSも落ちてないし、設定も間違っていない。
であるのに、データソースの初期化に失敗し、UnavailableException (このサーブレットは使えないよ)というエラーが発生する（ことがある）。
これ、大ハマリしたんだけど、原因は、''Oracle のプーリング機能が働いてる為''だった。
データベースのコネクションプールというのは、
あらかじめいくつかの接続を開いておいて、
2度目以降のアクセスで同じ接続先だったりSQLだったりしたときに、
前に使っていた接続をプールから探して、同じのがあればそれを再利用するという機能。
つまり、この''あらかじめ開いておく接続数がサーバの許容（接続可能な数）を超えてしまうとつながらない''と。
SQLPlus は接続を1本しか張らないから、すんなりつながるわけですな。
これがDBサーバの設定や状態によって発生したりしなかったりするエラーなので、
突然つながらなくなったり、かと思えば突然つながるようになったりするので、
原因がさっぱりつかめずにハマるパターンだったりする。
大抵、DBサーバを再起動すればしばらく正常につながる。
ただ、開発やデバッグの段階ではプーリング機能はあまり関係ないので、
minCount や maxCount の値を小さく（両方 1 でも良い）してしまえば良い。
** native2asc [#x3cb8aaa]
ネイティブコード (Latin 1 および Unicode 以外) のファイルを Unicode コードに変換。
JDK に含まれているはず。（\bin の中）
*** Unicode に変換 [#y9fe0a07]
C:\(JDK ディレクトリ)\bin> native2asc (ネイティブコードのファイル) (変換先ファイル)
例えば、
C:\JDK1.5\bin> native2asc C:\temp\hoge.properties C:\temp\hoge.properties.asc
とか。
※ファイル名はフルパスで。
*** ネイティブに戻す [#r6ad592d]
reverse オプションを使う。
C:\(JDK ディレクトリ)\bin> native2asc -reverse (Unicode のファイル) (変換先ファイル)
*** 文字コードを指定する [#ibb89d15]
encoding オプションを使う
C:\(JDK ディレクトリ)\bin> native2asc -encoding (文字コード) (ネイティブコードのファイル) (変換先ファイル)
例えば、
C:\JDK1.5\bin> native2asc -encoding EUC-JP C:\temp\hoge.properties C:\temp\hoge.properties.asc
とか。
*** 参考 [#m99e0202]
- [[ネイティブ - ASCII コンバータ:http://sdc.sun.co.jp/java/docs/j2se/1.4/ja/docs/ja/tooldocs/win32/native2ascii.html]]
** 参考サイト [#waefa315]
- [[Apache Struts:http://struts.apache.org/]]&br;
本家。
- [[Apache Wiki(英語):http://wiki.apache.org/]]
-- [[Struts Wiki:http://wiki.apache.org/struts/]]&br;
Struts の様々な情報が詰まってる。
- [[uebu Jakarta TomcatとJakarta TaglibsとApache Strutsとその他の部屋:http://kamakura.cool.ne.jp/oppama/ssja/index.html]]&br;
参考になります。
-----
[[プログラム・開発系メモ]]
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
