JavaServer Pages (JSP) 是一種以 Java為主的跨平台web開發語言。
JSP與微軟的Active Server Pages 相容,但它是使用類似HTML的卷標以及Java程式碼段而不是VBScript。當你所使用的網站伺服器沒有提供本地ASP支援,也就是Apache或Netscape伺服器時,你可以考慮使用JSP。雖然你可以取得這些伺服器的ASP附加配備模組,但價格相當昂貴,而目前Sun並沒有對你所需要的JSP組件收取費用(雖然Sun未來有可能會收費)。對於Solaris與Linux以及Windows,這些組件也都很容易取得。
請不要將JSP與伺服端的JavaScript混為一談。網站伺服器會自動將以JSP寫成的Java程式碼段轉換成Java servlets。而許多先前必須以Perl手寫程式或伺服器特定的API(如ASP)控制的功能也都可透過JSP來自動化處理。
現在就讓我們開始動手協助你建立一個可執行JSP範例網站。
安裝好你的機器來使用JSP
你將會需要Java 2軟體開發工具(JSDK),它原來的名稱是Java發展工具(JDK)以及JavaServer網站發展工具(JSWDK),Tomcat,或是其它支援JSP的網路伺服器。Sun免費提供JSDK與JSWDK來供Windows,Solaris,以及Linux平台使用。
如果你想要在你目前的網路伺服器上使用JSP,但伺服器本身並不支援JSP與Java servlets,你可以試試看Allaire的Jrun,它的作用就像是針對Netscape企業版與FastTrack伺服器、微軟的網際網路資訊服務器(IIS)與個人網路伺服器(PWS)、Apache、以及其它伺服器的網路伺服器附加元件。你也可以使用Apache網路伺服器的Java版本,最新的JSWDK裡有提供。
下載與安裝你需要的組件
目前發布的1.2.2-001,JSDK可下載的版本是以可安裝的壓縮檔形式。下載的檔案大約是20MB,可提供完整的Java發展環境,讓你能建立利用標準API為核心的Java解決之道。然而,你的網路伺服器需要應用到JSP的唯一一件事是Java編譯器。要讓網路伺服器知道編譯器的位置,將環境變數JAVA.HOME設到JSDK的安裝目錄。如果你是在Windows上安裝並且接受預設目錄,將這行程式碼set JAVA.HOME=C:.2.2加到你的autoexec.bat檔案並且重新開機。
在安裝好JSDK之後,下載 並且安裝JSWDK或beta版的Tomcat,以Java為主的Apache網路伺服器。安裝在哪裡並不重要,重要的是你可以找到它。一般而言,它會放在上層目錄,這種方式可以讓你取代JSWDK或 JSDK的網路伺服器,不需要移動其它的網路伺服器。在你安裝好這個檔案之後,你就可以準備發展JSP了。
在你正確的安裝JSWDK之後,執行startserver指令檔案來啟用網路伺服器,預設通訊連接埠 為 8080。要看你在啟用伺服器之後是均C有正確的安裝工具,你可以載入範例JSP檔案中的任何一個(http://localhost:8080/examples/jsp/)。如果你能夠成功的執行一個範例檔案,你可以知道你已經正確的設定好軟體了。如果你在啟用伺服器的控制台視窗看到錯誤訊息,那麼你需要解決這個問題。最常發生的問題是沒有設定(或者不正確設定)環境變數JAVA.HOME。要檢視目前的環境設定,在DOS模式下鍵入set。
開始
解釋JSP文法之前,先建立一個顯示目前日期與時間的快速網頁並且將它儲存成sample.jsp:
<html>
<head>
<title>First Page</title>
</head>
<body>
<H3>Today is:
<%= new java.util.Date() %>
</H3>
</body>
</html>.
將這個檔案與你所有的HTML與JSP網頁放在你JSWDK安裝目錄下的網頁目錄裡. 你可以在http://localhost:8080/sample.jsp下載此頁.當你第一次參觀這個網頁時,網站伺服器會將JSP翻譯成Java servlet程式碼,那你就會看到目前的日期與時間.
現在你已經下載,安裝,並且架構好發展環境,你已經準備好要瞭解JSP文法與建立你自己的JSP為主的解決之道.
JSP文法的基本原理
安裝之後,接下來我們要討論JSP的文法.如果要偷懶,你可以下載文法卡 而如果你不熟悉 Java的程式設計,你可能會想要參考Sun的使用手冊;然而,網站建立者不應該做太多的Java發展.除了幾個函式呼叫之外,出現在你JSP網頁上的Java程式碼應該將它減到最少;
記住這點之後,現在讓我們先來看看JSP的編譯器指引與指令組件,之後我們將解釋JavaBeans與內部對象. JSP編譯器指引與指令組件有五種型態.JSP 1.0之後,大部分的JSP是包含在以<% 作為開始%>作為結束的單一卷標裡.新的 JSP 1.1規格已經發表了,它同時也與XML相容.
JSP的編譯器指引與指令組件
編譯器指示
<%@ 編譯器指示 %>
聲明
<%! 聲明 %>
運算式
<%= 運算式 %>
程式碼段/小型指令
<% 程式碼片段 %>
注釋
<%-- 注釋 --%>
編譯器指示
JSP的編譯器指示是針對JSP引擎。它們並不會直接產生任何看得見的輸出;相反的,它們是在告訴引擎如何處理其它的JSP網頁。它們永遠包含在 <%@ ?%>卷標裡。兩個主要的指引是 page與include。我們不會討論taglib編譯器指引但它可以在JSP1.1裡用來建立自訂卷標。
你幾乎可以在你所有的JSP網頁最上面找到page編譯器指示。雖然這不是必須的,但它可以讓你指定到哪裡可以找到支援的Java類別這類的事:
<%@ page import="java.util.Date" %>,
當發生Java問題的事件時應該將訊息傳送到哪裡:
<%@ page errorPage="errorPage.jsp" %>,
以及你是?需要為使用者管理通話期的資訊,可能存取多個網頁(稍後在JavaBeans裡會有更多通話期的討論):
<%@ page session="true" %>。
include編譯器指示讓你將你的內容分成幾個可管理的組件,就像那些有表頭或腳註的網頁。所包含的網頁可以是固定格式的HTML網頁或者是JSP內容的網頁:
<%@ include file="filename.jsp" %>。
宣告
JSP聲明讓你定義網頁層的變數,來儲存資訊或定義支援的函式,讓JSP網頁的其餘部分能夠使用。如果你發現自己有太多的程式碼,你最好將它們放在不同的Java類別裡。你可以在 <%! ?%>卷標裡找到聲明。記住要在變數聲明的後面加上分號,就跟任何有效Java敘述的形式一樣: <%! int i=0; %>。
運算式
JSP裡有運算式,評估運算式的結果可以轉換成字串並且直接使用在輸出網頁上。JSP運算是屬於 <%= ?%> 卷標裡,並不包含分號,加引號字串的無用部分。
<%= i %>
<%= "Hello" %> 。
程式碼段/小型指令檔案
JSP程式碼片段或小型指令檔案是包含在<% ?%> 卷標裡。當網路伺服器接受這段請求時,這段Java程式碼會執行。小型指令檔案可以是原始的HTML或XML,其內部的程式碼片段可以讓你建立有條件的執行程式代碼,或者只是一些使用另一塊程式碼的東西。舉例來說,下列的程式碼結合了運算式與小型指令檔案,在H1,H2,H3,以及H4卷標裡顯示字串"Hello"。小型指令檔案不限於一行的原始程式碼 :
<% for (int i=1; i<=4; i++) { %>
<H<%=i%>>Hello</H<%=i%>>
<% } %>。
注釋
最後一個主要JSP組件是嵌入式注釋。雖然你可以在你的檔案裡包含HTML注釋,如果使用者檢視網頁的原始碼,他們也會看到這些注釋。如果你不要讓使用者看到你的批註,你可以將它放在<%-- ?--%>卷標裡:
<%-- 針對伺服端的注釋 --%>。
JSP與JavaBean
雖然你可以在小型指令檔案裡放入一大塊的程式碼,但是大多數的Java程式碼是屬於可以重複使用的組件,稱為JavaBean。JavaBean就跟ActiveX控制項一樣:它們提供已知的功能,並且是為了可隨時重複使用的目的而設計的。
JavaBean的價值在於它可以經由一組特性來使用,而這些特性則提供對JavaBean設定的存取。以人來作範例,此人就是JavaBean,而他的姓名,社會福利安全號碼,以及住址可以是特性。對於JSP網站,基本上你是將'JavaBean'動態串連到你的網站。
假設JavaBean是在?html>
JSP入門
JavaServer Pages (JSP) 是一種以 Java為主的跨平台web開發語言。
JSP與微軟的Active Server Pages 相容,但它是使用類似HTML的卷標以及Java程式碼段而不是VBScript。當你所使用的網站伺服器沒有提供本地ASP支援,也就是Apache或Netscape伺服器時,你可以考慮使用JSP。雖然你可以取得這些伺服器的ASP附加配備模組,但價格相當昂貴,而目前Sun並沒有對你所需要的JSP組件收取費用(雖然Sun未來有可能會收費)。對於Solaris與Linux以及Windows,這些組件也都很容易取得。
請不要將JSP與伺服端的JavaScript混為一談。網站伺服器會自動將以JSP寫成的Java程式碼段轉換成Java servlets。而許多先前必須以Perl手寫程式或伺服器特定的API(如ASP)控制的功能也都可透過JSP來自動化處理。
現在就讓我們開始動手協助你建立一個可執行JSP範例網站。
安裝好你的機器來使用JSP
你將會需要Java 2軟體開發工具(JSDK),它原來的名稱是Java發展工具(JDK)以及JavaServer網站發展工具(JSWDK),Tomcat,或是其它支援JSP的網路伺服器。Sun免費提供JSDK與JSWDK來供Windows,Solaris,以及Linux平台使用。
如果你想要在你目前的網路伺服器上使用JSP,但伺服器本身並不支援JSP與Java servlets,你可以試試看Allaire的Jrun,它的作用就像是針對Netscape企業版與FastTrack伺服器、微軟的網際網路資訊服務器(IIS)與個人網路伺服器(PWS)、Apache、以及其它伺服器的網路伺服器附加元件。你也可以使用Apache網路伺服器的Java版本,最新的JSWDK裡有提供。
下載與安裝你需要的組件
目前發布的1.2.2-001,JSDK可下載的版本是以可安裝的壓縮檔形式。下載的檔案大約是20MB,可提供完整的Java發展環境,讓你能建立利用標準API為核心的Java解決之道。然而,你的網路伺服器需要應用到JSP的唯一一件事是Java編譯器。要讓網路伺服器知道編譯器的位置,將環境變數JAVA.HOME設到JSDK的安裝目錄。如果你是在Windows上安裝並且接受預設目錄,將這行程式碼set JAVA.HOME=C:.2.2加到你的autoexec.bat檔案並且重新開機。
在安裝好JSDK之後,下載 並且安裝JSWDK或beta版的Tomcat,以Java為主的Apache網路伺服器。安裝在哪裡並不重要,重要的是你可以找到它。一般而言,它會放在上層目錄,這種方式可以讓你取代JSWDK或 JSDK的網路伺服器,不需要移動其它的網路伺服器。在你安裝好這個檔案之後,你就可以準備發展JSP了。
在你正確的安裝JSWDK之後,執行startserver指令檔案來啟用網路伺服器,預設通訊連接埠 為 8080。要看你在啟用伺服器之後是均C有正確的安裝工具,你可以載入範例JSP檔案中的任何一個(http://localhost:8080/examples/jsp/)。如果你能夠成功的執行一個範例檔案,你可以知道你已經正確的設定好軟體了。如果你在啟用伺服器的控制台視窗看到錯誤訊息,那麼你需要解決這個問題。最常發生的問題是沒有設定(或者不正確設定)環境變數JAVA.HOME。要檢視目前的環境設定,在DOS模式下鍵入set。
開始
解釋JSP文法之前,先建立一個顯示目前日期與時間的快速網頁並且將它儲存成sample.jsp:
<html>
<head>
<title>First Page</title>
</head>
<body>
<H3>Today is:
<%= new java.util.Date() %>
</H3>
</body>
</html>.
將這個檔案與你所有的HTML與JSP網頁放在你JSWDK安裝目錄下的網頁目錄裡. 你可以在http://localhost:8080/sample.jsp下載此頁.當你第一次參觀這個網頁時,網站伺服器會將JSP翻譯成Java servlet程式碼,那你就會看到目前的日期與時間.
現在你已經下載,安裝,並且架構好發展環境,你已經準備好要瞭解JSP文法與建立你自己的JSP為主的解決之道.
JSP文法的基本原理
安裝之後,接下來我們要討論JSP的文法.如果要偷懶,你可以下載文法卡 而如果你不熟悉 Java的程式設計,你可能會想要參考Sun的使用手冊;然而,網站建立者不應該做太多的Java發展.除了幾個函式呼叫之外,出現在你JSP網頁上的Java程式碼應該將它減到最少;
記住這點之後,現在讓我們先來看看JSP的編譯器指引與指令組件,之後我們將解釋JavaBeans與內部對象. JSP編譯器指引與指令組件有五種型態.JSP 1.0之後,大部分的JSP是包含在以<% 作為開始%>作為結束的單一卷標裡.新的 JSP 1.1規格已經發表了,它同時也與XML相容.
JSP的編譯器指引與指令組件
編譯器指示
<%@ 編譯器指示 %>
聲明
<%! 聲明 %>
運算式
<%= 運算式 %>
程式碼段/小型指令
<% 程式碼片段 %>
注釋
<%-- 注釋 --%>
編譯器指示
JSP的編譯器指示是針對JSP引擎。它們並不會直接產生任何看得見的輸出;相反的,它們是在告訴引擎如何處理其它的JSP網頁。它們永遠包含在 <%@ ?%>卷標裡。兩個主要的指引是 page與include。我們不會討論taglib編譯器指引但它可以在JSP1.1裡用來建立自訂卷標。
你幾乎可以在你所有的JSP網頁最上面找到page編譯器指示。雖然這不是必須的,但它可以讓你指定到哪裡可以找到支援的Java類別這類的事:
<%@ page import="java.util.Date" %>,
當發生Java問題的事件時應該將訊息傳送到哪裡:
<%@ page errorPage="errorPage.jsp" %>,
以及你是?需要為使用者管理通話期的資訊,可能存取多個網頁(稍後在JavaBeans裡會有更多通話期的討論):
<%@ page session="true" %>。
include編譯器指示讓你將你的內容分成幾個可管理的組件,就像那些有表頭或腳註的網頁。所包含的網頁可以是固定格式的HTML網頁或者是JSP內容的網頁:
<%@ include file="filename.jsp" %>。
宣告
JSP聲明讓你定義網頁層的變數,來儲存資訊或定義支援的函式,讓JSP網頁的其餘部分能夠使用。如果你發現自己有太多的程式碼,你最好將它們放在不同的Java類別裡。你可以在 <%! ?%>卷標裡找到聲明。記住要在變數聲明的後面加上分號,就跟任何有效Java敘述的形式一樣: <%! int i=0; %>。
運算式
JSP裡有運算式,評估運算式的結果可以轉換成字串並且直接使用在輸出網頁上。JSP運算是屬於 <%= ?%> 卷標裡,並不包含分號,加引號字串的無用部分。
<%= i %>
<%= "Hello" %> 。
程式碼段/小型指令檔案
JSP程式碼片段或小型指令檔案是包含在<% ?%> 卷標裡。當網路伺服器接受這段請求時,這段Java程式碼會執行。小型指令檔案可以是原始的HTML或XML,其內部的程式碼片段可以讓你建立有條件的執行程式代碼,或者只是一些使用另一塊程式碼的東西。舉例來說,下列的程式碼結合了運算式與小型指令檔案,在H1,H2,H3,以及H4卷標裡顯示字串"Hello"。小型指令檔案不限於一行的原始程式碼 :
<% for (int i=1; i<=4; i++) { %>
<H<%=i%>>Hello</H<%=i%>>
<% } %>。
注釋
最後一個主要JSP組件是嵌入式注釋。雖然你可以在你的檔案裡包含HTML注釋,如果使用者檢視網頁的原始碼,他們也會看到這些注釋。如果你不要讓使用者看到你的批註,你可以將它放在<%-- ?--%>卷標裡:
<%-- 針對伺服端的注釋 --%>。
JSP與JavaBean
雖然你可以在小型指令檔案裡放入一大塊的程式碼,但是大多數的Java程式碼是屬於可以重複使用的組件,稱為JavaBean。JavaBean就跟ActiveX控制項一樣:它們提供已知的功能,並且是為了可隨時重複使用的目的而設計的。
JavaBean的價值在於它可以經由一組特性來使用,而這些特性則提供對JavaBean設定的存取。以人來作範例,此人就是JavaBean,而他的姓名,社會福利安全號碼,以及住址可以是特性。對於JSP網站,基本上你是將'JavaBean'動態串連到你的網站。
假設JavaBean是在建立網站之前建好的,你要做的第一件事是告訴JSP網頁它所需要使用JavaBean.這工作可以用<jsp:useBean>卷標來完成:
<jsp:useBean id="localName" class="com.jguru.Person" scope="application" />.
<jsp:useBean>卷標需要你以id 屬性來辨識豆子.在這裡,你提供一個名稱讓JSP網頁來辨識豆子,除了id 屬性之外,你也必須告訴網頁要到哪裡去找這個豆子,或者是它的Java類別名稱。類別屬性提供如何在各式方法之中找到它,最後一個需要的組件是scope 屬性.有了範圍屬性的協助,你可以告訴豆子,要它為單一網頁(預設)[scope="page"];為一個被請求的網頁[scope="request"];為通話期[scope="session"];或為整個應用程式[scope="application"]來維護它自己的資訊.對於通話期範圍,你可以很容易的維護JSP網頁裡的項目,例如購物車。
一但你宣告了JavaBean之後,你就可以存取它的特性來訂定它。要取得一特性的值,使用<jsp:getProperty>卷標。有了<jsp:getProperty>卷標,你可以指定要使用的豆子名稱(從useBean的id欄位),以及你要取得值的特性。接著,真正的值就會放在輸出裡:
<jsp:getProperty id="localName" property="name" />.
要更改JavaBean的特性,你需要使用<jsp:setProperty>卷標.對這個卷標,你也需要辨認豆子以及要修正的特性,除此之外,你還需要提供新值.如果命名正確,這些可以直接經由規定的格式取得:
<jsp:setProperty id="localName" property="*" />;
要從一參數取得,你必須直接命名此特性以及參數:
<jsp:setProperty id="localName" property="address" param="parameterName" />;
或是直接以名稱與值來設定:
<jsp:setProperty id="localName" property="serialNumber" value="string" /> or <jsp:setProperty id="localName" property="serialNumber" value= <%= expression %> />.
有關JavaBean的最後一點:要讓網路伺服器可以找到JavaBean,你需要將它們的類別檔案放在特別位置。對JSWDK而言,最簡單的地方是在安裝目錄裡的類別目錄,例如 \jswdk-1.0.1\classes.
JSP的內部對象
最後一個與JSP文法有關的組件叫做內部對象.在JSP小型指令檔案內,你可以存取這些內部對象來與執行JSP網頁的servlet環境相互作用。許多對內部對象的存取應該要簡化。然而,這些是範例,它們的存取都是可接受的,要完整的利用內部對象設定則需要對最新的Java Servlet API有所瞭解。
下表列出你可以使用的內部對象。
內部對象說明
request
用戶端請求,此請求會包含來自GET/POST請求的參數
response
網頁傳回用戶端的響應
pageContext
網頁的屬性是在這裡管理
session
與請求有關的會話
application
servlet正在執行的內容
out
用來傳送響應的輸出資料流
config
servlet的架構對象
page
JSP網頁本身
exception
針對錯誤網頁,未捕捉的例外
那麼,這些是做什麼的,而你應該如何使用它們呢?基本上,在你的小型指令檔案裡,你可以使用它們來存取執行JSP程式碼的servlet。為了避免談論到太多Servlet API 的細節,讓我們來檢視一些你可以利用它們來做的事:
不必使用運算式,你可以直接存取內部out對象來列印一些東西到response:
<% out.println("Hello"); %>.
不必直接傳送參數到JavaBean,你可以藉由請求對象來取得參數的值:
<% String name=request.getParameter("name"); out.println(name); %>。
當你以JSP寫了許多的應用程式之後,如果你建立了JavaBeans或者發現你自己將太多的Java原始碼放入你的JSP檔案,你需要建立支援的Java類別,這樣可以鼓勵重複使用並且降低JSP網頁轉換時所需要的時間。當你需要建立Java類別時,你必須:
將JDSWK的安裝目錄\bin目錄加到你的PATH。在你的autoexec.bat檔案的PATH行的最後,加入C:.2.2\bin; 。
以下面的指令將JAR檔案複製到\jre\lib\ext目錄:
copy c:\jswdk-1.0.1\lib\servlet.jar c:\jdk1.2.2\jre\lib\ext.