Resin使用簡(jiǎn)介

使用Resin開發(fā)Java Web項(xiàng)目時(shí)，需要建立自己的WebApp。這里不介紹Resin Cmp/Ejb的開發(fā)和使用，只介紹用Resin開發(fā)普通的jsp\java servlet項(xiàng)目。在這里還要談到resin.conf的配置。Resin中的應(yīng)用可以有2種方式發(fā)布：一是在Resin的目錄下發(fā)布；二是打包成War發(fā)布。

1、在Resin的目錄下發(fā)布

在resin.conf中查找<web-app>標(biāo)簽，該標(biāo)簽表示一個(gè)web應(yīng)用。

標(biāo)簽中，id屬性表示該應(yīng)用的Web路徑。如<web-app id=’/test’>，表示該應(yīng)用在Web上訪問(wèn)的時(shí)候應(yīng)該用http://hostname/test/來(lái)訪問(wèn)。app-dir屬性表示該應(yīng)用的實(shí)際路徑。如<app-dir>d:\resin\doc\test</app-dir>表示該應(yīng)用在d:\resin\doc\test目錄下面。默認(rèn)值為根下面的和id同名的目錄。Resin可以配置3種error-page：404錯(cuò)誤也就是文件找不到錯(cuò)誤頁(yè)；Exception違例頁(yè)；不能連接java引擎頁(yè)。他們分別可以這樣子設(shè)置。

404文件找不到頁(yè)

<web-app id='/app1'>

<error-page error-code='404' location='/file_not_found.jsp'/>

</web-app>

Exception 違例頁(yè)

<web-app id='/foo'>

<error-page exception-type='java.lang.NullPointerException'

location='/nullpointer.jsp'/>

</web-app>

不能連接到srun Servlet引擎錯(cuò)誤頁(yè)

該頁(yè)設(shè)置和應(yīng)用無(wú)關(guān)，屬于服務(wù)器的設(shè)置。

<http-server>

<error-page exception-type='connection'

location='/missing_file.html'/>

</http-server>

classpath的設(shè)置

參見(jiàn)下面的語(yǔ)句：

<classpath id='WEB-INF/classes' source='WEB-INF/src' compile='true'/>

id參數(shù)的值表示classpath中編譯后的classpath的存放路徑；source參數(shù)的值表示classpath中java源代碼的存放路徑；compile中的值可能是true或者false，表示是否由Resin的srun自動(dòng)編譯java源代碼。Classpath的設(shè)置一般和javaBean或者Servlet的使用有關(guān)。id的值表示javaBean的編譯好的包存放的根，source的值表示javaBean的java源代碼存放的根。Servlet相同。

Servlet的設(shè)置

參見(jiàn)下面的語(yǔ)句：

<servlet-mapping url-pattern='*.xtp' servlet-name='xtp'/>

<servlet-mapping url-pattern='*.jsp' servlet-name='jsp'/>

<servlet-mapping url-pattern='/servlet/*' servlet-name='invoker'/>

一般就是指定那些需要通過(guò)srun的解析。比如在這里，把*.jsp改成*.jss，其他不變，那么只要在訪問(wèn)時(shí)遇到*.jss的文件就和原來(lái)遇到*.jsp一樣處理。通過(guò)這個(gè)可以指定解析的引擎，如以下的配置：

<servlet-mapping url-pattern='*.xtp' servlet-name='com.caucho.jsp.XtpServlet'/>

在Servlet中，也可以指定servlet。如

<servlet servlet-name='hello' servlet-class='test.HelloWorld'/>

<servlet-mapping url-pattern='/hello.html' servlet-name='hello'/>

在servlet-mapping中有個(gè)重要的參數(shù)case-sensitive 如果在windows上，最好配置成false，忽略大小寫，從而和windows的約定一致。

Session的配置

參見(jiàn)如下的配置語(yǔ)句：

<session-config>

<session-max>4096</session-max>

<session-timeout>30</session-timeout>

<enable-cookies>true</enable-cookies>

<enable-url-rewriting>true</enable-url-rewriting>

<file-store>WEB-INF/sessions</file-store>

