Oracle Application Server 10g Oracle Containers for J2EE - サーブレット

Transcription

1 faq ORACLE FUSION MODDLEWARE Oracle Application Server 10g Oracle Containers for J2EE - サーブレット Frequently Asked Questions 2006 年 10 月 この FAQ では Oracle Containers for J2EE 10g(10.1.3) のサーブレット コンテナについて よく尋ねられる質 問を取り上げます Oracle Container for J2EE は Servlets 2.4 をはじめとする J2EE 1.4 標準に準拠しています 1. OC4J スタートアップ時に Web アプリケーションを自動的にロードする方法を教えてください たとえば 次のように <web-app> タグの http-web-site.xml にある load-on-startup 属性を true にセットする必要が あります <web-app application="default" name="lab02war" root="lab02" load-on-startup=" true"/> Web アプリケーションのデプロイメント ディスクリプタ つまり web.xml で <load-on-startup>prioritynumber</load-on-startup> のように サーブレットのロード優先順位を指定できます 0 以上の値の場合は 指定された順序で事前にロードされます 値が重複する場合 サーブレットは宣言順序でロードされます 0 より小さい値の場合 事前ロードは行われません 空要素の場合は 要素が Integer.MAX_VALUE で指定されたかのように処理されます これにより 0 以上の値を持つサーブレットの後に これらが確実に事前ロードされます 2. ユーザーに OC4J に直接接続させない方法 およびユーザーに Oracle HTTP サーバーを経由した接続を強制する方法を教えてください Web アプリケーションに対する orion-web.xml に変更を加えることで Web アプリケーションに対するアクセス マスクをセットし HTTP Server が稼働する特定のホストまたは IP アドレスへアクセスを許可できます たとえば dpanda-us という名前のホストと IP アドレスが のマシンからのアクセスのみを許可する場合 次の行を orion-web.xml に追加する必要があります <access-mask default="deny"> <host-access domain="dpanda-us" mode="allow" /> <ip-access ip=" " mode="allow" /> </access-mask> OracleAS では OC4J と Oracle HTTP Server は mod_oc4j に密統合されているため アクセス制御は Oracle HTTP Server レベルで指定および実施できます Oracle Containers for J2EE - サーブレット 1

2 3. Web アプリケーションのすべてのサーブレットでアクセスできる環境変数の定義方法を教えてください J2EE アプリケーションでは Web アプリケーションの 1 つまたは複数のサーブレットがアクセスする初期化パラ メータがいくつか必要です 初期化パラメータは コンテキスト用または特定のサーブレット用です コンテキスト レベル パラメータは Web アプリケーションの任意のサーブレットによってアクセス可能です a) コンテキスト パラメータを定義するには 次の行を web.xml に追加する必要があります <context-param> <param-name>filedir</param-name> <param-value>/temp</param-value> </context-param> b) コンテキスト レベル パラメータを取得するには 次のコードのように context.getinitparameter メソッドを使用する必要があります javax.servlet.servletcontext context = getservletcontext(); String filedir = context.getinitparameter("filedir"); 4. アプリケーションをデプロイする方法を教えてください default-web-app などの Web アプリケーションをデプロイする場合は OC4J デプロイメント ガイド の第 5 章を参照してください 5. JSP に対し生成されたサーブレット ソース コードを実行中に削除しないようにするには OC4J をどのように構成すればよいですか orion-web.xml ファイルの <orion-web-app> 要素の development を true にセットすると 生成されたコードが永続ディレクトリに保存されます Web アプリケーション用に生成されたコードを保存する場合は この変更を global-web-application.xml で行う必要があります Oracle9iAS のリリース 2 以降 JSP トランスレータはすべての変換済み JSP ソース テキストを自動的に保存します 詳細は JSP FAQ を参照してください 6. ディレクトリ参照を許可するには OC4J HTTP サーバーをどのようにセットアップすればよいですか OC4J HTTP サーバーは 配置されたアプリケーションのディレクトリ参照をサポートするように構成できます 配置されたアプリケーションのディレクトリ参照を可能にする手順は 次のとおりです a) Web アプリケーションの orion-web.xml を開きます b) <orion-web-app> タグを見つけます c) 属性 directory-browsing="allow" を追加します これで Welcome ファイルがない任意のディレクトリを参照できるようになります Welcome ファイルは <welcome-file-list> 属性で web.xml に構成されます Oracle Containers for J2EE - サーブレット 2

