Resin服務器的使用

 Resin服務器的使用 -Java Web服務器選擇簡介

在實際進行java Web項目實施的時候，我們可以採用的商業java Web服務器有Ibm WebSphere,Bea Web Logic

。這兩種服務器功能齊全而強大，支持所有的java 服務容器標準，適合成品商業java Web應用的發佈。但是

這兩種服務器是商業服務器，價格昂貴，而且對系統資源要求極高。特別是Websphere 配置複雜，如果不配合

採用ibm Websphere Studio Application非常不適合開發。而且他們不同的版本對servlet.jar等javax組件和

jdk的要求不同。如Websphere 3.5所要求的servlet.jar 支持的是舊版本的javax.servlet.http.HttpSession

操作，不支持session.setAttribute() session.getAttribute()。

在開發或者學習過程中，有許多免費的輕型的Java Web服務器可以供我們選用，如Tomcat,Resin,Orion等等。

他們使用都很方便，佔用資源也很少，適合開發中不斷的調試；還可以和Jbuilder這樣的集成開發工具集成使

用。根據實際開發中的情況來看，Jakata Tomcat 和Sun Java結合的最好，和其他應用服務器配合使用可支持

完整的j2ee標準，應用也很廣泛。但是從Java 普遍存在的編碼問題來看，還是Resin 解決的最好。還有從使

用的角度講，個人認爲Resin比Tomcat方便，而且Resin也可以結合Jbuilder6等ide使用。Resin強調使用Xml技

術，從Resin自己的HomePage使用xtp就可以看出來。

二、Resin的安裝和配置

Resin 可以在http://www.caucho.com/download/index.xtp 免費下載和使用。使用Resin開發或者學習是免

費的，但是如果把Resin作爲收費產品發佈是需要付費的。目前的版本是2.10。

下載Resin 時選擇Archive Versions 中的 windows.zip的普通安裝包resin-2.1.0.zip。

把該zip包解壓到任何目錄下面，如d:esin。以下介紹都假設Resin安裝在d:esin下。進入d:esinin，

鍵入httpd，可以在命令行控制檯下運行Resin服務器。此時彈出一個有start 和stop兩個Radio按紐和一close

按紐的對話框。在這裏可以看到Resin的運行信息。這些信息同時Resin可以在d:esinlog目錄下面的

stdout.log 日誌文件中察看到。如：

Resin 2.0.4 (built Thu Nov 15 17:56:24 PST 2001)
Copyright(c) 1998-2001 Caucho Technology. All rights reserved.
Starting Resin on Wed, 23 Jan 2002 14:41:47 +0800 (CST)

http listening to *0
srun listening to haitaiserver:6802

點選stop，可以停止當前的Resin服務器進程；再點選start，又可以開啓新的Resin服務器進程。關閉該對話

框，則回到Command 控制檯的盤符提示狀態下。如果在nt4或者win2k環境下，需要把Resin當成服務，只需要

在Command控制檯的該目錄下，鍵入 httpd ?install，就可以在管理工具的服務下面看到新增了一條Resin 

Web Server的自動的服務。以後只要進入nt 4或者win2k，就可以啓動Resin服務。該服務也可以像其他服務一

樣設置成手動或者禁用狀態。注意有的時候在安裝完服務後，啓動Resin，並不能看到自己寫的Resin例程可以

被解析，瀏覽器顯示服務器找不到錯誤。只要重新啓動win2k或者nt，就能解決該問題。

下面簡要介紹一下Resin服務器的配置。Resin服務器和大多數Java Web服務器一樣，通過一個Xml文件配置。

進入d:esinconf目錄，打開resin.conf，這是一個xml格式的文本。

這裏面有很多標記，先查找到：<http-server>。在<http-server></http-server>標記對中的配置和resin的

Java Web 服務器有關。找到<app-dir>，在<app-dir></app-dir>標記對中的表示resin的根，相當於Apache的

htdocs 或者 IIS 的wwwroot。Resin自帶http服務器，但是也可以不使用它，採用Apache 或者 IIS做http服

務器。這個在下面段落中會提到。

