Skip to content

10. Oracle Express 11g release 2

Passamos agora à adaptação para o Oracle Express 11g release 2 do que foi feito com o MySQL5.

10.1. Configuração do ambiente de trabalho

10.1.1. Ambiente Eclipse

Trabalharemos com o seguinte ambiente Eclipse:

  

Os projetos Oracle acima estão localizados na pasta [<exemples>/spring-database-config\oracle\eclipse].

Observação: execute o comando [Alt-F5] para regenerar todos os projetos Maven.

Inicie o Oracle Express e seu cliente [OraManager] (consulte o parágrafo 23.6). Vamos gerar:

  • o banco de dados [dbproduits] com o projeto [generic-create-dbproduits];
  • o banco de dados [dbproduitscategories] com o projeto [generic-create-dbproduitscategories];

10.1.2. Criação de usuários

Agora tudo ocorre no [OraManager]. O SGBD do Oracle deve ser executado. Utilizamos as credenciais system / system para o administrador do sistema (é necessário tê-las configurado previamente). Vamos criar dois usuários:

  • [DBPRODUITS / dbproduits], que será o proprietário do banco de dados [dbproduits];
  • [DBPRODUITSCATEGORIES / dbproduitscategories], que será o proprietário do banco de dados [dbproduits];
  • em [6-7], os identificadores são [system / system];
  • em [14]: substituir por dbproduits;
  • em [16], o usuário foi criado, mas não possui permissões suficientes para fazer login. Vamos concedê-las a ele por meio de um script SQL [17-18];
  • em [19], colocar o nome do usuário em maiúsculas;

Repetimos o mesmo procedimento para criar o usuário [DBPRODUITSCATEGORIES / dbproduitscategories]:

  

10.1.3. Instalação do driver JDBC da Oracle no repositório Maven

