< Anterior | Próximo >

Lição 2: Configurar a Área de Trabalho

Antes de gravar a lógica, crie dois projetos do EGL e importe as amostras Dojo.

Um aplicativo do EGL é organizado em um ou mais projetos, cada um dos quais é uma pasta física na área de trabalho. Um projeto contém uma pasta de origem do EGL que é fornecida para você, e essa pasta contém um ou mais pacotes que, por sua vez, contêm os arquivos de origem EGL. Esta hierarquia é a base para seu trabalho no EGL: um projeto, uma pasta de origem do EGL e um pacote com arquivos de origem EGL.

Os arquivos de origem EGL incluem partes do EGL, que são definições de tipo que você cria. Por exemplo, uma parte de Serviço contém lógica e uma parte de Registro pode ser a base de uma variável que você declara em sua parte de Serviço.

Os pacotes são importantes porque eles separam as partes em diferentes contextos ou namespaces:
  • Um nome da parte pode estar duplicado em dois pacotes diferentes, e qualquer código de origem do EGL pode fazer referência de cada parte precisamente. O principal benefício dos namespaces é que equipes diferentes podem desenvolver partes do EGL diferentes sem causar colisões de nomes.
  • Cada nome da parte em um pacote determinado é exclusivo dentro desse pacote:
    • Uma parte em um pacote pode facilmente fazer referência a outra parte no mesmo pacote especificando o nome da parte. Por exemplo, a seguir está uma declaração de um registro que é baseada na parte de Registro MyRecordPart:
      myRecord MyRecordPart{};
    • Uma parte em um pacote também pode fazer referência a uma parte em um segundo pacote fornecendo o nome do pacote e o nome da parte, ou por meio de um atalho que envolve a importação da parte. Este tutorial fornece exemplos.

Um projeto pode fazer referência a partes em um segundo projeto, mas apenas se o caminho de construção do EGL do projeto que faz a referência identificar o projeto de referência. Novamente, este tutorial fornece exemplos. Entretanto, em todos os casos, evite usar o mesmo nome do pacote em projetos diferentes, pois esse uso pode causar problemas na resolução do nome.

Sua próxima tarefa neste tutorial é criar os seguintes projetos:
MortgageServiceProject
Retém uma parte de Serviço do EGL e definições relacionadas
MortgageUIProject
Retém os manipuladores do Rich UI e definições relacionadas

É possível incluir todos os códigos em um único projeto, mas a separação mostrada aqui permite que você implemente facilmente os dois tipos de código de maneiras diferentes.

Criar um Projeto de Serviço do EGL

  1. Se você estiver em uma perspectiva do ambiente de trabalho diferente do EGL, vá para a perspectiva do EGL clicando em Janela > Abrir Perspectiva > [Outra] > EGL. O ícone da perspectiva está no canto superior direito do ambiente de trabalho.
    O ícone do EGL indica a perspectiva do EGL e é exibido em uma guia que está abaixo dos ícones minimizar, maximizar e fechar.
  2. Clique em Arquivo > Novo > Projeto do EGL ou clique no ícone Novo Projeto do EGL na barra de menus.
    O ícone Novo projeto é o primeiro de quatro no segundo grupo de ícones na barra de menus.
  3. Na janela Projeto do EGL, insira a seguinte informação:
    1. No campo Nome do projeto, digite o seguinte nome:
      MortgageServiceProject
    2. Na seção Tipos de Projeto do EGL, clique em Projeto Geral.
      A janela Novo Projeto do EGL com o Nome do projeto “MortgageServiceProject”.
    3. Clique em Avançar.
  4. Na segunda janela Projeto do EGL, os padrões que o EGL fornece devem estar corretos. Verifique as seguintes informações:
    1. A Plataforma de tempo de execução de destino é Java. Essa configuração indica que o EGL gera código de origem Java a partir da parte de Serviço do EGL.
    2. Em Opções do descritor de construção, o botão de opções Criar um novo descritor de construção está selecionado. Os descritores de construção controlam o processo de geração. Como você está criando um projeto separado para seu serviço, é possível usar o descritor de construção padrão que o EGL cria para você.
  5. Clique em Concluir.
