• Este projeto usa o banco de dados sample que está disponível para os servidores de banco de dados MySQL e JavaDB. Para obter mais detalhes sobre como usar um servidor de banco de dados MySQL com o IDE e criar uma conexão com o banco de dados, consulte o tutorial Conectando a um banco de dados MySQL. Como alternativa, será possível usar a conexão do banco de dados para o banco de dados sample do JavaDB que foi criado e registrado com o IDE por padrão, se você instalou o servidor GlassFish durante a instalação do IDE.

Baixando e instalando o servidor

Antes que você possa registrar o servidor, será necessário baixar o instalador do WebLogic Server e seguir as etapas descritas no guia de instalação do Oracle WebLogic Server para instalar o servidor em sua máquina local. Além de instalar o servidor, será necessário criar um domínio WebLogic antes de poder registrar o servidor com o IDE.

1. Baixe o instalador da página Downloads do Oracle WebLogic Server.
2. Instale o servidor seguindo as etapas no guia de instalação do Oracle WebLogic Server.

   Lembre-se de anotar o nome de usuário e a senha.

3. Crie um domínio WebLogic.

   Você pode usar o modo gráfico do assistente de Configuração do WebLogic para ajudá-lo a criar o domínio.

Consulte as seções a seguir do guia de instalação do WebLogic Server para obter detalhes sobre a instalação e a configuração do servidor.

• Preparando para a instalação
• Introdução aos domínios do WebLogic
• Criando um domínio WebLogic

Registrando o servidor com o IDE

Depois de instalar o servidor, é possível usar o assistente Adicionar instância de servidor para registrar uma instância do servidor especificando o domínio do servidor.

1. Abra a janela Serviços.
2. Clique com o botão direito do mouse no nó Servidores e selecione Adicionar servidor.
3. Selecione Oracle WebLogic Server. Clique em Próximo.
4. Clique em Procurar e localize o diretório de instalação do servidor. Clique em Próximo.

   O IDE automaticamente identificará o domínio para a instância do servidor.

5. Digite o nome de usuário e a senha do domínio.
6. Ative o JPA 2.0 (se não estiver ativado). Clique em Terminar.

   Observação. Se você estiver registrando uma instância do WebLogic Server 12c (12.1.1.0), o JPA 2.0 será ativado por padrão. Se você estiver registrando uma instância do WebLogic Server 11g Rel 1 (10.3.4 ou 10.3.5), poderá ativar o JPA 2.0 ao registrar o servidor ou no Gerenciador de servidores depois que o servidor estiver registrado. Consulte a seção Ativando o suporte para JPA 2.0 abaixo para obter mais detalhes.

Quando você clicar em Terminar, o Oracle WebLogic Server será exibido sob o nó Servidores na janela Serviços.

Você pode clicar com o botão direito do mouse no nó do Oracle WebLogic Server e executar várias ações, incluindo:

• Iniciar e parar o servidor
• Abrir o console de administração em seu navegador
• Visualize o Log do servidor na janela Saída do IDE

Abrindo o Admin Console

Neste exercício você abrirá o console Admin para o WebLogic Server no navegador. O console Admin permite a configuração das configurações do servidor e a visualização dos aplicativos implementados e recursos disponíveis.

1. Inicie o servidor clicando com o botão direito do mouse no nó do Oracle WebLogic Server na janela Serviços e selecione Iniciar.

   Ao iniciar o servidor, é possível ver o log do servidor na aba Oracle WebLogic Server da janela Saída.

   Caso a aba não esteja visível, você pode com o botão direito do mouse no nó do Oracle WebLogic Server e selecionar Visualizar log do servidor.

2. Clique com o botão direito do mouse no nó do Oracle WebLogic Server e selecionar Visualizar console Admin.

   Ao escolher Visualizar o console Admin, a tela de logon do servidor é aberta no navegador.

3. Conecte-se com o nome de usuário e senha que você especificou quando instalou o servidor.

Após se conectar, será possível ver a Página inicial do console Admin no seu navegador.

