Oracle Cloud Infrastructureドキュメント

SDKの使用例は、GitHubにあります:

この例は、SDKのダウンロード可能な.zipファイルにもあります。 古いバージョンのSDKの例は、特定のバージョン(「GitHubに」)でダウンロード可能な.zipにあります。

まだカバーされていない別の例を見たい場合は、「GitHubの問題」を提出してください。

実行例

  1. SDKをociという名前のディレクトリにダウンロードします。 ダウンロードについてはGitHubを参照してください。
  2. SDKをociディレクトリに解凍します。 例: tar -xf oci-java-sdk-dist.zip
  3. ホーム・ディレクトリ(~/.oci/config)に構成ファイルを作成します。 「SDKの構成」を参照してください。
  4. javacを使用して、先の例のクラスの1つをexamplesディレクトリからコンパイルします。例:

    javac -cp lib/oci-java-sdk-full-<version>.jar:third-party/lib/* examples/ObjectStorageSyncExample.java
  5. 今すぐexamplesディレクトリにクラス・ファイルがあります。 例を実行します:

    java -cp examples:lib/oci-java-sdk-full-<version>.jar:third-party/lib/* ObjectStorageSyncExample

第三者の依存関係とシェーディング

SDKには、多数のサードパーティの依存関係が必要です。これらの依存関係は、third-party/libディレクトリにあります。 SDKライブラリlib/oci-java-sdk-full-<version>.jarを使用するには、third-party/libのサードパーティのすべての依存関係をクラスパス上に配置する必要があります。

SDKには、サードパーティの依存関係のほとんどが既に含まれているSDKライブラリの2番目のバージョンshaded/lib/oci-java-sdk-full-shaded-<version>.jarも含まれています。 このバージョンのSDKライブラリを使用する場合は、shaded/third-party/libのサードパーティ・ライブラリをクラスパスに追加する必要があります。

SDKライブラリのこれらの2つのバージョンは機能的には同じですが、2番目のバージョンのshaded/lib/oci-java-sdk-full-shaded-<version>.jarはサードパーティ依存のさまざまなバージョンの処理を簡素化できます。 これは、shaded/lib/oci-java-sdk-full-shaded-<version>.jarに含まれるすべての依存関係が陰影付けされているためです。つまり、このSDKに含めることができる他のバージョンのSDKと干渉しないためです。

lib/oci-java-sdk-full-<version>.jarまたはshaded/lib/oci-java-sdk-full-shaded-<version>.jarのいずれかを使用できますが、両方を使用することはできません。 lib/oci-java-sdk-full-<version>.jarを使用する場合は、third-party/libのすべてのサードパーティ・ライブラリを使用してください。 shaded/lib/oci-java-sdk-full-shaded-<version>.jarを使用する場合は、shaded/third-party/libのすべてのサードパーティ・ライブラリを使用してください。

SDKの影付きバージョンを使用するには、ステップ4および5のjavacコマンドを次のように置き換えます。

  • 手順4:

    javac -cp shaded/lib/oci-java-sdk-full-shaded-<version>.jar:shaded/third-party/lib/* examples/ObjectStorageSyncExample.java
  • 手順5:

    java -cp examples:shaded/lib/oci-java-sdk-full-shaded-<version>.jar:shaded/third-party/lib/* ObjectStorageSyncExample