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 コマンドを使用して、特定のフィーチャー・セットのクラスパスを生成できます。 詳しくは、 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 環境変数で指定した、デフォルトでないすべてのディレクトリー。

IBM i プラットフォームの場合ポリシーには例外があり、 ${wlp.install.dir}/etcの内容は変更されません。 Installation Managerを使用して IBM® iSeries プラットフォームに Liberty をインストールすると、ファイル ${wlp.install.dir}/etc/default.env が作成されます。 また、このファイルは、アーカイブ時に iAdmin POSTINSTALL コマンドによって作成または置換されます。 iAdmin コマンドは、${wlp.install.dir}/lib/native/os400/bin ディレクトリーにあります。 iAdmin コマンドを参照してください。

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