WebLogic Server Web アプリケーション、サーブレット、JSP の開発
|
 |
 |
|
以下の節では、JavaServer Pages (JSP) の作成に関するリファレンス情報を提供します。
以下の表では、JSP ページで使用できる基本的なタグについて説明します。短縮形のタグには、それぞれ対応する XML タグがあります。
|
|
||
|
|
||
|
|
||
|
|
||
|
|
|
|
|
|
JSP では、スクリプトレットや式に含まれる暗黙的オブジェクト用に予約語が用意されています。この暗黙的オブジェクトとは、JSP ページに有用なメソッドや情報を提供する Java オブジェクトです。WebLogic JSP は、JSP 2.0 仕様に定義されている暗黙的オブジェクトをすべて実装しています。JSP API については、Sun Microsystems の JSP ホームページにある Javadoc で説明されています。
注意 : この暗黙的オブジェクトはスクリプトレットや式の中でのみ使用するようにします。宣言で定義されるメソッドからこれらのキーワードを使用すると、未定義の変数を参照することになるため、変換時にコンパイル エラーが発生します。
request は、HttpServletRequest オブジェクトを表します。ブラウザからのリクエストについての情報が含まれ、クッキー、ヘッダ、およびセッション データを取得するために便利な一連のメソッドも用意されています。
response は、HttpServletResponse オブジェクト、JSP ページからブラウザに返送される応答の設定に便利な複数のメソッドを表します。この応答の例には、クッキーやその他のヘッダ情報があります。
警告 : JSP ページ内から response.getWriter() メソッドを使用することはできません。使用した場合、実行時例外が送出されます。JSP 応答をブラウザに返送するには、可能であればスクリプトレット コード内から out キーワードを使用します。WebLogic Server の javax.servlet.jsp.JspWriter の実装では、javax.servlet.ServletOutputStream を使用しています。これは、response.getServletOutputStream() を使用できることを暗黙的に示しています。しかし、この実装は WebLogic Server に固有のものであることに注意が必要です。コードの保守容易性および移植性を保つには、out キーワードを使用します。
out は、javax.jsp.JspWriter のインスタンスで、ブラウザへの出力の返送に使用できるメソッドがあります。
出力ストリームを必要とするメソッドを使用している場合、JspWriter は動作しません。この制限を回避するには、バッファされたストリームを提供して、このストリームを out に記述します。次のコードに、例外スタック トレースを out に記述する方法を示します。
ByteArrayOutputStream ostr = new ByteArrayOutputStream();
exception.printStackTrace(new PrintWriter(ostr));
out.print(ostr);
pageContext は、javax.servlet.jsp.PageContext オブジェクトを表します。さまざまなスコープのネームスペースやサーブレット関連オブジェクトへのアクセスに便利な API で、一般的なサーブレット関連機能のためのラッパー メソッドを提供します。
session は、リクエストに対する javax.servlet.http.HttpSession オブジェクトを表します。セッション ディレクティブは、デフォルトでは true に設定されています。したがって、session はデフォルトで有効です。JSP 2.0 仕様では、セッション ディレクティブが false に設定されている場合、session キーワードを使用すると変換時に致命的なエラーが発生することが説明されています。
application は、javax.servlet.ServletContext オブジェクトを表します。サーブレット エンジンやサーブレット環境に関する情報の検索に使用します。
リクエストを転送または取り込む場合は、ServletContext を使用してサーブレットの requestDispatcher にアクセスできます。または、他のサーブレットへのリクエストの転送に JSP の forward ディレクティブ、他のサーブレットからの出力の取り込みに JSP の include ディレクティブを使用することもできます。
page は、この JSP ページから生成されたサーブレット インスタンスを表します。スクリプトレット コード内の Java キーワード this と同義です。
page は java.lang.Object のインスタンスとして定義されるため、使用する際には JSP ページを実装しているサーブレットのクラス タイプにキャストする必要があります。デフォルトでは、このサーブレット クラスは JSP ファイル名を取って名付けられます。便宜上、page を使用する代わりに、Java キーワード this を使用してサーブレット インスタンスを参照し、初期化パラメータへアクセスすることをお勧めします。
関数を実行したり、JSP ページを特定の方法で解釈したりするよう WebLogic JSP に指示するには、ディレクティブを使用します。ディレクティブは、JSP ページのどこに挿入してもかまいません。通常、ディレクティブの位置は無関係で (include ディレクティブを除く)、複数のディレクティブ タグを使用できます。ディレクティブは、ディレクティブ タイプとその 1 つまたは複数の属性で構成されます。
構文は、次に示すように短縮形と XML の 2 種類を使用できます。
dir_type はディレクティブのタイプ、dir_attr はそのディレクティブ タイプの 1 つまたは複数のディレクティブ属性のリストで置き換えます。
ディレクティブには、page、taglib、include の 3 種類があります。
文字エンコーディング セットを指定するには、そのページの先頭で次のディレクティブを使用します。
<%@ page contentType="text/html; charset=custom-encoding" %>
contentType ディレクティブで指定した文字セットは、JSP およびその JSP に含まれるすべての JSP で使用される文字セットを指定します。
Web アプリケーションの WebLogic 固有のデプロイメント記述子で、デフォルトの文字エンコーディングを指定できます。
taglib ディレクティブを使用して、JSP ページが、タグ ライブラリに定義されているカスタム JSP タグ拡張を使用することを宣言します。カスタム JSP タグの記述方法と使い方の詳細については、『WebLogic JSP Tag Extensions プログラマーズ ガイド』を参照してください。
宣言を使用して、生成された JSP サーブレット内のクラス スコープ レベルの変数とメソッドを定義します。JSP タグの間に記述された宣言は、JSP ページの他の宣言やスクリプトレットからアクセスできます。以下に例を示します。
<%!
int i=0;
String foo= "Hello";
private void bar() {
// ここに Java コードを記述
}
%>
クラス スコープのオブジェクトは、サーブレットの同一のインスタンス内で実行中の複数のスレッド間で共有されます。共有違反を防ぐには、クラス スコープのオブジェクトを同期させます。スレッドセーフなコードの記述に自信がない場合は、次のディレクティブを使用して、サーブレットを非スレッドセーフとして宣言できます。
<%@ page isThreadSafe="false" %>
デフォルトでは、この属性は true に設定されています。isThreadSafe を false に設定すると、メモリ消費量が増えるのでパフォーマンスが低下することがあります。
JSP スクリプトレットは、JSP サーブレットの HTTP 応答の Java 本文を構成します。次に示すように短縮形または XML の scriptlet タグを使用して、JSP ページ内にスクリプトレットを含めます。
out を使用して、Java コードからサーブレット出力ストリームに、HTML テキストを直接出力できる。print() メソッドを呼び出して、HTTP ページ応答に文字列を追加します。 ユーザが以前に入力したデータを出力する場合、HTML 特殊文字が入力されていればすべて削除することをお勧めします。これらの文字を削除しない場合、クロスサイト スクリプティングによって Web サイトが損なわれるおそれがあります。詳細については、「JSP 式言語の名前付き変数」を参照してください。
JSP ファイルの中に式を含めるには、次のタグを使用します。
expr を Java 式で置き換えます。式が評価されるときに、その string 表現が HTML 応答ページ内にインラインで配置されます。このタグは次のタグの短縮形です。
<% out.print( expr ); %>
このテクニックを使用すると、JSP ページ内の HTML を読みやすくできます。次の節のサンプルでは expression タグの使い方を示します。
式は、ユーザが以前に入力したデータを返すためによく使われます。ユーザが入力したデータを出力する場合、HTML 特殊文字が入力されていればすべて削除することをお勧めします。これらの文字を削除しない場合、クロスサイト スクリプティングによって Web サイトが損なわれるおそれがあります。詳細については、「JSP 式言語の名前付き変数」を参照してください。
次に、HTML と埋め込み Java を使用した JSP の例を示します。
<html>
<head><title>Hello World Test</title></head>
<body bgcolor=#ffffff>
<center>
<h1> <font color=#DB1260> Hello World Test </font></h1>
<font color=navy>
<%
out.print("Java-generated Hello World");
%>
</font>
<p> This is not Java!
<p><i>Middle stuff on page</i>
<p>
<font color=navy>
<%
for (int i = 1; i<=3; i++) {
%>
<h2>This is HTML in a Java loop!<%= i %> </h2>
<%
}
%>
</font>
</center>
</body>
</html>
上記のコードがコンパイルされると、ブラウザには次のようなページが表示されます。
JSP アクションを使用して、JavaBean で表されるオブジェクトの変更、使用、または作成を行います。アクションでは、XML 構文のみが使用されます。
<jsp:useBean> アクション タグを使用すると、JavaBean 仕様に準拠した Java オブジェクトをインスタンス化し、それを JSP ページから参照できます。
JavaBean 仕様に準拠するには、オブジェクトに次のものが必要です。
variable フィールドに対する setVariable() メソッドvariable フィールドに対する getVariable() メソッド<jsp:useBean> タグは、既存の名前付き Java オブジェクトを特定のスコープから検索しようと試みます。既存のオブジェクトが見つからなければ、新しいオブジェクトをインスタンス化し、id 属性で指定された名前にそのオブジェクトを関連付けようとします。オブジェクトは、オブジェクトの可用性を決定する scope 属性で指定された位置に格納されます。たとえば、次のタグでは、examples.jsp.ShoppingCart というタイプの Java オブジェクトを、cart という名前の HTTP セッションから検索しようとします。
<jsp:useBean id="cart"
class="examples.jsp.ShoppingCart" scope="session"/>
そのようなオブジェクトがその時点で存在しなければ、JSP では新しいオブジェクトを作成し、cart という名前の HTTP セッション内に格納しようとします。クラスは、WebLogic Server の起動に使用する CLASSPATH 内、または JSP を含む Web アプリケーションの WEB-INF/classes ディレクトリに入っている必要があります。
捕捉が必要な実行時例外があるので、<jsp:useBean> タグと共に errorPage ディレクティブを使用することをお勧めします。errorPage ディレクティブを使用しない場合、JavaBean で参照されるクラスを作成できず、InstantiationException が送出され、ブラウザにエラー メッセージが返されます。
Java 内で有効な型キャスト操作であれば、type 属性を使用して、その JavaBean タイプを別のオブジェクトやインタフェースにキャストできます。class 属性なしで type 属性を使用する場合、JavaBean オブジェクトは、指定したスコープ内にすでに存在している必要があります。有効でない場合は、InstantiationException が送出されます。
<jsp:useBean> タグ構文には、別の形式もあります。これを使用すると、オブジェクトがインスタンス化されるときに実行する JSP コードの本文を定義できます。名前付き JavaBean が指定したスコープ内にすでにある場合、本文は実行されません。この形式を使用すると、オブジェクトが最初に作成されるときのプロパティを設定できます。以下に例を示します。
<jsp:useBean id="cart" class="examples.jsp.ShoppingCart"
scope=session>
Creating the shopping cart now...
<jsp:setProperty name="cart"
property="cartName" value="music">
</jsp:useBean>
注意 : class 属性なしで type 属性を使用すると、JavaBean オブジェクトはインスタンス化されません。したがって、本文を含めるようなタグ形式は使用しないでください。代わりに、単一のタグ形式を使用します。この場合、JavaBean が指定したスコープ内に存在している必要があります。存在していないと InstantiationException が送出されます。errorPage ディレクティブを使用して、潜在的な例外を捕捉します。
JavaBean オブジェクトをインスタンス化したら、Java オブジェクトのように、JSP ファイルでその id 名により参照できます。この JavaBean オブジェクトは、スクリプトレット タグや式評価タグ内で使えます。<jsp:setProperty> タグを用いてその setXxx() メソッドを呼び出すこともでき、また <jsp:getProperty> タグを用いて getXxx() メソッドを呼び出すこともできます。
scope 属性を使用して、JavaBean オブジェクトの可用性とライフスパンを指定します。スコープは以下のいずれかです。
JavaBean に対するデフォルトのスコープです。オブジェクトは現在のページの javax.servlet.jsp.PageContext に格納されます。この JSP ページの現在の呼び出しからのみ使用できます。インクルードされた JSP ページでは使用できません。このページ リクエストの完了時には破棄されます。
request スコープを使用すると、オブジェクトは現在の ServletRequest 内に格納されます。同じリクエスト オブジェクトに渡された他のインクルード済み JSP ページで使用可能です。このオブジェクトは現在のリクエストが完了したときに破棄されます。
複数の HTTP ページにわたって JavaBean オブジェクトを追跡できるよう、session スコープを使用して HTTP セッション内に JavaBean オブジェクトを格納できます。JavaBean への参照は、このページの HttpSession オブジェクトに格納されます。このスコープを使用するには、JSP ページがセッションに参加できなければなりません。つまり、この page ディレクティブで、session を false に設定しないようにします。
JavaBean の使い方の詳細については、JSP 2.0 仕様を参照してください。
どのような種類の認証を使用している場合でも、<jsp:forward> タグでリクエストが転送されるときには、ユーザを再認証する必要はありません (デフォルト設定)。この動作を変更して、転送されたリクエストの認証を実行するには、<check-auth-on-forward/> 要素を WebLogic 固有のデプロイメント記述子 (weblogic.xml) の <container-descriptor> 要素に追加します。以下に例を示します。
<container-descriptor>
<check-auth-on-forward/>
</container-descriptor>
<jsp:include> タグを使用すると、JSP に別のリソースを含めることができます。このタグは、次の 2 種類の属性を取ります。
<jsp:include> タグが JSP ページの別のタグ内にあり、含めるリソースをそのタグで処理する場合は、flush="false" に設定すると便利です。
新しい JSP 式言語 (JSP EL) は、ECMAScript 式言語と XPath 式言語の両方の影響を受けています。JSP EL は、標準アクションおよびカスタム アクションの属性値と、テンプレート テキスト内で使用可能です。どちらの場合も、JSP EL は一貫して構文 ${expr} で呼び出されます。
この JSP EL が JSP 技術に追加されたことで、スクリプトレット JSP ページをより簡単に記述できるようになりました。スクリプトレット JSP ページでは JSP EL 式を使用できますが、Java スクリプトレット、Java 式、そして Java 宣言要素は使用できません。この使用パターンは、web.xml デプロイメント記述子のスクリプティングが無効化された JSP コンフィグレーション要素にも適用できます。
JSP 式言語の詳細については、JSP 2.0 仕様を参照してください。
JSP EL 式は、実行時の式を受け入れられる任意の属性で、標準アクションとカスタム アクションのどちらの場合にも使用できます。以下に、属性値での式の使用方法として 3 つの例を示します。
注意 : このルールは JSP 2.0 の変換と同様ですが、空の文字列の扱いが異なります。
以下に、JSP EL を使用して Bean のプロパティが 3 個未満かどうかを調べる条件付きのアクションを示します。
<c:if test="${bean1.a < 3}">
...
</c:if>
通常の JSP の制御メカニズムでも <mytags:if test="true" /> を使用することは可能です。リテラル値に文字列 ${ を含める場合、この値を含むリテラルの使用方法は次のようになります。
<mytags:example code="an expression is ${'${'}expr}" />
結果として生じる属性値は、「an expression is ${expr}」という文字列になります。
テンプレート テキスト内には JSP EL を直接使用できます。カスタムまたは標準のアクションの本文内でもアクション外部のテンプレート テキスト内でも構いません。ただし、タグの本体がタグ依存の場合や、(通常、互換性の問題から) ディレクティブによって明示的に、または暗黙的に JSP EL が無効化されている場合は除きます。
JSP EL 式のセマンティクスは Java 式と同じで、値が計算されて現在の出力に挿入されます。エスケープ処理が必要な場合 (クロスサイト スクリプティング攻撃を予防するために行う場合など) は、JSTL のコア タグ <c:out> を使用できます。以下に例を示します。
<c:out value="${anELexpression}" />
以下に示すカスタム アクションでは、2 つの JSP EL 式を使用して Bean のプロパティにアクセスしています。
1 つめの値は ${bean1.a}、2 つめの値は ${bean2.a.c} です。
</c:wombat>
JSP ページ内で使用する JSP EL 式で利用可能な暗黙的オブジェクトが、複数用意されています。これらのオブジェクトは以下の名前を使用して常に利用可能です。
pageContext
pageScope
requestScope
sessionScope
applicationScope
param
paramValues
header
headerValues
cookie
initParam
表 10-1 に、上記の暗黙的オブジェクトの使用例をいくつか示します。
以降の節では、JSP EL 式のリテラルと演算子について説明します。JSP EL の構文はとても簡単です。変数には名前でアクセスできます。汎用の演算子 [] を使用すると、マップ、リスト、オブジェクトの配列、および JavaBean オブジェクトのプロパティにアクセスできます。この演算子は自由にネスト可能です。. 演算子は、Java の ID 規約に従った名前を持つプロパティに対し、簡単にアクセスする手段として使用できます。一方、[] 演算子では、より汎用的なアクセスが可能です。
標準の Java 比較演算子を使用して、関係比較を行えます。他の値、ブール値 (等価比較のみ)、String 型、整数、または浮動小数点リテラルに対して比較を実行できます。算術演算子を使用すると、整数および浮動小数点の値を計算できます。論理演算子も利用可能です。
ブール値、整数、浮動小数点、文字列、null 用のリテラルが用意されています。
ほとんどの場合、JSP ページは表示用に使われます。表示に使用する場合は一般的に、ページに単純なエラーがあっても可能な限り良い状態で表示できるようにすることが、もっとも重要なポイントになります。JSP EL では、この要件のための警告は用意されていませんが、デフォルト値とエラーを利用できます。デフォルト値は入力を修正する値で、問題がある場合に代わりに表示するものとして割り当てられます。エラーは例外であり、送出された後には標準の JSP 機構で処理されます。
JSP 式言語 (JSP EL) で提供される演算子の一覧を以下に示します。
演算子とその機能の詳細については、JSP 2.0 仕様を参照してください。
以下に、演算子の優先順位を高い方から低い方へ、左から右の順で示します。
以下の単語は予約語であり、識別子として使用することはできません。
現時点では、これらの単語の多くがこの言語に含まれていません。ただし、将来的に組み入れられる可能性があるので、使用は避けるようにしてください。
JSP EL の基本的な構想に、変数名を評価してオブジェクトに解決することがあります。JSP EL API では、名前をオブジェクトに解決する汎用メカニズムとして VariableResolver が提供されています。このデフォルトの解決メカニズムが、テンプレートや属性内にある JSP EL 式の評価に使用されます。このデフォルト解決メカニズムでは、「JSP 式言語の暗黙的オブジェクト」で説明した暗黙的オブジェクトが提供されています。
デフォルトの解決メカニズムでは、他の識別子をマップすることも可能です。これには、pageContext オブジェクトの PageContext.findAttribute(String) の動作により、識別子の値を属性としてルックアップします。例えば ${product} のようにします。
この式では product という名前の属性を検索し、ページ、リクエスト、セッション、およびアプリケーション スコープを検索して、属性の値を返します。属性が見つからない場合、null が返されます。JSP 2.0 仕様の 14 章「Expression Language API」で、VariableResolver の詳細と、評価 API との対応関係について参照してください。
式やスクリプトレットを使うと、JSP でユーザからデータを受け取ったり、ユーザが入力したデータを返したりできます。たとえば、リスト 10-1 のサンプル JSP では、ユーザに文字列の入力を求め、その文字列を userInput という名前のパラメータに代入してから、<%= javax.servlet.ServletRequest.getParameter("userInput")%> という式を使ってそのデータをブラウザに返しています。
コード リスト 10-1 ユーザが入力した内容を返すための式の使用
<html>
<body>
<h1>My Sample JSP</h1>
<form method="GET" action="mysample.jsp">
Enter string here:
<input type="text" name="userInput" size=50>
<input type=submit value="Submit">
</form>
<br>
<hr>
<br>
Output from last command:
<%=javax.servlet.ServletRequest.getParameter("userInput")%>
</body>
</html>
このようにユーザが入力したデータを返す機能があると、クロスサイト スクリプティングと呼ばれるセキュリティの脆弱性がもたらされます。これは、ユーザのセキュリティ認可を盗用するために利用されるおそれがあります。クロスサイト スクリプティングの詳細については、http://www.cert.org/tech_tips/malicious_code_mitigation.html の「Understanding Malicious Content Mitigation for Web Developers」 (CERT のセキュリティ勧告) を参照してください。
セキュリティの脆弱性をなくすには、ユーザが入力したデータを返す前にそのデータを走査して、表 10-2 に示す HTML 特殊文字があるかどうかを調べます。特殊文字が見つかった場合、HTML のエンティティ参照または文字参照と置き換えます。文字を置換することで、ブラウザでユーザ入力によるデータが HTML として実行されることを回避します。
WebLogic Server には、ユーザが入力したデータ内の特殊文字を置き換える weblogic.servlet.security.Utils.encodeXSS() メソッドが用意されています。このメソッドを使用するには、ユーザ入力データを入力として提供します。次に例を示します。<%= weblogic.servlet.security.Utils.encodeXSS(
javax.servlet.ServletRequest.getParameter("userInput"))%>
アプリケーション全体を保護するため、ユーザが入力したデータは、返す際に毎回 encodeXSS() メソッドを使用する必要があります。上記の例は encodeXSS() メソッドを明らかに使用すべき場所ですが、表 10-3 には、他に encodeXSS() メソッドの使用を検討すべき場所を示します。
WebLogic JSP 内のセッションは、JSP 2.0 仕様に従って動作します。次に、セッションの使い方に関連した留意事項を示します。
ClassCastException エラーが返されます。
JSP を使用すると、適切なクライアント ブラウザ タグを含む HTML を生成することによって、Web ページに Java Plug-in を簡単に組み込むことができます。Java Plug-in では、クライアントの Web ブラウザにより実装された JVM の代わりに、Sun Microsystems から提供されている Java Runtime Environment (JRE) を使用することができます。この機能により、アプレットと特定の種類の Web ブラウザ間の非互換性による問題が回避できます。Java Plug-in は、Sun の Web サイト (http://java.sun.com/products/plugin/) から入手できます。
Internet Explorer と Netscape では使用している構文が違うため、<jsp:plugin> アクションから生成されたサーブレット コードでは、動的にブラウザ クライアントの種類が調べられ、適切な <OBJECT> タグか、<EMBED> タグがその HTML ページに送信されます。
<jsp:plugin> タグでは、<APPLET> タグの属性に似た多くの属性、および使用する Java Plug-in のバージョンをコンフィグレーションできる他の属性群が使用されます。アプレットがサーバと通信する場合、アプレット コードを実行する JVM は WebLogic Server を実行する JVM と互換性がある必要があります。
次のサンプルでは、plugin アクションを使用してアプレットをデプロイします。
<jsp:plugin type="applet" code="examples.applets.PhoneBook1"
codebase="/classes/" height="800" width="500"
jreversion="2.0"
nspluginurl=
"http://java.sun.com/products/plugin/1.1.3/plugin-install.html"
iepluginurl=
"http://java.sun.com/products/plugin/1.1.3/
jinstall-113-win32.cab#Version=1,1,3,0" >
<jsp:params>
<param name="weblogic_url" value="t3://localhost:7001">
<param name="poolname" value="demoPool">
</jsp:params>
<jsp:fallback>
<font color=#FF0000>Sorry, cannot run java applet!!</font>
</jsp:fallback>
</jsp:plugin>
上のサンプルの JSP 構文は、ブラウザに対して、(まだダウンロードされていなければ) Java Plug-in バージョン 1.3.1 をダウンロードし、code 属性で指定したアプレットを、codebase で指定された位置から実行するように指示しています。
jreversion 属性は、アプレットが要求している Java Plug-in のバージョンを識別します。Web ブラウザでは、このバージョンの Java Plug-in を使おうとします。プラグインがまだブラウザにインストールされていない場合、nspluginurl 属性および iepluginurl 属性で URL が指定され、そこで、Sun の Web サイトからその Java Pug-in をダウンロードできます。一度プラグインが Web ブラウザにインストールされれば、再度そのプラグインをダウンロードする必要はありません。
WebLogic Server では Java 1.3.x VM を使用するため、<jsp:plugin> タグ内に、Java Plug-in バージョン 1.3.x を指定する必要があります。上のサンプル コードで 1.3 JVM を指定するには、対応する属性値を次のように置き換えます。
jreversion="1.3"
nspluginurl=
"http://java.sun.com/products/plugin/1.3/plugin-install.html"
iepluginurl=
"http://java.sun.com/products/plugin/1.3/jinstall-131-win32.cab"
プラグイン アクションのほかの属性は、<APPLET> タグの属性に相当します。アプレット パラメータは、<params> タグのペアで指定し、<jsp:plugin> タグと </jsp:plugin> タグでネストします。
<jsp:fallback> タグでは、<jsp:plugin> アクションでサポートされていないブラウザ用に HTML を置換できます。<fallback> タグと </jsp:fallback> タグでネストされた HTML が、プラグイン構文の代わりに送られます。
WebLogic JSP コンパイラは非推奨になっています。EAR ファイル、WAR ファイル、および EJB のコンパイルには、WebLogic の appc コンパイラである weblogic.appc の使用をお勧めします。
WebLogic JSP コンパイラではコンパイルのパフォーマンスを向上させるため、ディスク上にまず java ファイルを作成してからクラス ファイルにコンパイルするのではなく、直接 JSP をディスク上のクラス ファイルに変換します。java ファイルはメモリ上にのみ置かれます。
生成された java ファイルを参照するには、メモリ内の java ファイルをディスクにダンプする -keepgenerated フラグをオンにします。
注意 : JSP のコンパイル中には、コマンドライン フラグ (compilerclass) も記述子要素も呼び出されません。
JSP コンパイラは、他の WebLogic コンパイラ (RMI コンパイラや EJB コンパイラなど) とほとんど同じ方法で動作します。JSP コンパイラを起動するには、次のコマンドを入力します。
$ java weblogic.jspc -options fileName
fileName を、コンパイルする JSP ファイルの名前で置き換えます。対象の fileName の前か後に options を指定することもできます。次の例では、-d オプションを使用して myFile.jsp をコンパイルし、出力先ディレクトリ weblogic/classes に出力します。
$ java weblogic.jspc -d /weblogic/classes myFile.jsp
注意 : Web アプリケーションの一部で、Web アプリケーションのリソース (JSP タグ ライブラリなど) を参照している JSP をプリコンパイルする場合は、-webapp フラグを使用して Web アプリケーションの場所を指定する必要があります。-webapp フラグは JSP コンパイラ オプションの次のリストで説明します。
希望する CLASSPATH となるディレクトリのリストを (Windows NT/2000 プラットフォームではセミコロンで区切り、UNIX プラットフォームではコロンで区切って) 追加します。JSP に必要なすべてのクラスを格納するディレクトリを含めます。次に例を示します (実際には 1 行で入力します)。
$ java weblogic.jspc
-classpath java/classes.zip;/weblogic/classes.zip
myFile.JSP
JSP contentType ディレクティブで使用される IANA または非公式の文字セット名から java 文字セット名へのマッピングを指定します。以下に例を示します。
最も一般的なマッピングは、JSP コンパイラに組み込まれています。このオプションは、希望の文字セット マッピングが認識されない場合にのみ使用します。
カレント ディレクトリ、または -webapp オプションで指定したディレクトリ内のすべての JSP を再帰的にコンパイルします (このオプション リストにある -webapp の説明を参照してください)。サブディレクトリ内の JSP もコンパイルされます。
生成された Java ソース コードからクラス ファイルをコンパイルする際に使用する Java コンパイラを指定します。デフォルトでは、コンパイラとして javac が使われます。コンパイラの絶対パスを明示的に指定する場合を除いて、Java コンパイラ プログラムは PATH 内になければなりません。
コンパイルされた出力 (クラス ファイル) の出力先ディレクトリを指定します。このオプションは、コンパイルされたクラスを、すでに CLASSPATH に入っているディレクトリに置くためのショートカットとして使用します。
有効な引数は、(a) JDK のデフォルト文字エンコーディングの使用を指定する default、または (b) 8859_1 などの名前付き文字エンコーディングです。-encoding フラグが指定されない場合、バイト配列が使用されます。
JSP ファイルに、多数のまたは深くネストしたカスタム JSP タグが含まれていて、コンパイル時に java.lang.VerifyError 例外が発生する場合、JSP を正しくコンパイルするためにこのフラグを使用します。
生成されたサーブレットによって拡張されたスーパークラスのクラス名を設定します。スーパークラスの名前は、HttpServlet または GenericServlet から派生したものでなければなりません。
weblogic.xml デプロイメント記述子の <jsp-descriptor> 要素の precompile パラメータを true に設定すると、Web アプリケーションをデプロイまたは再デプロイしたとき、あるいは WebLogic Server を起動したときに JSP をプリコンパイルするようにコンフィグレーションできます。サーバを再起動するたびに、また追加でサーバを対象指定したときに、JSP を再コンパイルしなくても済むようにするには、weblogic.jspc を使用して JSP をプリコンパイルし、プリコンパイルした JSP を WEB-INF/classes フォルダにコピーして、.war ファイルにアーカイブします。ソース ファイルをアーカイブ .war ファイルとは別のディレクトリに格納すると、クラス ファイルのどれかと JSP との依存関係によってエラーが発生するおそれがなくなります。
|
|
|