Beispiele

In diesem Thema wird beschrieben, wie Sie einige Beispiele für OCI-SDK für Java-Code suchen und installieren.

Beispiele für die SDK-Verwendung finden Sie auf GitHub, darunter:

Die Beispiele finden Sie auch in der herunterladbaren ZIP-Datei für das SDK. Beispiele für ältere Versionen des SDK finden Sie in der herunterladbaren ZIP-Datei für die spezifische Version, die auf GitHub verfügbar ist.

Wenn Sie andere Beispiele ansehen möchten, die noch nicht abgedeckt wurden, erstellen Sie ein GitHub-Problem.

Beispiele, die Jersey 2 als HTTP-Client-Library (OCI-SDK für Java 3) verwenden

Um Jersey 2 als HTTP-Client-Library zu verwenden, muss explizit eine Abhängigkeit von oci-java-sdk-common-httpclient-jersey in der pom.xml der Anwendung deklariert werden Weitere Informationen finden Sie unter bmc-jersey-examples/pom.xml.

Beispiele mit Jersey 2 als HTTP-Client-Library finden Sie in bmc-other-examples/bmc-jersey-examples.

Beispiele, die Jersey 3 als HTTP-Client-Library (OCI-SDK für Java 3) verwenden

Um Jersey 3 als HTTP-Client-Library zu verwenden, muss explizit eine Abhängigkeit von oci-java-sdk-common-httpclient-jersey3 in der pom.xml der Anwendung deklariert werden Weitere Informationen finden Sie unter bmc-jersey3-examples/pom.xml.

Beispiele mit Jersey 3 als HTTP-Client-Library finden Sie in bmc-other-examples/bmc-jersey3-examples.

Beispiele für das OCI-Legacy-SDK für Java (OCI-SDK für Java 1 und 2)

Beispiele für das OCI-Legacy-SDK für Java finden Sie hier.

SDK-Referenz

Neben den Beispielen auf GitHub enthält die API-Referenz für das SDK für Java Codebeispiele, die Sie kopieren und ändern können, um sie in Ihrer eigenen Umgebung auszuführen.

Beispiele ausführen

Laden Sie das SDK in ein Verzeichnis mit dem Namen oci herunter. Informationen zum Herunterladen finden Sie auf GitHub.
Extrahieren Sie das SDK im Verzeichnis oci. Beispiel: tar -xf oci-java-sdk-dist.zip
Erstellen Sie Ihre Konfigurationsdatei in Ihrem Home-Verzeichnis (~/.oci/config). Siehe SDK konfigurieren.
Verwenden Sie javac, um eine der vorherigen Beispielklassen aus dem Verzeichnis examples zu kompilieren. Beispiel:
```
javac -cp lib/oci-java-sdk-full-<version>.jar:third-party/lib/* examples/ObjectStorageSyncExample.java
```

Nun sollte eine Klassendatei im Verzeichnis examples vorhanden sein. Führen Sie das Beispiel aus:

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

Drittanbieterabhängigkeiten und Schattierung

Das SDK erfordert eine Reihe von Drittanbieterabhängigkeiten, die im Verzeichnis third-party/lib verfügbar sind. Um die SDK-Library lib/oci-java-sdk-full-<version>.jar zu verwenden, müssen sich alle Drittanbieterabhängigkeiten in third-party/lib im Classpath befinden.

Das SDK enthält außerdem eine zweite Version der SDK-Library, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, die bereits die meisten Drittanbieterabhängigkeiten enthält. Nur einige weitere Librarys von Drittanbietern in shaded/third-party/lib müssen sich im Classpath befinden, wenn Sie diese Version der SDK-Library verwenden.

Diese beiden Versionen der SDK-Library sind funktional identisch, die zweite Version hingegen, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, kann den Umgang mit unterschiedlichen Versionen von Drittanbieterabhängigkeiten vereinfachen. Der Grund dafür ist, dass alle in shaded/lib/oci-java-sdk-full-shaded-<version>.jar enthaltenen Abhängigkeiten schattiert wurden, d.h., sie stehen nicht mit anderen Versionen von sich selbst im Konflikt, die Sie eventuell zusätzlich zu diesem SDK verwenden möchten.

Sie können entweder lib/oci-java-sdk-full-<version>.jar oder shaded/lib/oci-java-sdk-full-shaded-<version>.jar verwenden, jedoch nicht beide Versionen. Wenn Sie lib/oci-java-sdk-full-<version>.jar verwenden, nutzen Sie alle Drittanbieter-Librarys in third-party/lib. Wenn Sie shaded/lib/oci-java-sdk-full-shaded-<version>.jar verwenden, nutzen Sie alle Drittanbieter-Librarys in shaded/third-party/lib.

Um die schattierte Version des SDK zu verwenden, ersetzen Sie die javac-Befehle in den Schritten 4 und 5 durch Folgendes:

Schritt 4:

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

Schritt 5:

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