Começando a desenvolver aplicações utilizando Oracle ADF

Por Waslley Souza
Postado em Junho 2014


O Oracle ADF (Application Development Framework) é um framework de aplicação baseado na plataforma Java, padrões Java EE e tecnologias de padrões abertos. Por ser declarativo, o Oracle ADF simplifica e acelera o desenvolvimento, possibilitando que os desenvolvedores foquem na lógica de negócio da aplicação, ao invés dos detalhes de codificação e de infraestrutura.

Arquitetura do Oracle ADF

Alinhado com as melhores práticas, as aplicações construídas com Oracle ADF atingem uma clara separação das regras de negócio, navegação de páginas e interface de usuário, aderindo ao modelo MVC.

  • Model layer: representa os dados relativos a página ativa;
  • View layer: possui as páginas utilizadas para visualizar ou modificar esses dados;
  • Controller layer: processa as informações de entrada do usuário e determina a navegação de página.
  • Business service layer: gerencia o acesso a dados e encapsula a regra de negócio.

ADF
Figure 1 - Arquitetura MVC

Os módulos do Oracle ADF se encaixam perfeitamente no padrão MVC.

  • ADF Model: permite uma abordagem unificada para vincular qualquer interface de usuário a qualquer serviço de negócio, sem a necessidade de escrever código. É o principal módulo do framework.
  • ADF Business Components: simplifica a construção de serviços de negócio.
  • ADF Faces rich client: possui uma grande variedade de componentes de interface AJAX para aplicações JSF.
  • ADF Controller: integra o JSF com o ADF Model. É uma extensão do JSF Controller com várias funcionalidades adicionais, como as Task Flows.


Figure 2 - Arquitetura do Oracle ADF

Instalação das ferramentas

Oracle Database XE

Para a nossa primeira aplicação Oracle ADF, iremos utilizar o banco de dados Oracle Database XE, pois além de ser muito simples a sua instalação, ele possui um schema pronto, chamado HR, com várias tabelas para serem utilizadas.

Faça o download do instalador para o seu sistema operacional no site da Oracle: http://www.oracle.com/technetwork/database/database-technologies/express-edition/downloads/index.html

Descompacte o arquivo.
Usando o terminal, acesse o diretório descompactado, e execute:

  • No Windows: Disk1/setup.exe
  • No Linux: rpm –ivvh oracle-xe-11.2.0-1.0.x86_64.rpm

A instalação irá começar, execute os seguintes passos:

  1. Na etapa inicial, clique em Próximo.
  2. Na etapa de contrato de licença, aceite os termos do acordo de licença e clique em Avançar.
  3. Na etapa de escolher localização de destino, informe o local que deseja instalar, e clique em Próximo.
  4. Na etapa de especificar senhas de banco de dados, informe a senha que deseja criar para os usuários SYS e SYSTEM, e clique em Próximo.
  5. Na etapa de resumo, confira as informações da instalação, e clique em Instalar.
  6. Na etapa final, clique em Concluir.

Os passos a seguir são necessários para aumentar o número de processos e sessões do Oracle Database XE para funcionar em conjunto com as ferramentas Oracle Fusion Middleware.

  1. Acesse o SQLPlus, e conecte com o usuário SYS
  2. Execute:
  3. alter system set sessions = 600 scope=spfile;
    alter system set processes = 750 scope=spfile;

  4. Faça stop/start.

Pronto! A instalação do Oracle Database XE foi realizada!

Java

Para executar o Oracle JDeveloper, precisamos da instalação do Java.
Baixe a última versão estável disponível para o seu sistema operacional no site da Oracle: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Neste artigo iremos utilizar a JDK 7u60.

Acesse a pasta onde instalador foi salvo, e execute:

  • No Windows: jdk-7u60-windows-x64.exe
  • No Linux: rpm –ivvh jdk-7u60-linux-x64.rpm

A instalação irá começar, execute os seguintes passos:

  1. Na etapa inicial, clique em Próximo.
  2. Na etapa de escolher localização de destino da JDK, informe o local que deseja instalar, e clique em Próximo.
  3. Na etapa de escolher localização de destino da JRE, informe o local que deseja instalar, e clique em Próximo.
  4. Na etapa final, clique em Fechar.

Para verificar se a instalação foi executada com sucesso, verifique a versão do JDK.


Pronto! A instalação da JDK foi realizada com sucesso!

Oracle JDeveloper

O Oracle JDeveloper é a IDE utilizada para desenvolvimento de aplicações Oracle ADF. Iremos utilizar a versão 11g (11.1.1.7.0), pois a versão 12c ainda não suporta as outras ferramentas do Oracle Fusion Middleware como SOA Suite e WebCenter.

Faça o download no site da Oracle: http://www.oracle.com/technetwork/developer-tools/jdev/downloads/jdeveloper11117-1917330.html

Neste artigo iremos utilizar o arquivo Oracle JDeveloper 11g 11.1.1.7.0 Generic/Others.

Acesse a pasta onde instalador foi salvo, e execute: java -jar jdevstudio11117install.jar