O EGL cria um projeto denominado MortgageServiceProject. Observe as seguintes pastas dentro do diretório:
EGLSource
Coloque seus pacotes e arquivos de origem aqui.
EGLGen/JavaSource
O EGL coloca os arquivos Java que ele gera aqui.
JavaSource
Coloque quaisquer arquivos de origem Java customizados aqui. Esses arquivos não são sobrescritos durante o processo de geração.
JRE System Library
O EGL usa essa pasta para arquivos JAR que suportam o Java Runtime Environment.
A visualização Explorador de Projetos mostra o novo projeto e as pastas.

Criar um Projeto do EGL Rich UI

  1. Clique no ícone Novo Projeto do EGL na barra de menus.
  2. Na janela Novo Projeto do EGL, insira a seguinte informação:
    1. No campo Nome do projeto, digite o seguinte nome:
      MortgageUIProject
    2. Na seção Tipos de Projeto do EGL, clique em Projeto do Rich UI.
      A janela Projeto do EGL com o Nome do projeto "MortgageUIProject."
    3. Clique em Avançar.
  3. Na segunda janela Projeto do EGL, os padrões que o EGL fornece devem estar corretos. Verifique as seguintes informações:
    1. Usar o local padrão para o projeto está selecionado.
    2. A lista Bibliotecas do Widget contém os seguintes projetos:
      • Widgets EGL Rich UI
      • Widgets Dojo do EGL
    3. No grupo Recursos do Projeto do EGL, Criar um descritor de implementação do EGL está selecionado.
  4. Clique em Avançar.
  5. Na página Configurações do EGL, selecione MortgageServiceProject. O projeto de serviço é incluído no caminho de construção para o novo projeto, para que o projeto da IU possa usar partes que estão definidas no projeto de serviço.
  6. Clique em Concluir.
O EGL cria um projeto denominado MortgageUIProject e inclui projetos de suporte na área de trabalho do Rich UI, Widgets Dojo e da biblioteca de tempo de execução Dojo. Além dos diretórios que o EGL criou para o projeto Geral, um projeto do Rich UI inclui o seguinte diretório:
WebContent
Contém arquivos de suporte, tais como folhas de estilo em cascata (CSS) e imagens.
A visualização Explorador de Projetos mostra o novo projeto e as pastas.

Importar a Amostra de Widgets Dojo do EGL

  1. A partir do menu da parte superior do ambiente de trabalho, clique em Ajuda > Conteúdo da Ajuda.
  2. Em Conteúdo da Ajuda, expanda Amostras > Amostras de tecnologia > EGL e clique em Widgets Dojo do EGL.
    O menu Amostras expandido.
  3. Na área de janela Conteúdo, clique em Obter a amostra.
    A área de janela Conteúdo
  4. Na janela Importar, os valores padrão estão corretos. Clique em Concluir.
A versão mais recente do projeto com.ibm.egl.rui.dojo.samples é incluída na área de trabalho.
O projeto de amostras Dojo na visualização Explorador de Projetos.

Alterar o Caminho de Construção para MortgageUIProject

O caminho de construção do EGL determina os projetos que o EGL examina ao tentar resolver referências em sua lógica. Para incluir o projeto que acabou de ser importado:

  1. Na visualização Explorador de Projetos, clique com o botão direito do mouse em MortgageUIProject e, em seguida, clique em Propriedade. No lado esquerdo da janela Propriedades do MortgageUIProject, clique em Caminho de Construção do EGL. O EGL exibe uma lista de projeto em sua área de trabalho.
  2. Selecione o projeto com.ibm.egl.dojo.samples. Não é necessário selecionar o projeto com.ibm.egl.dojo.widgets, pois ele já está no caminho de construção do projeto com.ibm.egl.dojo.runtime.local. A janela do caminho de construção concluída deve parecer com a seguinte imagem:
    Quatro de cinco projetos estão selecionados.
    Estas seleções significam que quando você organiza as instruções de importação que fornecem outros detalhes para seus programas, o EGL verificará todos os projetos selecionados para resolver referências.
  3. Clique em OK.

Ponto de Verificação da Lição

Nesta lição, você concluiu as tarefas a seguir:
  • Criou um projeto do EGL para o serviço de hipoteca
  • Criou um projeto do EGL para o aplicativo do Rich UI
  • Importou o projeto de amostras Dojo do EGL
  • Ajustou o caminho de construção do EGL para o segundo projeto

Na próxima lição, você criará um serviço dedicado para calcular um pagamento de hipoteca mensal.

< Anterior | Próximo >

Feedback