再查找<http port=´8080´/>標記，它可以這樣配置<http host=´localhost´ port=´80´/>。host參數指定的

是服務器，port指定的是http端口，默認是localhost和8080。還有<srun host=´localhost´ port=´6802´/>

標記。這個是jsp和java Servlet的引擎配置。一般默認就可以了，除非6802端口已經被別的程序佔用了。然

後，配置jdk。這個需要在classpath中設置。右鍵點擊我的電腦，在系統特性的高級標籤中，點擊環境變量，

在系統變量中新建一個環境變量，變量名爲classpath，值爲jdk所在的目錄；再新建另外一個環境變量，變量

名爲path，值爲javac.exe和java.exe所在的目錄（在jdk所在的目錄下面的bin目錄下）。一般這樣子配置以

後，Resin就可以使用了。在d:esindoc中（假設你的<appdir></appdir>對中的名稱是doc，也就是根是

d:/resin/doc，而且你的<http host=´localhost´ port=´80´/>如左配置），隨便寫一個jsp文件，如可以寫

個test.jsp文件，內容爲<%=1+2+3%>。然後，在瀏覽器中，鍵入http://localhost/test.jsp。如果你可以看

到瀏覽器顯示6，則表示Resin服務器已經可以正常運行了。注意，修改配置後，一般重新啓動resin才能看到

變化。

三、Resin使用簡介

使用Resin開發Java Web項目時，需要建立自己的WebApp。這裏不介紹Resin Cmp/Ejb的開發和使用，只介紹用

Resin開發普通的jspjava servlet項目。在這裏還要談到resin.conf的配置。Resin中的應用可以有2種方式

發佈：一是在Resin的目錄下發布；二是打包成War發佈。

1、在Resin的目錄下發布

在resin.conf中查找<web-app>標籤，該標籤表示一個web應用。

標籤中，id屬性表示該應用的Web路徑。如<web-app id=´/test´>，表示該應用在Web上訪問的時候應該用

http://hostname/test/來訪問。app-dir屬性表示該應用的實際路徑。如

<app-dir>d:esindoc        est</app-dir>表示該應用在d:esindoc        est目錄下面。默認值爲根下面的和id

同名的目錄。Resin可以配置3種error-page：404錯誤也就是文件找不到錯誤頁；Exception違例頁；不能連接

java引擎頁。他們分別可以這樣子設置。

404文件找不到頁

<web-app id=´/app1´>
<error-page error-code=´404´ location=´/file_not_found.jsp´/>
</web-app>

Exception 違例頁

<web-app id=´/foo´>
<error-page exception-type=´java.lang.NullPointerException´
location=´/nullpointer.jsp´/>
</web-app>

不能連接到srun Servlet引擎錯誤頁

該頁設置和應用無關，屬於服務器的設置。

<http-server>
<error-page exception-type=´connection´
location=´/missing_file.html´/>
</http-server>

classpath的設置

參見下面的語句：

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

id參數的值表示classpath中編譯後的class的存放路徑；source參數的值表示classpath中java源代碼的存放

路徑；compile中的值可能是true或者false，表示是否由Resin的srun自動編譯java源代碼。Classpath的設置

一般和javaBean或者Servlet的使用有關。id的值表示javaBean的編譯好的包存放的根，source的值表示

javaBean的java源代碼存放的根。Servlet相同。

Servlet的設置

參見下面的語句：

