4 ojspcによるJSPページのプリコンパイル

この章では、OC4J付属のojspcユーティリティによって提供されているJSPの事前変換およびプリコンパイル機能について説明します。次の各項で、ojspc機能について説明します。

ojspcユーティリティの仕組み

この章では、ojspcによって提供されている基本的なプリコンパイル機能と、アーカイブ・ファイルを使用するJSPページのバッチ・プリコンパイルについて説明します。次の項が含まれます。

基本的なojspc機能の概要

単純なJSPページの場合、ojspcのデフォルトの機能は次のとおりです。

JSPトランスレータを起動してJSPファイルをJavaページ実装クラス・コードに変換し、.javaファイルを作成します。
Javaコンパイラを起動して.javaファイルをコンパイルし、ページ実装クラスに対する.classファイルを作成します。

ojspcは、デフォルトでは、JSPトランスレータがオンデマンド変換で生成したものと同じファイル・セットを生成し、ojspcを実行したときのカレント作業ディレクトリ内またはその下にそのファイル・セットを格納します。

出力には、次のファイルが含まれます。

.javaソース・ファイル（バッチ事前変換の場合はコンパイル後に破棄されます。）
ページ実装クラスに対する.classファイル
必要に応じて、ページの静的なテキストのJavaリソース・ファイル（.res）

特定の状況（この章で後述する-extresオプションの説明を参照）では、ojspcオプションによって、JSPトランスレータは、このコンテンツをページ実装クラスに格納せずに、静的なページのコンテンツに対する.res Javaリソース・ファイルを作成します。

WARファイルのバッチ事前変換の概要

ojspcユーティリティは、JSPファイルの変換を行うのみでなく、WARまたはEARファイルのバッチ事前変換も実行できます。処理後の.classファイルとすべてのJavaリソース・ファイルは、WARファイル内のネストされたJARファイルに出力されます。ネストされたJARファイルは、WAR内のWEB-INF\libパス内に追加されるため、アーカイブはそのままOC4Jにデプロイできます。

ojspcのコマンドラインにアーカイブ・ファイル名が含まれている場合、ojspcは、デフォルトで次の手順を実行します。

アーカイブ・ファイルを開きます。
アーカイブ内の.jspおよび.javaファイルをすべて変換およびコンパイルします。
アーカイブ内のタグ・ファイルも、アーカイブ内のJSPで使用されている場合、やはりコンパイルされます。
WEB-INF\libパスに新しいネストされたJARファイルを追加してアーカイブを更新し、出力された.classファイルとすべてのJavaリソース・ファイルをこのファイルに追加します。この過程で作成されたすべての.javaファイルは破棄されます。

ネストされたJARファイルの名前には、出力されたアーカイブ・ファイルのベース名が含まれ、.jar拡張子が付加されます。たとえば、ojspcがsample.warに対して実行された場合、WAR内のネストされたJARファイルの名前は__oracle_jsp_sample.jarとなります。

ネストされたJARファイル内のファイル・パスは、Javaパッケージ名と、JSP include文とforward文の指定したファイル・パスに基づきます。ネストされたJARファイル内の.classファイルとリソース・ファイルは、元のJSPファイルが抽出後に変換された場合と同じディレクトリ・パスに配置されます。

ojspcの使用

ojspc実行可能ファイルの場所がホスト・マシンのPATHに追加されていれば、ojspcユーティリティを任意のディレクトリから起動できます。一般的なojspcのコマンドライン構文は、次のとおりです。

ojspc [option_settings] file_list

ソース・ファイル・リストにはJSPファイルと他のソース・ファイル（.java）、またはアーカイブ・ファイル（JAR、WAR、EARまたはZIPファイル）を含めることができます。ディレクトリ内のすべてのJSPファイルをプリコンパイルするには、file_listの値に*.jspを指定します。

個別のojspcの使用例は、次の各項を参照してください。

1つ以上のJSPのプリコンパイル

WARファイル内のJSPのプリコンパイル

重要

ojspcを任意の作業ディレクトリから起動するには、ojspc.batの場所をPATHに追加する必要があります。ojspc.batのデフォルトのパスは次のとおりです。

