j2ee doc 之 配置指南
關鍵詞:Java
聲明:本文檔由freehero翻譯,未經作者同意不能用於商業用途,您可以自由的復制和傳播,文檔只供您理解j2ee,因作者能力有限,建議您同時閱讀英文文檔,對於因為翻譯的錯誤代來的後果作者不負任何責任,歡迎您來信討論[email protected]
j2ee配置指南
1。介紹
本文介紹j2ee環境的配置,所有涉及的文件都在j2ee安裝目錄下的oncfig目錄,這些文件都是文本文件,
你可以有任意的文本編輯器來編輯它們。
通常情況下,你沒有改變這些文件的必要。但是如果你使用的數據庫驅動不是cloudscape的時候,你需要
遵循本章的內容進行配置。
2。JDBC驅動
默認的j2ee安裝後支持cloudscape數據庫(一個sun公司提供的演示數據庫),如果你的ejb使用的jdbc不
是連接cloudscape數據庫,那麼你需要按照下面的知道進行配置。(如果你不能確定本版本的j2ee支持你使用
的jdbc驅動,請到 11111 看相關信息。)
3。驅動的位置
你必須把驅動文件(.jar文件)copy到 $J2EE_HOME/lib/system目錄下。並且保證該文件包含在
J2EE_CLASSPATH 的環境變量中。
4。J2EE_CLASSPATH 環境變量
j2ee server通過JDBC驅動連接數據庫。通通過J2EE_CLASSPATH 的環境變量定位驅動文件(.jar文件)的位
置。你可以在啟動j2ee前在命令行設置這個變量。但是我們推薦你在腳本中設置J2EE_CLASSPATH 變量。編輯用
戶配置文件在安裝的過程中是必須的一步。在unix中,用戶配置文件是 /bin/userconfig.sh,windows nt中是
bin/userconfig.bat
注意:你應該同時在CLASSPATH環境變量中去掉驅動文件(.jar文件)。
5。JDBC 1.0 驅動
為了配置jdbc1.0驅動,編輯config/default.properties 文件的jdbc.drivers 和 jdbc.datasources兩個
屬性值。再次要注意的是驅動文件必須包含在J2EE_CLASSPATH環境變量中。
jdbc.drivers 屬性
jdbc.drivers 屬性的值是有一系列的冒號分割的jdbc驅動的類名。格式如下:
jdbc.drivers=<classname>:<classname>: . . .
例如:
jdbc.drivers=oracle.jdbc.driver.OracleDriver:testutil.MyDriver
jdbc.datasources 屬性值
jdbc.datasources 屬性值由兩部分組成,一個是datasource的jndi的名字,一個是數據庫的url。典型的
情況是:jndi名字是數據庫的邏輯名字,rul指定數據庫的實際位置。jndi名字和url都是在ejb編碼的過程中指
定的。rul的格式,請參照jdbc驅動提供商的文檔。
jdbc.datasources 的語法如下:
jdbc.datasources=<jndi_datasource>|<url>|<jndi_datasource>|<url>. . .
|符號有兩個作用。第一,它隔開幾個jndi_datasource;第二,它隔開每一個jndi_datasource中的
jndi_datasource> 和 <url> 元素.
jndi_datasource元素的語法如下:
jdbc/<jndi_name>
由jdbc關鍵字開頭,jndi_name是在jndi目錄中指定的datasouce名字。
例如:
jdbc.datasources=jdbc/Oracle|jdbc:oracle:thin@rtc:1521:acct|jdbc/MyDB|jdbc:test
6。支持JTA的JDBC2.0驅動
配置JTA的JDBC2.0的驅動,你需要設置以下屬性的值:
jdbc20.datasources
xadatasource.<n>.jndiname
xadatasource.<n>.classname
xadatasource.<n>.dbuser
xadatasource.<n>.dbpassword
xadatasource.<n>.prop.<property-name>
同時你也必須在J2EE_CLASSPATH 環境變量中包括jdbc驅動文件。
jdbc20.datasources 屬性
jdbc20.datasources 屬性的值和jndi名字連接,用於定位datasouce的位置(它就是lookup方法的參數)
。
jdbc20.datasources 的語法如下:
jdbc20.datasources=<jndi_datasource>|<jndi_XA_datasource>|<jndi_datasource>|<jndi_XA_datasource>
|的作用有兩個,第一,隔開jndi_datasource 和<jndi_XA_datasource>並組成一對,第二,隔開每一對的
jndi_datasource> 、<jndi_XA_datasource>元素。
<jndi_datasource> 和 jndi_XA_datasource有相同的語法:
jdbc/<jndi_name>
jdbc關鍵字開頭。jndi_name是datasource名字,這個名字指向jndi目錄。
例如:
jdbc20.datasources=jdbc/Merant|jdbc/XAMerant|jdbc/Finch|jdbc/XAFinch
xadatasource屬性
xadatasource.<n>.jndiname 屬性指定XA DataSource的jndi名字。語法如下:
xadatasource.<n>.jndiname=jdbc/<jndi_XA_datasource>
n代表每一組xadatasource。第一個jdbc2.0驅動n為0,下一個是1,2等等。jndi_XA_datasource元素和
jdbc20.datasources 指定的值對應。
The xadatasource.<n>.dbuser 和 xadatasource.<n>.dbpassword 屬性指定數據庫用戶和密碼。通常該用
戶具有管理員的權限(更多的信息請看 2222 The distributed.transaction.recovery )。
xadatasource.<n>.prop.<property_name> 指定和特定的屬性值關聯的值。實際的值可能是jdbc驅動。
例如:
xadatasource.0.jndiname=jdbc/XAMerant
xadatasource.0.classname=com.merant.sequelink.jdbcx.datasource.SequeLinkDataSource
xadatasource.0.prop.url=jdbc:sequelink://mypc:5000/[Oracle]
7。事務
你可以編輯config/default.properties 文件控制事務發生和超時設置。
distributed.transaction.recovery 屬性
這個屬性控制分布事物是否發生。入這些事物可以發生的化,下面的條件必須滿足:
跨庫操作時的事物范圍。
j2ee程序通過jdbc2.0 JTA驅動訪問數據庫
當故障發生的時候,事物的各個的組成部分可以按照符合兩段提交協議的方式提交或回滾。
事物發生的時候,server重新啟動後事物可以提交或回滾。
distributed.transaction.recovery的值為true或者false。j2ee安裝後默認為false。
distributed.transaction.recovery=false
transaction.time屬性
在應用container-managed 事物的ejb中,你可以控制事物超時的間隔通過設置transaction.timeout的值
。例如:
transaction.timeout=5
在設置以後,如果事物在5秒內沒有完成,j2ee事物管理器將回滾它。
當j2ee第一次安裝的時候,timeout的值時0代表沒有超時。
只有使用container-managed 管理事物的ejb受到timeout的影響。至於在bean-managed和JTA
transactions 中你可以引用 UserTransaction 的 setTransactionTimeout方法。同時你也可以在其他組建中
引用setTransactionTimeout方法:比如servlets和jsp。
8。端口
j2ee需要tcp/ip端口。修改config目錄下的相應文件可以修改端口號。下表是端口號和相應的文件。
EJB 9191 ejb.properties http.port=9191
HTTP 8000 web.properties port=8000
HTTPS 7000 web.properties https.port=7000
Naming and Directory 1050 orb.properties port=1050
9191 端口用於提供client下載需要的stub類
8000 提供http服務
7000 提供https服務
1050 基於orb的jndi名字服務使用的端口
9。日志文件
j2ee server有幾個日志文件。默認這些文件在logs目錄下。編輯config/default.properties 文件中的
log.directory 屬性可以更改默認目錄。
log.directory=logs
同時你也可以編輯default.properties 文件更改日志文件的名字。例如:你可以修改log.output 屬性的
值來修改the output.log 文件的名字。
一般來說,日志文件決定於啟動j2ee的模式。(single還是multiple VM (virtual machine) 模式)
Single VM 日志文件
默認的情況是Single VM 模式。在這種情況下,日志文件位於
$J2EE_HOME/<logs>/<host>/ejb
logs是在default.properties 文件中log.directory 屬性指定的。host元素是計算機名稱。
生成下列文件。
system.out
system.err
event.log
output.log
error.log
system.out 和system.err文件包括ejb中 System.out 和 System.err的輸出。如果你運行j2ee -verbose
參數,輸出被寫到stdout(標准輸出) 和stderr(標准錯誤。輸出)。system.out 和 system.err日志文件不
創建。只有config/auth.properties 文件中audit屬性值為true時audit.lo才創建。
Multiple VM 日志
如果你用j2ee -mutiVM啟動server,ejb和http服務在自己的虛擬機以單獨的服務啟動。每一個depploy的
應用程序也在自己的虛擬機中運行。日志文件和上述的一樣,但是存放的目錄不同。
目錄如下:
EJB $J2EE_HOME/<logs>/ejb/ejbd
HTTP $J2EE_HOME/<logs>/ejb/httpd
deployed application $J2EE_HOME/<logs>/ejb/<app-name>
web server日志
編輯web.properties文件中的內容,可以改變由web server創建的日志文件的名字。
10。安全
未授權用戶
對於j2ee來說,當有未授權的用戶試圖調用ejb container的時候,j2ee必須存在一般意義上的未授權用戶
存在。在j2ee中這個用戶名字是guest,密碼是guest123。你可以在auth.properties 文件中修改用戶名和密碼
。
default.principal.name=guest
default.principal.password=guest123
Keystore密碼<