Midleware CXF. Angélica A. P. Ribeiro, Leandro M. G. Sousa. Universidade Federal de Uberlândia (UFU) Caixa Postal Monte Carmelo MG Brazil

Transcrição

1 Midleware CXF Angélica A. P. Ribeiro, Leandro M. G. Sousa Universidade Federal de Uberlândia (UFU) Caixa Postal Monte Carmelo MG Brazil Faculdade de computação Abstract. Apache CXF is an open source services framework. CXF helps you build and develop services using frontend programming APIs, like JAX-WS and JAX-RS. These services can speak a variety of protocols such as SOAP, XML/HTTP, RESTful HTTP, or CORBA and work over a variety of transports such as HTTP, JMS or JBI. This article describes how the apache CXF works and what is the advantages between the others technologies already spocken. Resumo. Apache CXF é um framework open sorurce. CXF ajuda a construer e a desenvolver servicos que envolvem API s de programacao frontend, tipo JAX-WS e JAX-RS. Estes servicos podem falar uma variedade de protocolos comoo SOAP, XML/HTTP, RESTful HTTP, ou CORBA e trabalhar com uma variedade de transportes como tais como HTTP, JMS ou JBI. Este artigo tem como finalidade descrever como o apache CXF trabalha e mostrar quais sao as vantagens e desvantagens desta tecnologia. 1. Apache CXF Apache CXF é uma estrutura de serviços de código aberto. CXF ajuda a construir e desenvolver os serviços usando APIs de programação frontend, como JAX-WS e JAX- RS. Esses serviços podem falar uma variedade de protocolos, como SOAP, XML / HTTP, HTTP RESTful, ou CORBA e trabalho ao longo de uma variedade de transportes, tais como HTTP, JMS ou JBI. CXF inclui um amplo conjunto de recursos, mas é focado principalmente nas seguintes áreas: a) Serviços Web Standards Apoio: CXF suporta uma variedade de padrões de serviços web, incluindo SOAP, o WS-I Basic perfil, WSDL, WS-Addressing, WS-Policy, WS-ReliableMessaging, WS-Security, WS-SecurityPolicy, WS- SecureConverstation, e WS-Trust (parcial). b) Frontends: CXF suporta uma variedade de "frontend" modelos de programação. c) CXF implementa as APIs JAX-WS. Apoio CXF JAX-WS inclui algumas extensões para o padrão que o tornam muito mais fácil de usar, em comparação com a implementação de referência: Ele irá gerar automaticamente o código para as classes de solicitação e resposta de beans, e não necessita de um WSDL para casos simples.

2 d) Ele também inclui um "frontend simples", que permite a criação de clientes e pontos finais sem anotações. CXF suporta tanto primeiro contrato de desenvolvimento com WSDL e código primeiro empreendimento a partir de Java. Para REST, CXF também suporta uma interface JAX-RS. Facilidade de uso: CXF é projetado para ser intuitivo e fácil de usar. Existem APIs simples para construir rapidamente serviços Code-First, Maven plug-ins para fazer a integração fácil de ferramentas, suporte a API JAX-WS, apoio 2.x XML para fazer a configuração de um piscar de olhos, e muito mais. Apoio para Binário e Legacy Protocolo: CXF foi projetado para fornecer uma arquitetura plugável que suporta não apenas XML, mas também as ligações do tipo não-xml, como JSON e CORBA, em combinação com qualquer tipo de transporte. 2. Vantagens do apache CXF As vantagens do CXF estão incluídas em suas metas gerais são Metas Gerais: Alto desempenho Extensível Intuitiva e fácil de usar Suporte para Padrões Suporte JSR Os serviços suportados pelo apache CXF são os seguintes : JAX-WS - API Java para Serviços de Web XML (JAX-WS) JSR-224; Web Metadados Serviços para a plataforma Java - JSR-181; JAX-RS - A API Java para serviços Web RESTful - JSR-311; SAAJ - SOAP com Anexos API para Java (SAAJ) - JSR-67; WS- * e especificações relacionados Suporte; Suporte básico: WS-I Basic Profile 1.1; Qualidade de Serviço: WS-Reliable Messaging; Metadados: WS-Policy, WSDL Web Service Definition Idioma; Comunicação de Segurança: WS-Security, WS-SecurityPolicy, WS- SecureConversation, WS-Trust (suporte parcial); Suporte Messaging: WS-Addressing, SOAP 1.1, SOAP 1.2, Mecanismo Mensagem Transmissão Optimization (MTOM); Vários Transportes, Protocolo de Ligações, Ligações de dados e formata;