ORACLE_HOME/j2ee/home/jsp/bin/ojspc

次に、ファイルの生成および格納の制御に最も頻繁に使用されるojspcオプションを示します。オプションの完全なリストは、「ojspcコマンドライン・オプションのサマリー表」を参照してください。

-appRootは、JSPソース・ファイルが格納されているディレクトリと、ojspcが実行されている作業ディレクトリとが異なる場合に、アプリケーション・ルート・ディレクトリを指定します。
-srcdirは、ソース・ファイルを指定の場所に格納します（バッチ事前変換の場合は関係ありません）。
-dirは、バイナリ・ファイル（.classファイルとJavaリソース・ファイル）を指定の場所に格納します（バッチ事前変換の場合は関係ありません）。
-noCompileは、生成されたページ実装クラスのソースをコンパイルしません。

その結果、.classファイルは作成されません。
-extresは、静的なテキストをJavaリソース・ファイル（.res）に格納します。

1つ以上のJSPのプリコンパイル

この項では、JSPをプリコンパイルする使用例を示します。

単一のJSPのプリコンパイル

この例では、指定されたJSPを変換およびコンパイルする、基本的なojspcの使用方法を示します。

cd /source
ojspc index.jsp

この場合、次のファイルが/source作業ディレクトリ内に生成されます。

_index.class
_index.java

複数のJSPのプリコンパイル

次の例では、myapp/mysrcdir/内のすべてのJSPがコンパイルされます。

cd /source
ojspc myapp/mysrcdir/*.jsp

デフォルトでは、出力される.javaおよび.classファイルは、/source作業ディレクトリ内の_myapp/_mysrcdirという名前の新しいサブディレクトリに生成されます。

異なるソース・ディレクトリ内のJSPのプリコンパイル

次のように、ソース・ファイルが格納されているディレクトリ構造の外にあるディレクトリからojspcを実行すると仮定します。この場合、ファイルへの絶対パスに加え、-appRootオプションを使用してアプリケーション・ルートも指定する必要があります。

cd /stuff
ojspc -appRoot /source D:/source/myapp/mysrcdir/*.jsp

出力されるファイルは/stuff/_source/_myapp/_mysrcdirに生成されます。

異なるディレクトリでの異なるファイル・タイプの生成

次の例では、-dirオプションで指定したディレクトリにJavaクラスとファイルを生成し、-srcdirオプションで指定したディレクトリに.javaソース・ファイルを生成します。-extresオプションを使用すると、JSP内の静的なテキストが_MyPage.resというJavaリソース・ファイルに格納されます。これは、ページに大量の静的なコンテンツが含まれている場合に便利です。

ojspc -dir myapp/mybindir -extres -srcdir myapp/mysrcdir MyPage.jsp

ojspcを使用する際、次の点に注意してください。

特定のJSPをコンパイルするには、ファイル・リストのJSPファイル名を空白で区切ります。ファイルが作業ディレクトリ内に存在しない場合は、各JSPごとにパスを指定する必要があります。
ターゲット・ディレクトリ内のすべてのJSPをコンパイルするには、*.jspを指定します。
オプション・リスト内のオプション名とオプション値の間のデリミタには空白を使用します。
オプション名は大/小文字を区別しませんが、オプション値（パッケージ名、ディレクトリ名、クラス名、インタフェース名など）は、通常、大/小文字を区別します。
コマンドラインにオプション名を入力して、デフォルトでは無効のブール型のオプション（フラグ）を有効にします。たとえば、-extres trueではなく、-extresと入力します。

WARファイル内のJSPのプリコンパイル

ojspcをWARファイルや、または1つ以上のネストされたWARファイルが格納されているEARに対して実行し、中に格納されているJSPをプリコンパイルできます。ユーティリティにより、WAR内のWEB-INF\libパスに、コンパイル済のJavaクラスを格納した__oracle_jspwarFileName.jarというJARが作成されます。出力されたWARはそのままデプロイできます。

たとえば、ojspcをsample.earに対して実行し、その中のsample-web.warには複数のJSPが含まれていると仮定します。出力ファイルを指定していないため、既存のWARは新しいJARファイルで更新されます。

ojspc sample.ear

更新後のsample-web.warでは、WEB-INF\libパスに次のファイルが含まれます。

__oracle_jsp_sample-web.jar

使用の際は、次の点にも注意してください。

デフォルトで、ojspcにより、元のアーカイブ・ファイルが新しいJARで更新されます。元のアーカイブ・ファイルを変更したくない場合、-outputオプションを使用すると、新しいアーカイブ・ファイル名を指定できます。
-batchMaskオプションを使用すると、事前変換およびコンパイル用のファイル名拡張子を指定できます。指定した拡張子は、デフォルト（*.jspおよび*.java）のかわりに使用されます。
出力されるアーカイブ・ファイルに処理されたソース・ファイルを含めない場合は、-deleteSourceオプションを使用します。その場合、使用前に、「ojspcコマンドライン・オプションのサマリー表」に記されているこのオプションの説明を確認してください。
変換中に作成されたすべての.javaファイルは更新後のWARから破棄されます。

Antタスクを使用したJSPのプリコンパイル

Antタスクを使用してJSPをプリコンパイルできます。ORACLE_HOME/ant/にあるAntのOC4J実装を使用する場合は、Antタスクを次のように設定できます。

 <project name="test" default="t1" basedir="." xmlns:oracle="antlib:oracle" >

    <property name="oracle.home" value=ORACLE_HOME/>

    <target name="t1" >
       <oracle:compileJsp file="test/simplest.ear"
                         verbose="true"
                          output="test/out.ear" />
     </target>
    <target name="t2" >
      <oracle:compileJsp verbose="true" 
                         appRoot="/scratch/ojspcAntTask/build"
                         dir="/scratch/ojspcAntTask/generatedClass"
                         srcDir="/scratch/ojspcAntTask/generatedJavaSources"
                         
addClasspath="lib/a.jar;lib/b.jar:${oracle.home}/lib/some.jar">
        <fileset dir="/scratch/ojspcAntTask/build">
          <include name="**/*.jsp"/>
          <exclude name="**/*negativeExample.jsp*"/>
        </fileset>
      </oracle:compileJsp>
    </target>
  </project>