3 7. Web アプリケーションに対してセッション タイムアウトをセットする方法を教えてください Servlet セッション ( および JSP セッション どちらも同じ ) は 次のフォーマットで web.xml のノードにより 制御されるタイムアウト時間を持ちます <session-config> <session-timeout>60</session-timeout> </session-config> これは セッションが最後に使用されてからの分単位の時間を表現します したがってセッションに影響する またはアクセスする各ページが このタイマーをリセットします 8. 事前に構成された DataSource を Servlet から使用する方法を教えてください DataSource 名が OracleDS で jdbc/oracleds にあると想定します これらは j2ee/home/config/data-sources.xml ファイルに定義されます 次のコードは DataSource をルックアップする方法および接続を取得する方法を示します try { InitialContext context = new InitialContext(); DataSource myds = (DataSource) context.lookup("jdbc/oracleds"); Connection conn = myds.getconnection(); // Use connection as normal since it's a normal JDBC connection } catch(namingexception ne) { } 9. OC4J の Web アプリケーションで特定の MIME タイプに対しサーブレット連鎖をセットアップする方法を教えてください MIME タイプのテキスト /html に対しチェイナとして確立する ChainServlet という名前のサーブレットがあるとします その場合 Web アプリケーションの orion-web.xml を編集して 次の行を挿入する必要があります <servlet-chaining mime-type="text/html" servlet-name="chainservlet" /> サーブレットのチェーニング ( 連鎖 ) には Servlet Filters をお薦めします 10. Web に公開されたファイルの中で 物理的にドキュメント ルート下に存在しないディレクトリを追加する方法を教えてください これは 物理ディレクトリを Web アプリケーションの外の仮想パスにマップする仮想ディレクトリを指定することによって実行できます たとえば e:\pictures と呼ばれるディレクトリにすべての画像があり これに /img というアクセス ポイントを追加するとします Web アプリケーション用の orion-web.xml ファイルを編集して 次のように仮想ディレクトリを追加します <orion-web> <virtual-directory virtual-path="/img" real-path="/e:/pictures/" /> </orion-web> Oracle Containers for J2EE - サーブレット 3

4 11. jsp がサブディレクトリにあるとき welcome-file-list に JSP ファイルを追加する方法を教えてください ファイル名が xx.jsp で web\jsp\one サブディレクトリにあると想定します 標準の J2EE WAR フォーマットを使用して Web アプリケーションを配置します 次のように デプロイメン ト ディスクリプタ ファイル web.xml の Welcome ファイル リストにファイルを追加できます <welcome-file-list> <welcome-file>web/jsp/one/xx.jsp</welcome-file> </welcome-file-list> ディレクトリ web/jsp/one は Web モジュールのホームに対し相対的な位置にあります 12. OC4J で HTTP トンネリングを設定する方法を教えてください Remote Method Invocation(RMI) により 開発者は Java で分散型アプリケーションを構築できます ただし RMI コールは通常 ファイアウォールによってブロックされます RMI HTTP トンネリングは RMI が HTTP を 使用してファイアウォールを通過する手段を提供する RMI の実装です HTTP プロキシを介して RMI HTTP トンネリング機能を使用できます サーブレット RMIHttpTunnelProxyServlet として実行されます global-web-application.xml には 次の行が存在する必要があります <servlet> <servlet-name>rmi</servlet-name> <servlet-class>com.evermind.server.rmi.rmihttptunnelservlet</servlet-class> </servlet> http: に RMI URL を追加して実行します たとえば クライアント プログラムで Naming.Lookup ("ormi://localhost/theapp") として RMI オブジェクトにアクセスするには Naming.Lookup (" に修正する必要があります 13. クラス ライブラリをロードするために WAR ファイル Manifest の Class-Path 属性を使用するよう OC4J を設定する方法を教えてください OC4J には Manifest Class-Path エントリに含まれるクラス ライブラリをロードするための構成可能なオプショ ンがあります OC4J に Manifest Class-Path からクラス ライブラリをロードするよう指示するには 次のディレ クティブを orion-web.xml に含める必要があります <web-app-class-loader include-war-manifest-class-path="true" /> 14. System クラスまたは上位レベルのクラスを無視して Web アプリケーションにパッケージされたローカル クラスをロードするよう OC4J を設定する方法を教えてください OC4J には 上位レベルのクラスを無視してローカル クラスを最初にロードするための 構成可能なオプショ ンがあります OC4J にローカル クラスをロードするよう指示するには Web モジュール用に次のディレクテ ィブを orion-web.xml に含める必要があります <web-app-class-loader search-local-classes-first="true" /> Oracle Containers for J2EE - サーブレット 4

5 15. WAR モジュールにパッケージされた Servlet/JSP のリソース ファイルをロードするには どのクラスローダーを使用する必要がありますか プロパティまたはリソース ファイルのロードには コンテキスト クラスローダーを使用する必要があります たとえば Web モジュールの WEB-INF/ クラスに debu.properties と呼ばれるプロパティ ファイルがある場合 プロパティ ファイルをロードするには 次のコードを使用する必要があります InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("debu.prop erties"); 16. JNDI 参照によって URL リソースを検索するよう OC4J を構成する方法を教えてください a) デプロイメント ディスクリプタで リソースを定義する必要があります ( たとえば Web アプリケーションから URL リソースにアクセスする場合 次の行を web.xml に挿入する必要があります ) <resource-ref> <res-ref-name>url/myurl</res-ref-name> <res-type>java.net.url</res-type> <res-auth>container</res-auth> <res-sharing-scope>shareable</res-sharing-scope> </resource-ref> b) リソース名をマップする必要があります ( たとえば url/myurl は 次のようにベンダー固有のデプロイメント ディスクリプタ たとえば orion-web.xml の位置にマップする必要があります ) <resource-ref-mapping name="url/myurl" location=" /> c) これで 次のコ ドを使用して URL リソースを参照し接続できます HttpURLConnection connection = null; Context context = new InitialContext(); URL url = (URL) context.lookup ("java:comp/env/url/myurl"); connection = (HttpURLConnection)url.openConnection(); 17. ブラウザでスタック トレースを表示する方法を教えてください 例外が発生し それを処理するエラー ページが存在しない場合に表示されるエラー メッセージに 次の変更が加えられました セキュリティに依存する例外については 次のエラー メッセージが表示されます Servlet error: An exception occurred. For security reasons, it may not be included in this response. Please consult the application log for details. 他の例外については 次のエラー メッセージが表示されます Servlet error: An exception occurred. The current application deployment descriptors does not allow for including it in this response. Please consult the application log for details. 例外またはスタック トレースの表示に依存するテストができる場合は アプリケーションを開発者モードで実行することによりスタック トレースを表示させることができます アプリケーションを開発者モードで実行するには orion-web.xml ファイルの <orion-web-app> 要素の development 属性を true にセットします 次に例を示します Oracle Containers for J2EE - サーブレット 5