</session-config>

session-max ：最大 session數(shù)量

session-timeout ：session過(guò)期時(shí)間，以分鐘為單位。

是否允許cookie ：指session是否采用cookies。如果采用cookies，瀏覽器必須支持session才能使用，發(fā)布時(shí)建議改成false。enable-url-rewriting和enable-cookies一般配合使用。如果enable-cookies是false，enable-url-rewriting應(yīng)該設(shè)成true比較合適。

file-store ：該配置指示服務(wù)器是否把session作為文件存放在服務(wù)器上。如果把該項(xiàng)注釋掉，則在你的web-app目錄下的WEB-Inf/sessions目錄不保存序列化后的session對(duì)象。Session還有jdbc-store配置，對(duì)應(yīng)著把session通過(guò)jdbc永久保存在數(shù)據(jù)庫(kù)中。其實(shí)也就是會(huì)話變量的序列化后的保存和重新載入的物理實(shí)現(xiàn)。在這里session還支持了多服務(wù)器的設(shè)置問(wèn)題，

通過(guò)tcp-store參數(shù)設(shè)置。由于涉及到負(fù)載平衡的問(wèn)題，在這里不詳細(xì)敘述，只簡(jiǎn)單寫一個(gè)例子：

<http-server>

<http id='a' port='80'/>

<srun id='a' host='host-a' port='6802'/>

<http id='b' port='80'/>

<srun id='b' host='host-b' port='6802'/>

<host id=''>

<web-app id=''>

<session-config>

<tcp-store/>

<always-load-session/>

</session-config>

</web-app>

</host>

</http-server>

這個(gè)例子表示session是按照tcp ring的方式傳遞。

temp-dir 的設(shè)置

temp-dir指的是應(yīng)用的臨時(shí)目錄。也就是在javax.servlet.context.tempdir中用到的目錄。模認(rèn)是應(yīng)用目錄下的WEB-INF\tmp目錄。

以上的設(shè)置都可以在<web-app>標(biāo)簽對(duì)中設(shè)置，控制某個(gè)web應(yīng)用的設(shè)置。

2、打包成War發(fā)布

以下是介紹對(duì)如何在resin下使用已經(jīng)打包成War的java Web應(yīng)用進(jìn)行發(fā)布。

其實(shí)這個(gè)是最簡(jiǎn)單也是最清晰的良好方法。在j2ee中，所有的項(xiàng)目都打包成ear發(fā)布。其中，Web應(yīng)用打包成war，ejb應(yīng)用打包成jar。在resin中，這些都可以直接部署。這里我只對(duì)打包成war的Web應(yīng)用的部署做介紹。

在resin.conf中，查找這個(gè)：<war-dir id='webapps'/>。他表示war文件應(yīng)該被拷貝的路徑。這里指的是相對(duì)于resin的安裝路徑，如以上的設(shè)置表示d:\resin\webapps。只要重新啟動(dòng)Resin就可以了。Resin會(huì)把該war自動(dòng)解包到webapps目錄下。你可以在command控制臺(tái)或者stdout.log中看到類似于

[2002-04-27 09:56:21.680] initializing application http://haitaiserver:8080/rwtest 的語(yǔ)句。這個(gè)表示該Web應(yīng)用是自動(dòng)安裝的。只要這個(gè)應(yīng)用是符合j2ee標(biāo)準(zhǔn)的Web應(yīng)用，應(yīng)該不會(huì)有問(wèn)題。通過(guò)如上顯示的路徑就可以訪問(wèn)到這個(gè)應(yīng)用。如果你到d:\resin\webapps\rwtest中瀏覽，你會(huì)看到Resin已經(jīng)為你生成了rwtest目錄，下面是META-INF和WEB-INF還有你自己的JSP\servlet 文件和目錄。是完全符合j2ee的結(jié)構(gòu)的。你可以在rwtest目錄下建立新的jsp\servlet，一樣可以被編譯和解析并運(yùn)行的。在實(shí)際操作中，可以使用Jbuilder 或者 WebSphere等Ide工具進(jìn)行集成調(diào)試和打包，非常的方便。

