Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Platform 4.2+が必要

最低限のクライアント環境の指定

Nexaweb 4.2.x では、Nexaweb クライアントアプリケーションの起動に必要なブラウザ環境の最低基準を指定することができます。

...

  1. アプリケーションの WebContent\WEB-INF ディレクトリに、nexaweb-client.xmlファイルを配置します。
  2. これをテキスト エディタで開きます。
    <launch-requirements>セクションを検索すると、次のようになっています。

     

    Code Block
    <launch-requirements>
    
     <jvm-version>
     <include>*</include>
     <exclude></exclude>
     </jvm-version>
    
     <jvm-vendor>
     <include>*</include>
     <exclude></exclude>
     </jvm-vendor>
    
     <user-agent>
     <include>*</include>
     <exclude></exclude>
     </user-agent>
    
     <minimum-screen-resolution>
     <width>0</width>
     <height>0</height>
     </minimum-screen-resolution>
    
     <error-page>Nexaweb/jsp/launcher/errorLaunchRequirementsNotMet.jsp</error-page>
    </launch-requirements>
  3. アプリケーションのクライアントが要求する JVM バージョンを、<jvm-version> セクションの <include>*</include> および <exclude>*</exclude> タグで指定します。
    ブラウザでクライアントを起動しようとする際に、ブラウザが使用する JVM のバージョンが、jvm-version include リストにも exclude リストにもない場合は、クライアントでエラーが表示されます。複数の include タグおよび exclude タグを指定できます。
    JVM バージョン 1.4.0 を除いたバージョン 1.4 のすべてとバージョン 1.3.2_02 で実行する場合の、アプリケーションのクライアントの起動要件の作成例を次に示します。

    Code Block
    <include>1.4</include>
    <include>1.3.2_02</include>
    <exclude>1.4.0</exclude>
  4. アプリケーションのクライアントが要求する JVM ベンダを、<jvm-vendor> セクションの <include>*</include> および <exclude>*</exclude> タグで指定します。
    アプリケーションのクライアントは、include タグまたは exlude タグ内の文字列を java.vendor プロパティと対照して確認します。たとえば、sun java.vendor として "Sun Microsystems" が報告されている
    Sun プラグインに対してはマッチします。ブラウザでクライアントを起動しようとする際に、ブラウザが使用するベンダごとの JVM JVM-vendor include リストにも exclude リストにもない場合は、クライントでエラーが表示されます。複数の include タグおよび exclude タグを指定できます。
  5. アプリケーションのクライアントが要求するユーザーエージェントを<user-agent> セクションの <include>*</include> および <exclude>*</exclude> タグで指定します。
    ブラウザでクライアントを起動しようとする際に、ブラウザが使用するユーザーエージェントがuser-agent include リストにも exclude リストにもない場合は、クライアントでエラーが表示されます。複数の include タグおよび exclude タグを指定できます。
  6. アプリケーションのクライアントが要求する画面の最低解像度を、<minimum-screen-resolution> セクションの <width>0</width> および <height>0</height> タグで指定します。ブラウザでクライアントを起動しようとする際に、ブラウザの使用する画面解像度がここで指定した解像度より低い場合は、クライアントでエラーが表示されます。
  7. ユーザーのブラウザが起動要件を満たしていない場合に表示されるエラー メッセージからユーザーがアクセスできるデフォルトのエラー ページについて、これを使用したくない場合は、<error-page> </error-page> セクションで使用するエラーページを指定します。デフォルトのエラー ページは、他の Nexaweb エラーページと同様にクライアントの情報を URL 文字列の
    パラメータとして受け取ります。exceptionパラメータによって、クライアントが起動要件を満たさなかった理由が示されます。このパラメータに次の値のいずれかが含まれて、アプリケーションが起動に失敗した理由を示します。

    Code Block
    - jvm-version-not-included
    - jvm-version-excluded
    - jvm-vendor-not-included
    - jvm-vendor-excluded
    - user-agent-not-included
    - user-agent-excluded
    - minimum-screen-resolution-width
    - minimum-screen-resolution-height
  8. 起動要件の追加が完了したら、nexaweb-client.xmlファイルを保存して閉じます。