Liberty の外部のサポート

Liberty の外部的な機能およびリソースは、直接使用することができ、次のリリースにも存在すると見込むことができます。Liberty の内部的または付随的な部分は、サービスを適用したときや、将来のリリースにアップグレードしたときに変更される可能性があります。

Liberty で直接使用でき、次のリリースにも存在すると見込めるもの

以下のリソースは直接使用することができ、次のリリースでも引き続き使用可能になります。
  • ${wlp.install.dir}/dev ディレクトリー内の JAR ファイルの内容によって定義されたアプリケーション・プログラミング・インターフェース (API) およびシステム・プログラミング・インターフェース (SPI)。
    • サーバー構成内のフィーチャーで提供される API は、アプリケーション・クラス・ローダーから可視です。 サーバー構成内のフィーチャーで提供される API と SPI はすべて、製品拡張フィーチャーから可視です。
    • ${wlp.install.dir}/dev ディレクトリーの JAR ファイルを基にコードをコンパイルします。${wlp.install.dir}/dev ディレクトリー内の JAR ファイルは、アプリケーションおよびフィーチャーのコンパイルのためのみに提供されています。実行時の使用ではサポートされません。これらの JAR ファイルをアプリケーション、ライブラリー、およびテストで使用しないでください。
  • 可視性が public または protected のフィーチャーを含む、サーバー構成。public フィーチャーおよび構成エレメントは、server.xml ファイルと組み込みファイル内に指定できます。保護されたフィーチャーは、ユーザー独自のフィーチャーに組み込むことができます。
  • ${wlp.install.dir}/bin ディレクトリーおよびサブディレクトリー内のコマンド、スクリプト、およびアーカイブ。
  • ${wlp.install.dir}/clients ディレクトリーおよびサブディレクトリー内のクライアント・ユーティリティー。

依存を避ける必要があるもの

製品の付随的な部分には、依存関係を構築しないでください。付随的な部分に依存関係を構築すると、サービスを適用したときや将来のリリースにアップグレードしたときに製品に悪影響を与える可能性があります。依存を避けるべき製品内部の例としては、以下のシナリオがあります (以下に限定されるわけではありません)。
  • 製品バイナリー JAR ファイル (例えば、${wlp.install.dir}/dev ディレクトリー内のものなど) の名前。ツールまたは javac -extdirs オプションを使用して、これらの JAR ファイルを基にコードをコンパイルします。
    Apache Ant を使用してコードをコンパイルする場合、特定の JAR バージョンへの依存関係が生じないようにワイルドカードを使用します。例:
    <fileset dir="${wlp.install.dir}/dev/api/spec" includes="com.ibm.ws.javaee.servlet.3.0_*.jar"/>
    あるいは、featureManager classpath コマンドを使用して、特定のフィーチャー・セットのクラスパスを生成できます。詳しくは、Liberty: featureManager コマンドを参照してください。
  • ${wlp.install.dir}/lib ディレクトリー内の製品バイナリー・ファイルの直接使用。直接呼び出すことができる JAR ファイルは、${wlp.install.dir}/bin/tools ディレクトリー内のものだけです。
  • 実行時にサーバーによって出力されるメッセージ。メッセージのテキストや挿入内容は、サービスやバージョンのアップグレードで変更される可能性があります。 実用的に可能な限り、操作の特定時点で出力されるメッセージ ID において製品で一貫性が保たれますが、ベースとなる実装が変更されることがあるため、 これを保証することはできません。
  • ${wlp.install.dir}/bin ディレクトリーおよび ${wlp.install.dir}/dev ディレクトリー以外の、製品インストールのレイアウト。
  • ${wlp.install.dir}/templates ディレクトリー内の例およびテンプレート・ファイル。これらのファイルは、サービスをご使用のインストール済み環境に適用したときに変更される可能性があります。
  • API として明示的に公開されていないプライベートまたはサード・パーティーの Java™ パッケージ。 これらは、実行時にアプリケーション・クラス・ローダーから可視ではありません。
  • 文書化されていない構成プロパティー。Liberty コード・ベースは WebSphere® Application Server traditional コード・ベースと共通です。このため、Liberty コード・ベース内の構成プロパティーの一部は文書化されていない可能性があります。ただし、これが指定されると、Liberty の振る舞いに影響を与える場合があります。これらの構成プロパティーは Liberty には適用されないため、 Liberty ではサポートされません。また、Liberty ではテストされていないため、現在も今後も Liberty では確実には動作しない可能性があります。これらのプロパティーは製品の外部として文書化されていないため、いつでも削除できます。

サービスまたはアップグレードの適用によって変更される可能性があるもの

次のディレクトリーとそのサブディレクトリーの内容は、サービスまたはアップグレードの適用時に変更される可能性があります。 これらのロケーションにあるファイルは独自に変更しないでください。 そうでないと、製品保守またはアップグレードによって上書きされる可能性があります。
  • ${wlp.install.dir}/bin
  • ${wlp.install.dir}/clients
  • ${wlp.install.dir}/dev
  • ${wlp.install.dir}/java
  • ${wlp.install.dir}/lib
  • ${wlp.install.dir}/templates
次のディレクトリーの内容は変更されません。 これらはユーザーのファイルであるため、サービスまたはアップグレードを適用しても変更されません。
  • ${wlp.install.dir}/etc (ここには、server.env ファイルまたは jvm.options ファイルを追加している場合があります)。
  • ${wlp.install.dir}/usr (ユーザー構成およびアプリケーションのデフォルト・ロケーション)。
  • WLP_USER_DIR 環境変数で指定した、デフォルトでないすべてのディレクトリー。

サード・パーティーの API は、将来、後方互換性を考慮せずに変更される可能性があります。 これらは、オープン・ソース・コミュニティーで開発され、Liberty の一部として配信されたフィーチャーの実装の一部と見なされる Java パッケージです。デフォルトでは、サード・パーティーの API は、アプリケーションから可視になっていません。サード・パーティー・アクセスを明示的に許可するクラス・ローダー構成が設定された Java EE アプリケーションからは、アプリケーション・クラス・ローダーでこれらのパッケージが可視であり、OSGi アプリケーションはパッケージを明示的にインポートする必要があります。サード・パーティーの API の使用を決定する前に、非互換の変更による影響を考慮してください。


トピックのタイプを示すアイコン 参照トピック

ファイル名: rwlp_profile_externals.html