Exemples

Cette rubrique décrit comment trouver et installer des exemples de code de trousse SDK OCI pour Java.

Vous pouvez trouver des exemples d'utilisation de trousse SDK dans GitHub, notamment :

Les exemples figurent également dans le fichier .zip téléchargeable de la trousse SDK. Des exemples de versions plus anciennes de la trousse SDK figurent dans le fichier .zip téléchargeable de la version spécifique, disponible sur GitHub.

Si vous voulez voir un autre exemple qui n'est pas encore couvert, soumettez un problème GitHub.

Exemples d'utilisation de Jersey 2 en tant que bibliothèque de client HTTP (trousse SDK OCI pour Java 3)

Pour que Jersey 2 puisse être utilisé en tant que bibliothèque de client HTTP, une dépendance à oci-java-sdk-common-httpclient-jersey doit être déclarée explicitement dans pom.xml de l'application. Voir bmc-jersey-examples/pom.xml.

Des exemples d'utilisation de Jersey 2 en tant que bibliothèque de client HTTP sont disponibles dans bmc-other-examples/bmc-jersey-examples.

Exemples d'utilisation de Jersey 3 en tant que bibliothèque de client HTTP (trousse SDK OCI pour Java 3)

Afin d'utiliser Jersey 3 en tant que bibliothèque de client HTTP, une dépendance à oci-java-sdk-common-httpclient-jersey3 doit être déclarée explicitement dans pom.xml de l'application. Voir bmc-jersey3-examples/pom.xml.

Pour des exemples utilisant Jersey 3 comme bibliothèque de client HTTP, consultez la page bmc-other-examples/bmc-jersey3-examples.

Exemples pour la trousse SDK OCI pour Java existante (trousse SDK OCI pour Java 1 et 2)

Des exemples relatifs à la trousse SDK OCI pour Java existante sont disponibles ici.

Informations de référence sur la trousse SDK

En plus des exemples trouvés sur GitHub, les informations de référence sur les API pour la trousse SDK pour Java contiennent des exemples de code que vous pouvez copier et modifier pour les exécuter dans votre propre environnement.

Exécution d'exemples

Téléchargez la trousse SDK dans un répertoire nommé oci. Voir GitHub pour le téléchargement.
Décompressez la trousse SDK dans le répertoire oci. Par exemple : tar -xf oci-java-sdk-dist.zip
Créez votre fichier de configuration dans le répertoire de base (~/.oci/config). Voir Configuration de la trousse SDK.
Utilisez javac pour compiler 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 maintenant avoir 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 et ombrage de tierce partie

La trousse SDK nécessite un certain nombre de dépendances de tierce partie, qui sont disponibles dans le répertoire third-party/lib. Pour utiliser la bibliothèque de la trousse SDK lib/oci-java-sdk-full-<version>.jar, toutes les dépendances de tierce partie dans third-party/lib doivent figurer dans le chemin de la classe.

La trousse SDK comprend également une deuxième version de la bibliothèque SDK, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, qui contient la plupart des dépendances de tierce partie. Seules quelques bibliothèques de tierce partie dans shaded/third-party/lib doivent figurer dans le chemin de la classe lorsque vous utilisez cette version de la bibliothèque de trousses SDK.

Ces deux versions de la bibliothèque SDK sont identiques, mais la seconde version, shaded/lib/oci-java-sdk-full-shaded-<version>.jar peut simplifier le traitement des différentes versions de dépendances de tierce partie. Cela est dû au fait que 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èreront pas avec d'autres versions d'elles-mêmes que vous voudrez peut-être inclure avec cette trousse 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 de tierce partie sous third-party/lib. Lorsque vous utilisez shaded/lib/oci-java-sdk-full-shaded-<version>.jar, utilisez toutes les bibliothèques de tierce partie sous shaded/third-party/lib.

Pour utiliser la version ombrée de la trousse SDK, remplacez les commandes javac dans les étapes 4 et 5 par les éléments suivants :

Étape 4 :

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

Étape 5 :

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