3 Transportes: HTTP, Servlet, JMS, In-VM e muitos outros, através do transporte do camelo por CXF como SMTP / POP3, TCP e Jabber; Ligações Protocolo: SOAP, REST / HTTP, XML puro; As ligações de dados: JAXB 2.x, Aegis, Apache XMLBeans, Service Data Objects (SDO), JiBX; Formatos: Textual XML, JSON, FastInfoset; API de extensibilidade permite ligações adicionais para CXF, permitindo um apoio adicional formato de mensagem, tais como CORBA / IIOP; Implantação Flexível; Embalagens leves: implantar serviços em Jetty, Tomcat ou recipientes com base em Primavera; Integração JBI: implantar como um mecanismo de serviço em um recipiente JBI como ServiceMix, OpenESB ou Pétalas; Integração Java EE: implantar serviços em servidores de aplicações Java EE, como Apache Geronimo, Jonas, Redhat JBoss, OC4J, Oracle WebLogic e IBM WebSphere Cliente / servidor Java Standalone; Suporte para várias linguagens de programação; O suporte total para JAX-WS 2.x modelo de programação cliente / servidor; JAX-WS 2.x API síncronas, assíncronas e unidirecionais do JAX-WS 2.x Interface de Invocação Dinâmica (DII) API; JAX-RS para clientes RESTFUL; Suporte para estilos embrulhados e não enrolados; XML API de mensagens; Suporte para JavaScript e ECMAScript 4 XML (E4X) - cliente e servidor; Suporte para CORBA; Suporte para JBI com ServiceMix; Tooling; Gerando Código: WSDL para Java, WSDL para JavaScript, Java para JavaScript; Gerar WSDL: Java para WSDL, XSD para WSDL, IDL para WSDL, WSDL para XML; Adicionando Endpoints: WSDL para SOAP, WSDL para CORBA, WSDL para o serviço; Gerando arquivos de suporte: WSDL para IDL; Validando arquivos: Validação WSDL ;

4 3. Suportes e serviços Com tantas opções disponíveis para os desenvolvedores hoje no espaço de serviços da web, uma das perguntas que vale a pena perguntar é por que dever-se-ia usar o CXF ou não. Em nenhuma ordem particular, aqui estão algumas das razões que podese querer usar CXF. CXF implementa as APIs JAX-WS que fazem serviços de construção de web fácil. JAX- WS abrange muitas áreas diferentes: Gerar WSDL de classes Java e gerar classes Java a partir do WSDL; Prove uma API que permite a criação de mensagens simples recebimento de endpoints servidor; API Dispatch que possibilita o envio de mensagens XML brutos de terminais de servidores; A primeira é uma integração da primeira classe com Apache CXF. Este suporta a sintaxe XML do Spring 2.0, tornando-se trivial para declarar endpoints que são apoiados por Primavera e injetar clientes em sua aplicação. 3.1 Aegis DataBinding Aegis ligação de dados (2.0.x) é a nossa própria biblioteca de ligação de dados que torna o desenvolvimento de serviços web de código-primeiro incrivelmente fácil. Ao contrário de JAXB, você não precisa de anotações em tudo. Ele também funciona corretamente com uma variedade de tipos de dados, tais como listas, mapas, datas, etc. direita fora da caixa. Se você está construindo um protótipo de serviços web que é realmente inestimável, uma vez que significa que você tem que fazer muito pouco trabalho para se levantar e correr (e um dos principais motivos XFire foi iniciado um tempo atrás) 3.2 Serviços RESTful CXF permite o desenvolvimento de serviços RESTful através de anotações usando o HTTP Binding. Usando modelos e anotações URI você pode vincular uma operação de serviço de combinações de URL / verbais arbitrários. Por exemplo, você pode anotar um método getcustom comgethttpresource ("/ clientes / {id}"). CXF, então, escutar as solicitações de entrar naquele URL e usando o parâmetro no {id} localização como um parâmetro para o serviço. Apache CXF suporta uma variedade de especificações de serviços da Web, incluindo WS-Addressing, WS-Policy, WS-ReliableMessaging e WS-Security. 3.3 Apache Licenciado CXF vem sob a licença Apache liberal, tornando CXF ótimo para todos os tipos de aplicações. CXF fornece uma ampla variedade de pontos de contato que o aplicativo

