Preparando Glassfish 3.1.2 para aplicações ADF com Oracle JDeveloper 12c

Objetivo

O objetivo deste tutorial é apresentar passo a passo o necessário para configurar o servidor de aplicações Glassfish 3.1.2 fazendo o mesmo suportar o deploy de aplicações JEE com ADF framework.

Obtendo artefatos necessários

Baixe o Glassfish 3.1.2 (Full Platform - EN) no link Glassfish na área links deste tutorial. É muito importante que a versão seja Full Platform, pois a versão Web Profile não possui características necessárias ao framework ADF.

Baixe também o adf-essentials.zip (conjunto de jars necessário para rodar aplicações ADF) no link ADF Essentials na área links deste tutorial.

Segue abaixo a lista de jars presentes no adf-essentials.zip:

·      oracle.adf.share.ca_11.1.1/adf-share-base.jar

·      oracle.adf.share.ca_11.1.1/adf-share-ca.jar

·      oracle.adf.share_11.1.1/commons-el.jar

·      oracle.adf.share_11.1.1/adf-share-support.jar

·      oracle.adf.share_11.1.1/adfsharembean.jar

·      oracle.adf.share_11.1.1/jsp-el-api.jar

·      oracle.adf.share_11.1.1/adflogginghandler.jar

·      oracle.adf.share_11.1.1/oracle-el.jar

·      oracle.mds_11.1.1/mdsrt.jar

·      oracle.bali.share_11.1.1/share.jar

·      oracle.xmlef_11.1.1/xmlef.jar

·      oracle.javatools_11.1.1/resourcebundle.jar

·      oracle.javatools_11.1.1/javamodel-rt.jar

·      oracle.javatools_11.1.1/javatools-nodeps.jar

·      oracle.adf.security_11.1.1/adf-share-security.jar

·      oracle.adf.security_11.1.1/adf-controller-security.jar

·      oracle.xdk_11.1.0/xmlparserv2_sans_jaxp_services.jar

·      oracle.xdb_11.1.0.jar

·      oracle.jrf_11.1.1/jrf-api.jar

·      oracle.jdbc_11.1.1/ojdbc6dms.jar

·      oracle.dms_11.1.1/dms.jar

·      oracle.odl_11.1.1/ojdl.jar

·      oracle.odl_11.1.1/ojdl2.jar

·      oracle.jmx_11.1.1/jmxframework.jar

·      oracle.jmx_11.1.1/jmxspi.jar

·      oracle.classloader_11.1.1.jar

·      oracle.logging-utils_11.1.1.jar

·      oracle.web-common_11.1.1.jar

·      oracle.webservices_11.1.1/oc4j-ws-support.jar

·      org.apache.bcel_5.1.jar

·      oracle.nlsrtl_11.2.0/orai18n-mapping.jar

Instalando o Glassfish

Execute o instalador como administrador. Siga as instruções do assistente de instalação e desmarque a opção Instalar Ferramenta de Atualização conforme Figura 1.

Figura 1 - Instalando Glassfish

Ao final da instalação, será gerado o diretório c:\glassfish3 (doravante chamado GLASSFISH_HOME).

Configurando Glassfish

Acesse o prompt de comando e vá até o diretório GLASSFISH_HOME/bin e então execute o arquivo asadmin.bat para ter acesso ao prompt de administração do Glassfish. Pare a execução do domínio padrão com a instrução stop-domain domain1 e em seguida remova-o com a instrução delete-domain domain1 conforme Figura 2.

Figura 2 - Remove domínio padrão

Em seguida crie um novo domínio com a instrução create-domain adfdomain. NÃO tecle “Enter” para aceitar o usuário padrão admin, digite um usuário e senha a sua escolha conforme Figura 3. Neste tutorial utilizaremos usuário e senha admin/admin respectivamente.

Figura 3 - Criando domínio adfdomain

Inicialize o novo domínio com a instrução start-domain adfdomain e execute instrução enable-secure-admin. A após a mensagem de falha e autenticação digite a senha para o usuário criado anteriormente. Vide Figura 4.

Figura 4 - Habilitando Segurança

Reinicialize o domínio com as instruções stop-domain adfdomain e start-domain adfdomain. Acesse o console administrativo https://localhost:4848/.
Na área Common-Tasks > Configurations > server-config > JVM Settings acesse a aba JVM Options. Altere a propriedade ‑XX:MaxPermSize=192m para -XX:MaxPermSize=512m e adicione a propriedade -Doracle.mds.cache=simple e então clique no botão Save conforme Figura 5.

Figura 5 - Configurando JVM Options

Após configurar as variáveis da JVM pare a execução do domain com a instrução stop-domain adfdomain. Descompacte o zip (Ignorando a estrutura de diretórios) que contem os jars do adf-essentials e copie os jars para o diretório GLASSFISH_HOME/glassfish/domains/adfdomains/lib.

Voialá, o domínio adfdomain do Glassfish esta pronto para deploy de aplicações JEE com ADF framework.

ADF-ESSENTIALS IMPORTANTE

É provável que o arquivo adf-essentials.zip não possua todos os jars apresentados na sessão Obtendo Artefatos Necessários. Os jars que estiverem faltando podem ser encontrados dentro do diretório oracle_commom da instalação do JDeveloper.

DESCOMPACTAR IGNORANDO ESTRUTURA DE DIRETORIOS

Existem softwares com Winzip, Winrar, 7zip que podem realizar esta tarefa sem dificuldade. Contudo, existe uma maneira muito simples de realizar esta tarefa via prompt de comando no Windows.

Baixe o unzip.exe no link Unzip na área links deste tutorial e mova-o para o diretório C:\Windows\System32.

Execute a seguinte instrução unzip -d adf-essentials-unziped -j adf-essentials.zip no prompt de comando, dentro do diretório que possui o arquivo adf-essentials.zip. O conteúdo do mesmo será descompactado no diretório adf-essentials-unziped ignorando a estrutura de diretórios do arquivo zip.

 LINKS

Glassfish	https://glassfish.java.net/downloads/3.1.2-final.html
ADF Essentials	http://www.oracle.com/technetwork/developer-tools/adf/overview/adfessentials-1719844.html
Unzip	http://stahlforce.com/dev/unzip.exe