Tutorial Desenvolvimento de Aplicações Java/CORBA Emerson Ribeiro de Mello, Fábio Favarim e Joni da Silva Fraga {emerson, fabio, fraga@das.ufsc.br Este tutorial ensina como criar uma aplicação distribuída CORBA utilizando o JacORB. O exemplo abordado neste tutorial é um simples sistema de envio de mensagens eletrônicas, trocadas entre um cliente e um servidor. Com este exemplo é possível conhecer todas as tarefas envolvidas em uma aplicação distribuída. Os passos a seguir mostram resumidamente, o que está envolvido no processo desenvolvimento uma aplicação distribuída CORBA: 1. Definição da interface remota do objeto Deve-se definir primeiramente a interface remota do objeto usando a Linguagem de Definição de Interface da OMG (IDL-Interface Definition Language). 2. Compilação da IDL Nesta etapa serão gerados os códigos Java da interface, assim como os stubs e skeletons do objeto. 3. Implementação da interface (servant) Nesta etapa é implementado em JAVA a interface descrita na IDL. A implementação da interface é denominada servant. 4. Implementação do servidor Que é responsável por criar os objetos e por registra-los no serviço de nomes, assim como aguardar pelas invocações dos clientes remotos. O servidor usa os skeletons gerados pelo compilador IDL, para facilitar a comunicação. 5. Implementação do cliente O cliente é responsável por obter a referência para o objeto remoto e fazer a chamada aos métodos. Similarmente ao servidor, o cliente usa os Stubs gerados pelo compilador IDL como base da aplicação cliente. 6. Compilando e executando as aplicações Compilação das classes 1
Iniciar o serviço de nomes Executar o servidor Executar o cliente Desenvolvimento da Aplicação Descrição Um sistema de envio de mensagens eletrônica, onde as mensagens são compostas por um emissor, destinatário, assunto e corpo da mensagem. O lado servidor da aplicação será responsável por receber as mensagens enviadas pelo lado cliente. O cliente deverá fornecer uma forma de que se possa compor um mensagem e enviá-la para o servidor. Definição da Interface O servidor possui o método enviar_msg(mensagem email), que tem como retorno uma cadeia de caracteres, informando ao objeto que requisitou o método uma mensagem de confirmação indicando se a comunicação foi ou não bem sucessida. Escrevendo a interface IDL (tutorial.idl) module tutorial { struct mensagem{ string emissor; string destinatario; string assunto; string corpo; ; interface correio{ string enviar_msg(in mensagem email); ; ; Compilando a IDL (JacORB 1 1.4) Para compilar a IDL basta executar o seguinte comando: idl tutorial.idl 1 Para este exemplo foi usado o ORB JacORB 1.4, disponível em http://www.jacorb.org, porém pode-se utilizar qualquer ORB que esteja de acordo com a especificação CORBA v2.3 2
O compilador IDL do JacORB irá gerar 6 arquivos em um sub-diretório com o mesmo nome do módulo definido na IDL : tutorial. correio.java Esta interface contem a versão Java da interface correio (correio.idl). A classe correio.java estende a interface org.omg.corba.object, para fornecer a funcionalidade dos objetos CORBA. O arquivo correio.java: /** * Generated from IDL definition of interface "correio" * @author JacORB IDL compiler */ public interface correio extends correiooperations, org.omg.corba.object, org.omg.corba.portable.idlentity{ IDL interface correio module tutorial O mapeamento das sentenças em IDL para JAVA. correiooperations.java Java public interface correio Esta classe contem os métodos da interface correio (enviar_msg(mensagem email)). Todas as operações definidas na interface IDL são mapeadas para Java e colocadas no arquivo de operações. Para a interface correio, o arquivo correspondente seria: /** * Generated from IDL definition of interface "correio" * @author JacORB IDL compiler */ public interface correiooperations { /* constants */ /* operations */ 3
java.lang.string enviar_msg(tutorial.mensagem email); correiopoa.java Esta classe é o skeleton do servidor, responsável por fornecer a funcionalidade básica do CORBA para o servidor. _correiostub.java Esta classe é o stub do cliente, responsável por fornecer a funcionalidade básica do CORBA para o cliente. correiohelper.java Esta classe fornece operações auxiliares, como a operação narrow(), necessária para fazer o cast de uma referência de objeto CORBA para o tipo correio. correioholder.java Esta classe fornece operações para argumentos do tipo out e inout. Restando então implementar os códigos para os métodos da interface correio (correioimpl.java) definidos na IDL, e os códigos do Servidor (Servidor.java) e do Cliente (Cliente.java) Implementações Todas os códigos utilizados neste tutorial estão neste documento como anexos. Implementaçãoda Inteface(correioImpl.java) A classe correioimpl deve implementar todos os métodos da interface correio. Cada instância de correio é implementada pela correioimpl. O método enviar_msg possui como parâmetro uma estrutura (definida na IDL e que é mapeada para uma classe em Java) mensagem. Implementaçãodo Servidor(Servidor.java) A implementação do servidor deve: Iniciar o ORB; 4
Criar uma instância da implementação do objeto CORBA correio Transformar o objeto em uma referência para objeto CORBA; Obter a referência do serviço de nomes; Registrar o novo objeto no servidor serviço de nomes, usando por exemplo o nome Servidor-email ; Aguardar pelas invocações dos clientes ao objeto. Implementaçãodo Cliente(Cliente.java) A implementação do cliente deve: Inicializar o ORB; Obter a referência do serviço de nomes; Procurar pelo objeto que tenha sido registrado com o nome "Servidor-email" no serviço de nomes e recuperar a referência do objeto; Converter o objeto para o tipo de sua interface (correiohelper.narrow(obj)); Invocar os métodos no objeto. Compilando e executando o exemplo Para que seja possível compilar e executar o exemplo é importante que o ambiente já esteja preparado, ou seja, que todas as variáveis de ambientes necessárias já tenham sido configuradas. Todos os passos para preparação do ambiente no LCMI são descritos no documento guialocal.pdf que pode ser obtido em: http://www.das.ufsc.br/~emerson/java-corba, juntamente com os códigos fontes do exemplo descrito aqui. Compilando a IDL: $ idl tutorial.idl Compilando os arquivos.java: 5
$ javac tutorial/*.java Iniciando o serviço de nomes (NS) $ ns Executando o servidor Abra uma nova shell: $ jaco tutorial.servidor Executando o cliente Abra uma nova shell $ jaco tutorial.cliente 6
Anexos Arquivo: tutorial.idl // Arquivo IDL /* Descrição: Um sistema para envio de mensagens contendo um emissor, destinatario, um assunto e a mensagem propriamente dita. */ module tutorial{ struct mensagem{ string emissor; string destinatario; string assunto; string corpo; ; interface correio{ string enviar_msg(in mensagem email); ; ; Arquivo: correioimpl.java public class correioimpl extends correiopoa{ // Constructor correioimpl(){ System.out.println("Objeto correio criado com sucesso!"); public String enviar_msg(mensagem email) { 7
\n"); System.out.println("\n...::: Recebimento de mensagem :::... System.out.println("De: "+email.emissor); System.out.println("Para: "+email.destinatario); System.out.println("Assunto: "+email.assunto); System.out.println("Mensagem: "+email.corpo); System.out.println("...::: Fim da mensagem :::..."); return("mensagem enviada com sucesso"); Arquivo: Servidor.java import org.omg.cosnaming.*; class Servidor{ static public void main(string[] args){ try { // Inicia o ORB org.omg.corba.orb orb = org.omg.corba.orb.init(args, null); // Pega a referencia do POAManager e o inicializa org.omg.portableserver.poa rootpoa = org.omg.portableserver.poahelper.narrow (orb.resolve_initial_references("rootpoa")); rootpoa.the_poamanager().activate(); // Cria o objeto correioimpl objcorreio = new correioimpl(); // Transforma o objeto local em uma referencia CORBA org.omg.corba.object ref = rootpoa.servant_to_reference (objcorreio); correio correioref = correiohelper.narrow(ref); // Obtem a referencia do servico de nomes org.omg.corba.object nsref = orb.resolve_initial_references ("NameService"); NamingContextExt ncref = NamingContextExtHelper.narrow (nsref); nomes // Faz a ligação (bind) do objeto ao nome no serviço de NameComponent [] name = new NameComponent[1]; name[0] = new NameComponent("Servidor-Correio", ""); 8
ncref.rebind(name, correioref); // Executa o ORB e fica aguardando pelas invocacoes dos clientes System.out.println("Servidor de Correio iniciado com sucesso...\n\n"); orb.run(); catch (Exception e) { //Caso ocorra algum erro System.err.println("ERROR: " + e); Arquivo: Cliente.java import org.omg.cosnaming.*; class Cliente{ static correio objcorreio; static public void main(string[] args){ try { // inicializa o ORB org.omg.corba.orb orb = org.omg.corba.orb.init(args, null); // Obtem a referencia do servico de nomes org.omg.corba.object nsref = orb.resolve_initial_references ("NameService"); NamingContextExt ncref = NamingContextExtHelper.narrow (nsref); // Busca pelo nome no serviço de nomes NameComponent [] name = new NameComponent[1]; name[0] = new NameComponent("Servidor-Correio", ""); org.omg.corba.object objref = ncref.resolve(name); // Converte o objeto para o tipo da interface correio objcorreio = correiohelper.narrow(objref); //Chama o menu interativo menu(); catch(exception e) { //Em caso de algum erro 9
System.err.println("\n\n Atencao - Nao foi possivel enviar a mensagem"); System.err.println("System Exception: "+e); public static void menu(){ java.io.bufferedreader teclado = new java.io.bufferedreader(new java.io.inputstreamreader(system.in)); String linha = ""; try{ while (!linha.equals("2")) { System.out.println("\n..:: Correio eletronico ::..\n"); System.out.println("1 - Enviar nova mensagem"); System.out.println("2 - Sair\n"); System.out.print("Entre com a opcao: "); try{ linha = teclado.readline(); catch(java.io.ioexception e){ System.err.println("ERRO DE IO: "+e); if (linha.equals("1")){ mensagem msg = new mensagem(); System.out.print("\nDe: "); msg.emissor = teclado.readline(); System.out.print("Para: "); msg.destinatario = teclado.readline(); System.out.print("Assunto: "); msg.assunto = teclado.readline(); System.out.print("Corpo: "); msg.corpo = teclado.readline(); // Invocacao do metodo enviar_msg; System.out.println(objCorreio.enviar_msg(msg)); catch(exception e){ System.err.println("System Exception: "+e); 10