5 pode aproveitar. Este guia deve dar-lhe uma visão geral de algumas das funcionalidades e opções à sua disposição. 3.4 Transportes CXF trabalha com muitos transportes diferentes. Atualmente CXF inclui suporte para HTTP, JMS, e local (ou seja, "in-jvm") transporta. O transporte local é o único que não vai funcionar em máquinas, mas simplesmente envia mensagens na memória. Você também pode configurar o transporte local para evitar a serialização usando o objeto de ligação ou o recurso de colocation, se desejar. Você também pode escrever o seu próprio transporte. 3.4 Transportes CXF trabalha com muitos transportes diferentes. Atualmente CXF inclui suporte para HTTP, JMS, e local (ou seja, "in-jvm") transporta. A ligação SOAP, que é o padrão, mapeia mensagens SOAP e pode ser usado com as várias WS- * módulos dentro CXF. A ligação XML Pure evita serialização de um envelope SOAP e apenas envia uma mensagem XML bruto. Existe também uma ligação HTTP que mapeia um serviço de HTTP usando semântica RESTful. 3.6 Mensagem Intercepção e Modificação Muitas vezes você pode querer fornecer funcionalidade para o seu aplicativo que funciona em um nível baixo com mensagens XML. Isso geralmente ocorre através da funcionalidade referida como manipuladores ou interceptores. Manipuladores / interceptores são úteis para: Efetuar a autenticação com base em cabeçalhos; Cabeçalhos personalizados Processamento; Transformar uma mensagem (ou seja, via XSLT ou GZip); Redirecionando uma mensagem; Obtendo acesso ao I / O cru ou fluxo de XML; 3.7 JAX-WS Handlers Se você estiver usando a interface JAX-WS, JAX-WS suporta o conceito de manipuladores lógicos e protocolo. Manipuladores de protocolo permitem manipular a mensagem em sua matéria, muitas vezes baseada em XML, a forma - ou seja, um SAAJ SOAPMessage. Manipuladores lógicos permitem manipular a mensagem após a sua já foi ligado a partir do protocolo para o objeto JAXB que o serviço irá receber. 3.8 Interceptores Interceptores fornecer acesso a todos os recursos que CXF tem para oferecer - o que lhe permite fazer praticamente qualquer coisa, incluindo a manipulação dos bytes brutos ou XML da mensagem.

6 3.9 Transmitindo dados binários CXF fornece instalações para transmitir dados binários de forma eficiente através de um padrão chamado MTOM. Normalmente, os dados binários dentro de uma mensagem XML devem ser codificado em Base64. Isso resulta em sobrecarga de processamento e aumenta o tamanho da mensagem em 30%. Se você usar MTOM, CXF vai enviar / receber mensagens MIME com a mensagem armazenada como um anexo MIME, assim como . Isso resulta em uma comunicação muito mais eficiente e permite transmitir mensagens muito maiores do que a memória. 4. APIs JAX-WS O servidor é simplesmente a classe Java que dá vida ao Web Service. Essa classe implementará uma interface Java que define o comportamento descrito pelo WSDL e será publicada em um endereço físico acessível pelo cliente. O cliente é qualquer sistema que queira invocar operações do serviço inclusive outros serviços. A seguir, uma implementação simples da operação digaola. Figure 1: Servidor Alguns pontos importantes dessa implementação deve-se ressaltar: A classe deve ser anotada para ser interpretada pelo framework CXF. O CXF usará as informações da anotação WebService para conseguir interpretar as chamadas ao serviço e invocar esse código. A classe implementa a interface DigaOlaPortType. Essa interface foi gerada pela ferramenta wsd2java no diretório target/generated-sources/cxf.