使用Resin進(jìn)行java Web項(xiàng)目的開發(fā)和調(diào)試

這里篇幅有限，不可能講太多，我只對(duì)實(shí)際中最有用的部分做介紹。

Resin中如果定義了錯(cuò)誤頁(yè)，則出錯(cuò)后最常見(jiàn)的一大串Exception不會(huì)被看到，直接跳轉(zhuǎn)到錯(cuò)誤頁(yè)。所以建議開發(fā)中先不設(shè)置錯(cuò)誤頁(yè)。jsp錯(cuò)誤中最常見(jiàn)的就是Nullpoint Exception，其次是名稱的拼寫錯(cuò)誤。錯(cuò)誤也可以在Resin安裝目錄下的log目錄下的stderr.log中找到。通過(guò)對(duì)該log文件的分析可以看到很多有用的錯(cuò)誤信息。

在調(diào)試jsp的時(shí)候，如果定義了compile為true，jsp先被翻譯成Servlet的java文件，再被編譯成class文件。可以在你自己的work目錄中找到該文件。java的名稱在Resin中是這樣子定義的：原先的jsp文件名前加下劃線，再加上_jsp這個(gè)字樣。所以在java 應(yīng)用中的命名不要以_jsp結(jié)尾，也不要出現(xiàn)中文名稱等字符；其實(shí)名稱以_jsp為開頭也是不合法的。

關(guān)于java對(duì)多國(guó)語(yǔ)言的支持問(wèn)題，在Resin中得到了很好的解決。以jsp為例，參考Resin自動(dòng)生成的java Servlet文件。只要在任何的jsp文件的最開始處增加：

<%@page contentType="text/html;charset=gb2312" %>

中文問(wèn)題就解決了。察看生成的Servlet源文件片斷：

response.setContentType("text/html;charset=gb2312");

request.setCharacterEncoding("GB2312");

以上為設(shè)置字符集

private static byte []_jsp_string26;

private static byte []_jsp_string27;

_jsp_string26 = "\r\n</table>\r\n<table class=\"type\">\r\n<tr>\r\n <td>".getBytes("GB2312");

_jsp_string27 = "\r\n</td><td>\r\n</tr>\r\n<!--\r\n<tr>\r\n<td>\r\".getBytes("GB2312");

以上是對(duì)頁(yè)面的顯示的編碼。其中，getBytes(“gb2312”)是靜態(tài)編碼，這是Resin為了解決某些環(huán)境下還是不能正常顯示而設(shè)置的。在Resin的配置文件(/conf/resin.conf)中，可以通過(guò)設(shè)置<jsp precompile='true' static-encoding='false' recompile-on-error='true'/>中的static-encoding屬性為true或者false，來(lái)控制是否靜態(tài)編碼。其實(shí)在Resin容器的內(nèi)部，所有的字符都是按照iso-8859-1來(lái)處理的。iso-8859-1是一個(gè)大字符集，雖然中文的gb2312和8859在字的定義上有不同，但是編碼是包容了gb2312的。按照解決多國(guó)語(yǔ)言的方法，在純英文平臺(tái)上用iso-8859-1處理內(nèi)部編碼，而把字符的顯示推向客戶端的機(jī)器。所以這樣只要編碼是正確的，

在頁(yè)面上顯示中文就不存在問(wèn)題。Tomcat3.2不方便的地方是Tomcat對(duì)數(shù)據(jù)庫(kù)的操作中文支持不好，需要手動(dòng)在java Bean或者Servlet中硬編碼。通過(guò)測(cè)試，在Resin中完全沒(méi)有這個(gè)問(wèn)題。Tomcat4.0解決了這個(gè)問(wèn)題。不過(guò)個(gè)人習(xí)慣來(lái)講還是覺(jué)得resin在配置方面方便一些。

在Resin中可以自動(dòng)解決引入的jar。這個(gè)在使用特殊的類或者第三方提供的開發(fā)包非常有用。方法非常簡(jiǎn)單：只要把該jar或者是zip拷貝到Resin安裝目錄下的lib目錄下面，重新啟動(dòng)Resin，就可以了。如db2用到的db2java.zip文件，只要輕松拷貝到d:\resin\lib中就可以了。