A instalação irá começar, execute os seguintes passos:

  1. Na etapa inicial, clique em Próximo.
  2. Na etapa de selecionar diretório Home de Middleware, selecione a opção "Criar um novo Home de Middleware" e informe onde deseja criar. Clique em Próximo.

  1. Na etapa de selecionar tipo de instalação, selecione a opção "Típica", e clique em Próximo.
  2. Na etapa de seleção do JDK, verifique se a JDK está selecionada, e clique em Próximo.
  3. Na etapa de selecionar diretórios de instalação do produto, clique em Próximo.
  4. Na etapa de resumo da instalação, verifique o resumo da instalação, e clique em Próximo.
  5. Na etapa final, desmarque a opção “Executar Quickstart”, e clique em Concluído.

Para aumentar a quantidade de memória utilizada pelo JDeveloper, acesse JDEVELOPER_HOME/jdeveloper/ide/bin/, abra o arquivo ide.conf, e configure os parâmetros informados abaixo:

Obs.: Considerando um computador com pelo menos 4GB de memória.

AddVMOption -Xmx

1024M

Indica o limite máximo de memória que a JVM irá consumir, nesse caso o JDeveloper.

AddVMOption -Xms

1024M

Indica o tamanho inicial da JVM. Esse é o valor alocado inicialmente pelo JDeveloper e pode crescer até o tamanho informado no parâmetro -Xmx.

Pronto! A instalação do Oracle JDeveloper foi realizada com sucesso!

Para inicializar o JDeveloper, execute os seguintes passos:

  1. Acesse JDEVELOPER_HOME/jdeveloper/jdev/bin, e execute o arquivo: jdev.exe (jdev no linux).
  2. Selecione a opção "Default Role".
  3. Na primeira execução do JDeveloper, várias janelas são abertas. Feche todas elas.

Criando uma aplicação Oracle ADF simples

Nesse artigo iremos criar uma aplicação simples, que possui uma página com uma tabela de dados de funcionários e um formulário que apresenta esses dados quando a linha da tabela é selecionada.

Para começar devemos criar uma nova aplicação, clique em New Application.
Informe o nome da aplicação, o prefixo de pacote padrão e o template "Fusion Web Application (ADF)". Clique em Finish.

O template cria os projetos Model e ViewController. No projeto Model devem ficar todos os arquivos da camada de negócios e no projeto ViewController todos os arquivos da camada de apresentação.

Vamos começar criando os arquivos necessários para consulta ao banco de dados. Selecione o projeto Model, depois selecione o menu File | New. Na janela selecione ADF Business Components | Business Components from Tables. Clique em OK.

Na próxima janela, clique em + e crie a conexão com o banco de dados. Clique em OK.

O Entity Object é o componente que faz o mapeamento de tabelas. Para cada tabela mapeada na aplicação, deve existir um Entity Object.
Nesta aplicação só iremos utilizar a tabela Employees. Então, clique em Query para consultar todas as tabelas do schema HR e selecione somente a tabela Employees. Clique em Next.

O View Object é o componente que executa as consultas / inclusões / exclusões / etc. no banco de dados. Pode existir mais de um arquivo por tabela.
Selecione o View Object Employees, e clique em Next.

Não iremos utilizar Read-Only View Objects nessa aplicação. Clique em Next.
O Application Module é o componente transacional que os componentes de interface utilizam para trabalhar com os dados da aplicação.
Clique em Finish.

Pronto! A criação dos arquivos responsáveis por executar a comunicação com o banco de dados foi realizada. Agora podemos criar a página da aplicação, que irá consumir esses arquivos.

Abra o arquivo adfc-config.xml do projeto ViewController.
Arraste o componente View e o renomeie para Employees.

Clique duas vezes no componente Employees para criar a página.
Não altere os valores. Clique em OK.

Vamos dividir a página ao meio para que cada componente tenha sua área. Arraste o componente Panel Splitter para a página e altere a propriedade Orientation="vertical".

Para criar a tabela, arraste o EmployeesView1 para a primeira área e selecione Table | ADF Read-only Table.

Selecione a opção "Single Row" para habilitar a seleção de linha na tabela, e clique em OK.

Para criar o formulário, arraste o EmployeesView1 para a segunda área e selecione Form | ADF Read-only Form. Clique em OK na próxima janela.

Para que o formulário seja atualizado ao selecionar as linhas da tabela, selecione o componente af:panelFormLayout da segunda área, e altere a propriedade PartialTriggers="t1". t1 é o identificador da tabela.

A aplicação foi criada! Salve tudo.
Para executar, clique com o botão direito no arquivo adfc-config.xml e selecione Run. Se for a primeira execução, o JDeveloper irá criar o servidor de aplicação integrado.



Waslley Leandro de Souza, é Consultor Oracle com foco em tecnologias Oracle Fusion Middleware e SOA. Pós-graduado em Engenharia de Software com ênfase em SOA e bacharel em Ciências da Computação. Possui as certificações: Oracle Application Development Framework 11g Certified Implementation Specialist; Oracle WebCenter Portal 11g Certified Implementation Specialist; Oracle Certified Expert, Java Platform, EE 6 Web Component Developer; Oracle Certified Professional, Java SE 6 Programmer.