Ativando suporte para JPA 2.0

Se você estiver usando o Oracle WebLogic Server 11g (10.3.4 ou 10.3.5), será necessário ativar o suporte para a JPA 2.0 (Java Persistence API) e definir o provedor de persistência padrão para TopLink. O Oracle WebLogic Server 11g é um contêiner Java EE 5 e é compatível com JPA 1.0 e JPA 2.0. A JPA 1.0 é ativada por padrão quando os Oracle WebLogic Server 10.3.4 e 10.3.5 são instalados, mas a instalação do WebLogic Server inclui os arquivos necessários para suportar a JPA 2.0. É possível ativar a JPA 2.0 para o WebLogic Server ao registrar a instância do servidor ou no gerenciamento de servidores no IDE. Como alternativa, é possível seguir as etapas em Usando JPA 2.0 com TopLink no WebLogic Server na documentação do WebLogic Server.

O WebLogic Server suporta a JPA (Java Persistence API) e se integra com as bibliotecas de persistência Oracle TopLink e Kodo. Neste exercício você alterará o provedor de persistência padrão do Kodo para o Oracle TopLink no console Admin do WebLogic Server.

Observação: O suporte ao TopLink e à JPA 2.0 está ativado por padrão ao instalar o WebLogic Server 12c.

Para ativar o suporte à JPA 2.0 no gerenciador de servidores e definir o provedor de persistência padrão, execute as etapas a seguir.

1. Clique com o botão direito do mouse no nó do Oracle WebLogic Server na janela Serviços e selecione Propriedades para abrir o gerenciador de servidores.

   Como alternativa, é possível selecione Ferramentas > Servidores no menu principal para abrir o gerenciador de servidores.

   

   A aba Domínio do gerenciador de servidores permite que você visualize e modifique o nome de usuário e a senha.

2. Clique em Ativar JPA 2. Clique em Fechar.

   Ao clicar em Ativar JPA 2, o IDE modificará o classpath do WebLogic Server para adicionar os arquivos para ativar o suporte para JPA 2.

   Observação: Também é possível ativar a JPA 2.0 usando o Oracle Smart Update ou modificando manualmente o classpath do WebLogic. Para obter mais detalhes sobre como ativar o suporte para JPA 2.0, consulte os links a seguir.

   • Usando JPA 2.0 com TopLink no WebLogic Server
   • Fórum de Discussão OTN: 11g Release 1 Patch Set 3 (WLS 10.3.4)
   • Executando a API JPA 2.0 no WebLogic 10.3
3. Abra o console Admin do Oracle WebLogic Server em seu navegador e conecte-se.
4. Clique em Domínio na seção Configurações de domínio do console Admin.
5. Clique na aba JPA na aba Configuração.
6. Selecione TopLink na lista suspensa Provedor JPA padrão. Clique em Salvar.

Ao clicar em Salvar, o Oracle TopLink se tornará o provedor de persistência padrão para aplicativos implementados no servidor quando nenhum provedor de persistência for explicitamente especificado pelo aplicativo.

Observação: O aplicativo neste tutorial usará a JTA (Java Transaction API) para gerenciar transações. A JTA é ativada por padrão quando o WebLogic é instalado. É possível modificar as configurações da JTA na aba JTA da aba Configuração para o domínio.

Criando projeto

Neste exercício, você usará o assistente para Novo projeto para criar um aplicativo web e especificar o Oracle WebLogic Server como o servidor de destino.

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N; &#8984-Shift-N on Mac).
2. Na categoria Java Web, selecione Aplicativo da Web. Clique em Próximo.
3. Digite WebLogicCustomer para o nome do projeto e especifique a localização do projeto.
4. Desmarque a opção Utilizar pasta dedicada, se ela estiver selecionada. Clique em Próximo.
5. Selecione Oracle WebLogic Server na lista suspensa Servidor.
6. Selecione Java EE 5 como a versão do Java EE. Clique em Próximo.
   
