Exemplos

Este tópico descreve como localizar e instalar alguns exemplos de código do OCI SDK para Java.

Exemplos de uso do SDK podem ser encontrados no GitHub, incluindo:

Os exemplos também estão no arquivo .zip transferível por download para o SDK. Há exemplos de versões mais antigas do SDK no .zip disponível para download no GitHub.

Se você deseja ver outro exemplo ainda não mencionado, registre um problema no GitHub.

Exemplos de Uso de Jersey 2 como a Biblioteca Cliente HTTP (OCI SDK para Java 3)

Para usar o Jersey 2 como a biblioteca de clientes HTTP, uma dependência do oci-java-sdk-common-httpclient-jersey precisa ser declarada explicitamente no pom.xml do aplicativo. Consulte bmc-jersey-examples/pom.xml.

Exemplos de uso do Jersey 2 como a biblioteca de cliente HTTP podem ser encontrados em bmc-other-examples/bmc-jersey-examples.

Exemplos Usando o Jersey 3 como a Biblioteca Cliente HTTP (OCI SDK para Java 3)

Para usar o Jersey 3 como a biblioteca de clientes HTTP, uma dependência do oci-java-sdk-common-httpclient-jersey3 precisa ser declarada explicitamente no pom.xml do aplicativo. Consulte bmc-jersey3-examples/pom.xml.

Exemplos de uso do Jersey 3 como a biblioteca de cliente HTTP podem ser encontrados em bmc-other-examples/bmc-jersey3-examples.

Exemplos para o Legacy OCI SDK for Java (OCI SDK for Java 1 e 2)

Veja os exemplos do OCI SDK para Java legado aqui.

Referência do SDK

Além dos exemplos encontrados no GitHub, a Referência de API do SDK para Java contém exemplos de código que você pode copiar e modificar para executar em seu próprio ambiente.

Exemplos de Execução

Faça o download do SDK para um diretório chamado oci. Consulte GitHub para obter informações sobre download.
Descompacte o SDK no diretório oci. Por exemplo: tar -xf oci-java-sdk-dist.zip
Crie o seu arquivo de configuração no diretório home (~/.oci/config). Consulte Configurando o SDK.
Use javac para compilar uma das classes de exemplo anteriores com base no diretório examples, por exemplo:
```
javac -cp lib/oci-java-sdk-full-<version>.jar:third-party/lib/* examples/ObjectStorageSyncExample.java
```

Agora você deverá ter um arquivo de classe no diretório examples. Execute o exemplo:

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

Sombreamento e Dependências de Terceiros

O SDK requer várias dependências de terceiros, que estão disponíveis no diretório third-party/lib. Para usar a biblioteca do SDK lib/oci-java-sdk-full-<version>.jar, todas as dependências de terceiros em third-party/lib deverão estar no classpath.

O SDK também inclui uma segunda versão da biblioteca SDK, shaded/lib/oci-java-sdk-full-shaded-<version>.jar, que já contém a maioria das dependências de terceiros. Somente algumas bibliotecas de terceiros em shaded/third-party/lib devem estar no caminho de classe durante a utilização dessa versão da biblioteca SDK.

Essas duas versões da biblioteca SDK são funcionalmente iguais; no entanto, a segunda versão, shaded/lib/oci-java-sdk-full-shaded-<version>.jar pode simplificar transações com diferentes versões das dependências de terceiros. Isso acontece porque todas as dependências incluídas em shaded/lib/oci-java-sdk-full-shaded-<version>.jar foram sombreadas. Isso significa que elas não interferirão com outras versões que você deseja incluir com esse SDK.

Você pode usar lib/oci-java-sdk-full-<version>.jar ou shaded/lib/oci-java-sdk-full-shaded-<version>.jar, mas não ambas as opções. Ao utilizar lib/oci-java-sdk-full-<version>.jar, use todas as bibliotecas de terceiros em third-party/lib. Ao utilizar shaded/lib/oci-java-sdk-full-shaded-<version>.jar, use todas as bibliotecas de terceiros em shaded/third-party/lib.

Para usar a versão sombreada do SDK, substitua os comandos javac nas etapas 4 e 5 pelo seguinte:

Etapa 4:

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

Etapa 5:

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