< Anterior | Próximo >

Lição 3: Configurar a Conexão com o Banco de Dados

Nesta lição, você conectará seu projeto ao banco de dados importado na lição anterior.
Como o objetivo deste tutorial não é ensinar como se conectar a um banco de dados, esta lição não explicará o processo em detalhes. Resumindo, você configurará uma conexão com o banco de dados que permite que seu aplicativo EGL se conecte com o banco de dados quando você projeta o aplicativo (a conexão no tempo de design) e quando executa o aplicativo no servidor (a conexão no tempo de execução).

Conforme explicado em uma lição anterior, o WebSphere Application Server usa as informações sobre conexão com o banco de dados no projeto EAR. O Tomcat usa informações de conexão com o banco de dados no projeto da Web. Assim, as etapas de conexão com o banco de dados diferem para cada servidor.

Criando a Conexão

Independente de qual servidor esteja usando, você deve criar uma conexão no tempo de design com o banco de dados. Se você estiver usando o WebSphere Application Server, o EGL também criará automaticamente uma conexão no tempo de execução correspondente. Se você estiver usando o Tomcat, etapas adicionais posteriores nesta lição o guiarão pela associação desta conexão ao Tomcat. Na próxima lição, você também usará esta conexão no tempo de design para criar o código do EGL iniciante.

  1. Na visualização do Enterprise Explorer, clique com o botão direito do mouse no projeto EGLWeb e, em seguida, clique em Propriedades.
  2. Na janela Propriedades, clique em Origem de Dados do Tempo de Execução do EGL.
  3. Na página Origem de Dados do Tempo de Execução do EGL, selecione Carregar valores de uma conexão de ferramentas de dados e, em seguida, clique em Novo. A janela Nova Conexão será aberta.
  4. Na janela Perfil de Conexão, em Tipos de perfil de conexão, clique em Derby.
  5. Para Nome, digite o seguinte nome:
    EGLDerbyDB
  6. É possível deixar a descrição em branco. Clique em Avançar.
  7. A partir da lista Drivers, deixe o padrão Driver Integrado BIRT SampleDb Derby.
  8. Em Propriedades, no campo Local do Banco de Dados, clique em Navegar e navegue para a seguinte pasta:

    workspace-location/EGLWeb/WebContent/EGLDerbyDB

    workspace-location é o caminho completo da área de trabalho atual. Clique em OK.

  9. Limpe o campo Nome de usuário e deixe o campo Senha em branco. Você não precisa de um nome de usuário ou senha para este banco de dados.
  10. Aceite o valor-padrão para a URL. Você pode desmarcar a caixa de opção Criar banco de dados (se necessário), pois o banco de dados já existe. Certifique-se de que Conectar quando o assistente concluir esteja selecionado.
  11. Clique em Testar Conexão. Se todas as informações estiverem corretas, a janela Nova Conexão deverá ser semelhante ao seguinte exemplo, com suas próprias informações de área de trabalho e local no campo Local do Banco de Dados:
    A janela Especificar um Driver e Detalhes da Conexão mostra uma conexão bem-sucedida
  12. Clique em OK para fechar a janela Testar Conexão.
  13. Clique em Concluir. A nova conexão é criada e as informações necessárias para a conexão são preenchidas nos campos abaixo:
    Nova Origem de Dados de Tempo de Execução na página Propriedades

    Observe que o EGL forneceu a esta conexão um Nome JNDI, que é um identificador para a conexão. Por padrão, o nome da JNDI será jdbc/EGLDerbyDB, com base no nome do banco de dados. O aplicativo usará este nome para acessar a conexão com o banco de dados no tempo de execução.

  14. Clique em OK.
  15. Você pode ver uma janela perguntando se deseja atualizar as informações nas opções de criação padrão desse projeto. Se visualizar essa janela, clique em Sim.
  16. Na visualização Explorador de Projetos, expanda o projeto EGLWeb e a pasta EGLSource. Abra o arquivo de construção para o projeto clicando duas vezes no arquivo EGLWeb.eglbld na visualização Explorador de Projetos. O arquivo de construção é aberto no editor de partes de construção.
  17. Verifique se a janela Origem de Dados do Tempo de Execução do EGL configurou as opções do descritor de construção com base nas informações de conexão. As opções do descritor de construção devem ser semelhantes a esta para o WebSphere Application Server:
    Figura das opções do descritor de construção mostrando as configurações adequadas para a conexão com o banco de dados
    Para que a conexão com o banco de dados funcione, as seguintes opções devem ser configuradas:
    dbms
    Esta opção do descritor de construção indica o tipo de banco de dados, nesse caso, o DERBY.
    sqlDB
    Esta opção do descritor de construção indica a URL de conexão ou uma cadeia que o servidor usa para localizar o banco de dados. O formato da URL de conexão difere para cada tipo de banco de dados, mas para o Derby, o formato é o protocolo de conexão (neste caso, o JDBC), um separador de dois-pontos, o tipo de banco de dados (Derby), outro separador de dois-pontos, o caminho para o banco de dados no disco e qualquer outro parâmetro para a conexão. Neste caso, a URL de conexão é algo como o seguinte exemplo, com o caminho para o banco de dados no lugar de D:\MyData\workspace_jsf_tutorial:
    jdbc:derby:D:\MyData\workspace_jsf_tutorial\EGLWeb\WebContent\EGLDerbyDB
    sqlValidationConnectionURL
    Esta opção do descritor de construção configura uma URL de conexão a ser usada para validar a conexão com o banco de dados. Nesse caso, como na maioria dos casos, esta opção é igual a sqlDB.
    sqlJDBCDriverClass
    Esta opção do descritor de construção configura o nome do driver do banco de dados, o programa usado para acessar o banco de dados. A janela Nova Conexão recuperou este nome do arquivo derby.jar: org.apache.derby.jdbc.EmbeddedDriver.
    sqlJNDIName
    O nome JNDI que representa a conexão no tempo de execução.
  18. Se as opções do descritor de construção tiverem sido configuradas com base nas informações preenchidas na janela Nova Conexão, feche o descritor de construção sem fazer alterações. Se as opções do descritor de construção não tiverem sido configuradas, siga estas etapas para configurá-las:
    1. Na lista Carregar opções do BD usando a conexão, selecione sua conexão EGLDerbyDB. Muitas opções são configuradas, exceto a opção sqlJNDIName.
    2. Configure a opção sqlJNDIName com o seguinte nome JNDI, exatamente como mostrado:
      jdbc/EGLDerbyDB
      Nota: Para abrir a opção sqlJNDIName para edição, clique duas vezes lentamente na coluna Valor ao lado dessa opção. Além disso, você pode clicar três vezes rapidamente na coluna Valor.
      Os valores das opções do descritor de construção agora correspondem aos descritos acima.
    3. Salve e feche o descritor de construção.
    4. Opcionalmente, configure a janela Conexão com o Banco de Dados no Tempo de Execução do EGL para fazer essas alterações no futuro ativando a preferência associada. Clique em Janela > Preferências e, em seguida, clique em EGL > Descritor de Construção Padrão. Em Atualizar opções do descritor de construção padrão para o projeto quando a origem de dados do tempo de execução for modificada, selecione Sempre para atualizar as opções do descritor de construção automaticamente ou selecione Avisar para oferecer a opção. Esta preferência entra em vigor da próxima vez que você usa a janela Conexão com o Banco de Dados no Tempo de Execução do EGL.