7. Selecione o framework JavaServer Faces.
8. Selecione JSF 2.0 na lista suspensa Biblioteca do servidor. Clique em Terminar.
   

   O Oracle WebLogic Server inclui as bibliotecas necessárias para usar JSF 1.2 e JSF 2.0 em seus aplicativos, mas elas estão desativadas por padrão. É necessário implementar e instalar as bibliotecas antes de poder iniciar o uso das bibliotecas. Se a biblioteca ainda não estiver instalada, o IDE solicitará a você e instalará a biblioteca para você caso escolha a biblioteca no assistente para Novo projeto.

   

   Observação: A biblioteca precisa ser instalada somente uma vez.

   Ao clicar em Terminar, o IDE criará o projeto do aplicativo web e abrirá o index.xhtml no editor. O IDE modificou o web.xml para especificar faces/index.xhtml como a página index padrão.

9. Expanda o nó Arquivos de configuração na janela Projetos e clique duas vezes no arquivo weblogic.xml do descritor para abrir o arquivo no editor.
   

   Ao abrir o arquivo weblogic.xml do descritor no editor, o arquivo se parecerá com o código a seguir.

   <?xml version="1.0" encoding="UTF-8"?>
   <weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90" xmlns:j2ee="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.bea.com/ns/weblogic/90 http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd">
     <jsp-descriptor>
       <keepgenerated>true</keepgenerated>
       <debug>true</debug>
     </jsp-descriptor>
     <context-root>/WebLogicCustomer</context-root>
     <fast-swap>
       <enabled>true</enabled>
     </fast-swap>
   </weblogic-web-app>

   Observação: Se o servidor de destino for o WebLogic Server 11g, ao visualizar o arquivo weblogic.xml do descritor, será possível ver que o IDE modificou o arquivo para especificar a biblioteca do JSF que será usada com o aplicativo. Veja que a referência da biblioteca no weblogic.xml corresponde à versão do JAR do JSF 2.0 que você ativou no painel Frameworks no assistente para Novo Projeto.

   <?xml version="1.0" encoding="UTF-8"?>
   <weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90" xmlns:j2ee="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.bea.com/ns/weblogic/90 http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd">
     <context-root>/WebLogicCustomer</context-root>
     <library-ref>
         <library-name>jsf</library-name>
         <specification-version>2.0</specification-version>
         <implementation-version>1.0.0.0_2-0-2</implementation-version>
         <exact-match>true</exact-match>
     </library-ref>
     <fast-swap>
       <enabled>true</enabled>
     </fast-swap>
   </weblogic-web-app>

10. Faça as seguintes alterações no elemento <fast-swap> no weblogic.xml para alterar o valor para false. Salve as alterações.

        <fast-swap>
            <enabled>false</enabled>
        </fast-swap>
    </weblogic-web-app>

Criando a conexão de banco de dados

Este tutorial usa um banco de dados chamado sample e é executado no servidor de banco de dados MySQL. Neste exercício, você usará o IDE para criar o banco de dados e preencher as tabelas do banco de dados. Em seguida, você abrirá uma conexão de banco de dados para o banco de dados. O IDE usará os detalhes da conexão do banco de dados para criar a unidade de persistência para o aplicativo. Para obter mais detalhes sobre como usar um servidor de banco de dados MySQL com o IDE, consulte o tutorial Conectando a um banco de dados MySQL.

Observação: Como alternativa, se você instalou o servidor GlassFish quando o IDE foi instalado, será possível usar a conexão do banco de dados para o exemplo de banco de dados no servidor de banco de dados JavaDB que foi registrado automaticamente durante a instalação do IDE.

Neste exercício, você criará e abrirá uma conexão para o banco de dados.

1. Clique com o botão direito do mouse no nó do MySQL Server na janela Serviço e selecione Conectar.
2. Digite o nome de usuário e a senha. Clique em OK.
3. Clique com o botão direito do mouse no nó Servidor MySQL e escolha Criar banco de dados.
4. Selecione sample na lista suspensa Novo nome do banco de dados. Clique em OK.
   

   Observação: Dependendo de como você configurou o banco de dados, você pode vir a precisar especificar explicitamente as permissões de acesso para o novo banco de dados.

   Ao clicar em OK, o IDE criará um exemplo de banco de dados e preencherá as tabelas do banco de dados. Se você expandir o nó do servidor MySQL, será possível ver que a lista de bancos de dados agora contém o novo banco de dados sample.

