摘要: SQL
中的單記錄函數(shù)1.ASCII返回與指定的字符對(duì)應(yīng)的十進(jìn)制數(shù);SQL> select ascii('A') A,ascii('a') a,ascii('0') zero,ascii(' ') space from dual;
A???????? a????? ZERO??...
閱讀全文
文檔對(duì)象模型(Document Object Model,DOM)是用于操縱 XML 和 HTML 數(shù)據(jù)的最常用工具之一,然而它的潛力卻很少被充分挖掘出來。通過利用 DOM 的優(yōu)勢(shì),并使它更加易用,您將獲得一款應(yīng)用于 XML 應(yīng)用程序(包括動(dòng)態(tài) Web 應(yīng)用程序)的強(qiáng)大工具。
本期文章介紹了一位客串的專欄作家,同時(shí)也是我的朋友和同事 Dethe Elza。Dethe 在利用 XML 進(jìn)行 Web 應(yīng)用程序開發(fā)方面經(jīng)驗(yàn)豐富,在此,我要感謝他對(duì)我在介紹使用 DOM 和 ECMAScript 進(jìn)行 XML 編程這一方面的幫助。請(qǐng)密切關(guān)注本專欄,以了解 Dethe 的更多專欄文章。 —— David Mertz
DOM 是處理 XML 和 HTML 的標(biāo)準(zhǔn) API 之一。由于它占用內(nèi)存大、速度慢,并且冗長(zhǎng),所以經(jīng)常受到人們的指責(zé)。盡管如此,對(duì)于很多應(yīng)用程序來說,它仍然是最佳選擇,而且比 XML 的另一個(gè)主要 API —— SAX 無疑要簡(jiǎn)單得多。DOM 正逐漸出現(xiàn)在一些工具中,比如 Web 瀏覽器、SVG 瀏覽器、OpenOffice,等等。
DOM 很好,因?yàn)樗且环N標(biāo)準(zhǔn),并且被廣泛地實(shí)現(xiàn),同時(shí)也內(nèi)置到其他標(biāo)準(zhǔn)中。作為標(biāo)準(zhǔn),它對(duì)數(shù)據(jù)的處理與編程語言無關(guān)(這可能是優(yōu)點(diǎn),也可能是缺點(diǎn),但至少使我們處理數(shù)據(jù)的方式變得一致)。DOM 現(xiàn)在不僅內(nèi)置于 Web 瀏覽器,而且也成為許多基于 XML 的規(guī)范的一部分。既然它已經(jīng)成為您的工具的一部分,并且或許您偶爾還會(huì)使用它,我想現(xiàn)在應(yīng)該充分利用它給我們帶來的功能了。
在使用 DOM 一段時(shí)間后,您會(huì)看到形成了一些模式 —— 您想要反復(fù)做的事情。快捷方式可以幫助您處理冗長(zhǎng)的 DOM,并創(chuàng)建自解釋的、優(yōu)雅的代碼。這里收集了一些我經(jīng)常使用的技巧和訣竅,還有一些 JavaScript 示例。
insertAfter 和 prependChild
第一個(gè)訣竅就是“沒有訣竅”。DOM 有兩種方法將孩子節(jié)點(diǎn)添加到容器節(jié)點(diǎn)(常常是一個(gè) Element
,也可能是一個(gè) Document
或 DocumentFragment
):appendChild(node)
和 insertBefore(node, referenceNode)
。看起來似乎缺少了什么。假如我想在一個(gè)參考節(jié)點(diǎn)后面插入或者由前新增(prepend)一個(gè)子節(jié)點(diǎn)(使新節(jié)點(diǎn)位于列表中的第一位),我該怎么做呢?很多年以來,我的解決方法是編寫下列函數(shù):
清單 1. 插入和由前新增的錯(cuò)誤方法
function insertAfter(parent, node, referenceNode) {
if(referenceNode.nextSibling) {
parent.insertBefore(node, referenceNode.nextSibling);
} else {
parent.appendChild(node);
}
}
function prependChild(parent, node) {
if (parent.firstChild) {
parent.insertBefore(node, parent.firstChild);
} else {
parent.appendChild(node);
}
}
|
實(shí)際上,像清單 1 一樣,insertBefore()
函數(shù)已經(jīng)被定義為,在參考節(jié)點(diǎn)為空時(shí)返回到 appendChild()
。因此,您可以不使用上面的方法,而使用 清單 2 中的方法,或者跳過它們僅使用內(nèi)置函數(shù):
清單 2. 插入和由前新增的正確方法
function insertAfter(parent, node, referenceNode) {
parent.insertBefore(node, referenceNode.nextSibling);
}
function prependChild(parent, node) {
parent.insertBefore(node, parent.firstChild);
}
|
如果您剛剛接觸 DOM 編程,有必要指出的是,雖然您可以使多個(gè)指針指向一個(gè)節(jié)點(diǎn),但該節(jié)點(diǎn)只能存在于 DOM 樹中的一個(gè)位置。因此,如果您想將它插入到樹中,沒必要先將它從樹中移除,因?yàn)樗鼤?huì)自動(dòng)被移除。當(dāng)重新將節(jié)點(diǎn)排序時(shí),這種機(jī)制很方便,僅需將節(jié)點(diǎn)插入到新位置即可。
根據(jù)這種機(jī)制,若想交換兩個(gè)相鄰節(jié)點(diǎn)(稱為 node1
和 node2
)的位置,可以使用下列方案之一:
node1.parentNode.insertBefore(node2, node1);
node1.parentNode.insertBefore(node2, node1);
|
或
node1.parentNode.insertBefore(node1.nextSibling, node1);
node1.parentNode.insertBefore(node1.nextSibling, node1);
|
還可以使用 DOM 做什么?
Web 頁面中大量應(yīng)用了 DOM。若訪問 bookmarklets 站點(diǎn)(參閱 參考資料),您會(huì)發(fā)現(xiàn)很多有創(chuàng)意的簡(jiǎn)短腳本,它們可以重新編排頁面,提取鏈接,隱藏圖片或 Flash 廣告,等等。
但是,因?yàn)?Internet Explorer 沒有定義 Node
接口常量(可以用于識(shí)別節(jié)點(diǎn)類型),所以您必須確保在遺漏接口常量時(shí),首先為 Web 在 DOM 腳本中定義接口常量。
清單 3. 確保節(jié)點(diǎn)被定義
if (!window['Node']) {
window.Node = new Object();
Node.ELEMENT_NODE = 1;
Node.ATTRIBUTE_NODE = 2;
Node.TEXT_NODE = 3;
Node.CDATA_SECTION_NODE = 4;
Node.ENTITY_REFERENCE_NODE = 5;
Node.ENTITY_NODE = 6;
Node.PROCESSING_INSTRUCTION_NODE = 7;
Node.COMMENT_NODE = 8;
Node.DOCUMENT_NODE = 9;
Node.DOCUMENT_TYPE_NODE = 10;
Node.DOCUMENT_FRAGMENT_NODE = 11;
Node.NOTATION_NODE = 12;
}
|
清單 4
展示如何提取包含在節(jié)點(diǎn)中的所有文本節(jié)點(diǎn):
清單 4. 內(nèi)部文本
function innerText(node) {
// is this a text or CDATA node?
if (node.nodeType == 3 || node.nodeType == 4) {
return node.data;
}
var i;
var returnValue = [];
for (i = 0; i < node.childNodes.length; i++) {
returnValue.push(innerText(node.childNodes[i]));
}
return returnValue.join('');
}
|
快捷方式
人們常常抱怨 DOM 太過冗長(zhǎng),并且簡(jiǎn)單的功能也需要編寫大量代碼。例如,如果您想創(chuàng)建一個(gè)包含文本并響應(yīng)點(diǎn)擊按鈕的 <div>
元素,代碼可能類似于:
清單 5. 創(chuàng)建 <div> 的“漫長(zhǎng)之路”
function handle_button() {
var parent = document.getElementById('myContainer');
var div = document.createElement('div');
div.className = 'myDivCSSClass';
div.id = 'myDivId';
div.style.position = 'absolute';
div.style.left = '300px';
div.style.top = '200px';
var text = "This is the first text of the rest of this code";
var textNode = document.createTextNode(text);
div.appendChild(textNode);
parent.appendChild(div);
}
|
若頻繁按照這種方式創(chuàng)建節(jié)點(diǎn),鍵入所有這些代碼會(huì)使您很快疲憊不堪。必須有更好的解決方案 —— 確實(shí)有這樣的解決方案!下面這個(gè)實(shí)用工具可以幫助您創(chuàng)建元素、設(shè)置元素屬性和風(fēng)格,并添加文本子節(jié)點(diǎn)。除了 name
參數(shù),其他參數(shù)都是可選的。
清單 6. 函數(shù) elem() 快捷方式
function elem(name, attrs, style, text) {
var e = document.createElement(name);
if (attrs) {
for (key in attrs) {
if (key == 'class') {
e.className = attrs[key];
} else if (key == 'id') {
e.id = attrs[key];
} else {
e.setAttribute(key, attrs[key]);
}
}
}
if (style) {
for (key in style) {
e.style[key] = style[key];
}
}
if (text) {
e.appendChild(document.createTextNode(text));
}
return e;
}
|
使用該快捷方式,您能夠以更加簡(jiǎn)潔的方法創(chuàng)建 清單 5 中的 <div>
元素。注意,attrs
和 style
參數(shù)是使用 JavaScript 文本對(duì)象而給出的。
清單 7. 創(chuàng)建 <div> 的簡(jiǎn)便方法
function handle_button() {
var parent = document.getElementById('myContainer');
parent.appendChild(elem('div',
{class: 'myDivCSSClass', id: 'myDivId'}
{position: 'absolute', left: '300px', top: '200px'},
'This is the first text of the rest of this code'));
}
|
在您想要快速創(chuàng)建大量復(fù)雜的 DHTML 對(duì)象時(shí),這種實(shí)用工具可以節(jié)省您大量的時(shí)間。模式在這里就是指,如果您有一種需要頻繁創(chuàng)建的特定的 DOM 結(jié)構(gòu),則使用實(shí)用工具來創(chuàng)建它們。這不但減少了您編寫的代碼量,而且也減少了重復(fù)的剪切、粘貼代碼(錯(cuò)誤的罪魁禍?zhǔn)祝⑶以陂喿x代碼時(shí)思路更加清晰。
接下來是什么?
DOM 通常很難告訴您,按照文檔的順序,下一個(gè)節(jié)點(diǎn)是什么。下面有一些實(shí)用工具,可以幫助您在節(jié)點(diǎn)間前后移動(dòng):
清單 8. nextNode 和 prevNode
// return next node in document order
function nextNode(node) {
if (!node) return null;
if (node.firstChild){
return node.firstChild;
} else {
return nextWide(node);
}
}
// helper function for nextNode()
function nextWide(node) {
if (!node) return null;
if (node.nextSibling) {
return node.nextSibling;
} else {
return nextWide(node.parentNode);
}
}
// return previous node in document order
function prevNode(node) {
if (!node) return null;
if (node.previousSibling) {
return previousDeep(node.previousSibling);
}
return node.parentNode;
}
// helper function for prevNode()
function previousDeep(node) {
if (!node) return null;
while (node.childNodes.length) {
node = node.lastChild;
}
return node;
}
|
輕松使用 DOM
有時(shí)候,您可能想要遍歷 DOM,在每個(gè)節(jié)點(diǎn)調(diào)用函數(shù)或從每個(gè)節(jié)點(diǎn)返回一個(gè)值。實(shí)際上,由于這些想法非常具有普遍性,所以 DOM Level 2 已經(jīng)包含了一個(gè)稱為 DOM Traversal and Range 的擴(kuò)展(為迭代 DOM 所有節(jié)點(diǎn)定義了對(duì)象和 API),它用來為 DOM 中的所有節(jié)點(diǎn)應(yīng)用函數(shù)和在 DOM 中選擇一個(gè)范圍。因?yàn)檫@些函數(shù)沒有在 Internet Explorer 中定義(至少目前是這樣),所以您可以使用 nextNode()
來做一些類似的事情。
在這里,我們的想法是創(chuàng)建一些簡(jiǎn)單、普通的工具,然后以不同的方式組裝它們來達(dá)到預(yù)期的效果。如果您很熟悉函數(shù)式編程,這看起來會(huì)很親切。Beyond JS 庫(參閱 參考資料)將此理念發(fā)揚(yáng)光大。
清單 9. 函數(shù)式 DOM 實(shí)用工具
// return an Array of all nodes, starting at startNode and
// continuing through the rest of the DOM tree
function listNodes(startNode) {
var list = new Array();
var node = startNode;
while(node) {
list.push(node);
node = nextNode(node);
}
return list;
}
// The same as listNodes(), but works backwards from startNode.
// Note that this is not the same as running listNodes() and
// reversing the list.
function listNodesReversed(startNode) {
var list = new Array();
var node = startNode;
while(node) {
list.push(node);
node = prevNode(node);
}
return list;
}
// apply func to each node in nodeList, return new list of results
function map(list, func) {
var result_list = new Array();
for (var i = 0; i < list.length; i++) {
result_list.push(func(list[i]));
}
return result_list;
}
// apply test to each node, return a new list of nodes for which
// test(node) returns true
function filter(list, test) {
var result_list = new Array();
for (var i = 0; i < list.length; i++) {
if (test(list[i])) result_list.push(list[i]);
}
return result_list;
}
|
清單 9 包含了 4 個(gè)基本工具。listNodes()
和 listNodesReversed()
函數(shù)可以擴(kuò)展到一個(gè)可選的長(zhǎng)度,這與 Array
的 slice()
方法效果類似,我把這個(gè)作為留給您的練習(xí)。另一個(gè)需要注意的是,map()
和 filter()
函數(shù)是完全通用的,用于處理任何 列表(不只是節(jié)點(diǎn)列表)。現(xiàn)在,我向您展示它們的幾種組合方式。
清單 10. 使用函數(shù)式實(shí)用工具
// A list of all the element names in document order
function isElement(node) {
return node.nodeType == Node.ELEMENT_NODE;
}
function nodeName(node) {
return node.nodeName;
}
var elementNames = map(filter(listNodes(document),isElement), nodeName);
// All the text from the document (ignores CDATA)
function isText(node) {
return node.nodeType == Node.TEXT_NODE;
}
function nodeValue(node) {
return node.nodeValue;
}
var allText = map(filter(listNodes(document), isText), nodeValue);
|
您可以使用這些實(shí)用工具來提取 ID、修改樣式、找到某種節(jié)點(diǎn)并移除,等等。一旦 DOM Traversal and Range API 被廣泛實(shí)現(xiàn),您無需首先構(gòu)建列表,就可以用它們修改 DOM 樹。它們不但功能強(qiáng)大,并且工作方式也與我在上面所強(qiáng)調(diào)的方式類似。
DOM 的危險(xiǎn)地帶
注意,核心 DOM API 并不能使您將 XML 數(shù)據(jù)解析到 DOM,或者將 DOM 序列化為 XML。這些功能都定義在 DOM Level 3 的擴(kuò)展部分“Load and Save”,但它們還沒有被完全實(shí)現(xiàn),因此現(xiàn)在不要考慮這些。每個(gè)平臺(tái)(瀏覽器或其他專業(yè) DOM 應(yīng)用程序)有自己在 DOM 和 XML 間轉(zhuǎn)換的方法,但跨平臺(tái)轉(zhuǎn)換不在本文討論范圍之內(nèi)。
DOM 并不是十分安全的工具 —— 特別是使用 DOM API 創(chuàng)建不能作為 XML 序列化的樹時(shí)。絕對(duì)不要在同一個(gè)程序中混合使用 DOM1 非名稱空間 API 和 DOM2 名稱空間感知的 API(例如,createElement
和 createElementNS
)。如果您使用名稱空間,請(qǐng)盡量在根元素位置聲明所有名稱空間,并且不要覆蓋名稱空間前綴,否則情況會(huì)非常混亂。一般來說,只要按照慣例,就不會(huì)觸發(fā)使您陷入麻煩的臨界情況。
如果您一直使用 Internet Explorer 的 innerText
和 innerHTML
進(jìn)行解析,那么您可以試試使用 elem()
函數(shù)。通過構(gòu)建類似的一些實(shí)用工具,您會(huì)得到更多便利,并且繼承了跨平臺(tái)代碼的優(yōu)越性。將這兩種方法混合使用是非常糟糕的。
某些 Unicode 字符并沒有包含在 XML 中。DOM 的實(shí)現(xiàn)使您可以添加它們,但后果是無法序列化。這些字符包括大多數(shù)的控制字符和 Unicode 代理對(duì)(surrogate pair)中的單個(gè)字符。只有您試圖在文檔中包含二進(jìn)制數(shù)據(jù)時(shí)才會(huì)遇到這種情況,但這是另一種轉(zhuǎn)向(gotcha)情況。
結(jié)束語
我已經(jīng)介紹了 DOM 能做的很多事情,但是 DOM(和 JavaScript)可以做的事情遠(yuǎn)不止這些。仔細(xì)研究、揣摩這些例子,看看是如何使用它們來解決可能需要客戶端腳本、模板或?qū)S?API 的問題。
DOM 有自己的局限性和缺點(diǎn),但同時(shí)也擁有眾多優(yōu)點(diǎn):它內(nèi)置于很多應(yīng)用程序中;無論使用 Java 技術(shù)、Python 或 JavaScript,它都以相同方式工作;它非常便于使用 SAX;使用上述的模板,它使用起來既簡(jiǎn)潔又強(qiáng)大。越來越多的應(yīng)用程序開始支持 DOM,這包括基于 Mozilla 的應(yīng)用程序、OpenOffice 和 Blast Radius 的 XMetaL。越來越多的規(guī)范需要 DOM,并對(duì)它加以擴(kuò)展(例如,SVG),因此 DOM 時(shí)時(shí)刻刻就在您的身邊。使用這種被廣泛部署的工具,絕對(duì)是您的明智之舉。
參考資料
1、控制"縱打"、?橫打”和“頁面的邊距。?
(1)<script?defer>?
function?SetPrintSettings()?{?
//?--?advanced?features?
factory.printing.SetMarginMeasure(2)?//?measure?margins?in?inches?
factory.SetPageRange(false,?1,?3)?//?need?pages?from?1?to?3?
factory.printing.printer?=?"HP?DeskJet?870C"?
factory.printing.copies?=?2?
factory.printing.collate?=?true?
factory.printing.paperSize?=?"A4"?
factory.printing.paperSource?=?"Manual?feed"?
//?--?basic?features?
factory.printing.header?=?"This?is?MeadCo"?
factory.printing.footer?=?"Advanced?Printing?by?scriptX"?
factory.printing.portrait?=?false?
factory.printing.leftMargin?=?1.0?
factory.printing.topMargin?=?1.0?
factory.printing.rightMargin?=?1.0?
factory.printing.bottomMargin?=?1.0?
}?
</script>?
(2)?
<script?language="javascript">?
function?printsetup(){?
//?打印頁面設(shè)置?
wb.execwb(8,1);?
}?
function?printpreview(){?
//?打印頁面預(yù)覽?
?
wb.execwb(7,1);?
?
?
}?
function?printit()?
{?
if?(confirm(''確定打印嗎?''))?{?
wb.execwb(6,6)?
}?
}?
</script>?
</head>?
<body>?
<OBJECT?classid="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2"?
height=0?id=wb?name=wb?width=0></OBJECT>?
<input?type=button?name=button_print?value="打印"?
onclick="javascript:printit()">?
<input?type=button name=button_setup?value="打印頁面設(shè)置"?
onclick="javascript:printsetup();">?
<input?type=button name=button_show?value="打印預(yù)覽"?
onclick="javascript:printpreview();">?
<input?type=button?name=button_fh?value="關(guān)閉"?
onclick="javascript:window.close();">?
------------------------------------------------?
關(guān)于這個(gè)組件還有其他的用法,列舉如下:?
WebBrowser.ExecWB(1,1)?打開?
Web.ExecWB(2,1)?關(guān)閉現(xiàn)在所有的IE窗口,并打開一個(gè)新窗口?
Web.ExecWB(4,1)?保存網(wǎng)頁?
Web.ExecWB(6,1)?打印?
Web.ExecWB(7,1)?打印預(yù)覽?
Web.ExecWB(8,1)?打印頁面設(shè)置?
Web.ExecWB(10,1)?查看頁面屬性?
Web.ExecWB(15,1)?好像是撤銷,有待確認(rèn)?
Web.ExecWB(17,1)?全選?
Web.ExecWB(22,1)?刷新?
Web.ExecWB(45,1)?關(guān)閉窗體無提示?
2、分頁打印?
<HTML>?
<HEAD>?
<STYLE> ?
P?{page-break-after:?always}?
</STYLE>?
</HEAD>?
<BODY>?
<%while?not?rs.eof%>?
<P><%=rs(0)%></P>?
<%rs.movenext%>?
<%wend%>?
</BODY>?
</HTML>?
3、ASP頁面打印時(shí)如何去掉頁面底部的路徑和頂端的頁碼編號(hào)?
(1)ie的文件-〉頁面設(shè)置-〉講里面的頁眉和頁腳里面的東西都去掉,打印就不出來了。?
(2)<HTML>?
<HEAD>?
<TITLE>?New?Document?</TITLE>?
<META?NAME="Generator"?CONTENT="EditPlus">?
<META?NAME="Author"?CONTENT="YC">?
<script?language="VBscript">?
dim?hkey_root,hkey_path,hkey_key?
hkey_root="HKEY_CURRENT_USER"?
hkey_path="\Software\Microsoft\Internet?Explorer\PageSetup"?
''//設(shè)置網(wǎng)頁打印的頁眉頁腳為空?
function?pagesetup_null()?
on?error?resume?next?
Set?RegWsh?=?CreateObject("Wscript.Shell")?
hkey_key="\header" ?
RegWsh.RegWrite?hkey_root+hkey_path+hkey_key,""?
hkey_key="\footer"?
RegWsh.RegWrite?hkey_root+hkey_path+hkey_key,""?
end?function?
''//設(shè)置網(wǎng)頁打印的頁眉頁腳為默認(rèn)值?
function?pagesetup_default()?
on?error?resume?next?
Set?RegWsh?=?CreateObject("Wscript.Shell")?
hkey_key="\header" ?
RegWsh.RegWrite?hkey_root+hkey_path+hkey_key,"&w&b頁碼,&p/&P"?
hkey_key="\footer"?
RegWsh.RegWrite?hkey_root+hkey_path+hkey_key,"&u&b&d"?
end?function?
</script>?
</HEAD>?
<BODY>?
<br/>?
<br/>?
<br/>?
<br/>?
<br/>?
<br/><p?align=center>?
<input?type="button"?value="清空頁碼"?onclick=pagesetup_null()>?<input?type="button"?value="恢復(fù)頁嗎"?onclick=pagesetup_default()><br/>?
</p>?
</BODY>?
</HTML>?
4、浮動(dòng)幀打印?
<script?LANGUAGE=javascript>?
function?button1_onclick()?{?
var?odoc=window.iframe1.document;?
var?r=odoc.body.createTextRange();?
var?stxt=r.htmlText;?
alert(stxt)?
var?pwin=window.open("","print");?
pwin.document.write(stxt);?
pwin.print();?
}?
</script>?
4、用FileSystem組件實(shí)現(xiàn)WEB應(yīng)用中的本地特定打印?
<script?Language=VBscript>?
function?print_onclick?//打印函數(shù)?
dim?label?
label=document.printinfo.label.value?//獲得HTML頁面的數(shù)據(jù)?
set?objfs=CreateObject("scripting.FileSystemObject")?//創(chuàng)建FileSystem組件對(duì)象的實(shí)例?
set?objprinter=objfs.CreateTextFile?("LPT1:",true)?//建立與打印機(jī)的連接?
objprinter.Writeline("__________________________________")?//輸出打印的內(nèi)容?
objprinter.Writeline("|?|")?
objprinter.Writeline("|?您打印的數(shù)據(jù)是:"&label&?"?|”)?
objprinter.Writeline("|?|")?
objprinter.Writeline("|_________________________________|")?
objprinter.close?//斷開與打印機(jī)的連接?
set?objprinter=nothing?
set?objfs=nothing?//?關(guān)閉FileSystem組件對(duì)象?
end?function?
</script>?
服務(wù)器端腳本:?
<%………?
set?conn=server.CreateObject?("adodb.connection")?
conn.Open?"DSN=name;UID=XXXX;PWD=XXXX;"?
set?rs=server.CreateObject("adodb.recordset")?
rs.Open(“select?……”),conn,1,1?
……….%>?//與數(shù)據(jù)庫進(jìn)行交互?
HTML頁面編碼:?
<HTML>?
………?
<FORM?ID=printinfo?NAME="printinfo"?>?
<INPUT?type="button"?value="打印>>"?id=print?name=print?>?//調(diào)用打印函數(shù)?
<INPUT?type=hidden?id=text1?name=label?value=<%=………%>>?//保存服務(wù)器端傳來的數(shù)據(jù)?
………?
</HTML>
摘要: 在閱讀此文之前請(qǐng)你熟悉一些IOC的知識(shí),同時(shí)了解AOP的概念。
在
Spring
中所有的通知都是以
Java
類的形式編寫的。
Spring
是采用運(yùn)行期的方式來將切面織入到系統(tǒng)中的。
代理
Bean
只有在第一次被應(yīng)用系統(tǒng)需要的時(shí)候才被創(chuàng)建。
...
閱讀全文
在開發(fā)ejb之前,我們先得配置好服務(wù)器,我使用的是Weblogic9.0中文版,關(guān)于Weblogic9.0配置請(qǐng)看我的另一片文章。
配置Weblogic9.0???
??? 首先需要配置好eclipse。我這里主要說明weblogic的配置。
????

???
注意JDK選擇JDK5.0的版本。???
??? 順便將weblogic8的配置也貼上來,供大家比較參考
???

???
???
注意weblogic8的JDK版本必須是JDK1.4。???
??? 接下來就開始我們的開發(fā)了。





下面就是SessionBean的代碼

30
?1?package?com.ejb;
?2?
?3?import?java.rmi.RemoteException;
?4?
?5?import?javax.ejb.EJBException;
?6?import?javax.ejb.SessionBean;
?7?import?javax.ejb.SessionContext;
?8?
?9?/**
10??*?XDoclet-based?session?bean.??The?class?must?be?declared
11??*?public?according?to?the?EJB?specification.
12??*
13??*?To?generate?the?EJB?related?files?to?this?EJB:
14??*????????-?Add?Standard?EJB?module?to?XDoclet?project?properties
15??*????????-?Customize?XDoclet?configuration?for?your?appserver
16??*????????-?Run?XDoclet
17??*
18??*?Below?are?the?xdoclet-related?tags?needed?for?this?EJB.
19??*?
20??*?@ejb.bean?name="HelloWorld"
21??*???????????display-name="Name?for?HelloWorld"
22??*???????????description="Description?for?HelloWorld"
23??*???????????jndi-name="ejb/HelloWorld"
24??*???????????type="Stateless"
25??*???????????view-type="remote"
26??*/
27?public?class?HelloWorld?implements?SessionBean?{
28?
29?????/**?The?session?context?*/
30?????private?SessionContext?context;
31?
32?????public?HelloWorld()?{
33?????????super();
34?????????//?TODO?自動(dòng)生成構(gòu)造函數(shù)存根
35?????}
36?
37?????/**
38??????*?Set?the?associated?session?context.?The?container?calls?this?method?
39??????*?after?the?instance?creation.
40??????*?
41??????*?The?enterprise?bean?instance?should?store?the?reference?to?the?context?
42??????*?object?in?an?instance?variable.
43??????*?
44??????*?This?method?is?called?with?no?transaction?context.?
45??????*?
46??????*?@throws?EJBException?Thrown?if?method?fails?due?to?system-level?error.
47??????*/
48?????public?void?setSessionContext(SessionContext?newContext)
49?????????throws?EJBException?{
50?????????context?=?newContext;
51?????}
52?
53?????public?void?ejbRemove()?throws?EJBException,?RemoteException?{
54?????????//?TODO?自動(dòng)生成方法存根
55?
56?????}
57?
58?????public?void?ejbActivate()?throws?EJBException,?RemoteException?{
59?????????//?TODO?自動(dòng)生成方法存根
60?
61?????}
62?
63?????public?void?ejbPassivate()?throws?EJBException,?RemoteException?{
64?????????//?TODO?自動(dòng)生成方法存根
65?
66?????}
67?
68?????/**
69??????*?An?example?business?method
70??????*
71??????*?@ejb.interface-method?view-type?=?"remote"
72??????*?
73??????*?@throws?EJBException?Thrown?if?method?fails?due?to?system-level?error.
74??????*/
75?????public?String?hello()?throws?EJBException?{
76?????????//?rename?and?start?putting?your?business?logic?here
77?????????return?new?String("HelloEJBWorld!");
78?????}
79?
80?}
81?其實(shí)就是修改了其中的一個(gè)方法:
?1?/**
?2??????*?An?example?business?method
?3??????*
?4??????*?@ejb.interface-method?view-type?=?"remote"
?5??????*?
?6??????*?@throws?EJBException?Thrown?if?method?fails?due?to?system-level?error.
?7??????*/
?8?????public?String?hello()?throws?EJBException?{
?9?????????//?rename?and?start?putting?your?business?logic?here
10?????????return?new?String("HelloEJBWorld!");
11?????}
注意:代碼中的解釋文字不要?jiǎng)h除,因?yàn)閄Doclet需要。配置屬性

