< Anterior | Próximo >

Lição 2: Desenvolver um EJB

Sobre Esta Tarefa

Nesta lição, você cria um bean de sessão, desenvolve uma interface local e desenvolve a classe de implementação para o bean. Você também usa o diálogo Gerenciar Exportações de EJB para expor o EJB como um serviço OSGi.

Criando um Bean de Sessão

Sobre Esta Tarefa

Nesta seção, você cria um bean de sessão e especifica a interface local.

Procedimento

  1. Abra o assistente de bean de sessão. No projeto EJB, dê um clique direito em ejbModule e selecione Novo > Bean de Sessão (EJB 3.x).
  2. Crie o bean. Insira os seguintes valores no assistente:
    Projeto
    EJB
    Pacote Java™
    com.ibm.example.impl
    Nome da classe
    EJBConverter
    Tipo de estado
    Stateless
    Local
    Selecione a caixa de seleção Local e insira o valor a seguir: com.ibm.example.EJBConverterLocal
    Visualização sem interface
    Desmarque Visualização Sem Interface
    Criar Bean de Sessão EJB 3.x
    Nota: O aplicativo que é desenvolvido neste tutorial usa uma interface local. Se você desejar usar interfaces remotas, selecione a caixa de seleção Remota no assistente e, em seguida, desenvolva a interface correspondente. Consultas de JNDI para interfaces remotas funcionam de forma diferente. Com as interfaces remotas, ajuste o código de consulta. A próxima lição fornecerá um exemplo.
  3. Clique em Concluir. O bean de sessão é criado e a classe se abre no editor.

Desenvolvendo a interface local

Sobre Esta Tarefa

Quando criou o bean de sessão, a interface EJBConverterLocal foi criada no projeto EJBClient. Nesta seção, você inclui dois métodos na interface. Os métodos descrevem operações de conversão de temperatura básicas.

Procedimento

  1. Abra a interface EJBConverterLocal. No projeto EJBClient, expanda a pasta ejbModule e o pacote com.ibm.example. Clique duas vezes na interface EJBConverterLocal. A interface se abre no editor.
  2. Inclua métodos à interface. Inclua os seguinte métodos à interface:
    public double convertToFahrenheit(double celsius);
    public double convertToCelsius(double fahrenheit);
    O código a seguir é o resultado:
    package com.ibm.example;
    
    public interface EJBConverterLocal {
    
       public double convertToFahrenheit(double celsius);
    
       public double convertToCelsius(double fahrenheit);
    
    }
  3. Salve as alterações. Observe que, quando você salva o arquivo de interface, erros são exibidos para a classe EJBConverter, porque ele ainda não implementa os métodos que você incluiu na interface.

Desenvolvendo a classe de implementação

Sobre Esta Tarefa

Nesta seção, você implementa os métodos de conversão de temperatura que são requeridos pela interface local.

Procedimento

  1. Abra a classe EJBConverter. No projeto EJB, expanda a pasta ejbModule e o pacote com.ibm.example.impl. Dê um clique duplo na classe EJBConverter. A class se abre no editor.
  2. Remova o construtor padrão.
  3. Inclua as implementações para os dois métodos que você incluiu na interface EJBConverterRemote. Inclua as seguintes implementações de método na classe:
    public double convertToCelsius(double fahrenheit) {
       return (fahrenheit - 32) * (5 / 9d);
    }
    
    public double convertToFahrenheit(double celsius) {
       return celsius * (9 / 5d) + 32;
    }
    A classe concluída é semelhante ao código a seguir. Observe que o código original gerado pelo assistente contém uma anotação, @Stateless, e uma anotação, @Local, que especifica a interface local que você inseriu no assistente de bean de sessão.
    package com.ibm.example.impl;
    
    import com.ibm.example.EJBConverterLocal;
    import javax.ejb.Local;
    import javax.ejb.Stateless;
    
    @Stateless
    @Local(EJBConverterLocal.class)
    public class EJBConverter implements EJBConverterLocal {
    
       public double convertToCelsius(double fahrenheit) {
          return (fahrenheit - 32) * (5 / 9d);
       }
    
       public double convertToFahrenheit(double celsius) {
          return celsius * (9 / 5d) + 32;
       }
    }
  4. Salve as alterações.

Expondo um EJB como um Serviço OSGi

Sobre Esta Tarefa

Por padrão, os EJBs que você inclui em um projeto OSGi que tem suporte de EJB são automaticamente expostos como serviços OSGi. A exposição de serviços OSGi é controlada por meio do cabeçalho Export-EJB no manifesto do OSGi. Nesta seção, você verifica o manifesto e usa o diálogo Gerenciar Exportações de EJB para confirmar que EJBConverter está exposto como um serviço OSGi.

Procedimento

  1. Abra o manifesto. No projeto EJB, dê um clique duplo em Manifesto: EJB. O manifesto é aberto. Clique na guia MANIFEST.MF para visualizar o arquivo no formato de texto. Note que existe um cabeçalho Exportar-EJB com uma entrada para o EJBConverter EJB. Note que é possível gerenciar exportações de EJB manualmente incluindo entradas no cabeçalho Exportar-EJB. EJBs podem ser incluídos como uma lista separada por vírgula.
    Nota: Existem dois casos especiais do cabeçalho Export-EJB a serem conhecidos:
    NONE
    Se você especificar NONE como uma entrada para o cabeçalho Export-EJB, não EJBs serão expostos como serviços. Se você especificar NONE mas, em seguida, também incluir um EJB na lista, um aviso será exibido pelas ferramentas.
    BLANK
    Se você tiver um cabeçalho Export-EJB no manifest, mas não houver entradas, por padrão, todos os EJBs no projeto serão expostos como serviços.
  2. Abra o diálogo Gerenciar exportação de EJB. Dê um clique com o botão direito do mouse no projeto EJB e selecione OSGi > Expor EJBs como serviços OSGi. O diálogo Gerenciar exportações de EJB se abre. No diálogo, confirme se a caixa ao lado de EJBConverter EJB está selecionada e clique em OK. É possível usar esse diálogo em seus projetos para incluir ou remover EJBs que são expostos como serviços. Mudar os EJBs selecionados nesse diálogo muda as entradas no cabeçalho Exportar-EJB no manifesto.
    Diálogo Gerenciar exportações de EJB
    Nota: Se você criar novos EJBs para o projeto, eles serão automaticamente expostos como serviços OSGi. É possível usar o diálogo Gerenciar Exportações de EJB para limpar quaisquer EJBs que você não deseja expor.
< Anterior | Próximo >
Icon that indicates the type of topic Tutorial lesson topic
Timestamp icon Last updated: last_date

File name: osgi_ejb_2.html