5. Expanda o nó do servidor MySQL e clique com o botão direito do mouse no exemplo de banco de dados e selecione Conectar.

Ao clicar em Conectar, um nó de conexão de banco de dados para o banco de dados aparece sob o nó Bancos de dados. É possível expandir o nó para visualizar as tabelas do banco de dados.

O IDE usa a conexão de banco de dados para se conectar ao banco de dados e recuperar os detalhes do banco de dados. O IDE também usa os detalhes da conexão de banco de dados para gerar o arquivo XML que o WebLogic Server usa para criar as fontes de dados no servidor e identificar os drivers apropriados.

Se você não possui um banco de dados MySQL instalado, você pode usar o banco de dados sample em execução no JavaDB. Caso o banco de dados sample não exista, você pode clicar com o botão direito do mouse no nó MySQL (ou JavaDB) e selecionar Criar banco de dados.

Para obter mais detalhes, consulte o tutorial Conectando a um banco de dados MySQL.

Criando a unidade de persistência

Para gerenciar a persistência no aplicativo, é necessário apenas criar uma unidade de persistência, especificar quais fonte de dados e gerenciador de entidade a serem usados e permitir que o contêiner realize o trabalho de gerenciar as entidades e a persistência. Uma unidade de persistência é criada ao defini-la em persistence.xml.

Observação: Para fins de demonstração, neste exercício, você usará o assistente para Nova unidade de persistência para criar o arquivo persistence.xml. O assistente o ajudará a especificar as propriedades da unidade de persistência. Também é possível criar uma unidade de persistência no assistente Nova classe de entidade a partir do banco de dados. Caso nenhuma unidade de persistência exista, o assistente fornece a opção de criar uma unidade de persistência para o projeto. O assistente criará uma unidade de persistência que usa o provedor de persistência padrão do WebLogic Server.