Resin提供了對(duì)Jbuilder的集成調(diào)試。可以到：

http://www.caucho.com/projects/jbuilder/resin-jbuilder.jar免費(fèi)下載到resin的jbuilder的ide擴(kuò)展包。然后，把該包該名成：resin-jbuilder.jar，拷貝到j(luò)builder6\lib\ext目錄下。然后，把Resin2.1解包安裝在jbuilder6\resin-2.1目錄下，就可以了。打開任何的War項(xiàng)目，在project上點(diǎn)右鍵，選擇properties，選擇Servers標(biāo)簽。在原來(lái)的選擇框上，就可以看到多了一項(xiàng)Resin2.1。這樣子就可以象原來(lái)用tomcat一樣調(diào)試jsp\servlet了，而且比Tomcat更方便。見(jiàn)圖2：

圖2

調(diào)試方法和用Tomcat調(diào)試一樣。

其他問(wèn)題

使用Resin可以和apache結(jié)合使用。也就是利用apache做http服務(wù)器，而Resin做srun服務(wù)器。可以參考resin\conf\samples目錄下的apache.conf。主要就是把 app-dir 設(shè)成 /usr/local/apache/htdocs（也就是apache的root）。同時(shí)在apache 中的http.conf也做了相應(yīng)的設(shè)置。Resin還提供了對(duì)該過(guò)程的自動(dòng)安裝程式，運(yùn)行resin\bin\setup，你可以在彈處的對(duì)話框中選擇apache，這樣子就可以了。只要你曾經(jīng)安裝過(guò)apache，resin可以自己找到httpd.conf文件所在的路徑。

使用命令行方式啟動(dòng)Resin，如果改動(dòng)了Resin.conf，Resin會(huì)自己重新啟動(dòng)適應(yīng)新的配置。這個(gè)很適合初期安裝時(shí)使用。

Resin對(duì)數(shù)據(jù)庫(kù)緩沖池的支持很好。在這里，它提供了DBPool對(duì)緩沖池做了封裝。實(shí)際使用時(shí)，只要在resin.conf這樣配置：

<dbpool.sql>

<id>ORCL</id>

<driver>oracle.jdbc.driver.OracleDriver</driver>

<url>jdbc:oracle:thin:@localhost:1521:SMTH</url>

<!-- <url>jdbc:oracle:oci8:@SMTH</url> -->

<user>scott</user>

<password>tiger</password>

<max-connections>5</max-connections>

</dbpool.sql>

然后，在你的jsp或者servlet中就可以這樣子使用了：

先導(dǎo)入 com.caucho.sql.*包，然后如下直接得到連接：

Connection conn = DBPool.getPool("ORCL").getConnection();

個(gè)人建議不要如上使用連接池，還是按照ejb的方法用從Context中直接找到的DataSource對(duì)象中得到連接通用性比較好。代碼也很簡(jiǎn)單：

Context ctx = new InitialContext();

DataSource ds = (DataSource)ctx.lookup(“jdbc/EmployeeDB”);

Connection conn = ds.getConnection();

在Resin中如下配置jdbc就可以了：

<resource-ref>

<res-ref-name> jdbc/EmployeeDB</res-ref-name>

<res-type>javax.sql.DataSource</res-type>

<init-param driver-name="com.caucho.jdbc.mysql.Driver"/>

<init-param url="jdbc:mysql_caucho://localhost:3306/test"/>

<init-param user="name"/>

<init-param password="password"/>

<init-param max-connections="20"/>

<init-param max-idle-time="30"/>

</resource-ref>

用Resin Web Server開發(fā)還是比較愉快的。只是沒(méi)有像Weblogic 或者WebSphere那樣子提供現(xiàn)成的管理控制臺(tái)而已。但是從穩(wěn)定性和方便性來(lái)講，Resin個(gè)人認(rèn)為比Tomcat要好很多。況且Resin還有提供了resin-cmp 和 resin-ejb，功能更強(qiáng)大。