これで、ant t1 t2を実行できます。

注意
この章に記載されているOC4J Antタスクは、Apache Antバージョン1.6.5での使用を意図しています。最新のApache Ant製品ドキュメントについては、http://ant.apache.org/manual/を参照してください。

AntのOC4J実装を使用しない場合は、『Oracle Containers for J2EEデプロイメント・ガイド』の手順に従ってください。

このAntタスクの属性は、ojspcのコマンドライン・オプションに由来します。詳細はojspcオプションを確認してください。名前/値オプションは、それぞれがAntタスクの文字列またはファイルまたはパスの属性になります。ブール型オプション（名前のみで構成されるオプション）は、それぞれがAntタスクのブール型属性になります。

処理するファイルの指定方法は2つあります。1つは、t1というターゲットが示すように、ファイル属性を使用する方法です。もう1つは、t2というターゲットが示すように、標準のAntのfileset要素であるネストされた<fileset>要素を使用する方法です。この方法では、コンパイル対象をより柔軟に指定できます。後者の場合、appRoot属性を、ネストされた<fileset>要素のdir属性と同一にすることを強くお薦めします。

ojspcコマンドライン・オプションのサマリー表

表4-1に、ojspc事前変換ユーティリティでサポートされているコマンドライン・オプションが要約されています。

表4-1 ojspc事前変換ユーティリティのオプション