1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Propriedades.
2. Na categoria Códigos-fonte da janela Propriedades, selecione JDK 6 como o formato Binário/Código-fonte. Clique em OK.
3. Selecione Novo arquivo (Ctrl-N; &#8984-N no Mac) para abrir o assistente para Novo arquivo.
4. Selecione Unidade de persistência na categoria Persistência. Clique em Próximo.
5. Mantenha o nome padrão para a unidade de persistência sugerido pelo assistente.
6. Selecione EclipseLink na lista suspensa Provedor de persistência.
7. Selecione Nova fonte de dados na lista suspensa Fonte de dados.
8. Digite jdbc/mysql-sample para o nome da JNDI na caixa de diálogo Nova fonte de dados.
9. Selecione a conexão do exemplo de banco de dados MySQL. Clique em OK para fechar a caixa de diálogo.
10. Clique em Terminar no assistente para Nova unidade de persistência.

Ao clicar em Terminar, o arquivo persistence.xml é criado para o seu projeto e é aberto no editor. Você pode clicar em XML na barra de ferramentas do editor para ver a visualização do XML de persistence.xml. Esse arquivo contém as informações que o servidor precisa para gerenciar as entidades e a persistência do aplicativo.

Observação: Se você não estiver usando uma fonte de dados existente, o IDE gerará um arquivo XML sob o nó Recursos do servidor (por exemplo, datasource-1-jdbc.xml) contendo os detalhes que são usados para criar uma fonte de dados no servidor, incluindo o driver JDBC para o banco de dados.

Se persistence.xml for aberto no editor XML, será possível ver que o IDE especificou a versão da persistência como 2.0 e o esquema como persistence_2_0.xsd. O IDE especifica org.eclipse.persistence.jpa.PersistenceProvider como o provedor de persistência em persistence.xml. O EclipseLink é a implementação de persistência principal para Oracle TopLink e a implementação de referência da JPA.

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.0" xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_2_0.xsd">
  <persistence-unit name="WebLogicCustomerPU" transaction-type="JTA">
    <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    <jta-data-source>jdbc/mysql-sample</jta-data-source>
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <properties>
      <property name="eclipselink.ddl-generation" value="create-tables"/>
    </properties>
  </persistence-unit>
</persistence>

Também é possível selecionar o TopLink no assistente, que, nesse caso, o assistente especificará oracle.toplink.essentials.PersistenceProvider como o provedor de persistência em persistence.xml. O IDE adicionará as bibliotecas do Oracle TopLink Essentials - 2.0.1 ao classpath. Nas versões atuais e futuras do Oracle TopLink, o Oracle TopLink Essentials são substituídos pelo EclipseLink. Onde for possível, você deveria optar por usar o Oracle TopLink/EclipseLink em vez do Oracle TopLink Essentials.

Criando as classes de entidade

Agora, você usará o assistente para Classes de entidade em banco de dados para criar as classes de entidade com base em um banco de dados relacional.

1. Selecione Novo arquivo (Ctrl-N) para abrir o assistente para Novo arquivo.
2. Selecione Classes de entidade em banco de dados na categoria Persistência. Clique em Próximo.
3. No assistente para Classes de entidade em banco de dados, selecione jdbc/mysql-sample na lista suspensa Fonte de dados e forneça a senha, se necessário.
4. Selecione a tabela Customer nas Tabelas disponíveis e clique em Adicionar. Clique em Próximo.

   O assistente lista a tabela customer e as tabelas relacionadas em Tabelas selecionadas.

5. Digite ejb como o pacote para as classes geradas. Clique em Terminar.

Ao clicar em Terminar, o IDE gerará as classes de entidade para cada tabela selecionada. É possível expandir o nó do pacote de código-fonte ejb para visualizar as classes de entidade geradas.

Gerando páginas JSF

Neste exercício, você usará um assistente para gerar páginas JSF com base em classes de entidade existentes..

1. Clique com o botão direito do mouse no nó do projeto e selecione Novo > Outro.
2. Selecione Páginas JSF em Classes de entidade na categoria JavaServer Faces do assistente para Novo arquivo. Clique em Próximo.
3. Clique em Adicionar todos para criar páginas JSF para todas as entidades disponíveis. Clique em Próximo.
4. Digite web nos campos Pacote do controlador JPA e Pacote das classes JSF. Clique em Terminar.

Ao clicar em Terminar, o IDE gerará páginas JSF 2.0 e as classes de controle e conversão para as páginas JSF.

Executando o projeto

Neste exercício, você compilará e implementará o aplicativo web no WebLogic Server. O comando Executar no IDE será usado para compilar, implementar e iniciar o aplicativo.

1. Clique com o botão direito do mouse no nó do projeto e escolha Executar.

Ao clicar em Executar, o IDE compilará o projeto e implementará o arquivo WAR no WebLogic Server e criará e registrará a nova fonte de dados JDBC. A página de boas-vindas do aplicativo (http://localhost:7001/WebLogicCustomer/) é aberta em seu navegador.

Se você se conectar ao console Admin, será possível clicar em Implementações na seção Seus recursos implementados para ver uma tabela com os recursos que estão atualmente implementados no servidor.

É possível ver que a tabela agora lista o aplicativo web WebLogicCustomer.war e a configuração JDBC jdbc/mysql-sample, além da biblioteca JSF 2.0. Você pode clicar no nome de cada recurso para visualizar detalhes adicionais sobre o recurso. Também é possível excluir recursos na tabela Implementações.

Se você expandir a instância do Oracle WebLogic Server na janela Serviços, será possível visualizar os aplicativos e recursos que estão implementados no servidor.

Observe que os recursos JDBC foram criados no servidor e que as bibliotecas JSF estão instaladas.

Para obter mais informações sobre a implementação de aplicativos, consulte Implementando aplicativos no WebLogic Server