<servlet-mapping url-pattern=´*.xtp´ servlet-name=´xtp´/>
<servlet-mapping url-pattern=´*.jsp´ servlet-name=´jsp´/>
<servlet-mapping url-pattern=´/servlet/*´ servlet-name=´invoker´/>

一般就是指定那些需要通過srun的解析。比如在這裏，把*.jsp改成*.jss，其他不變，那麼只要在訪問時遇到

*.jss的文件就和原來遇到*.jsp一樣處理。通過這個可以指定解析的引擎，如以下的配置：

<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中有個重要的參數case-sensitive 如果在windows上，最好配置成false，忽略大小寫，從

而和windows的約定一致。

Session的配置

參見如下的配置語句：

<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數量
session-timeout ：session過期時間，以分鐘爲單位。

是否允許cookie ：指session是否採用cookies。如果採用cookies，瀏覽器必須支持session才能使用，發佈

時建議改成false。enable-url-rewriting和enable-cookies一般配合使用。如果enable-cookies是false，

enable-url-rewriting應該設成true比較合適。

file-store ：該配置指示服務器是否把session作爲文件存放在服務器上。如果把該項註釋掉，則在你的

web-app目錄下的WEB-Inf/sessions目錄不保存序列化後的session對象。Session還有jdbc-store配置，對應

着把session通過jdbc永久保存在數據庫中。其實也就是會話變量的序列化後的保存和重新載入的物理實現。
在這裏session還支持了多服務器的設置問題，

通過tcp-store參數設置。由於涉及到負載平衡的問題，在這裏不詳細敘述，只簡單寫一個例子：

<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>

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

temp-dir 的設置

temp-dir指的是應用的臨時目錄。也就是在javax.servlet.context.tempdir中用到的目錄。模認是應用目錄

下的WEB-INF        mp目錄。

以上的設置都可以在<web-app>標籤對中設置，控制某個web應用的設置。

2、打包成War發佈

以下是介紹對如何在resin下使用已經打包成War的java Web應用進行發佈。

其實這個是最簡單也是最清晰的良好方法。在j2ee中，所有的項目都打包成ear發佈。其中，Web應用打包成

war，ejb應用打包成jar。在resin中，這些都可以直接部署。這裏我只對打包成war的Web應用的部署做介紹。

在resin.conf中，查找這個：<war-dir id=´webapps´/>。他表示war文件應該被拷貝的路徑。這裏指的是相對

於resin的安裝路徑，如以上的設置表示d:esinwebapps。只要重新啓動Resin就可以了。Resin會把該war自

動解包到webapps目錄下。你可以在command控制檯或者stdout.log中看到類似於

[2002-04-27 09:56:21.680] initializing application[url=http://haitaiserver080/rwtest]http://haitaiserver080/rwtest[/url] 的語句。這個

表示該Web應用是自動安裝的。只要這個應用是符合j2ee標準的Web應用，應該不會有問題。通過如上顯示的路

徑就可以訪問到這個應用。如果你到d:esinwebappswtest中瀏覽，你會看到Resin已經爲你生成了rwtest

目錄，下面是META-INF和WEB-INF還有你自己的JSPservlet 文件和目錄。是完全符合j2ee的結構的。你可以

在rwtest目錄下建立新的jspservlet，一樣可以被編譯和解析並運行的。在實際操作中，可以使用Jbuilder 

或者 WebSphere等Ide工具進行集成調試和打包，非常的方便。

四、使用Resin進行java Web項目的開發和調試

這裏篇幅有限，不可能講太多，我只對實際中最有用的部分做介紹。

Resin中如果定義了錯誤頁，則出錯後最常見的一大串Exception不會被看到，直接跳轉到錯誤頁。所以建議開

發中先不設置錯誤頁。jsp錯誤中最常見的就是Nullpoint Exception，其次是名稱的拼寫錯誤。錯誤也可以在

Resin安裝目錄下的log目錄下的stderr.log中找到。通過對該log文件的分析可以看到很多有用的錯誤信息。

在調試jsp的時候，如果定義了compile爲true，jsp先被翻譯成Servlet的java文件，再被編譯成class文件。

可以在你自己的work目錄中找到該文件。java的名稱在Resin中是這樣子定義的：原先的jsp文件名前加下劃線

，再加上_jsp這個字樣。所以在java 應用中的命名不要以_jsp結尾，也不要出現中文名稱等字符；其實名稱

以_jsp爲開頭也是不合法的。

關於java對多國語言的支持問題，在Resin中得到了很好的解決。以jsp爲例，參考Resin自動生成的java 

Servlet文件。只要在任何的jsp文件的最開始處增加：

<% @page c %>

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

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

以上爲設置字符集

private static byte[] _jsp_string26;
private static byte[] _jsp_string27;

_jsp_string26 = "</table><table class="type"><tr> <td>".getBytes("GB2312");
_jsp_string27 = "</td><td></tr><!--<tr><td>".getBytes("GB2312");

以上是對頁面的顯示的編碼。其中，getBytes("gb2312")是靜態編碼，這是Resin爲了解決某些環境下還是不

能正常顯示而設置的。在Resin的配置文件(/conf/resin.conf)中，可以通過設置<jsp precompile=´true´ 

static-encoding=´false´ recompile-on-error=´true´/>中的static-encoding屬性爲true或者false，來控

制是否靜態編碼。其實在Resin容器的內部，所有的字符都是按照iso-8859-1來處理的。iso-8859-1是一個大

字符集，雖然中文的gb2312和8859在字的定義上有不同，但是編碼是包容了gb2312的。按照解決多國語言的方

法，在純英文平臺上用iso-8859-1處理內部編碼，而把字符的顯示推向客戶端的機器。所以這樣只要編碼是正

確的，在頁面上顯示中文就不存在問題。Tomcat3.2不方便的地方是Tomcat對數據庫的操作中文支持不好，需

要手動在java Bean或者Servlet中硬編碼。通過測試，在Resin中完全沒有這個問題。Tomcat4.0解決了這個問

題。不過個人習慣來講還是覺得resin在配置方面方便一些。

在Resin中可以自動解決引入的jar。這個在使用特殊的類或者第三方提供的開發包非常有用。方法非常簡單：

只要把該jar或者是zip拷貝到Resin安裝目錄下的lib目錄下面，重新啓動Resin，就可以了。如db2用到的

db2java.zip文件，只要輕鬆拷貝到d:esinlib中就可以了。

Resin提供了對Jbuilder的集成調試。可以到：

http://www.caucho.com/projects/jbuilder/resin-jbuilder.jar免費下載到resin的jbuilder的ide擴展包。

然後，把該包該名成：resin-jbuilder.jar，拷貝到jbuilder6libext目錄下。然後，把Resin2.1解包安裝

在jbuilder6esin-2.1目錄下，就可以了。打開任何的War項目，在project上點右鍵，選擇properties，選

擇Servers標籤。在原來的選擇框上，就可以看到多了一項Resin2.1。這樣子就可以象原來用tomcat一樣調試

jspservlet了，而且比Tomcat更方便。調試方法和用Tomcat調試一樣。

五、其他問題

使用Resin可以和apache結合使用。也就是利用apache做http服務器，而Resin做srun服務器。可以參考

resinconfsamples目錄下的apache.conf。主要就是把 app-dir 設成 /usr/local/apache/htdocs（也就是

apache的root）。同時在apache 中的http.conf也做了相應的設置。Resin還提供了對該過程的自動安裝程式

，運行resininsetup，你可以在彈處的對話框中選擇apache，這樣子就可以了。只要你曾經安裝過apache

，resin可以自己找到httpd.conf文件所在的路徑。

使用命令行方式啓動Resin，如果改動了Resin.conf，Resin會自己重新啓動適應新的配置。這個很適合初期安

裝時使用。

Resin對數據庫緩衝池的支持很好。在這裏，它提供了DBPool對緩衝池做了封裝。實際使用時，只要在

resin.conf這樣配置：

<dbpool.sql>

　　<id>ORCL</id>
　　<driver>oracle.jdbc.driver.OracleDriver</driver>
　　<url>jdbcracle:thinlocalhost:1521:SMTH</url>

　　<!-- <url>jdbcracleci8SMTH</url> -->

　　<user>scott</user>
　　<password>tiger</password>

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

</dbpool.sql>

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

先導入 com.caucho.sql.*包，然後如下直接得到連接：

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

個人建議不要如上使用連接池，還是按照ejb的方法用從Context中直接找到的DataSource對象中得到連接通用

性比較好。代碼也很簡單：

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-c/>
<init-param max-idle-time="30"/>
</resource-ref>

用ResinWeb Server開發還是比較愉快的。只是沒有像Weblogic或者WebSphere那樣子提供現成的管理控制檯而已。但是從穩定性和方便性來講，Resin個人認爲比Tomcat要好很多。況且Resin還有提供了resin-cmp 和 resin-ejb，功能更強大。