6 <?xml version="1.0"?> <orion-web-app xmlns:xsi=" xsi:nonamespaceschemalocation=" ion-web-10_0.xsd" deployment-version="null" deployment-time=" " jsp-cache-directory="./persistence" jsp-cache-tlds="standard" temporary-directory="./temp" context-root="/developmentthrowexception" schema-major-version="10" schema-minor-version="0" development="true"> <!-- Uncomment this element to control web application class loader behavior. <web-app-class-loader search-local-classes-first="true" include-war-manifest-class-path="true" /> --> <web-app> </web-app> </orion-web-app> OC4J JSP Documentation Oracle Application Server Production Documentation library Oracle Containers for J2EE - サーブレット 6

7 Oracle Application Server 10g FAQ 2006 年 10 月著者 : Dana Singleterry Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores, CA U.S.A. 海外からのお問合せ窓口 : 電話 : ファックス : Copyright 2006, Oracle. 無断転載を禁ず この文書はあくまで参考資料であり 掲載されている情報は予告なしに変更されることがあります オラクル社は 本ドキュメントの無謬性を保証しません オラクル社は 本書の内容に関していかなる保証もいたしません また 本ドキュメントに関連するいかなる責任も負いません Oracle はオラクル社の登録商標です 本ドキュメントで言及したすべての他の会社名および製品名は 当該会社および製品を識別するためにのみ使用しており それぞれの所有者の商標である可能性があります