Ejemplos

En este tema se describe cómo buscar e instalar algunos ejemplos de código de SDK para Java de OCI.

Puede encontrar ejemplos del uso de SDK en GitHub, incluidos:

Los ejemplos también están en el archivo .zip descargable para el SDK. Algunos ejemplos de versiones anteriores del SDK están en el archivo .zip descargable de la versión específica, disponible en GitHub.

Si desea ver otro ejemplo que aún no se ha cubierto, registre una incidencia de GitHub.

Ejemplos donde se utiliza Jersey 2 como biblioteca de cliente HTTP (SDK de OCI para Java 3)

Para utilizar Jersey 2 como biblioteca de cliente HTTP, se debe declarar explícitamente una dependencia en oci-java-sdk-common-httpclient-jersey en pom.xml de la aplicación. Consulte bmc-jersey-examples/pom.xml.

Los ejemplos donde se utiliza Jersey 2 como biblioteca de cliente HTTP se pueden encontrar en bmc-other-examples/bmc-jersey-examples.

Ejemplos donde se utiliza Jersey 3 como biblioteca de cliente HTTP (SDK de OCI para Java 3)

Para utilizar Jersey 3 como biblioteca de cliente HTTP, se debe declarar explícitamente una dependencia en oci-java-sdk-common-httpclient-jersey3 en la aplicación pom.xml. Consulte bmc-jersey3-examples/pom.xml.

Los ejemplos donde se utiliza Jersey 3 como biblioteca de cliente HTTP se pueden encontrar en bmc-other-examples/bmc-jersey3-examples.

Ejemplos del SDK heredado de OCI para Java (SDK deOCI para Java 1 y 2)

Puede consultar ejemplos del SDK de OCI heredado para Java aquí.

Referencia de SDK

Además de los ejemplos que se pueden encontrar en GitHub, la referencia de la API del SDK para Java contiene ejemplos de código que puede copiar y modificar para ejecutarlos en su propio entorno.

Ejecución de ejemplos

Descargue el SDK en un directorio denominado oci. Consulte GitHub para la descarga.
Descomprima el SDK en el directorio oci. Por ejemplo: tar -xf oci-java-sdk-dist.zip
Cree el archivo de configuración en el directorio raíz (~/.oci/config). Consulte Configuración del SDK.

Utilice javac para compilar una de las clases de ejemplo anteriores del directorio examples, por ejemplo:

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

Ahora debe tener un archivo de clase en el directorio examples. Ejecute el ejemplo:

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

Sombreado y dependencias de terceros

El SDK necesita un número de dependencias de terceros, que están disponibles en el directorio third-party/lib. Para utilizar la biblioteca de SDK lib/oci-java-sdk-full-<version>.jar, todas las dependencias de terceros en third-party/lib deben estar en la classpath.

El SDK también incluye una segunda versión de la biblioteca de SDK, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, que ya contiene la mayoría de las dependencias de terceros. Solo varias bibliotecas de terceros más de shaded/third-party/lib tienen que estar en la classpath al utilizar esta versión de la biblioteca de SDK.

Estas dos versiones de la biblioteca de SDK son las mismas funcionalmente, pero la segunda versión, shaded/lib/oci-java-sdk-full-shaded-<version>.jar puede simplificar la gestión con diferentes versiones de dependencias de terceros. Esto se debe a que todas las dependencias que se incluyen en shaded/lib/oci-java-sdk-full-shaded-<version>.jar se han sombreado, lo que significa que no interferirán con otras versiones de sí mismas que desee incluir junto con este SDK.

Puede utilizar lib/oci-java-sdk-full-<version>.jar o shaded/lib/oci-java-sdk-full-shaded-<version>.jar, pero no ambos. Al utilizar lib/oci-java-sdk-full-<version>.jar, utilice todas las bibliotecas de terceros en third-party/lib. Al utilizar shaded/lib/oci-java-sdk-full-shaded-<version>.jar, utilice todas las bibliotecas de terceros en shaded/third-party/lib.

Para utilizar la versión sombreada del SDK, sustituya los comandos javac en los pasos 4 y 5 por lo siguiente:

Paso 4:

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

Paso 5:

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