O driver JDBC da Oracle não está disponível nos repositórios centrais do Maven. É necessário baixá-lo do site da Oracle [http://www.oracle.com/technetwork/apps-tech/jdbc-112010-090769.html]:

Após o download, é necessário instalá-lo no repositório local do Maven. Isso é feito com o seguinte script:

"%M2_HOME%\bin\mvn.bat" install:install-file -Dfile=ojdbc6.jar -Dpackaging=jar -DgroupId=com.oracle.jdbc -DartifactId=ojdbc6 -Dversion=1.0

onde se substituirá [%M2_HOME%] pelo caminho do diretório de instalação do Maven (ver parágrafo 23.2). Feito isso, o driver JDBC poderá então ser importado para os projetos Maven por meio da configuração:


        <dependency>
            <groupId>com.oracle.jdbc</groupId>
            <artifactId>ojdbc6</artifactId>
            <version>1.0</version>
</dependency>

10.1.4. Geração do banco de dados [dbproduits]

Agora que temos um usuário [DBPRODUITS / dbproduits], vamos nos conectar ao Oracle com essas credenciais:

  • em [6], insira dbproduits;
  • em [9], a base de dados [DBPRODUITS] que vamos utilizar;

Na classe [ConfigJdbc] do projeto [oracle-config-jdbc], os parâmetros de conexão utilizados são os seguintes:


    public final static String DRIVER_CLASSNAME = "oracle.jdbc.OracleDriver";
    public final static String URL_DBPRODUITS = "jdbc:oracle:thin:@localhost:1521:xe";
    public final static String USER_DBPRODUITS = "DBPRODUITS";
    public final static String PASSWD_DBPRODUITS = "dbproduits";
    public final static String URL_DBPRODUITSCATEGORIES = "jdbc:oracle:thin:@localhost:1521:xe";
    public final static String USER_DBPRODUITSCATEGORIES = "DBPRODUITSCATEGORIES";
public final static String PASSWD_DBPRODUITSCATEGORIES = "dbproduitscategories";

Você deve adaptá-los à sua configuração do Oracle.

No projeto [oracle-config-jpa-eclipselink], a entidade JPA está definida da seguinte forma:

  

package generic.jpa.entities.dbproduits;

import generic.jdbc.config.ConfigJdbc;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.SequenceGenerator;
import javax.persistence.Table;

@Entity(name="Produit1")
@Table(name = ConfigJdbc.TAB_PRODUITS)
public class Produit {

    // campos
    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqProduits")
  @SequenceGenerator(name="genSeqProduits",sequenceName="PRODUITS_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_PRODUITS_ID)
    private Long id;
    @Column(name = ConfigJdbc.TAB_PRODUITS_NOM, unique = true, length = 30, nullable = false)
    private String nom;
    @Column(name = ConfigJdbc.TAB_PRODUITS_CATEGORIE, nullable = false)
    private int categorie;
    @Column(name = ConfigJdbc.TAB_PRODUITS_PRIX, nullable = false)
    private double prix;
    @Column(name = ConfigJdbc.TAB_PRODUITS_DESCRIPTION, length = 100, nullable = false)
    private String description;

...
}
  • linhas 18-19: a estratégia de geração da chave primária da tabela [PRODUITS] é [strategy=GenerationType.SEQUENCE]. Para MySQL, havia sido utilizada a estratégia [@GeneratedValue(strategy = GenerationType.IDENTITY)]. Com o Oracle Express 11g, essa estratégia não pode ser utilizada;
  • linha 18: indica-se que a chave primária será obtida por meio de um gerador de números, frequentemente chamado de sequência;
  • linha 19: o gerador de sequências (o atributo name faz referência ao gerador da linha 18) criará uma sequência chamada [PRODUITS_SEQUENCE] no banco de dados [dbproduits]. Como se deseja garantir a portabilidade entre as implementações JPA, é importante nomear a sequência. Caso contrário, na ausência da linha 19, as três implementações JPA criarão sequências que não terão o mesmo nome, tornando impossível a utilização, por JPA2, de um banco de dados criado por JPA1;

Estamos prontos para executar a configuração [generic-create-dbproduits-eclipselink]:

A execução desta configuração cria dois objetos:

  • uma tabela [PRODUITS];
  • uma sequência chamada [PRODUITS_SEQUENCE]

O DDL da tabela [PRODUITS] é o seguinte:

 

A chave primária [ID] não é autoincrementada, como era o caso com MySQL. No entanto, o projeto [spring-jdbc-03] pressupõe que o SGBD se encarrega de gerar as chaves primárias da tabela [PRODUITS]. Vamos criar um trigger ou um déclencheur. Um trigger é um procedimento armazenado dentro do SGBD que é executado sob determinadas condições. Vamos criar um trigger que, a cada nova inserção, gere a chave primária do produto inserido a partir da sequência [PRODUITS_SEQUENCE] criada pela configuração JPA.

  • em [6], o trigger [PRODUITS_ID_TRIGGER] [4] será executado antes de cada inserção;
  • em [7], um procedimento armazenado específico do SGBD do Oracle. Ela indica que o campo [ID] da linha que será inserida deve ser inicializado com o seguinte valor do gerador denominado [PRODUITS_SEQUENCE];
 

A base de dados [dbproduits] está agora pronta. Execute as seguintes configurações:

  • [spring-jdbc-generic-01.IntroJdbc01];
  • [spring-jdbc-generic-01.IntroJdbc02];
  • [spring-jdbc-generic-03.JUnitTestDao1];
  • [spring-jdbc-generic-03.JUnitTestDao2];

Todas devem ser executadas com sucesso.

10.1.5. Geração do banco de dados [dbproduitscategories]

  

Agora executamos o projeto [generic-create-dbproduitscategories], que irá gerar a base de dados [dbproduitscategories]. Antes disso, no [OraManager], fazemos login com as credenciais do [DBPRODUITSCATEGORIES / dbproduitscategories] para poder observar as alterações feitas no banco de dados [dbproduitscategories]:

  

As entidades JPA utilizadas possuem as seguintes estratégias de geração de chaves primárias:

[Categorie]


public class Categorie implements AbstractCoreEntity {

    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqCategories")
  @SequenceGenerator(name="genSeqCategories",sequenceName="CATEGORIES_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_JPA_ID)
    protected Long id;

[Produit]


public class Produit implements AbstractCoreEntity {
    // propriedades
    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqProduits2")
  @SequenceGenerator(name="genSeqProduits2",sequenceName="PRODUITS_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_JPA_ID)
    protected Long id;

[Role]


public class Role implements AbstractCoreEntity {
    // propriedades
    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqRoles")
  @SequenceGenerator(name="genSeqRoles",sequenceName="ROLES_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_JPA_ID)
    protected Long id;

[User]


public class User implements AbstractCoreEntity {
    // propriedades
    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqUsers")
  @SequenceGenerator(name="genSeqUsers",sequenceName="USERS_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_JPA_ID)
    protected Long id;

[UserRole]


public class UserRole implements AbstractCoreEntity {
    // propriedades
    @Id
    @GeneratedValue(strategy=GenerationType.SEQUENCE,generator="genSeqUsersRoles")
  @SequenceGenerator(name="genSeqUsersRoles",sequenceName="USERS_ROLES_SEQUENCE", allocationSize=5)
    @Column(name = ConfigJdbc.TAB_JPA_ID)
    protected Long id;

Assim como foi feito para a base [dbproduits], serão geradas cinco sequências. Elas são utilizadas pelas implementações JPA para gerar as chaves primárias. As implementações JPA não utilizam triggers, como fizemos anteriormente, mas consultam as sequências para obter a próxima chave primária. Nós, por outro lado, geraremos as chaves primárias também com triggers. Estes são necessários para o projeto [spring-jdbc-04].

Executamos a configuração [generic-create-dbproduitscategories-eclipselink]:

e obtemos o seguinte resultado:

  

Em seguida, geramos cinco triggers para gerar as chaves primárias das cinco tabelas:

 

Os triggers são associados às tabelas da seguinte maneira:

Table

Trigger

Séquence
CATEGORIES
CATEGORIES_ID_TRIGGER
CATEGORIES_SEQUENCE
PRODUITS
PRODUITS_ID_TRIGGER
PRODUITS_SEQUENCE
ROLES
ROLES_ID_TRIGGER
ROLES_SEQUENCE
USERS
USERS_ID_TRIGGER
USERS_SEQUENCE
USERS_ROLES
USERS_ROLES_ID_TRIGGER
USERS_ROLES_SEQUENCE
  

O projeto [spring-jdbc-04] requer que a coluna [VERSIONING] tenha um valor padrão em cada uma das tabelas:

Fazemos isso para as cinco tabelas.

Agora, execute as configurações:

  • [spring-jdbc-generic-04.JUnitTestDao];
  • [spring-jpa-generic-JUnitTestDao-hibernate-eclipselink];

Ambas devem ser executadas com sucesso.

10.2. Configuração da camada JDBC

 

O projeto [oracle-config-jdbc] configura a camada [JDBC] da seguinte arquitetura de testes:

O projeto é análogo ao projeto de configuração [mysql-config-jdbc] da camada JDBC do SGBD MySQL (ver parágrafo 3.3). Apresentamos apenas as alterações:

O arquivo [pom.xml] importa o driver JDBC da Oracle:


<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>dvp.spring.database</groupId>
    <artifactId>generic-config-jdbc</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>configuration generic jdbc</name>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.2.3.RELEASE</version>
    </parent>

    <dependencies>
        <!-- dependências variáveis ********************************************** -->
        <!-- driver JDBC do SGBD -->
        <dependency>
            <groupId>com.oracle.jdbc</groupId>
            <artifactId>ojdbc6</artifactId>
            <version>1.0</version>
        </dependency>
        <!-- dependências constantes ********************************************** -->
        ....
    </dependencies>
...
</project>
  • linhas 18-22: o driver JDBC da Oracle substitui o driver MySQL;

A segunda modificação está na classe [ConfigJdbc], que define os identificadores de acesso aos bancos de dados:


    // parâmetros de conexão
    public final static String DRIVER_CLASSNAME = "oracle.jdbc.OracleDriver";
    public final static String URL_DBPRODUITS = "jdbc:oracle:thin:@localhost:1521:xe";
    public final static String USER_DBPRODUITS = "DBPRODUITS";
    public final static String PASSWD_DBPRODUITS = "dbproduits";
    public final static String URL_DBPRODUITSCATEGORIES = "jdbc:oracle:thin:@localhost:1521:xe";
    public final static String USER_DBPRODUITSCATEGORIES = "DBPRODUITSCATEGORIES";
public final static String PASSWD_DBPRODUITSCATEGORIES = "dbproduitscategories";

A terceira alteração diz respeito ao número máximo de parâmetros que um pode suportar:


    // número máximo de parâmetros de um [PreparedStatement]
    public final static int MAX_PREPAREDSTATEMENT_PARAMETERS = 1000;

O teste [JUnitTestPushTheLimits] gera ordens SQL para 5.000 produtos, que, por sua vez, gerarão [PreparedStatement] com 5.000 parâmetros. O MySQL suportava esse valor, mas o Oracle não. Reduzimos esse valor para 1.000 e agora funciona.

 

Observação: execute o [Alt-F5] para regenerar todos os projetos Maven.

O projeto [oracle-config-jpa-eclipseLink] configura a camada [JPA] da arquitetura de testes:

O projeto é análogo ao projeto de configuração [mysql-config-jpa-eclipselink] (ver parágrafo 7.3) da camada JPA Eclipselink do SGBD MySQL. Apresentamos apenas as alterações:

A primeira está na classe [ConfigJpa], na definição do bean [jpaVendorAdapter]:


    // o provedor JPA
    @Bean
    public JpaVendorAdapter jpaVendorAdapter() {
        // Observação: as entidades JPA e a configuração do EclipseLink estão no arquivo META-INF/persistence.xml
        EclipseLinkJpaVendorAdapter eclipseLinkJpaVendorAdapter = new EclipseLinkJpaVendorAdapter();
        eclipseLinkJpaVendorAdapter.setShowSql(false);
        eclipseLinkJpaVendorAdapter.setDatabase(Database.ORACLE);
        eclipseLinkJpaVendorAdapter.setGenerateDdl(true);
        return eclipseLinkJpaVendorAdapter;
}
  • linha 7: indica-se à implementação JPA que ela trabalhará com um banco de dados Oracle. A implementação JPA adotará, então, tanto os tipos de dados proprietários quanto o SQL, que é proprietário da Oracle.

A segunda modificação diz respeito à estratégia de geração de chaves primárias. A nova estratégia foi apresentada no parágrafo 10.1.

10.4. Configuração da camada JPA do Hibernate

 

Observação: execute o [Alt-F5] para regenerar todos os projetos Maven.

O projeto [oracle-config-jpa-hibernate] é análogo ao projeto [mysql-config-jpa-hibernate] (parágrafo 6.3), com as mesmas modificações que orientaram a migração do [mysql-config-jpa-eclipselink] para o projeto [oracle-config-jpa-eclipselink] (parágrafo 10.3).

Após essas alterações, a execução da configuração [spring-jpa-generic-JUnitTestDao-hibernate-eclipselink] deve ser bem-sucedida.

10.5. Configuração da camada JPA OpenJpa

 

Observação: execute o [Alt-F5] para regenerar todos os projetos Maven.

O projeto [oracle-config-jpa-openjpa] é análogo ao projeto [mysql-config-jpa-openjpa] (parágrafo 8.3), com as mesmas modificações que orientaram a migração do [mysql-config-jpa-eclipselink] para o projeto [oracle-config-jpa-eclipselink] (parágrafo 10.3).

Após essas alterações, a execução da configuração [spring-jpa-generic-JUnitTestDao-openjpa] deve ser bem-sucedida.

https://stahe.github.io
Este tutorial, escrito por Serge Tahé, é disponibilizado ao público sob os termos da Creative Commons Atribuição – Sem uso comercial – Compartilhamento igual 3.0 inalterado.