Ponto de Verificação da Lição

Nesta lição, você configura uma conexão com o banco de dados para o projeto.
Quando você usou a página Origem de Dados do Tempo de Execução do EGL da janela Propriedades do projeto, primeiro criou uma conexão no tempo de design com o banco de dados usando as ferramentas de dados do ambiente de trabalho. Então, se você estava usando o WebSphere Application Server, o EGL usou as informações nesta conexão no tempo de design para criar uma conexão correspondente a ser usada no tempo de execução. Nesse caso, as alterações feitas no EGL em seus projetos incluem:
  • O EGL configurou os valores de determinadas opções do descritor de construção relacionadas ao banco de dados, conforme explicado anteriormente na lição.
  • O EGL criou um nome JNDI a ser usado como um nome para a conexão. Por padrão, o nome da JNDI criado para seu projeto será jdbc/EGLDerbyDB, com base no nome do banco de dados.
  • Para versões do WebSphere Application Server anteriores à Versão 7, o EGL incluiu uma origem de dados para o descritor de implementação do projeto EAR. Esta origem de dados associa o nome JNDI ao banco de dados em si. Com a Versão 7, a origem de dados não precisa mais ser definida no EAR.
  • O EGL incluiu uma referência de recurso a esse nome da JNDI no descritor de implementação do projeto EGLWeb, WebContent\WEB-INF\web.xml. Agora o projeto EGLWeb pode usar a origem de dados definida no projeto EAR, usando o nome JNDI. O editor parece muito diferente, dependendo da versão do servidor de aplicativos que é usada. O exemplo a seguir mostra o editor do WebSphere Application Server Versão 7.
    O descritor de implementação da Web que mostra a referência de recurso

Se você estiver usando Tomcat, seu projeto não tem um projeto EAR, então o EGL incluiu um arquivo de contextos no projeto da Web que fornece as informações para a conexão. O arquivo de contexto executa essencialmente a mesma tarefa que as informações nos descritores de implementação: associa o nome JNDI ao local do banco de dados e outras informações necessárias ao servidor para conexão. A conexão é válida apenas para este projeto.

Nota: A partir deste ponto, a maioria das etapas é igual, independente de qual servidor você esteja usando.
< Anterior | Próximo >

Feedback