7 Os tipos utilizados nessa operação (Nome, Saudacao, Erro) são aqueles que estão descritos no WSDL. Quando querer-se lançar um erro, pode-se utilizar a exception DigaOlaException (também gerada). Isso se traduzirá naturalmente em um Message Fault. Finalmente, cria-se um teste unitário com um cliente simples para o nosso serviço. Figure 2: Cliente Para publicar o serviço, utiliza-se apenas a classe utilitária javax.xml.ws.endpoint passando um endereço físico e uma instância da classe SimpleHelloWorldService. Além disso, o cliente (também gerado) é a classe br.com.devmedia.helloworldservice.wsdl.helloworldservice e precisa-se apenas passar o endereço do endpoint (servidor) para invocarmos a operação digaola. Nesse pom.xml a parte mais interessante está na seção de plugins. Vê-se uma ferramenta bem útil do CXF chamada wsdl2java. Esse plugin transformará o WSDL em código Java anotado utilizando o padrão JAX-WS. O JAX-WS é um padrão de mercado suportado por vários

8 fornecedores e traz facilidade na criação de serviços, apenas adicionado anotações do Java a classes Pojo. Um fato importante é que se utilizamos JAX-WS, não estamos necessariamente amarrados ao CXF. O JAX-WS é nativamente suportado pelo Java 6 em diante. Figure 3: POM.XML O WSDL que se utiliza é bem simples e oferece apenas uma operação que retorna obrigatoriamente uma resposta de sucesso ou um erro. Operações que trabalham requisição/resposta de forma síncrona são ditas que seguem o MEP (message exchange pattern) Request/Reply. Erros são comumente chamados de Fault.

9 Figure 4: WSDL do serviço de exemplo Os códigos acima foram codificados por Silva (2014) e estão disponíveis em no link devmedia (SILVA,2014). Abaixo o conseguimos ver a estrutura do WSDL, onde e composto de duas partes principais: uma abstrata que relaciona os tipos suportados (types), as mensagens (message) e as operações (porttype e operation) e a outra concreta, que amarra

10 as definições abstratas em detalhes de protocolo, transporte, endereço físicos e codificações (binding, servisse). Figure 5: Estrutura do WSDL. 6. Conclusão O Apache Axis2 é relativamente mais utilizado, mas o Apache CXF pontuações sobre outros Web Services Framework comparativamente considerando a facilidade de desenvolvimento, atual tendência da indústria, desempenho scorecard global e outros recursos (a menos que haja apoio Orquestração de Web Services é explicitamente necessário, o que não é necessária aqui ). Embora Primavera Núcleo Framework é uma tecnologia estabelecida, Web Services Spring ainda está em evolução em comparação com o Apache CXF e CXF tem suporte mais amplo de normas e quadro comprovado do ponto de vista do desempenho. Assim, Apache CXF é a estrutura recomendada e claramente o mais preferido.

11 6. Referências FOUNDATION, The Apache Software. Apache CXF Disponível em: < Acesso em: 22 nov SILVA, Leonardo Goncalves da. Desenvolvendo a primeira aplicação com Apache CXF: Veja neste artigo os passos necessários para criar uma primeira aplicação Java do tipo Web Service utilizando o framework Apache CXF. Leia mais em: Desenvolvendo a primeira aplicação com Apache CXF Disponível em: < Acesso em: 22 nov