Exemples

Cette rubrique explique comment rechercher et installer des exemples de code OCI SDK pour Java.

Vous trouverez des exemples de syntaxe du kit SDK sur GitHub, notamment les suivants :

Les exemples se trouvent également dans le fichier .zip téléchargeable dédié au kit SDK. Des exemples relatifs aux anciennes versions du kit SDK se trouvent dans le fichier .zip téléchargeable correspondant aux versions spécifiques, sur GitHub.

Si vous souhaitez consulter un autre exemple qui n'a pas encore été traité, enregistrez un problème dans GitHub.

Exemples utilisant Jersey 2 en tant que bibliothèque client HTTP (kit SDK OCI pour Java 3)

Pour utiliser Jersey 2 comme bibliothèque client HTTP, une dépendance à oci-java-sdk-common-httpclient-jersey doit être explicitement déclarée dans le fichier pom.xml de l'application. Reportez-vous à bmc-jersey-examples/pom.xml.

Des exemples utilisant Jersey 2 comme bibliothèque client HTTP sont disponibles dans bmc-other-examples/bmc-jersey-examples.

Exemples utilisant Jersey 3 en tant que bibliothèque client HTTP (kit SDK OCI pour Java 3)

Pour utiliser Jersey 3 comme bibliothèque client HTTP, une dépendance à oci-java-sdk-common-httpclient-jersey3 doit être explicitement déclarée dans le fichier pom.xml de l'application. Reportez-vous à bmc-jersey3-examples/pom.xml.

Des exemples utilisant Jersey 3 comme bibliothèque client HTTP sont disponibles dans bmc-other-examples/bmc-jersey3-examples.

Exemples concernant le kit SDK Java OCI hérité (kit SDK Java 1 et 2)

Vous trouverez un exemple du kit SDK OCI hérité pour Java ici.

Référence de kit SDK

En plus des exemples trouvés sur GitHub, la référence d'API du kit SDK pour Java contient des exemples de code que vous pouvez copier et modifier afin de les exécuter dans votre propre environnement.

Exécution des exemples

Téléchargez le kit SDK dans un répertoire nommé oci. Accédez à GitHub pour le téléchargement.
Décompressez le kit SDK dans le répertoire oci. Par exemple : tar -xf oci-java-sdk-dist.zip
Créez le fichier de configuration dans votre répertoire de base (~/.oci/config). Reportez-vous à Configuration du kit SDK.
Utilisez javac pour compiler l'une des classes d'exemple précédentes à partir du répertoire examples, par exemple :
```
javac -cp lib/oci-java-sdk-full-<version>.jar:third-party/lib/* examples/ObjectStorageSyncExample.java
```
Vous devez désormais disposer d'un fichier de classe dans le répertoire examples. Exécutez l'exemple suivant :
```
java -cp examples:lib/oci-java-sdk-full-<version>.jar:third-party/lib/* ObjectStorageSyncExample
```

Dépendances tierces et ombrage

Le kit SDK requiert un certain nombre de dépendances tierces, qui sont disponibles dans le répertoire third-party/lib. Pour utiliser la bibliothèque du kit SDK lib/oci-java-sdk-full-<version>.jar, toutes les dépendances tierces dans third-party/lib doivent se trouver dans la variable d'environnement CLASSPATH.

Le kit SDK inclut également une deuxième version de la bibliothèque du kit SDK, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, qui contient déjà la plupart des dépendances tierces. Seules quelques bibliothèques tierces supplémentaires dans shaded/third-party/lib doivent figurer dans le chemin de classe lorsque vous utilisez cette version de la bibliothèque du kit SDK.

Ces deux versions de la bibliothèque du kit SDK fonctionnent de la même manière. Cependant, la deuxième version, shaded/lib/oci-java-sdk-full-shaded-<version>.jar peut simplifier la gestion de différentes versions des dépendances tierces. En effet, toutes les dépendances incluses dans shaded/lib/oci-java-sdk-full-shaded-<version>.jar ont été ombrées, ce qui signifie qu'elles n'interfèrent pas avec les autres versions d'elles-mêmes que vous pouvez inclure avec ce kit SDK.

Vous pouvez utiliser lib/oci-java-sdk-full-<version>.jar ou shaded/lib/oci-java-sdk-full-shaded-<version>.jar, mais pas les deux. Lorsque vous utilisez lib/oci-java-sdk-full-<version>.jar, utilisez toutes les bibliothèques tierces dans third-party/lib. Lorsque vous utilisez shaded/lib/oci-java-sdk-full-shaded-<version>.jar, utilisez toutes les bibliothèques tierces dans shaded/third-party/lib.

Pour utiliser la version ombrée du kit SDK, remplacez les commandes javac des étapes 4 et 5 par ce qui suit :

Etape 4 :

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

Etape 5 :

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