添加weblogic.jar。我的路徑是:bea\weblogic90\server\lib\weblogic.jar










就下來寫EJBTest類:
?1?package?com;
?2?
?3?import?java.rmi.RemoteException;
?4?import?java.util.Properties;
?5?
?6?import?javax.ejb.CreateException;
?7?import?javax.naming.Context;
?8?import?javax.naming.InitialContext;
?9?import?javax.naming.NamingException;
10?
11?import?com.interfaces.HelloWorld;
12?import?com.interfaces.HelloWorldHome;
13?
14?public?class?EJBTest?{
15?
16?????/**
17??????*?@param?args
18??????*/
19?????public?static?void?main(String[]?args)?{
20?????????//?TODO?自動(dòng)生成方法存根
21?????????Properties?properties=new?Properties();
22?????????properties.setProperty(Context.INITIAL_CONTEXT_FACTORY,"weblogic.jndi.WLInitialContextFactory");
23?????????properties.setProperty(Context.PROVIDER_URL,"t3://localhost:7001");
24?????????
25?????????Context?context;
26?????????try?{
27?????????????context?=?new?InitialContext(properties);
28?????????????HelloWorldHome?hwh=(HelloWorldHome)context.lookup("ejb/HelloWorld");
29?????????????HelloWorld?hw=hwh.create();
30?????????????String?s=hw.hello();
31?????????????System.out.println(s);
32?????????}?catch?(NamingException?e)?{
33?????????????//?TODO?自動(dòng)生成?catch?塊
34?????????????e.printStackTrace();
35?????????}?catch?(RemoteException?e)?{
36?????????????//?TODO?自動(dòng)生成?catch?塊
37?????????????e.printStackTrace();
38?????????}?catch?(CreateException?e)?{
39?????????????//?TODO?自動(dòng)生成?catch?塊
40?????????????e.printStackTrace();
41?????????}
42?????????
43?????}
44?
45?
46?}
47?
最后就是看結(jié)果了,先啟動(dòng)weblogic,然后運(yùn)行EJBTest程序。
SQLServer和Oracle是大家經(jīng)常用到的數(shù)據(jù)庫,在此感謝作者總結(jié)出這些常用函數(shù)以供大家參考。
數(shù)學(xué)函數(shù):
1.絕對(duì)值
S:select abs(-1) value
O:select abs(-1) value from dual
2.取整(大)
S:select ceiling(-1.001) value
O:select ceil(-1.001) value from dual
3.取整(小)
S:select floor(-1.001) value
O:select floor(-1.001) value from dual
4.取整(截取)
S:select cast(-1.002 as int) value
O:select trunc(-1.002) value from dual
5.四舍五入
S:select round(1.23456,4) value 1.23460
O:select round(1.23456,4) value from dual 1.2346
6.e為底的冪
S:select Exp(1) value 2.7182818284590451
O:select Exp(1) value from dual 2.71828182
7.取e為底的對(duì)數(shù)
S:select log(2.7182818284590451) value 1
O:select ln(2.7182818284590451) value from dual; 1
8.取10為底對(duì)數(shù)
S:select log10(10) value 1
O:select log(10,10) value from dual; 1
9.取平方
S:select SQUARE(4) value 16
O:select power(4,2) value from dual 16
10.取平方根
S:select SQRT(4) value 2
O:select SQRT(4) value from dual 2
11.求任意數(shù)為底的冪
S:select power(3,4) value 81
O:select power(3,4) value from dual 81
12.取隨機(jī)數(shù)
S:select rand() value
O:select sys.dbms_random.value(0,1) value from dual;
13.取符號(hào)
S:select sign(-8) value -1
O:select sign(-8) value from dual -1
14.圓周率
S:SELECT PI() value 3.1415926535897931
O:不知道
15.sin,cos,tan 參數(shù)都以弧度為單位
例如:select sin(PI()/2) value 得到1(SQLServer)
16.Asin,Acos,Atan,Atan2 返回弧度
17.弧度角度互換(SQLServer,Oracle不知道)
DEGREES:弧度-〉角度
RADIANS:角度-〉弧度
數(shù)值間比較:
18. 求集合最大值
S:select max(value) value from
(select 1 value
union
select -2 value
union
select 4 value
union
select 3 value)a
O:select greatest(1,-2,4,3) value from dual
19. 求集合最小值
S:select min(value) value from
(select 1 value
union
select -2 value
union
select 4 value
union
select 3 value)a
O:select least(1,-2,4,3) value from dual
20.如何處理null值(F2中的null以10代替)
S:select F1,IsNull(F2,10) value from Tbl
O:select F1,nvl(F2,10) value from Tbl
21.求字符序號(hào)
S:select ascii('a') value
O:select ascii('a') value from dual
22.從序號(hào)求字符
S:select char(97) value
O:select chr(97) value from dual
23.連接
S:select '11'+'22'+'33' value
O:select CONCAT('11','22') 33 value from dual
23.子串位置 --返回3
S:select CHARINDEX('s','sdsq',2) value
O:select INSTR('sdsq','s',2) value from dual
23.模糊子串的位置 --返回2,參數(shù)去掉中間%則返回7
S:select patindex('%d%q%','sdsfasdqe') value
O:oracle沒發(fā)現(xiàn),但是instr可以通過第四個(gè)參數(shù)控制出現(xiàn)次數(shù)
select INSTR('sdsfasdqe','sd',1,2) value from dual 返回6
24.求子串
S:select substring('abcd',2,2) value
O:select substr('abcd',2,2) value from dual
25.子串代替 返回aijklmnef
S:SELECT STUFF('abcdef', 2, 3, 'ijklmn') value
O:SELECT Replace('abcdef', 'bcd', 'ijklmn') value from dual
26.子串全部替換
S:沒發(fā)現(xiàn)
O:select Translate('fasdbfasegas','fa','我' ) value from dual
27.長(zhǎng)度
S:len,datalength
O:length
28.大小寫轉(zhuǎn)換 lower,upper
29.單詞首字母大寫
S:沒發(fā)現(xiàn)
O:select INITCAP('abcd dsaf df') value from dual
30.左補(bǔ)空格(LPAD的第一個(gè)參數(shù)為空格則同space函數(shù))
S:select space(10)+'abcd' value
O:select LPAD('abcd',14) value from dual
31.右補(bǔ)空格(RPAD的第一個(gè)參數(shù)為空格則同space函數(shù))
S:select 'abcd'+space(10) value
O:select RPAD('abcd',14) value from dual
32.刪除空格
S:ltrim,rtrim
O:ltrim,rtrim,trim
33. 重復(fù)字符串
S:select REPLICATE('abcd',2) value
O:沒發(fā)現(xiàn)
34.發(fā)音相似性比較(這兩個(gè)單詞返回值一樣,發(fā)音相同)
S:SELECT SOUNDEX ('Smith'), SOUNDEX ('Smythe')
O:SELECT SOUNDEX ('Smith'), SOUNDEX ('Smythe') from dual
SQLServer中用SELECT DIFFERENCE('Smithers', 'Smythers') 比較soundex的差
返回0-4,4為同音,1最高
日期函數(shù):
35.系統(tǒng)時(shí)間
S:select getdate() value
O:select sysdate value from dual
36.前后幾日
直接與整數(shù)相加減
37.求日期
S:select convert(char(10),getdate(),20) value
O:select trunc(sysdate) value from dual
select to_char(sysdate,'yyyy-mm-dd') value from dual
38.求時(shí)間
S:select convert(char(8),getdate(),108) value
O:select to_char(sysdate,'hh24:mm:ss') value from dual
39.取日期時(shí)間的其他部分
S:DATEPART 和 DATENAME 函數(shù) (第一個(gè)參數(shù)決定)
O:to_char函數(shù) 第二個(gè)參數(shù)決定
參數(shù)---------------------------------下表需要補(bǔ)充
year yy, yyyy
quarter qq, q (季度)
month mm, m (m O無效)
dayofyear dy, y (O表星期)
day dd, d (d O無效)
week wk, ww (wk O無效)
weekday dw (O不清楚)
Hour hh,hh12,hh24 (hh12,hh24 S無效)
minute mi, n (n O無效)
second ss, s (s O無效)
millisecond ms (O無效)
----------------------------------------------
40.當(dāng)月最后一天
S:不知道
O:select LAST_DAY(sysdate) value from dual
41.本星期的某一天(比如星期日)
S:不知道
O:SELECT Next_day(sysdate,7) vaule FROM DUAL;
42.字符串轉(zhuǎn)時(shí)間
S:可以直接轉(zhuǎn)或者select cast('2004-09-08'as datetime) value
O:SELECT To_date('2004-01-05 22:09:38','yyyy-mm-dd hh24-mi-ss') vaule FROM DUAL;
43.求兩日期某一部分的差(比如秒)
S:select datediff(ss,getdate(),getdate()+12.3) value
O:直接用兩個(gè)日期相減(比如d1-d2=12.3)
SELECT (d1-d2)*24*60*60 vaule FROM DUAL;
44.根據(jù)差值求新的日期(比如分鐘)
S:select dateadd(mi,8,getdate()) value
O:SELECT sysdate+8/60/24 vaule FROM DUAL;
45.求不同時(shí)區(qū)時(shí)間
S:不知道
O:SELECT New_time(sysdate,'ydt','gmt' ) vaule FROM DUAL;
-----時(shí)區(qū)參數(shù),北京在東8區(qū)應(yīng)該是Ydt-------
AST ADT 大西洋標(biāo)準(zhǔn)時(shí)間
BST BDT 白令海標(biāo)準(zhǔn)時(shí)間
CST CDT 中部標(biāo)準(zhǔn)時(shí)間
EST EDT 東部標(biāo)準(zhǔn)時(shí)間
GMT 格林尼治標(biāo)準(zhǔn)時(shí)間
HST HDT 阿拉斯加?夏威夷標(biāo)準(zhǔn)時(shí)間
MST MDT 山區(qū)標(biāo)準(zhǔn)時(shí)間
NST 紐芬蘭標(biāo)準(zhǔn)時(shí)間
PST PDT 太平洋標(biāo)準(zhǔn)時(shí)間
YST YDT YUKON標(biāo)準(zhǔn)時(shí)間
在講外連接之前,先舉例介紹內(nèi)連接,也就是一般的相等連接。
select * from a, b where a.id = b.id;
???? 對(duì)于外連接,Oracle中可以使用“(+)”來表示,9i可以使用LEFT/RIGHT/FULL OUTER JOIN,下面將配合實(shí)例一一介紹。
1. LEFT OUTER JOIN:左外關(guān)聯(lián)
SELECT e.last_name, e.department_id, d.department_name?
FROM employees e?
LEFT OUTER JOIN departments d?
ON (e.department_id = d.department_id);
?
等價(jià)于
SELECT e.last_name, e.department_id, d.department_name?
FROM employees e, departments d?
WHERE e.department_id=d.department_id(+);
?
結(jié)果為:所有員工及對(duì)應(yīng)部門的記錄,包括沒有對(duì)應(yīng)部門編號(hào)department_id的員工記錄。
2. RIGHT OUTER JOIN:右外關(guān)聯(lián)
SELECT e.last_name, e.department_id, d.department_name?
FROM employees e?
RIGHT OUTER JOIN departments d?
ON (e.department_id = d.department_id);
?
等價(jià)于
SELECT e.last_name, e.department_id, d.department_name?
FROM employees e, departments d?
WHERE e.department_id(+)=d.department_id;
?
結(jié)果為:所有員工及對(duì)應(yīng)部門的記錄,包括沒有任何員工的部門記錄。
3. FULL OUTER JOIN:全外關(guān)聯(lián)
SELECT e.last_name, e.department_id, d.department_name?
FROM employees e?
FULL OUTER JOIN departments d?
ON (e.department_id = d.department_id);
?
結(jié)果為:所有員工及對(duì)應(yīng)部門的記錄,包括沒有對(duì)應(yīng)部門編號(hào)department_id的員工記錄和沒有任何員工的部門記錄。
你的SID應(yīng)該是你的數(shù)據(jù)庫所在的SID呀,你可以用sqlplus登陸到服務(wù)器
$sqlplus / as sysdba
SQL> select * from v$instance;
看一下你的機(jī)器正在跑的SID的名字是什么
TO_DATE格式?
Day:?
dd?number?12?
dy?abbreviated?fri?
day?spelled?out?friday?
ddspth?spelled?out,?ordinal?twelfth?
Month:?
mm?number?03?
mon?abbreviated?mar?
month?spelled?out?march?
Year:?
yy?two?digits?98?
yyyy?four?digits?1998?
24小時(shí)格式下時(shí)間范圍為:?0:00:00?-?23:59:59....?
12小時(shí)格式下時(shí)間范圍為:?1:00:00?-?12:59:59?....?
1.?
日期和字符轉(zhuǎn)換函數(shù)用法(to_date,to_char)?
2.?
select?to_char(?to_date(222,'J'),'Jsp')?from?dual?
顯示Two?Hundred?Twenty-Two?
3.?
求某天是星期幾?
select?to_char(to_date('2002-08-26','yyyy-mm-dd'),'day')?from?dual;?
星期一?
select?to_char(to_date('2002-08-26','yyyy-mm-dd'),'day','NLS_DATE_LANGUAGE?=?American')?from?dual;?
monday?
設(shè)置日期語言?
ALTER?SESSION?SET?NLS_DATE_LANGUAGE='AMERICAN';?
也可以這樣?
TO_DATE?('2002-08-26',?'YYYY-mm-dd',?'NLS_DATE_LANGUAGE?=?American')?
4.?
兩個(gè)日期間的天數(shù)?
select?floor(sysdate?-?to_date('20020405','yyyymmdd'))?from?dual;?
5.?時(shí)間為null的用法?
select?id,?active_date?from?table1?
UNION?
select?1,?TO_DATE(null)?from?dual;?
注意要用TO_DATE(null)?
6.?
a_date?between?to_date('20011201','yyyymmdd')?and?to_date('20011231','yyyymmdd')?
那么12月31號(hào)中午12點(diǎn)之后和12月1號(hào)的12點(diǎn)之前是不包含在這個(gè)范圍之內(nèi)的。?
所以,當(dāng)時(shí)間需要精確的時(shí)候,覺得to_char還是必要的?
7.?日期格式?jīng)_突問題?
輸入的格式要看你安裝的ORACLE字符集的類型,?比如:?US7ASCII,?date格式的類型就是:?'01-Jan-01'?
alter?system?set?NLS_DATE_LANGUAGE?=?American?
alter?session?set?NLS_DATE_LANGUAGE?=?American?
或者在to_date中寫?
select?to_char(to_date('2002-08-26','yyyy-mm-dd'),'day','NLS_DATE_LANGUAGE?=?American')?from?dual;?
注意我這只是舉了NLS_DATE_LANGUAGE,當(dāng)然還有很多,?
可查看?
select?*?from?nls_session_parameters?
select?*?from?V$NLS_PARAMETERS?
8.?
select?count(*)?
from?(?select?rownum-1?rnum?
from?all_objects?
where?rownum?<=?to_date('2002-02-28','yyyy-mm-dd')?-?to_date('2002-?
02-01','yyyy-mm-dd')+1?
)?
where?to_char(?to_date('2002-02-01','yyyy-mm-dd')+rnum-1,?'D'?)?
not?
in?(?'1',?'7'?)?
查找2002-02-28至2002-02-01間除星期一和七的天數(shù)?
在前后分別調(diào)用DBMS_UTILITY.GET_TIME,?讓后將結(jié)果相減(得到的是1/100秒,?而不是毫秒).?
9.?
select?months_between(to_date('01-31-1999','MM-DD-YYYY'),?
to_date('12-31-1998','MM-DD-YYYY'))?"MONTHS"?FROM?DUAL;?
1?
select?months_between(to_date('02-01-1999','MM-DD-YYYY'),?
to_date('12-31-1998','MM-DD-YYYY'))?"MONTHS"?FROM?DUAL;?
1.03225806451613?
10.?Next_day的用法?
Next_day(date,?day)?
Monday-Sunday,?for?format?code?DAY?
Mon-Sun,?for?format?code?DY?
1-7,?for?format?code?D?
11?
select?to_char(sysdate,'hh:mi:ss')?TIME?from?all_objects?
注意:第一條記錄的TIME?與最后一行是一樣的?
可以建立一個(gè)函數(shù)來處理這個(gè)問題?
create?or?replace?function?sys_date?return?date?is?
begin?
return?sysdate;?
end;?
select?to_char(sys_date,'hh:mi:ss')?from?all_objects;?
12.?
獲得小時(shí)數(shù)?
SELECT?EXTRACT(HOUR?FROM?TIMESTAMP?'2001-02-16?2:38:40')?from?offer?
SQL>?select?sysdate?,to_char(sysdate,'hh')?from?dual;?
SYSDATE?TO_CHAR(SYSDATE,'HH')?
--------------------?---------------------?
2003-10-13?19:35:21?07?
SQL>?select?sysdate?,to_char(sysdate,'hh24')?from?dual;?
SYSDATE?TO_CHAR(SYSDATE,'HH24')?
--------------------?-----------------------?
2003-10-13?19:35:21?19?
獲取年月日與此類似?
13.?
年月日的處理?
select?older_date,?
newer_date,?
years,?
months,?
abs(?
trunc(?
newer_date-?
add_months(?older_date,years*12+months?)?
)?
)?days?
from?(?select?
trunc(months_between(?newer_date,?older_date?)/12)?YEARS,?
mod(trunc(months_between(?newer_date,?older_date?)),?
12?)?MONTHS,?
newer_date,?
older_date?
from?(?select?hiredate?older_date,?
add_months(hiredate,rownum)+rownum?newer_date?
from?emp?)?
)?
14.?
處理月份天數(shù)不定的辦法?
select?to_char(add_months(last_day(sysdate)?+1,?-2),?'yyyymmdd'),last_day(sysdate)?from?dual?
16.?
找出今年的天數(shù)?
select?add_months(trunc(sysdate,'year'),?12)?-?trunc(sysdate,'year')?from?dual?
閏年的處理方法?
to_char(?last_day(?to_date('02'?||?:year,'mmyyyy')?),?'dd'?)?
如果是28就不是閏年?
17.?
yyyy與rrrr的區(qū)別?
'YYYY99?TO_C?
-------?----?
yyyy?99?0099?
rrrr?99?1999?
yyyy?01?0001?
rrrr?01?2001?
18.不同時(shí)區(qū)的處理?
select?to_char(?NEW_TIME(?sysdate,?'GMT','EST'),?'dd/mm/yyyy?hh:mi:ss')?,sysdate?
from?dual;?
19.?
5秒鐘一個(gè)間隔?
Select?TO_DATE(FLOOR(TO_CHAR(sysdate,'SSSSS')/300)?*?300,'SSSSS')?,TO_CHAR(sysdate,'SSSSS')?
from?dual?
2002-11-1?9:55:00?35786?
SSSSS表示5位秒數(shù)?
20.?
一年的第幾天?
select?TO_CHAR(SYSDATE,'DDD'),sysdate?from?dual?
310?2002-11-6?10:03:51?
21.計(jì)算小時(shí),分,秒,毫秒?
select?
Days,?
A,?
TRUNC(A*24)?Hours,?
TRUNC(A*24*60?-?60*TRUNC(A*24))?Minutes,?
TRUNC(A*24*60*60?-?60*TRUNC(A*24*60))?Seconds,?
TRUNC(A*24*60*60*100?-?100*TRUNC(A*24*60*60))?mSeconds?
from?
(?
select?
trunc(sysdate)?Days,?
sysdate?-?trunc(sysdate)?A?
from?dual?
)?
select?*?from?tabname?
order?by?decode(mode,'FIFO',1,-1)*to_char(rq,'yyyymmddhh24miss');?
//?
floor((date2-date1)?/365)?作為年?
floor((date2-date1,?365)?/30)?作為月?
mod(mod(date2-date1,?365),?30)作為日.?
23.next_day函數(shù)?
next_day(sysdate,6)是從當(dāng)前開始下一個(gè)星期五。后面的數(shù)字是從星期日開始算起。
轉(zhuǎn)載)[TOMCAT]用web.xml控制Web應(yīng)用的行為
1 定義頭和根元素
部署描述符文件就像所有XML文件一樣,必須以一個(gè)XML頭開始。這個(gè)頭聲明可以使用的XML版本并給出文件的字符編碼。
DOCYTPE聲明必須立即出現(xiàn)在此頭之后。這個(gè)聲明告訴服務(wù)器適用的servlet規(guī)范的版本(如2.2或2.3)并指定管理此文件其余部分內(nèi)容的語法的DTD(Document Type Definition,文檔類型定義)。
所有部署描述符文件的頂層(根)元素為web-app。請(qǐng)注意,XML元素不像HTML,他們是大小寫敏感的。因此,web-App和WEB-APP都是不合法的,web-app必須用小寫。
2 部署描述符文件內(nèi)的元素次序
XML 元素不僅是大小寫敏感的,而且它們還對(duì)出現(xiàn)在其他元素中的次序敏感。例如,XML頭必須是文件中的第一項(xiàng),DOCTYPE聲明必須是第二項(xiàng),而web- app元素必須是第三項(xiàng)。在web-app元素內(nèi),元素的次序也很重要。服務(wù)器不一定強(qiáng)制要求這種次序,但它們?cè)试S(實(shí)際上有些服務(wù)器就是這樣做的)完全拒絕執(zhí)行含有次序不正確的元素的Web應(yīng)用。這表示使用非標(biāo)準(zhǔn)元素次序的web.xml文件是不可移植的。
下面的列表給出了所有可直接出現(xiàn)在web-app元素內(nèi)的合法元素所必需的次序。例如,此列表說明servlet元素必須出現(xiàn)在所有servlet-mapping元素之前。請(qǐng)注意,所有這些元素都是可選的。因此,可以省略掉某一元素,但不能把它放于不正確的位置。
l icon icon元素指出IDE和GUI工具用來表示W(wǎng)eb應(yīng)用的一個(gè)和兩個(gè)圖像文件的位置。
l display-name display-name元素提供GUI工具可能會(huì)用來標(biāo)記這個(gè)特定的Web應(yīng)用的一個(gè)名稱。
l description description元素給出與此有關(guān)的說明性文本。
l context-param context-param元素聲明應(yīng)用范圍內(nèi)的初始化參數(shù)。
l filter 過濾器元素將一個(gè)名字與一個(gè)實(shí)現(xiàn)javax.servlet.Filter接口的類相關(guān)聯(lián)。
l filter-mapping 一旦命名了一個(gè)過濾器,就要利用filter-mapping元素把它與一個(gè)或多個(gè)servlet或JSP頁面相關(guān)聯(lián)。
l listener servlet API的版本2.3增加了對(duì)事件監(jiān)聽程序的支持,事件監(jiān)聽程序在建立、修改和刪除會(huì)話或servlet環(huán)境時(shí)得到通知。Listener元素指出事件監(jiān)聽程序類。
l servlet 在向servlet或JSP頁面制定初始化參數(shù)或定制URL時(shí),必須首先命名servlet或JSP頁面。Servlet元素就是用來完成此項(xiàng)任務(wù)的。
l servlet-mapping 服務(wù)器一般為servlet提供一個(gè)缺省的URL:
http://host/webAppPrefix/servlet/ServletName
。但是,常常會(huì)更改這個(gè)URL,以便servlet可以訪問初始化參數(shù)或更容易地處理相對(duì)URL。在更改缺省URL時(shí),使用servlet-mapping元素。
l session-config 如果某個(gè)會(huì)話在一定時(shí)間內(nèi)未被訪問,服務(wù)器可以拋棄它以節(jié)省內(nèi)存。可通過使用HttpSession的setMaxInactiveInterval方法明確設(shè)置單個(gè)會(huì)話對(duì)象的超時(shí)值,或者可利用session-config元素制定缺省超時(shí)值。
l mime-mapping 如果Web應(yīng)用具有想到特殊的文件,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證。
l welcom-file-list welcome-file-list元素指示服務(wù)器在收到引用一個(gè)目錄名而不是文件名的URL時(shí),使用哪個(gè)文件。
l error-page error-page元素使得在返回特定HTTP狀態(tài)代碼時(shí),或者特定類型的異常被拋出時(shí),能夠制定將要顯示的頁面。
l taglib taglib元素對(duì)標(biāo)記庫描述符文件(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD文件的位置,而不用編輯使用這些文件的JSP頁面。
l resource-env-ref resource-env-ref元素聲明與資源相關(guān)的一個(gè)管理對(duì)象。
l resource-ref resource-ref元素聲明一個(gè)資源工廠使用的外部資源。
l security-constraint security-constraint元素制定應(yīng)該保護(hù)的URL。它與login-config元素聯(lián)合使用
l login-config 用login-config元素來指定服務(wù)器應(yīng)該怎樣給試圖訪問受保護(hù)頁面的用戶授權(quán)。它與sercurity-constraint元素聯(lián)合使用。
l security-role security-role元素給出安全角色的一個(gè)列表,這些角色將出現(xiàn)在servlet元素內(nèi)的security-role-ref元素的role-name子元素中。分別地聲明角色可使高級(jí)IDE處理安全信息更為容易。
l env-entry env-entry元素聲明Web應(yīng)用的環(huán)境項(xiàng)。
l ejb-ref ejb-ref元素聲明一個(gè)EJB的主目錄的引用。
l ejb-local-ref ejb-local-ref元素聲明一個(gè)EJB的本地主目錄的應(yīng)用。
3 分配名稱和定制的UL
在web.xml中完成的一個(gè)最常見的任務(wù)是對(duì)servlet或JSP頁面給出名稱和定制的URL。用servlet元素分配名稱,使用servlet-mapping元素將定制的URL與剛分配的名稱相關(guān)聯(lián)。
3.1 分配名稱
為了提供初始化參數(shù),對(duì)servlet或JSP頁面定義一個(gè)定制URL或分配一個(gè)安全角色,必須首先給servlet或JSP頁面一個(gè)名稱。可通過 servlet元素分配一個(gè)名稱。最常見的格式包括servlet-name和servlet-class子元素(在web-app元素內(nèi)),如下所示:
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
這表示位于WEB-INF/classes/moreservlets/TestServlet的servlet已經(jīng)得到了注冊(cè)名Test。給 servlet一個(gè)名稱具有兩個(gè)主要的含義。首先,初始化參數(shù)、定制的URL模式以及其他定制通過此注冊(cè)名而不是類名引用此servlet。其次,可在 URL而不是類名中使用此名稱。因此,利用剛才給出的定義,URL
http://host/webAppPrefix/servlet/Test
可用于
http://host/webAppPrefix/servlet/moreservlets.TestServlet
的場(chǎng)所。
請(qǐng)記住:XML元素不僅是大小寫敏感的,而且定義它們的次序也很重要。例如,web-app元素內(nèi)所有servlet元素必須位于所有servlet- mapping元素(下一小節(jié)介紹)之前,而且還要位于5.6節(jié)和5.11節(jié)討論的與過濾器或文檔相關(guān)的元素(如果有的話)之前。類似地,servlet 的servlet-name子元素也必須出現(xiàn)在servlet-class之前。5.2節(jié)"部署描述符文件內(nèi)的元素次序"將詳細(xì)介紹這種必需的次序。
例如,程序清單5-1給出了一個(gè)名為TestServlet的簡(jiǎn)單servlet,它駐留在moreservlets程序包中。因?yàn)榇藄ervlet是扎根在一個(gè)名為deployDemo的目錄中的Web應(yīng)用的組成部分,所以TestServlet.class放在deployDemo/WEB- INF/classes/moreservlets中。程序清單5-2給出將放置在deployDemo/WEB-INF/內(nèi)的web.xml文件的一部分。此web.xml文件使用servlet-name和servlet-class元素將名稱Test與TestServlet.class相關(guān)聯(lián)。圖 5-1和圖5-2分別顯示利用缺省URL和注冊(cè)名調(diào)用TestServlet時(shí)的結(jié)果。
程序清單5-1 TestServlet.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
/** Simple servlet used to illustrate servlet naming
* and custom URLs.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
*
http://www.moreservlets.com/.
* ? 2002 Marty Hall; may be freely used or adapted.
*/
public class TestServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String uri = request.getRequestURI();
out.println(ServletUtilities.headWithTitle("Test Servlet") +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>URI: " + uri + "</H2>\n" +
"</BODY></HTML>");
}
}
程序清單5-2 web.xml(說明servlet名稱的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- … -->
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
<!-- … -->
</web-app>
3.2 定義定制的URL
大多數(shù)服務(wù)器具有一個(gè)缺省的serlvet URL:
http://host/webAppPrefix/servlet/packageName.ServletName
。雖然在開發(fā)中使用這個(gè)URL很方便,但是我們常常會(huì)希望另一個(gè)URL用于部署。例如,可能會(huì)需要一個(gè)出現(xiàn)在Web應(yīng)用頂層的URL(如,http: //host/webAppPrefix/Anyname),并且在此URL中沒有servlet項(xiàng)。位于頂層的URL簡(jiǎn)化了相對(duì)URL的使用。此外,對(duì)許多開發(fā)人員來說,頂層URL看上去比更長(zhǎng)更麻煩的缺省URL更簡(jiǎn)短。
事實(shí)上,有時(shí)需要使用定制的URL。比如,你可能想關(guān)閉缺省URL映射,以便更好地強(qiáng)制實(shí)施安全限制或防止用戶意外地訪問無初始化參數(shù)的servlet。如果你禁止了缺省的URL,那么你怎樣訪問servlet呢?這時(shí)只有使用定制的URL了。
為了分配一個(gè)定制的URL,可使用servlet-mapping元素及其servlet-name和url-pattern子元素。Servlet- name元素提供了一個(gè)任意名稱,可利用此名稱引用相應(yīng)的servlet;url-pattern描述了相對(duì)于Web應(yīng)用的根目錄的URL。url- pattern元素的值必須以斜杠(/)起始。
下面給出一個(gè)簡(jiǎn)單的web.xml摘錄,它允許使用URL
http://host/webAppPrefix/UrlTest
而不是
http://host/webAppPrefix/servlet/Test
或
http: //host/webAppPrefix/servlet/moreservlets.TestServlet。請(qǐng)注意,仍然需要XML頭、 DOCTYPE聲明以及web-app封閉元素。此外,可回憶一下,XML元素出現(xiàn)地次序不是隨意的。特別是,需要把所有servlet元素放在所有 servlet-mapping元素之前。
<servlet>
<servlet-name>Test</servlet-name>
<servlet-class>moreservlets.TestServlet</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name>Test</servlet-name>
<url-pattern>/UrlTest</url-pattern>
</servlet-mapping>
URL模式還可以包含通配符。例如,下面的小程序指示服務(wù)器發(fā)送所有以Web應(yīng)用的URL前綴開始,以..asp結(jié)束的請(qǐng)求到名為BashMS的servlet。
<servlet>
<servlet-name>BashMS</servlet-name>
<servlet-class>msUtils.ASPTranslator</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name>BashMS</servlet-name>
<url-pattern>/*.asp</url-pattern>
</servlet-mapping>
3.3 命名JSP頁面
因?yàn)镴SP頁面要轉(zhuǎn)換成sevlet,自然希望就像命名servlet一樣命名JSP頁面。畢竟,JSP頁面可能會(huì)從初始化參數(shù)、安全設(shè)置或定制的URL中受益,正如普通的serlvet那樣。雖然JSP頁面的后臺(tái)實(shí)際上是servlet這句話是正確的,但存在一個(gè)關(guān)鍵的猜疑:即,你不知道JSP頁面的實(shí)際類名(因?yàn)橄到y(tǒng)自己挑選這個(gè)名字)。因此,為了命名JSP頁面,可將jsp-file元素替換為servlet-calss元素,如下所示:
<servlet>
<servlet-name>Test</servlet-name>
<jsp-file>/TestPage.jsp</jsp-file>
</servlet>
命名JSP頁面的原因與命名servlet的原因完全相同:即為了提供一個(gè)與定制設(shè)置(如,初始化參數(shù)和安全設(shè)置)一起使用的名稱,并且,以便能更改激活 JSP頁面的URL(比方說,以便多個(gè)URL通過相同頁面得以處理,或者從URL中去掉.jsp擴(kuò)展名)。但是,在設(shè)置初始化參數(shù)時(shí),應(yīng)該注意,JSP頁面是利用jspInit方法,而不是init方法讀取初始化參數(shù)的。
例如,程序清單5-3給出一個(gè)名為TestPage.jsp的簡(jiǎn)單JSP頁面,它的工作只是打印出用來激活它的URL的本地部分。TestPage.jsp放置在deployDemo應(yīng)用的頂層。程序清單5-4給出了用來分配一個(gè)注冊(cè)名PageName,然后將此注冊(cè)名與
http://host/webAppPrefix/UrlTest2/anything
形式的URL相關(guān)聯(lián)的web.xml文件(即,deployDemo/WEB-INF/web.xml)的一部分。
程序清單5-3 TestPage.jsp
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>
JSP Test Page
</TITLE>
</HEAD>
<BODY BGCOLOR="#FDF5E6">
<H2>URI: <%= request.getRequestURI() %></H2>
</BODY>
</HTML>
程序清單5-4 web.xml(說明JSP頁命名的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/TestPage.jsp</jsp-file>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> PageName </servlet-name>
<url-pattern>/UrlTest2/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>
4 禁止激活器servlet
對(duì)servlet或JSP頁面建立定制URL的一個(gè)原因是,這樣做可以注冊(cè)從 init(servlet)或jspInit(JSP頁面)方法中讀取得初始化參數(shù)。但是,初始化參數(shù)只在是利用定制URL模式或注冊(cè)名訪問 servlet或JSP頁面時(shí)可以使用,用缺省URL
http://host/webAppPrefix/servlet/ServletName
訪問時(shí)不能使用。因此,你可能會(huì)希望關(guān)閉缺省URL,這樣就不會(huì)有人意外地調(diào)用初始化servlet了。這個(gè)過程有時(shí)稱為禁止激活器servlet,因?yàn)槎鄶?shù)服務(wù)器具有一個(gè)用缺省的servlet URL注冊(cè)的標(biāo)準(zhǔn)servlet,并激活缺省的URL應(yīng)用的實(shí)際servlet。
有兩種禁止此缺省URL的主要方法:
l 在每個(gè)Web應(yīng)用中重新映射/servlet/模式。
l 全局關(guān)閉激活器servlet。
重要的是應(yīng)該注意到,雖然重新映射每個(gè)Web應(yīng)用中的/servlet/模式比徹底禁止激活servlet所做的工作更多,但重新映射可以用一種完全可移植的方式來完成。相反,全局禁止激活器servlet完全是針對(duì)具體機(jī)器的,事實(shí)上有的服務(wù)器(如ServletExec)沒有這樣的選擇。下面的討論對(duì)每個(gè)Web應(yīng)用重新映射/servlet/ URL模式的策略。后面提供在Tomcat中全局禁止激活器servlet的詳細(xì)內(nèi)容。
4.1 重新映射/servlet/URL模式
在一個(gè)特定的Web應(yīng)用中禁止以
http://host/webAppPrefix/servlet/
開始的URL的處理非常簡(jiǎn)單。所需做的事情就是建立一個(gè)錯(cuò)誤消息servlet,并使用前一節(jié)討論的url-pattern元素將所有匹配請(qǐng)求轉(zhuǎn)向該 servlet。只要簡(jiǎn)單地使用:
<url-pattern>/servlet/*</url-pattern>
作為servlet-mapping元素中的模式即可。
例如,程序清單5-5給出了將SorryServlet servlet(程序清單5-6)與所有以
http://host/webAppPrefix/servlet/
開頭的URL相關(guān)聯(lián)的部署描述符文件的一部分。
程序清單5-5 web.xml(說明JSP頁命名的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<servlet>
<servlet-name>Sorry</servlet-name>
<servlet-class>moreservlets.SorryServlet</servlet-class>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> Sorry </servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>
程序清單5-6 SorryServlet.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
/** Simple servlet used to give error messages to
* users who try to access default servlet URLs
* (i.e.,
http://host/webAppPrefix/servlet/ServletName
)
* in Web applications that have disabled this
* behavior.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
*
http://www.moreservlets.com/.
* ? 2002 Marty Hall; may be freely used or adapted.
*/
public class SorryServlet extends HttpServlet {
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String title = "Invoker Servlet Disabled.";
out.println(ServletUtilities.headWithTitle(title) +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>" + title + "</H2>\n" +
"Sorry, access to servlets by means of\n" +
"URLs that begin with\n" +
"
http://host/webAppPrefix/servlet/
\n" +
"has been disabled.\n" +
"</BODY></HTML>");
}
public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
4.2 全局禁止激活器:Tomcat
Tomcat 4中用來關(guān)閉缺省URL的方法與Tomcat 3中所用的很不相同。下面介紹這兩種方法:
1.禁止激活器: Tomcat 4
Tomcat 4用與前面相同的方法關(guān)閉激活器servlet,即利用web.xml中的url-mapping元素進(jìn)行關(guān)閉。不同之處在于Tomcat使用了放在 install_dir/conf中的一個(gè)服務(wù)器專用的全局web.xml文件,而前面使用的是存放在每個(gè)Web應(yīng)用的WEB-INF目錄中的標(biāo)準(zhǔn) web.xml文件。
因此,為了在Tomcat 4中關(guān)閉激活器servlet,只需在install_dir/conf/web.xml中簡(jiǎn)單地注釋出/servlet/* URL映射項(xiàng)即可,如下所示:
<!--
<servlet-mapping>
<servlet-name>invoker</servlet-name>
<url-pattern>/servlet/*</url-pattern>
</servlet-mapping>
-->
再次提醒,應(yīng)該注意這個(gè)項(xiàng)是位于存放在install_dir/conf的Tomcat專用的web.xml文件中的,此文件不是存放在每個(gè)Web應(yīng)用的WEB-INF目錄中的標(biāo)準(zhǔn)web.xml。
2.禁止激活器:Tomcat3
在Apache Tomcat的版本3中,通過在install_dir/conf/server.xml中注釋出InvokerInterceptor項(xiàng)全局禁止缺省 servlet URL。例如,下面是禁止使用缺省servlet URL的server.xml文件的一部分。
<!--
<RequsetInterceptor
className="org.apache.tomcat.request.InvokerInterceptor"
debug="0" prefix="/servlet/" />
-->
5 初始化和預(yù)裝載servlet與JSP頁面
這里討論控制servlet和JSP頁面的啟動(dòng)行為的方法。特別是,說明了怎樣分配初始化參數(shù)以及怎樣更改服務(wù)器生存期中裝載servlet和JSP頁面的時(shí)刻。
5.1 分配servlet初始化參數(shù)
利用init-param元素向servlet提供初始化參數(shù),init-param元素具有param-name和param-value子元素。例如,在下面的例子中,如果initServlet servlet是利用它的注冊(cè)名(InitTest)訪問的,它將能夠從其方法中調(diào)用getServletConfig(). getInitParameter("param1")獲得"Value 1",調(diào)用getServletConfig().getInitParameter("param2")獲得"2"。
<servlet>
<servlet-name>InitTest</servlet-name>
<servlet-class>moreservlets.InitServlet</servlet-class>
<init-param>
<param-name>param1</param-name>
<param-value>value1</param-value>
</init-param>
<init-param>
<param-name>param2</param-name>
<param-value>2</param-value>
</init-param>
</servlet>
在涉及初始化參數(shù)時(shí),有幾點(diǎn)需要注意:
l 返回值。GetInitParameter的返回值總是一個(gè)String。因此,在前一個(gè)例子中,可對(duì)param2使用Integer.parseInt獲得一個(gè)int。
l JSP中的初始化。JSP頁面使用jspInit而不是init。JSP頁面還需要使用jsp-file元素代替servlet-class。
l 缺省URL。初始化參數(shù)只在通過它們的注冊(cè)名或與它們注冊(cè)名相關(guān)的定制URL模式訪問Servlet時(shí)可以使用。因此,在這個(gè)例子中,param1和 param2初始化參數(shù)將能夠在使用URL
http://host/webAppPrefix/servlet/InitTest
時(shí)可用,但在使用URL
http://host/webAppPrefix/servlet/myPackage.InitServlet
時(shí)不能使用。
例如,程序清單5-7給出一個(gè)名為InitServlet的簡(jiǎn)單servlet,它使用init方法設(shè)置firstName和emailAddress字段。程序清單5-8給出分配名稱InitTest給servlet的web.xml文件。
程序清單5-7 InitServlet.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
/** Simple servlet used to illustrate servlet
* initialization parameters.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
*
http://www.moreservlets.com/.
* ? 2002 Marty Hall; may be freely used or adapted.
*/
public class InitServlet extends HttpServlet {
private String firstName, emailAddress;
public void init() {
ServletConfig config = getServletConfig();
firstName = config.getInitParameter("firstName");
emailAddress = config.getInitParameter("emailAddress");
}
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html");
PrintWriter out = response.getWriter();
String uri = request.getRequestURI();
out.println(ServletUtilities.headWithTitle("Init Servlet") +
"<BODY BGCOLOR=\"#FDF5E6\">\n" +
"<H2>Init Parameters:</H2>\n" +
"<UL>\n" +
"<LI>First name: " + firstName + "\n" +
"<LI>Email address: " + emailAddress + "\n" +
"</UL>\n" +
"</BODY></HTML>");
}
}
程序清單5-8 web.xml(說明初始化參數(shù)的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<servlet>
<servlet-name>InitTest</servlet-name>
<servlet-class>moreservlets.InitServlet</servlet-class>
<init-param>
<param-name>firstName</param-name>
<param-value>Larry</param-value>
</init-param>
<init-param>
<param-name>emailAddress</param-name>
<param-value>
Ellison@Microsoft.com
</param-value>
</init-param>
</servlet>
<!-- ... -->
</web-app>
5.2 分配JSP初始化參數(shù)
給JSP頁面提供初始化參數(shù)在三個(gè)方面不同于給servlet提供初始化參數(shù)。
1)使用jsp-file而不是servlet-class。因此,WEB-INF/web.xml文件的servlet元素如下所示:
<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/RealPage.jsp</jsp-file>
<init-param>
<param-name>...</param-name>
<param-value>...</param-value>
</init-param>
...
</servlet>
2) 幾乎總是分配一個(gè)明確的URL模式。對(duì)servlet,一般相應(yīng)地使用以
http://host/webAppPrefix/servlet/
開始的缺省URL。只需記住,使用注冊(cè)名而不是原名稱即可。這對(duì)于JSP頁面在技術(shù)上也是合法的。例如,在上面給出的例子中,可用URL
http://host/webAppPrefix/servlet/PageName
訪問RealPage.jsp的對(duì)初始化參數(shù)具有訪問權(quán)的版本。但在用于JSP頁面時(shí),許多用戶似乎不喜歡應(yīng)用常規(guī)的servlet的URL。此外,如果 JSP頁面位于服務(wù)器為其提供了目錄清單的目錄中(如,一個(gè)既沒有index.html也沒有index.jsp文件的目錄),則用戶可能會(huì)連接到此 JSP頁面,單擊它,從而意外地激活未初始化的頁面。因此,好的辦法是使用url-pattern(5.3節(jié))將JSP頁面的原URL與注冊(cè)的 servlet名相關(guān)聯(lián)。這樣,客戶機(jī)可使用JSP頁面的普通名稱,但仍然激活定制的版本。例如,給定來自項(xiàng)目1的servlet定義,可使用下面的 servlet-mapping定義:
<servlet-mapping>
<servlet-name>PageName</servlet-name>
<url-pattern>/RealPage.jsp</url-pattern>
</servlet-mapping>
3)JSP頁使用jspInit而不是init。自動(dòng)從JSP頁面建立的servlet或許已經(jīng)使用了inti方法。因此,使用JSP聲明提供一個(gè)init方法是不合法的,必須制定jspInit方法。
為了說明初始化JSP頁面的過程,程序清單5-9給出了一個(gè)名為InitPage.jsp的JSP頁面,它包含一個(gè)jspInit方法且放置于 deployDemo Web應(yīng)用層次結(jié)構(gòu)的頂層。一般,
http://host/deployDemo/InitPage.jsp
形式的URL將激活此頁面的不具有初始化參數(shù)訪問權(quán)的版本,從而將對(duì)firstName和emailAddress變量顯示null。但是, web.xml文件(程序清單5-10)分配了一個(gè)注冊(cè)名,然后將該注冊(cè)名與URL模式/InitPage.jsp相關(guān)聯(lián)。
程序清單5-9 InitPage.jsp
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><TITLE>JSP Init Test</TITLE></HEAD>
<BODY BGCOLOR="#FDF5E6">
<H2>Init Parameters:</H2>
<UL>
<LI>First name: <%= firstName %>
<LI>Email address: <%= emailAddress %>
</UL>
</BODY></HTML>
<%!
private String firstName, emailAddress;
public void jspInit() {
ServletConfig config = getServletConfig();
firstName = config.getInitParameter("firstName");
emailAddress = config.getInitParameter("emailAddress");
}
%>
程序清單5-10 web.xml(說明JSP頁面的init參數(shù)的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<servlet>
<servlet-name>InitPage</servlet-name>
<jsp-file>/InitPage.jsp</jsp-file>
<init-param>
<param-name>firstName</param-name>
<param-value>Bill</param-value>
</init-param>
<init-param>
<param-name>emailAddress</param-name>
<param-value>
gates@oracle.com
</param-value>
</init-param>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> InitPage</servlet-name>
<url-pattern>/InitPage.jsp</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>
5.3 提供應(yīng)用范圍內(nèi)的初始化參數(shù)
一般,對(duì)單個(gè)地servlet或JSP頁面分配初始化參數(shù)。指定的servlet或JSP頁面利用ServletConfig的getInitParameter方法讀取這些參數(shù)。但是,在某些情形下,希望提供可由任意servlet或JSP頁面借助ServletContext的getInitParameter方法讀取的系統(tǒng)范圍內(nèi)的初始化參數(shù)。
可利用context-param元素聲明這些系統(tǒng)范圍內(nèi)的初始化值。context-param元素應(yīng)該包含param-name、param-value以及可選的description子元素,如下所示:
<context-param>
<param-name>support-email</param-name>
<param-value>
blackhole@mycompany.com
</param-value>
</context-param>
可回憶一下,為了保證可移植性,web.xml內(nèi)的元素必須以正確的次序聲明。但這里應(yīng)該注意,context-param元素必須出現(xiàn)任意與文檔有關(guān)的元素(icon、display-name或description)之后及filter、filter-mapping、listener或 servlet元素之前。
5.4 在服務(wù)器啟動(dòng)時(shí)裝載servlet
假如servlet或JSP頁面有一個(gè)要花很長(zhǎng)時(shí)間執(zhí)行的init (servlet)或jspInit(JSP)方法。例如,假如init或jspInit方法從某個(gè)數(shù)據(jù)庫或ResourceBundle查找產(chǎn)量。這種情況下,在第一個(gè)客戶機(jī)請(qǐng)求時(shí)裝載servlet的缺省行為將對(duì)第一個(gè)客戶機(jī)產(chǎn)生較長(zhǎng)時(shí)間的延遲。因此,可利用servlet的load-on- startup元素規(guī)定服務(wù)器在第一次啟動(dòng)時(shí)裝載servlet。下面是一個(gè)例子。
<servlet>
<servlet-name> … </servlet-name>
<servlet-class> … </servlet-class> <!-- Or jsp-file -->
<load-on-startup/>
</servlet>
可以為此元素體提供一個(gè)整數(shù)而不是使用一個(gè)空的load-on-startup。想法是服務(wù)器應(yīng)該在裝載較大數(shù)目的servlet或JSP頁面之前裝載較少數(shù)目的servlet或JSP頁面。例如,下面的servlet項(xiàng)(放置在Web應(yīng)用的WEB-INF目錄下的web.xml文件中的web-app元素內(nèi))將指示服務(wù)器首先裝載和初始化SearchServlet,然后裝載和初始化由位于Web應(yīng)用的result目錄中的index.jsp文件產(chǎn)生的 servlet。
<servlet>
<servlet-name>Search</servlet-name>
<servlet-class>myPackage.SearchServlet</servlet-class> <!-- Or jsp-file -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>Results</servlet-name>
<servlet-class>/results/index.jsp</servlet-class> <!-- Or jsp-file -->
<load-on-startup>2</load-on-startup>
</servlet>
6 聲明過濾器
servlet版本2.3引入了過濾器的概念。雖然所有支持servlet API版本2.3的服務(wù)器都支持過濾器,但為了使用與過濾器有關(guān)的元素,必須在web.xml中使用版本2.3的DTD。
過濾器可截取和修改進(jìn)入一個(gè)servlet或JSP頁面的請(qǐng)求或從一個(gè)servlet或JSP頁面發(fā)出的相應(yīng)。在執(zhí)行一個(gè)servlet或JSP頁面之前,必須執(zhí)行第一個(gè)相關(guān)的過濾器的doFilter方法。在該過濾器對(duì)其FilterChain對(duì)象調(diào)用doFilter時(shí),執(zhí)行鏈中的下一個(gè)過濾器。如果沒有其他過濾器,servlet或JSP頁面被執(zhí)行。過濾器具有對(duì)到來的ServletRequest對(duì)象的全部訪問權(quán),因此,它們可以查看客戶機(jī)名、查找到來的cookie等。為了訪問servlet或JSP頁面的輸出,過濾器可將響應(yīng)對(duì)象包裹在一個(gè)替身對(duì)象(stand-in object)中,比方說把輸出累加到一個(gè)緩沖區(qū)。在調(diào)用FilterChain對(duì)象的doFilter方法之后,過濾器可檢查緩沖區(qū),如有必要,就對(duì)它進(jìn)行修改,然后傳送到客戶機(jī)。
例如,程序清單5-11帝國難以了一個(gè)簡(jiǎn)單的過濾器,只要訪問相關(guān)的servlet或JSP頁面,它就截取請(qǐng)求并在標(biāo)準(zhǔn)輸出上打印一個(gè)報(bào)告(開發(fā)過程中在桌面系統(tǒng)上運(yùn)行時(shí),大多數(shù)服務(wù)器都可以使用這個(gè)過濾器)。
程序清單5-11 ReportFilter.java
package moreservlets;
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
/** Simple filter that prints a report on the standard output
* whenever the associated servlet or JSP page is accessed.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
*
http://www.moreservlets.com/.
* ? 2002 Marty Hall; may be freely used or adapted.
*/
public class ReportFilter implements Filter {
public void doFilter(ServletRequest request,
ServletResponse response,
FilterChain chain)
throws ServletException, IOException {
HttpServletRequest req = (HttpServletRequest)request;
System.out.println(req.getRemoteHost() +
" tried to access " +
req.getRequestURL() +
" on " + new Date() + ".");
chain.doFilter(request,response);
}
public void init(FilterConfig config)
throws ServletException {
}
public void destroy() {}
}
一旦建立了一個(gè)過濾器,可以在web.xml中利用filter元素以及filter-name(任意名稱)、file-class(完全限定的類名)和(可選的)init-params子元素聲明它。請(qǐng)注意,元素在web.xml的web-app元素中出現(xiàn)的次序不是任意的;允許服務(wù)器(但不是必需的)強(qiáng)制所需的次序,并且實(shí)際中有些服務(wù)器也是這樣做的。但這里要注意,所有filter元素必須出現(xiàn)在任意filter-mapping元素之前, filter-mapping元素又必須出現(xiàn)在所有servlet或servlet-mapping元素之前。
例如,給定上述的ReportFilter類,可在web.xml中作出下面的filter聲明。它把名稱Reporter與實(shí)際的類ReportFilter(位于moreservlets程序包中)相關(guān)聯(lián)。
<filter>
<filter-name>Reporter</filter-name>
<filter-class>moresevlets.ReportFilter</filter-class>
</filter>
一旦命名了一個(gè)過濾器,可利用filter-mapping元素把它與一個(gè)或多個(gè)servlet或JSP頁面相關(guān)聯(lián)。關(guān)于此項(xiàng)工作有兩種選擇。
首先,可使用filter-name和servlet-name子元素把此過濾器與一個(gè)特定的servlet名(此servlet名必須稍后在相同的 web.xml文件中使用servlet元素聲明)關(guān)聯(lián)。例如,下面的程序片斷指示系統(tǒng)只要利用一個(gè)定制的URL訪問名為SomeServletName 的servlet或JSP頁面,就運(yùn)行名為Reporter的過濾器。
<filter-mapping>
<filter-name>Reporter</filter-name>
<servlet-name>SomeServletName</servlet-name>
</filter-mapping>
其次,可利用filter-name和url-pattern子元素將過濾器與一組servlet、JSP頁面或靜態(tài)內(nèi)容相關(guān)聯(lián)。例如,相面的程序片段指示系統(tǒng)只要訪問Web應(yīng)用中的任意URL,就運(yùn)行名為Reporter的過濾器。
<filter-mapping>
<filter-name>Reporter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
例如,程序清單5-12給出了將ReportFilter過濾器與名為PageName的servlet相關(guān)聯(lián)的web.xml文件的一部分。名字 PageName依次又與一個(gè)名為TestPage.jsp的JSP頁面以及以模式http: //host/webAppPrefix/UrlTest2/ 開頭的URL相關(guān)聯(lián)。TestPage.jsp的源代碼已經(jīng)JSP頁面命名的談?wù)撛谇懊娴?節(jié)"分配名稱和定制的URL"中給出。事實(shí)上,程序清單5- 12中的servlet和servlet-name項(xiàng)從該節(jié)原封不動(dòng)地拿過來的。給定這些web.xml項(xiàng),可看到下面的標(biāo)準(zhǔn)輸出形式的調(diào)試報(bào)告(換行是為了容易閱讀)。
audit.irs.gov tried to access
http://mycompany.com/deployDemo/UrlTest2/business/tax-plan.html
on Tue Dec 25 13:12:29 EDT 2001.
程序清單5-12 Web.xml(說明filter用法的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<filter>
<filter-name>Reporter</filter-name>
<filter-class>moresevlets.ReportFilter</filter-class>
</filter>
<!-- ... -->
<filter-mapping>
<filter-name>Reporter</filter-name>
<servlet-name>PageName</servlet-name>
</filter-mapping>
<!-- ... -->
<servlet>
<servlet-name>PageName</servlet-name>
<jsp-file>/RealPage.jsp</jsp-file>
</servlet>
<!-- ... -->
<servlet-mapping>
<servlet-name> PageName </servlet-name>
<url-pattern>/UrlTest2/*</url-pattern>
</servlet-mapping>
<!-- ... -->
</web-app>
7 指定歡迎頁
假如用戶提供了一個(gè)像http: //host/webAppPrefix/directoryName/ 這樣的包含一個(gè)目錄名但沒有包含文件名的URL,會(huì)發(fā)生什么事情呢?用戶能得到一個(gè)目錄表?一個(gè)錯(cuò)誤?還是標(biāo)準(zhǔn)文件的內(nèi)容?如果得到標(biāo)準(zhǔn)文件內(nèi)容,是 index.html、index.jsp、default.html、default.htm或別的什么東西呢?
Welcome-file-list 元素及其輔助的welcome-file元素解決了這個(gè)模糊的問題。例如,下面的web.xml項(xiàng)指出,如果一個(gè)URL給出一個(gè)目錄名但未給出文件名,服務(wù)器應(yīng)該首先試用index.jsp,然后再試用index.html。如果兩者都沒有找到,則結(jié)果有賴于所用的服務(wù)器(如一個(gè)目錄列表)。
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
雖然許多服務(wù)器缺省遵循這種行為,但不一定必須這樣。因此,明確地使用welcom-file-list保證可移植性是一種良好的習(xí)慣。
8 指定處理錯(cuò)誤的頁面
現(xiàn)在我了解到,你在開發(fā)servlet和JSP頁面時(shí)從不會(huì)犯錯(cuò)誤,而且你的所有頁面是那樣的清晰,一般的程序員都不會(huì)被它們的搞糊涂。但是,是人總會(huì)犯錯(cuò)誤的,用戶可能會(huì)提供不合規(guī)定的參數(shù),使用不正確的URL或者不能提供必需的表單字段值。除此之外,其它開發(fā)人員可能不那么細(xì)心,他們應(yīng)該有些工具來克服自己的不足。
error-page元素就是用來克服這些問題的。它有兩個(gè)可能的子元素,分別是:error-code和exception- type。第一個(gè)子元素error-code指出在給定的HTTP錯(cuò)誤代碼出現(xiàn)時(shí)使用的URL。第二個(gè)子元素excpetion-type指出在出現(xiàn)某個(gè)給定的Java異常但未捕捉到時(shí)使用的URL。error-code和exception-type都利用location元素指出相應(yīng)的URL。此 URL必須以/開始。location所指出的位置處的頁面可通過查找HttpServletRequest對(duì)象的兩個(gè)專門的屬性來訪問關(guān)于錯(cuò)誤的信息,這兩個(gè)屬性分別是:javax.servlet.error.status_code和javax.servlet.error.message。
可回憶一下,在web.xml內(nèi)以正確的次序聲明web-app的子元素很重要。這里只要記住,error-page出現(xiàn)在web.xml文件的末尾附近,servlet、servlet-name和welcome-file-list之后即可。
8.1 error-code元素
為了更好地了解error-code元素的值,可考慮一下如果不正確地輸入文件名,大多數(shù)站點(diǎn)會(huì)作出什么反映。這樣做一般會(huì)出現(xiàn)一個(gè)404錯(cuò)誤信息,它表示不能找到該文件,但幾乎沒提供更多有用的信息。另一方面,可以試一下在
www.microsoft.com
、
www.ibm.com
處或者特別是在
www.bea.com
處輸出未知的文件名。這是會(huì)得出有用的消息,這些消息提供可選擇的位置,以便查找感興趣的頁面。提供這樣有用的錯(cuò)誤頁面對(duì)于Web應(yīng)用來說是很有價(jià)值得。事實(shí)上rm-error-page子元素)。由form-login-page給出的HTML表單必須具有一個(gè)j_security_check的 ACTION屬性、一個(gè)名為j_username的用戶名文本字段以及一個(gè)名為j_password的口令字段。
例如,程序清單5-19指示服務(wù)器使用基于表單的驗(yàn)證。Web應(yīng)用的頂層目錄中的一個(gè)名為login.jsp的頁面將收集用戶名和口令,并且失敗的登陸將由相同目錄中名為login-error.jsp的頁面報(bào)告。
程序清單5-19 web.xml(說明login-config的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<security-constraint> ... </security-constraint>
<login-config>
<auth-method> FORM </auth-method>
<form-login-config>
<form-login-page>/login.jsp</form-login-page>
<form-error-page>/login-error.jsp</form-error-page>
</form-login-config>
</login-config>
<!-- ... -->
</web-app>
9.2 限制對(duì)Web資源的訪問
現(xiàn)在,可以指示服務(wù)器使用何種驗(yàn)證方法了。"了不起,"你說道,"除非我能指定一個(gè)來收到保護(hù)的 URL,否則沒有多大用處。"沒錯(cuò)。指出這些URL并說明他們應(yīng)該得到何種保護(hù)正是security-constriaint元素的用途。此元素在 web.xml中應(yīng)該出現(xiàn)在login-config的緊前面。它包含是個(gè)可能的子元素,分別是:web-resource-collection、 auth-constraint、user-data-constraint和display-name。下面各小節(jié)對(duì)它們進(jìn)行介紹。
l web-resource-collection
此元素確定應(yīng)該保護(hù)的資源。所有security-constraint元素都必須包含至少一個(gè)web-resource-collection項(xiàng)。此元素由一個(gè)給出任意標(biāo)識(shí)名稱的web-resource-name元素、一個(gè)確定應(yīng)該保護(hù)的URL的url-pattern元素、一個(gè)指出此保護(hù)所適用的 HTTP命令(GET、POST等,缺省為所有方法)的http-method元素和一個(gè)提供資料的可選description元素組成。例如,下面的 Web-resource-collection項(xiàng)(在security-constratint元素內(nèi))指出Web應(yīng)用的proprietary目錄中所有文檔應(yīng)該受到保護(hù)。
<security-constraint>
<web-resource-coolection>
<web-resource-name>Proprietary</web-resource-name>
<url-pattern>/propritary/*</url-pattern>
</web-resource-coolection>
<!-- ... -->
</security-constraint>
重要的是應(yīng)該注意到,url-pattern僅適用于直接訪問這些資源的客戶機(jī)。特別是,它不適合于通過MVC體系結(jié)構(gòu)利用 RequestDispatcher來訪問的頁面,或者不適合于利用類似jsp:forward的手段來訪問的頁面。這種不勻稱如果利用得當(dāng)?shù)脑捄苡泻锰帯@纾瑂ervlet可利用MVC體系結(jié)構(gòu)查找數(shù)據(jù),把它放到bean中,發(fā)送請(qǐng)求到從bean中提取數(shù)據(jù)的JSP頁面并顯示它。我們希望保證決不直接訪問受保護(hù)的JSP頁面,而只是通過建立該頁面將使用的bean的servlet來訪問它。url-pattern和auth-contraint元素可通過聲明不允許任何用戶直接訪問JSP頁面來提供這種保證。但是,這種不勻稱的行為可能讓開發(fā)人員放松警惕,使他們偶然對(duì)應(yīng)受保護(hù)的資源提供不受限制的訪問。
l auth-constraint
盡管web-resource-collention元素質(zhì)出了哪些URL應(yīng)該受到保護(hù),但是auth-constraint元素卻指出哪些用戶應(yīng)該具有受保護(hù)資源的訪問權(quán)。此元素應(yīng)該包含一個(gè)或多個(gè)標(biāo)識(shí)具有訪問權(quán)限的用戶類別role- name元素,以及包含(可選)一個(gè)描述角色的description元素。例如,下面web.xml中的security-constraint元素部門規(guī)定只有指定為Administrator或Big Kahuna(或兩者)的用戶具有指定資源的訪問權(quán)。
<security-constraint>
<web-resource-coolection> ... </web-resource-coolection>
<auth-constraint>
<role-name>administrator</role-name>
<role-name>kahuna</role-name>
</auth-constraint>
</security-constraint>
重要的是認(rèn)識(shí)到,到此為止,這個(gè)過程的可移植部分結(jié)束了。服務(wù)器怎樣確定哪些用戶處于任何角色以及它怎樣存放用戶的口令,完全有賴于具體的系統(tǒng)。
例如,Tomcat使用install_dir/conf/tomcat-users.xml將用戶名與角色名和口令相關(guān)聯(lián),正如下面例子中所示,它指出用戶joe(口令bigshot)和jane(口令enaj)屬于administrator和kahuna角色。
<tomcat-users>
<user name="joe" password="bigshot" roles="administrator,kahuna" />
<user name="jane" password="enaj" roles="kahuna" />
</tomcat-users>
l user-data-constraint
這個(gè)可選的元素指出在訪問相關(guān)資源時(shí)使用任何傳輸層保護(hù)。它必須包含一個(gè)transport-guarantee子元素(合法值為NONE、 INTEGRAL或CONFIDENTIAL),并且可選地包含一個(gè)description元素。transport-guarantee為NONE值將對(duì)所用的通訊協(xié)議不加限制。INTEGRAL值表示數(shù)據(jù)必須以一種防止截取它的人閱讀它的方式傳送。雖然原理上(并且在未來的HTTP版本中),在 INTEGRAL和CONFIDENTIAL之間可能會(huì)有差別,但在當(dāng)前實(shí)踐中,他們都只是簡(jiǎn)單地要求用SSL。例如,下面指示服務(wù)器只允許對(duì)相關(guān)資源做 HTTPS連接:
<security-constraint>
<!-- ... -->
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
l display-name
security-constraint的這個(gè)很少使用的子元素給予可能由GUI工具使用的安全約束項(xiàng)一個(gè)名稱。
9.3 分配角色名
迄今為止,討論已經(jīng)集中到完全由容器(服務(wù)器)處理的安全問題之上了。但servlet以及JSP頁面也能夠處理它們自己的安全問題。
例如,容器可能允許用戶從bigwig或bigcheese角色訪問一個(gè)顯示主管人員額外緊貼的頁面,但只允許bigwig用戶修改此頁面的參數(shù)。完成這種更細(xì)致的控制的一種常見方法是調(diào)用HttpServletRequset的isUserInRole方法,并據(jù)此修改訪問。
Servlet的 security-role-ref子元素提供出現(xiàn)在服務(wù)器專用口令文件中的安全角色名的一個(gè)別名。例如,假如編寫了一個(gè)調(diào)用 request.isUserInRole("boss")的servlet,但后來該servlet被用在了一個(gè)其口令文件調(diào)用角色manager而不是boss的服務(wù)器中。下面的程序段使該servlet能夠使用這兩個(gè)名稱中的任何一個(gè)。
<servlet>
<!-- ... -->
<security-role-ref>
<role-name>boss</role-name> <!-- New alias -->
<role-link>manager</role-link> <!-- Real name -->
</security-role-ref>
</servlet>
也可以在web-app內(nèi)利用security-role元素提供將出現(xiàn)在role-name元素中的所有安全角色的一個(gè)全局列表。分別地生命角色使高級(jí)IDE容易處理安全信息。
10 控制會(huì)話超時(shí)
如果某個(gè)會(huì)話在一定的時(shí)間內(nèi)未被訪問,服務(wù)器可把它扔掉以節(jié)約內(nèi)存。可利用HttpSession的setMaxInactiveInterval方法直接設(shè)置個(gè)別會(huì)話對(duì)象的超時(shí)值。如果不采用這種方法,則缺省的超時(shí)值由具體的服務(wù)器決定。但可利用session-config和session- timeout元素來給出一個(gè)適用于所有服務(wù)器的明確的超時(shí)值。超時(shí)值的單位為分鐘,因此,下面的例子設(shè)置缺省會(huì)話超時(shí)值為三個(gè)小時(shí)(180分鐘)。
<session-config>
<session-timeout>180</session-timeout>
</session-config>
11 Web應(yīng)用的文檔化
越來越多的開發(fā)環(huán)境開始提供servlet和JSP的直接支持。例子有Borland Jbuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun Studio(寫此文時(shí),已被Macromedia收購)以及IBM VisuaAge for Java等。
大量的web.xml元素不僅是為服務(wù)器設(shè)計(jì)的,而且還是為可視開發(fā)環(huán)境設(shè)計(jì)的。它們包括icon、display-name和discription等。
可回憶一下,在web.xml內(nèi)以適當(dāng)?shù)卮涡蚵暶鱳eb-app子元素很重要。不過,這里只要記住icon、display-name和description是web.xml的web-app元素內(nèi)的前三個(gè)合法元素即可。
l icon
icon元素指出GUI工具可用來代表Web應(yīng)用的一個(gè)和兩個(gè)圖像文件。可利用small-icon元素指定一幅16 x 16的GIF或JPEG圖像,用large-icon元素指定一幅32 x 32的圖像。下面舉一個(gè)例子:
<icon>
<small-icon>/images/small-book.gif</small-icon>
<large-icon>/images/tome.jpg</large-icon>
</icon>
l display-name
display-name元素提供GUI工具可能會(huì)用來標(biāo)記此Web應(yīng)用的一個(gè)名稱。下面是個(gè)例子。
<display-name>Rare Books</display-name>
l description
description元素提供解釋性文本,如下所示:
<description>
This Web application represents the store developed for
rare-books.com, an online bookstore specializing in rare
and limited-edition books.
</description>
12 關(guān)聯(lián)文件與MIME類型
服務(wù)器一般都具有一種讓W(xué)eb站點(diǎn)管理員將文件擴(kuò)展名與媒體相關(guān)聯(lián)的方法。例如,將會(huì)自動(dòng)給予名為mom.jpg的文件一個(gè)image/jpeg的MIME 類型。但是,假如你的Web應(yīng)用具有幾個(gè)不尋常的文件,你希望保證它們?cè)诎l(fā)送到客戶機(jī)時(shí)分配為某種MIME類型。mime-mapping元素(具有 extension和mime-type子元素)可提供這種保證。例如,下面的代碼指示服務(wù)器將application/x-fubar的MIME類型分配給所有以.foo結(jié)尾的文件。
<mime-mapping>
<extension>foo</extension>
<mime-type>application/x-fubar</mime-type>
</mime-mapping>
或許,你的Web應(yīng)用希望重載(override)標(biāo)準(zhǔn)的映射。例如,下面的代碼將告訴服務(wù)器在發(fā)送到客戶機(jī)時(shí)指定.ps文件作為純文本(text/plain)而不是作為PostScript(application/postscript)。
<mime-mapping>
<extension>ps</extension>
<mime-type>application/postscript</mime-type>
</mime-mapping>
13 定位TLD
JSP taglib元素具有一個(gè)必要的uri屬性,它給出一個(gè)TLD(Tag Library Descriptor)文件相對(duì)于Web應(yīng)用的根的位置。TLD文件的實(shí)際名稱在發(fā)布新的標(biāo)簽庫版本時(shí)可能會(huì)改變,但我們希望避免更改所有現(xiàn)有JSP頁面。此外,可能還希望使用保持taglib元素的簡(jiǎn)練性的一個(gè)簡(jiǎn)短的uri。這就是部署描述符文件的taglib元素派用場(chǎng)的所在了。Taglib包含兩個(gè)子元素:taglib-uri和taglib-location。taglib-uri元素應(yīng)該與用于JSP taglib元素的uri屬性的東西相匹配。Taglib-location元素給出TLD文件的實(shí)際位置。例如,假如你將文件chart-tags- 1.3beta.tld放在WebApp/WEB-INF/tlds中。現(xiàn)在,假如web.xml在web-app元素內(nèi)包含下列內(nèi)容。
<taglib>
<taglib-uri>/charts.tld</taglib-uri>
<taglib-location>
/WEB-INF/tlds/chart-tags-1.3beta.tld
</taglib-location>
</taglib>
給出這個(gè)說明后,JSP頁面可通過下面的簡(jiǎn)化形式使用標(biāo)簽庫。
<%@ taglib uri="/charts.tld" prefix="somePrefix" %>
14 指定應(yīng)用事件監(jiān)聽程序
應(yīng)用事件監(jiān)聽器程序是建立或修改servlet環(huán)境或會(huì)話對(duì)象時(shí)通知的類。它們是servlet規(guī)范的版本2.3中的新內(nèi)容。這里只簡(jiǎn)單地說明用來向Web應(yīng)用注冊(cè)一個(gè)監(jiān)聽程序的web.xml的用法。
注冊(cè)一個(gè)監(jiān)聽程序涉及在web.xml的web-app元素內(nèi)放置一個(gè)listener元素。在listener元素內(nèi),listener-class元素列出監(jiān)聽程序的完整的限定類名,如下所示:
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
雖然listener元素的結(jié)構(gòu)很簡(jiǎn)單,但請(qǐng)不要忘記,必須正確地給出web-app元素內(nèi)的子元素的次序。listener元素位于所有的servlet 元素之前以及所有filter-mapping元素之后。此外,因?yàn)閼?yīng)用生存期監(jiān)聽程序是serlvet規(guī)范的2.3版本中的新內(nèi)容,所以必須使用 web.xml DTD的2.3版本,而不是2.2版本。
例如,程序清單5-20給出一個(gè)名為ContextReporter的簡(jiǎn)單的監(jiān)聽程序,只要Web應(yīng)用的Servlet-Context建立(如裝載Web應(yīng)用)或消除(如服務(wù)器關(guān)閉)時(shí),它就在標(biāo)準(zhǔn)輸出上顯示一條消息。程序清單5-21給出此監(jiān)聽程序注冊(cè)所需要的web.xml文件的一部分。
程序清單5-20 ContextReporterjava
package moreservlets;
import javax.servlet.*;
import java.util.*;
/** Simple listener that prints a report on the standard output
* when the ServletContext is created or destroyed.
* <P>
* Taken from More Servlets and JavaServer Pages
* from Prentice Hall and Sun Microsystems Press,
*
http://www.moreservlets.com/.
* ? 2002 Marty Hall; may be freely used or adapted.
*/
public class ContextReporter implements ServletContextListener {
public void contextInitialized(ServletContextEvent event) {
System.out.println("Context created on " +
new Date() + ".");
}
public void contextDestroyed(ServletContextEvent event) {
System.out.println("Context destroyed on " +
new Date() + ".");
}
}
程序清單5-21 web.xml(聲明一個(gè)監(jiān)聽程序的摘錄)
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"
http://java.sun.com/dtd/web-app_2_3.dtd
">
<web-app>
<!-- ... -->
<filter-mapping> … </filter-mapping>
<listener>
<listener-class>package.ListenerClass</listener-class>
</listener>
<servlet> ... </servlet>
<!-- ... -->
</web-app>
15 J2EE元素
本節(jié)描述用作J2EE環(huán)境組成部分的Web應(yīng)用的web.xml元素。這里將提供一個(gè)簡(jiǎn)明的介紹,詳細(xì)內(nèi)容可以參閱
http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf
的Java 2 Plantform Enterprise Edition版本1.3規(guī)范的第5章。
l distributable
distributable 元素指出,Web應(yīng)用是以這樣的方式編程的:即,支持集群的服務(wù)器可安全地在多個(gè)服務(wù)器上分布Web應(yīng)用。例如,一個(gè)可分布的應(yīng)用必須只使用 Serializable對(duì)象作為其HttpSession對(duì)象的屬性,而且必須避免用實(shí)例變量(字段)來實(shí)現(xiàn)持續(xù)性。distributable元素直接出現(xiàn)在discription元素之后,并且不包含子元素或數(shù)據(jù),它只是一個(gè)如下的標(biāo)志。
<distributable />
l resource-env-ref
resource -env-ref元素聲明一個(gè)與某個(gè)資源有關(guān)的管理對(duì)象。此元素由一個(gè)可選的description元素、一個(gè)resource-env-ref- name元素(一個(gè)相對(duì)于java:comp/env環(huán)境的JNDI名)以及一個(gè)resource-env-type元素(指定資源類型的完全限定的類),如下所示:
<resource-env-ref>
<resource-env-ref-name>
jms/StockQueue
</resource-env-ref-name>
<resource-env-ref-type>
javax.jms.Queue
</resource-env-ref-type>
</resource-env-ref>
l env-entry
env -entry元素聲明Web應(yīng)用的環(huán)境項(xiàng)。它由一個(gè)可選的description元素、一個(gè)env-entry-name元素(一個(gè)相對(duì)于java: comp/env環(huán)境JNDI名)、一個(gè)env-entry-value元素(項(xiàng)值)以及一個(gè)env-entry-type元素(java.lang程序包中一個(gè)類型的完全限定類名,java.lang.Boolean、java.lang.String等)組成。下面是一個(gè)例子:
<env-entry>
<env-entry-name>minAmout</env-entry-name>
<env-entry-value>100.00</env-entry-value>
<env-entry-type>minAmout</env-entry-type>
</env-entry>
l ejb-ref
ejb -ref元素聲明對(duì)一個(gè)EJB的主目錄的應(yīng)用。它由一個(gè)可選的description元素、一個(gè)ejb-ref-name元素(相對(duì)于java: comp/env的EJB應(yīng)用)、一個(gè)ejb-ref-type元素(bean的類型,Entity或Session)、一個(gè)home元素(bean的主目錄接口的完全限定名)、一個(gè)remote元素(bean的遠(yuǎn)程接口的完全限定名)以及一個(gè)可選的ejb-link元素(當(dāng)前bean鏈接的另一個(gè) bean的名稱)組成。
l ejb-local-ref
ejb-local-ref元素聲明一個(gè)EJB的本地主目錄的引用。除了用local-home代替home外,此元素具有與ejb-ref元素相同的屬性并以相同的方式使用。
本文使用的服務(wù)器是Tomcat服務(wù)器,Web應(yīng)用發(fā)布描述文件web.xml是在Servlet規(guī)范中定義的。web.xml存放在WEB-INF/目錄下
在分析web.xml文檔之前我想先說一下web.xml中根元素<web-app>各子元素的順序問題,因?yàn)樵趙eb.xml中元素定義的先后順序是不能顛倒的(除非
在web.xml文件中使用XML Schema,本文不做討論),否則Tomcat服務(wù)器可能拋出SAXParseException。
順序如下:
<web-app>
<display-name>
<description>
<distributable>
<context-param>
<filter>
<filter-mapping>
<listener>
<servlet>
<servlet-mapping>
<session-config>
<mime-mapping>
<welcome-file-list>
<error-page>
<taglib>
<resource-env-ref>
<resource-ref>
<security-constraint>
<login-config>
<security-role>
<env-entry>
<ejb-ref>
<ejb-local-ref>
web.xml中的開頭幾行是固定的,它定義了該文件的字符編碼,XML版本以及引用的DTD文件。
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "
在web.xml中頂層元素為<web-app>,其他所有的子元素都必須定義在<web-app>內(nèi)<display-name>元素定義這個(gè)web應(yīng)用的名字,Java Web 服務(wù)器的Web管理工具將用這個(gè)名字來標(biāo)志W(wǎng)eb應(yīng)用。
<description>元素用來聲明Web應(yīng)用的描述信息
<context-param>元素用來配置外部引用的,在servlet中如果要獲得該元素中配置的值,String param-value = getServletContext().getInitParameter("param-name")
<filter>
<filter-name>SampleFilter</filter-name>
<filter-class>com.lpdev.SampleFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>SampleFilter</filter-name>
<url-pattern>*.jsp</url-pattern>
</filter-mapping>
以上是配置了一個(gè)servlet過濾器,對(duì)于servlet容器收到的客戶請(qǐng)求以及發(fā)出的響應(yīng)結(jié)果,servlet都能檢查和修改其中的信息,以上代碼指名當(dāng)客戶請(qǐng)求訪問Web應(yīng)用中的所有JSP文件時(shí),將觸發(fā)SampleFilter過濾器工作,具體的過濾事務(wù)在由<filter-class>中指定的類來完成
<servlet>
<servlet-name>IncludeServlet</servlet-name>
<servlet-class>com.lpdev.IncludeServlet</servlet-class>
<init-param>
<param-name>copyright</param-name>
<param-value>/foot.jspf</param-value>
<load-on-startup>1</load-on-startup>
</init-param>
</servlet>
配置Servlet,<servlet-name>是servlet的名字,<servlet-class>是實(shí)現(xiàn)這個(gè)Servlet的類,<init-param>定義Servlet的初始化參數(shù)(參數(shù)名和參數(shù)值),一個(gè)Servlet可以有多個(gè)<init-param>,在Servlet類中通過getInitParameter(String name)方法訪問初始化參數(shù)
<servlet-mapping>
<servlet-name>IncludeServlet</servlet-name>
<url-pattern>/IncludeServlet</url-pattern>
</servlet-mapping>
配置Servlet映射,<servlet-mapping>元素用來設(shè)定客戶訪問某個(gè)Servlet的URL,這里只需給出對(duì)于整個(gè)web應(yīng)用的相對(duì)的URL路徑,<url-pattern>中的“/”表示開始于Web應(yīng)用的根目錄例如,如果你在你本地機(jī)器上使用Tomcat4.1.x,并且創(chuàng)建了名為“myapp”的應(yīng)用程序,<url-pattern>/IncludeServlet</url-pattern>該Servlet的完整web地址就是http://localhost:8080/myapp/IncludeServlet
<session-config>元素用來設(shè)定HttpSession的生命周期,該元素只有一個(gè)<session-timeout>屬性,時(shí)間單位是“秒”。
<welcome-file-list>當(dāng)用戶訪問web時(shí),如果僅僅給出web應(yīng)用的Root URL,沒有指定具體文件名,容器調(diào)用該配置,該元素可以包含多個(gè)<welcome-file>屬性。
<taglib>元素用來設(shè)置web引用的tag library,例示定義了一個(gè)“/mytaglib”標(biāo)簽庫,它對(duì)應(yīng)的tld文件為:/WEB_INF/mytaglib.tld
<taglib>
<taglib-url>/mytaglib</taglib-url>
<taglib-locationg>/WEB-INF/mytaglib.tld</taglib-location>
</taglib>
<resource-ref>如果web應(yīng)用由Servlet容器管理的某個(gè)JNDI Resource,必須在web.xml中聲明對(duì)這個(gè)JNDI Resource的引用。
<resource-ref>
<description>DB Connection</description> //說明
<res-ref-name>jdbc/sampleDB</res-ref-name> //引用資源的JNDI名字
<res-type>javax.sql.DataSource</res-type> //引用資源的類名字
<res-auth>Container</res-auth> //管理引用資源的Manager
</resource-ref>
<security-constraint>用來為Web應(yīng)用定義安全約束
<security-constraint>
<web-resource-collection>//聲明受保護(hù)的web資源
<web-resource-name>ResourceServlet</web-resource-name>//標(biāo)識(shí)受保護(hù)web資源
<url-pattern>/ResourceServlet</url-pattern>//指定受保護(hù)的URL路徑
<http-method>GET</http-method>//指定受保護(hù)的方法
<http-method>POST</http-method>
</web-resource-collection>
<auth-constraint>//可以訪問受保護(hù)資源的角色
<description>this applies only to admin secrity role</description>
<role-name>admin</role-name>
</auth-constraint>
<user-data-constraint>
<transport-guarantee>NONE</transport-guarantee>
</user-data-constraint>
</security-constraint>
<login-config>元素指定當(dāng)Web客戶訪問受保護(hù)資源時(shí),系統(tǒng)彈出的登陸對(duì)話框的類型。例示配置了基于表單驗(yàn)證的登陸界面
<login-config>
<auth-method>FORM</auth-method>//BASIC(基本驗(yàn)證法),DIGEST(摘要驗(yàn)證),F(xiàn)ORM(表單驗(yàn)證)
<real-name>設(shè)定安全域的名稱</realname>
<form-login-config>
<form-login-page>/login.jsp</form-login-page>
<form-error-page>/error.jsp</form-error-page>
</form-login-config>
<security-role>指明這個(gè)Web應(yīng)用引用的所有角色名字
<security-role>
<description>描述</description>
<role-name>admin</role-name>
</security-role>