オプション	説明
`-addclasspath`	生成されたページ実装クラス・ソースのコンパイル時に使用する、`javac`のための追加クラスパス・エントリを指定します。
`-approot`	アプリケーション・ルート・ディレクトリを指定します。変換対象のファイルが含まれているディレクトリとは別のディレクトリから`ojspc`を実行する場合のみ、このオプションを使用します。デフォルトは`ojspc`の作業ディレクトリです。指定したアプリケーション・ルート・ディレクトリ・パスは、次の場合に使用されます。変換するページの静的な`include`ディレクティブで使用指定したディレクトリ・パスは、変換するページの`include`ディレクティブ内でアプリケーション相対（コンテキスト相対）パスの前に付加されます。ページ実装クラスのパッケージを決定するときに使用パッケージのディレクトリは、変換されるファイルの場所に基づいて、アプリケーション・ルート・ディレクトリに対して相対的に決定されます。このパッケージによって、出力ファイルの格納場所も決定します。次に例を示します。次のファイルを変換すると仮定します。 /abc/def/ghi/test.jsp 次のように、カレント・ディレクトリの`/abc`から`ojspc`を実行します。 cd /abc ojspc def/ghi/test.jsp `test.jsp`ページには次の`include`ディレクティブがあります。 <%@ include file="/test2.jsp" %> 次のように、`test2.jsp`ページは`/abc`ディレクトリ内にあります。 /abc/test2.jsp この例では、デフォルトのアプリケーション・ルートの設定がカレント・ディレクトリの`/abc`ディレクトリであるため、`-appRoot`の設定は不要です。`include`ディレクティブでは、アプリケーションに対して相対的な`/test2.jsp`構文（「`/`」で始まります）を使用するため、インクルード・ページの場所は、`/abc/test2.jsp`になります。この場合のパッケージは`_def._ghi`です。このパッケージは、`ojspc`を実行したときのカレント・ディレクトリに対して相対的な`test.jsp`の場所に基づいて決定されます。（カレント・ディレクトリはデフォルトのアプリケーション・ルートです。）これに従って、出力ファイルが格納されます。ただし、他のディレクトリ（`/home/mydir`など）から`ojspc`を実行する場合は、次の例に示すように、`-appRoot`の設定が必要です。 cd /home/mydir ojspc -appRoot /abc abc/def/ghi/test.jsp パッケージは`_def._ghi`のままですが、ディレクトリは、指定のアプリケーション・ルート・ディレクトリに対して相対的な`test.jsp`の場所に基づいて決定されます。
`-batchMask`	バッチ事前変換の際、アーカイブ・ファイルで処理されるソース・ファイルを指定できます。デフォルトでは、`.jsp`および`.java`ファイルがすべて処理されます。`-batchMask`オプションによって指定されたファイル・マスクは、これらのデフォルトに追加するのではなく、デフォルトのかわりに使用されます。ファイル・マスクのリストの前後は引用符で囲み、リスト内ではデリミタにカンマまたはセミコロンを使用します。ファイル・マスクの前後にある空白は無視されます。マスクにディレクトリを含めることができます。このオプションで指定するファイル・マスクでは大/小文字を区別しません。 `-batchMask`実装では、標準のワイルドカード・パターン・マッチングが完全にサポートされています。デフォルト設定の場合、次の2つの例と同じです。 ojspc myapp.war ojspc -batchMask ".jsp,.java" myapp.war この次の例では、`.java`ファイルの処理が削除されていますが、`.jsph`ファイルの処理が追加されています。 ojspc -batchMask ".jsph,.jsp" myapp.war 次の例では、`.java`ファイルは処理されていません。名前が「abc」で始まり、アーカイブ・ファイルの上位レベルのサブディレクトリにある`.jsp`ファイルのみが処理されます。 ojspc -batchMask "/abc.jsp" myapp.zip 次の例は、前述の例と同じですが、アーカイブ・ファイルの上位レベルにあり、名前が「abc」で始まる`.jsp`ファイルも処理されます。 ojspc -batchMask "abc.jsp, /abc.jsp" myapp.jar 最後の例では、ファイル`a.jspc`と、「My」で始まり、`mydir/subdir`のサブディレクトリであるディレクトリにあり、パターン「t?st」（2番目の文字が任意の文字、「test」、「tast」、「tust」など）と一致する`.jsp`ファイルが明確に処理されます。 ojspc -batchMask "mydir/subdir/t?st/My.jsp" myapp.ear
`-debug`	生成後のJavaクラス・ファイル内にSMAPデバッグ・データを生成する場合に使用します。オプション設定の`file`により、作業ディレクトリ内のSMAPファイルにデバッグ情報が生成されます。ファイル名は生成されるJavaクラスと同じで、.smap拡張子が付加されます。たとえば、`foo.jsp`のデバッグ・データは`_foo_jsp.smap`に出力されます。
`-deleteSource`	バッチ事前変換で、出力されるアーカイブ・ファイルに、処理されたソース・ファイルを含めない場合に使用します。デフォルトでは、`.jsp`および`.java`ファイルが対象となります。それ以外の場合は、`-batchMask`オプションのファイル・マスクと一致するファイルのみが対象となります。生成された`.java`ファイルも破棄されます。 `-output`オプションを使用しない場合、元のアーカイブ・ファイルのコンテンツが上書きされ、処理後に処理されたソース・ファイルが削除されます。`-output`オプションを使用すると、処理されたソース・ファイルは、指定の出力アーカイブ・ファイルにはコピーされません。（元のアーカイブ・ファイルは変更されません。）使用上の注意: 名前がデフォルトのファイル拡張子と一致しない（`-batchMask`オプションを使用しない場合）ファイル、または`-batchMask`オプションを使用して指定した名前マスクと一致しないファイルは、`-deleteSource`オプションでは破棄されません。これらのファイルは、必要に応じて、出力されたアーカイブ・ファイルから削除する必要があります。これは特に、静的にインクルードされたソース・ファイルの場合に当てはまります。静的にインクルードされたソース・ファイルは、独自に変換できないため、`.jsp`拡張子、またはファイルを独自に変換しようとする他の拡張子を使用できません。 JSPソース・ファイルをデプロイしない場合に、`-deleteSource`を使用するには、ターゲットのJSP実行時環境を、使用可能なソース・ファイルがない場合でも正しく動作するように構成する必要があります。
`-dir`（または`-d`）	`ojspc`が生成されたバイナリ・ファイル（`.class`ファイルとJavaリソース・ファイル）を格納するベース・ディレクトリを指定します。（`-extres`オプションによって静的なコンテンツに対して作成された`.res`ファイルは、Javaリソース・ファイルです。）ショートカットとして、`-d`も使用できます。指定されたパスは、ファイルのシステム・パスとして（アプリケーション相対パスまたはページ相対パスではなく）取得されるため、ディレクトリはすでに存在している必要があります。指定されたディレクトリ下のサブディレクトリは、パッケージに応じて、必要な場合に自動的に作成されます。デフォルトでは、カレント・ディレクトリ（`ojspc`を実行したときのカレント・ディレクトリ）を使用します。このオプションを使用して、生成されたバイナリ・ファイルを未使用のディレクトリに格納することをお薦めします。これによって、作成されたファイルを簡単に識別できます。注意このオプションは、WARまたはEARファイルのバッチ事前変換の際は無視されます。ディレクトリ名に空白を使用できるWindowsおよびUNIXなどの環境では、ディレクトリ名を引用符で囲んでください。
`-extend`	生成されたページ実装クラスが拡張するクラスを指定します。バッチ事前変換には、このオプションを使用しないでください。
`-extraImports`	OC4JによってインポートされるデフォルトのJSPパッケージよりも多くのインポートを追加します。追加のインポートのパッケージ名または完全修飾されたクラス名を指定します。名前を指定する場合は、次の例のように引用符で囲み、カンマまたはセミコロンで区切る必要があります。 ojspc -extraImports "java.util.,java.io." foo.jsp `-extraImports`オプションは、Oracle Containers for J2EE 10g（10.1.3.1.0）では推奨されていません。
`-extres`	ページの静的なコンテンツを、生成されたページ実装クラスのサービス・メソッドではなく、Javaリソース・ファイルに格納します。1ページに大量の静的なコンテンツが存在する場合は、この技法によって変換速度が向上し、ページの実行速度も向上します。詳細は、「大量の静的なコンテンツまたはタグ・ライブラリの使用の管理」を参照してください。リソース・ファイルは、出力された`.class`ファイルと同じディレクトリに格納されます。ファイル名は、JSPページ名に基づいて付けられます。現在のOC4JのJSP実装では、コア名がJSP名と同じになりますが（JSP名に特殊文字が含まれない場合）、接頭辞のアンダースコア（_）と接尾辞の`.res`が名前に付けられます。たとえば、`MyPage.jsp`を変換すると、通常の出力以外に、`_MyPage.res`が作成されます。ただし、名前の生成に関する正確な実装は、今後のリリースで変更される場合があります。
`-forgiveDupDirAttr`	単一のJSP変換単位内で同じディレクティブ属性に重複する設定がある場合に、JSPの変換エラーを回避します。 `-forgiveDupDirAttr`オプションは、Oracle Containers for J2EE 10g（10.1.3.1.0）では推奨されていません。
`-help`（または`-h`）	コンソールに`ojspc`の使用情報が表示されます。
`-ignoreErrors`	JSPとともにパッケージ化されているXMLディスクリプタ（`web.xml`または`orion-web.xml`など）の1つによるエラーでないかぎり、エラーが発生した場合も処理を継続するよう`ojspc`に強制します。
`-implement`	生成されたページ実装クラスが実装するインタフェースを指定します。バッチ事前変換には、このオプションを使用しないでください。
`-noCompile`	`ojspc`が生成されたページ実装クラスをコンパイルしないよう指示します。このオプションは、なんらかの理由で、後で代替のJavaコンパイラを使用してコンパイルする場合などに使用します。
`-oldIncludeFromTop`	ネストされた`include`ディレクティブ内のページの場所をトップレベルのページに対して相対的にします。それ以外の場合は、1つ上位の親ページに対して相対的になります。これはJSP仕様に準拠しています。このオプションは、Oracle9iASリリース2より前のOC4Jバージョンとの下位互換性を維持するために使用します。 `-oldIncludeFromTop`オプションは、Oracle Containers for J2EE 10g（10.1.3.1.0）では推奨されていません。
`-output`	バッチ事前変換の場合に、出力アーカイブ・ファイル名を指定します。元のアーカイブ・ファイルのすべてのコンテンツが、指定したアーカイブ・ファイルにコピーされます。次に、事前変換で出力された`.class`ファイルおよびリソース・ファイルが、指定したファイル内のネストされたJARファイルに格納されます（`-deleteSource`が有効になっている場合、指定したファイルからソース・ファイルが削除されます）。元のアーカイブ・ファイルは変更されません。デプロイには、元のファイルではなく新しいファイルを使用します。（ネストされたJARファイルの詳細は、「WARファイルのバッチ事前変換の概要」を参照。） `-output`オプションを指定しないと、元のアーカイブ・ファイルが更新され、新しいアーカイブ・ファイルは作成されません。次に、`-output`の使用例を示します。 `ojspc` -output myappout.war myapp.war
`-packageName`	生成されたページ実装クラスのパッケージ名を指定します。指定されていない場合のパッケージ名は、`ojspc`を実行したときのカレント・ディレクトリに対して相対的な`.jsp`ファイルの場所に基づいて決定されます。たとえば、`/myapproot`ディレクトリから`ojspc`を実行し、`.jsp`ファイルが`/myapproot/src/jspsrc`ディレクトリに存在する場合について考えます（`%`はUNIXプロンプトを表します）。 % cd /myapproot % ojspc -packageName myroot.mypackage src/jspsrc/Foo.jsp この結果、パッケージ名として`myroot.mypackage`が使用されます。この例で`-packageName`オプションが使用されなかった場合、JSPトランスレータは（現在の実装内で）デフォルトの`_src._jspsrc`をパッケージ名として使用します。（実装の詳細は、今後のリリースで変更される場合があります。）
`-reduceTagCode`	カスタム・タグを使用するために生成されたコードのサイズをさらに縮小します。デフォルトは`false`です。
`-reqTimeIntrospection`	コンパイル時にイントロスペクションが実行できなかった場合、リクエスト時にJavaBeanのイントロスペクションを実行できます。ただし、有効なコンパイル時のイントロスペクションが正常終了した場合、このフラグの設定に関係なく、リクエスト時のイントロスペクションは実行されません。デフォルトは`false`です。リクエスト時のイントロスペクションの使用例として、タグ・ハンドラによって、タグ補足情報クラスの`VariableInfo`インスタンスにある一般的な`java.lang.Object`インスタンスが変換時とコンパイル時に戻される一方で、実際には、特定のオブジェクトがリクエスト時（実行時）に生成される場合を想定します。この場合、`-reqTimeIntrospection`が有効になっていると、Webコンテナはリクエスト時までイントロスペクションを遅延します。このフラグには、`if..then..else`ループの別の分岐などで、Beanを2回宣言できるという効果もあります。次の例を考えてみます。`-reqTimeIntrospection`が有効になっていないと、このコードにより、解析例外が発生します。有効になっている場合、コードはエラーなしで機能します。 <% if (cond) { %> <jsp:useBean id="foo" class="pkgA.Foo" /> <% } else { %> <jsp:useBean id="foo" class="pkgA.Foo2" /> <% } %>
`-setpropertyOnErrContinue`	property="*"の場合、`jsp:setProperty`の使用時にエラーが発生したとき、リクエスト・パラメータの反復と対応するBeanプロパティの設定が継続されます。 `-setpropertyOnErrContinue`オプションは、Oracle Containers for J2EE 10g（10.1.3.1.0）では推奨されていません。
`-srcdir`	生成されたソース・ファイルを未使用のディレクトリに格納します。これによって、作成されたファイルを簡単に識別できます。バッチ事前変換には、このオプションを使用しないでください。 `ojspc`が、生成された（`.java`）ソース・ファイルを格納する場所を指定します。指定するディレクトリはすでに存在している必要があります。指定されたパスは、アプリケーション相対パスまたはページ相対パスではなく、ファイルのシステム・パスとして取得されます。指定されたディレクトリ下のサブディレクトリは、パッケージに応じて、必要な場合に自動的に作成されます。デフォルトでは、カレント・ディレクトリ（`ojspc`を実行したときのカレント・ディレクトリ）を使用します。
`-staticTextInChars`	JSPトランスレータが、JSPページの静的なテキストをバイトではなく文字として生成します。デフォルトの`false`では、静的なテキスト・ブロックの出力で、パフォーマンスが改善されます。次の例に示すように、実行時に文字エンコードをアプリケーションで動的に変更する必要がある場合は、このフラグを有効にします。 <% response.setContentType("text/html; charset=UTF-8"); %>
`-tagReuse`	このオプションを使用して、タグ・ハンドラの再利用（タグ・ハンドラ・インスタンスのプーリング）のモードを指定します。有効な値は次のとおりです。 `runtime`: タグ・ハンドラ再利用の実行時モデルを有効にします。この設定は、特定のJSPページで、JSPページ・コンテキスト属性`oracle.jsp.tags.reuse`を`false`の値に設定するとオーバーライドできます。現在のリリースでは、このオプションは推奨していません。 `none`: タグ・ハンドラの再利用を無効にします。この設定は、特定のJSPページで、JSPページ・コンテキスト属性`oracle.jsp.tags.reuse`を`true`の値に設定するとオーバーライドできます。 `compiletime`（デフォルト）: タグ・ハンドラ再利用のコンパイル時モデルをその基本モードで有効にします。 `compiletime_with_release`: タグ・ハンドラ再利用のコンパイル時モデルを、その「解放」モードで有効にします。この場合、タグ・ハンドラの`release()`メソッドは、指定したページの指定したタグ・ハンドラの使用の合間にコールされます。
`-validateXML`	`web.xml`ファイルのXML妥当性チェックをリクエストします。デフォルトでは、`web.xml`の妥当性チェックは実行されません。このオプションは、TLDのXML妥当性チェックを無効にします。デフォルトでは、TLDの妥当性チェックが実行されます。
`-verbose`	`ojspc`が実行時の状態情報を出力します。次の例は、`myerror.jsp`の変換に対する`-verbose`の出力を示します。（この例では、`ojspc`は`myerror.jsp`が存在するディレクトリから実行されます。） > ojspc -verbose myerror.jsp Translating file: myerror.jsp JSP files translated successfully. Compiling Java file: ./_myerror.java
`-version`	JSPのバージョン番号を表示します。