Processing?

Processing é uma linguagem de programação de código aberto e um ambiente de desenvolvimento integrado (IDE), construído para as artes eletrônicas e comunidades de design visual com o objetivo de ensinar noções básicas de programação de computador em um contexto visual e para servir como base para protótipos eletrônicos. O projeto foi iniciado em 2001 por Casey Reas e Ben Fry, ambos ex-membros do Grupo de Computação do MIT Media Lab. Um dos objetivos declarados do Processing é atuar como uma ferramenta para não-programadores, através da satisfação imediata de um retorno visual. Processing baseia-se na linguagem de programação Java, mas utiliza uma sintaxe simplificada e um padrão de programação baseado em gráficos.

Ambiente

O ambiente utilizado neste tutorial é Windows 7, NetBeans 7.1, JDK 1.6.0_30 e Processing 1.5.1.

Iniciando

Considerando que o NetBeans e o JDK já estejam instalados, é necessário ir no site do Processing e realizar o download da versão sem o JDK –  http://processing.org/download/. Após baixar o arquivo processing-1.5.1-windows-expert.zip, descompacte-o e mova a pasta processing-1.5.1 para dentro de C:\Arquivos de Programas.

Neste primeiro contato o Processing já está pronto para trabalhar, agora é só configurar o NetBeans.

Agora no Netbeans

Para continuar abra o NetBeans e clique em Projetos -> Bibliotecas.

Na tela de Bibliotecas, clique em Nova Biblioteca…

Em Nova Biblioteca, digite Processing 1.5.1 em Nome da biblioteca e clique em OK.

Após confirmar, clique em Adicionar JAR/pasta… Será exibida uma tela para localização dos arquivos. Procure C:\Arquivos de Programas\processing-1.5.1\lib, selecione os arquivos e clique em Adicionar JAR/pasta.

Será exibida a tela com as informações da nova biblioteca.

Neste momento a biblioteca está configurada e pronta para ser adicionada ao projeto.

Novo Projeto

Agora será necessário iniciar um novo projeto. Clique em Arquivo -> Novo Projeto. Na tela de Novo Projeto, selecione em Categorias: Java e Projetos: Aplicativo Java.

Na tela de Novo Aplicativo Java, insira o nome do projeto: TestProcessing, verifique as demais opções selecionadas e clique em Finalizar.

Após o novo projeto carregado, abra a árvore do projeto, clique em Bibliotecas, depois em Adicionar biblioteca…

Na tela de adicionar biblioteca, clique em Importar.

Selecione a biblioteca que foi criada (Processing 1.5.1) e clique em Importar biblioteca.

Novamente de volta a de Adicionar biblioteca selecione Processing 1.5.1 e clique em Adicionar biblioteca.

Os arquivos JAR do Processing serão adicionados ao projeto, assim será possível realizar a importação das bibliotecas.

Foi testado o seguinte código:

package testprocessing;
 
import processing.core.PApplet;
 
/**
*
* @author Eduardo Folly
*/
public class TestProcessing extends PApplet {
 
    /*
     *
     */
    @Override
    public void setup() {
        size(640, 480);
    }
 
   /*
    *
    */
    @Override
    public void draw() {
        background(0);
        rectMode(CENTER);
        fill(0xFFFFAA99);
        rect(mouseX, mouseY, 100, 100);
    }
 
    /**
     * @param args the command line arguments
     */
    public static void main(String[] args) {
        PApplet.main(new String[] { "testprocessing.TestProcessing" });
    }
}

E o resultado obtido foi a aplicação rodando perfeitamente.

Melhorias futuras e possíveis questões

• Somente o código fonte do exemplo foi testado, é necessário testar com outros exemplos que utilizem bibliotecas específicas.
  
• Devido ao Processing ser multi-plataforma, assim como o NetBeans, testar esta configuração em outros sistemas operacionais é imprescindível.

De acordo com a W3C, web service é um software projetado para suportar interação máquina-máquina de forma interoperável através de uma rede. Ele tem uma interface descrita em um formato máquina-processável (especificamente WSDL). Sistemas que interagem com o web service de uma maneira prescrita por sua descrição, utilizam mensagens SOAP, normalmente transmitidas através de HTTP com uma serialização XML em conjunto com outros padrões web.

O caminho.

Para a integração com outros sistemas, o ERP Protheus da Totvs provê uma série de web services e ainda existe a possibilidade de desenvolver e publicar serviços customizados dentro da plataforma.

Figura 1 – Página com a descrição dos serviços disponíveis do Protheus.

O problema.

Ao iniciar o desenvolvimento de uma aplicação em Java 6, utilizando o Netbeans 7.0 como IDE e a biblioteca JAX-WS para o consumo dos serviços, foi exibida a mensagem “WEBSERVICE ERROR : Soap Prefix Missing : USERPORTAL : PRTLOGIN : Formato do Pacote Soap DESCONHECIDO.” ao tentar executar uma chamada simples ao serviço USERPORTAL, método PRTLOGIN.

 

A solução.

Será demostrado um passo-a-passo de como iniciar um projeto até o consumo com sucesso do web service especificado.

No Netbeans, clique no menu Arquivo, seguido por Novo Projeto. Na tela que irá abrir, selecione em Categorias: “Java” e em Projetos: “Aplicativo Java”. Clique em Próximo.

Figura 2 – Novo projeto.

Informe o nome do projeto (neste caso SigaWS), faça modificações caso ache necessário e clique em Finalizar.

Figura 3 – Novo Aplicativo Java

Com o projeto criado, deverá ser criada a classe para consumo do serviço USERPORTAL, para isto clique em Arquivo, seguido por Novo Arquivo.

Figura 4 – Arquivo, Novo Arquivo.

Na tela de Novo Arquivo selecione em Categorias: “Serviços Web” e em Tipos de arquivos: “Cliente para serviço Web”, clicando em Próximo.

Figura 5 – Novo arquivo.

Na próxima tela deverá ser selecionada a opção WSDL URL e informado o caminho do arquivo de definição do serviço de acordo com o publicado no Protheus. Clique em Finalizar.

Figura 6 – Novo cliente para serviço Web.

Voltando para a tela principal do Netbeans, vá na aba Projetos e abra os nós de Referência de serviços Web até localizar o método PRTLOGIN.

Selecione o nó PRTLOGIN, arraste-o e solte dentro da classe SigaWS, isto fará com que o código de chamada ao método seja gerado automaticamente. Em seguida defina os parâmetros para execução da chamada do serviço.

Figura 7 – Definição da classe de execução do Web Service.

Executando o projeto neste momento, será verificado o erro citado no início do artigo.

Figura 8 – Erro na execução.

Para solucionar o problema, o proposto é adicionar um manipulador de mensagem SOAP e realizar algumas modificações nos dados retornados pelo serviço, assim possibilitando a serialização.

Clique em Arquivo, seguido por Novo Arquivo. Na tela seguinte, selecione em Categorias: “Serviços Web” e em Tipos de arquivos: “Manipulador de mensagens”, clique em Próximo.

Figura 9 – Novo arquivo – Manipulador de mensagens.

Informe o nome para o arquivo, neste caso SigaHandler, clique em Finalizar.

Figura 10 – Novo manipulador de mensagens.

Com o arquivo gerado o código deverá ficar desta forma:

package sigaws.ws;
 
import java.io.ByteArrayOutputStream;
import java.util.Collections;
import java.util.Set;
import javax.xml.namespace.QName;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPMessage;
import javax.xml.transform.Source;
import javax.xml.transform.stream.StreamSource;
import javax.xml.ws.handler.MessageContext;
import javax.xml.ws.handler.soap.SOAPHandler;
import javax.xml.ws.handler.soap.SOAPMessageContext;
 
/**
 *
 * @author Eduardo Folly
 */
public class SigaHandler implements SOAPHandler {
 
    @Override
    public boolean handleMessage(SOAPMessageContext messageContext) {
        boolean outbound = (Boolean) messageContext.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);
 
        if (outbound) {
            try {
                SOAPMessage msg = messageContext.getMessage();
 
                ByteArrayOutputStream baos = new ByteArrayOutputStream();
                msg.writeTo(baos);
                String teste = baos.toString(getMessageEncoding(msg));
                teste = teste.replaceAll("S:", "soap:");
                teste = teste.replaceAll("S=", "soap=");
 
                Source src = new StreamSource(new java.io.StringReader(teste));
                msg.getSOAPPart().setContent(src);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        return true;
    }
 
    @Override
    public Set getHeaders() {
        return Collections.EMPTY_SET;
    }
 
    @Override
    public boolean handleFault(SOAPMessageContext messageContext) {
        return true;
    }
 
    @Override
    public void close(MessageContext context) {
    }
 
    private String getMessageEncoding(SOAPMessage msg) throws SOAPException {
        String encoding = "utf-8";
        if (msg.getProperty(SOAPMessage.CHARACTER_SET_ENCODING) != null) {
            encoding = msg.getProperty(SOAPMessage.CHARACTER_SET_ENCODING).toString();
        }
        return encoding;
    }
}

Assim o resultado final da classe é apresentado.

Figura 11 – Classe SigaHandler.

Agora é necessário relacionar o manipulador de mensagens com o serviço USERPORTAL. Para isto na aba Projetos clique com o botão direito do mouse no serviço USERPORTAL, seguido por Configurar manipuladores…

Figura 12 – Configurar manipuladores…

Na próxima tela, clique em Adicionar.

Figura 13 – Configurar os manipuladores de mensagens.

Selecione o arquivo manipulador, neste caso o arquivo SigaHandler.java, e clique em OK.

Figura 14 – Selecionar classe de manipuladores de mensagens.

Após a confirmação será exibido o manipulador de mensagens associado ao serviço. Clique em OK.

Figura 15 – Associação do manipulador de mensagens.

Desta forma a execução do programa funciona perfeitamente.

Figura 16 – Execução do programa.

Considerações finais.

Até o presente momento a Totvs não disponibilizou uma modificação no padrão do retorno da mensagem do serviço Web para o Protheus 10.

Gostaria de agradecer a Vicente de Paula (vicenterecife@gmail.com) por ter originado os questionamentos que deram origem a este artigo.

O mundo Java é dividido entre duas IDE’s (Integrated Development Environment), o NetBeans e o Eclipse. Grande parte dos desenvolvedores que acompanham o Java desde seus primórdios e os oriundos do C++ são cativados amplamente pelo Eclipse. Já a nova geração do Java e os amantes da interface gráfica se encantaram com a facilidade de criar interfaces tal como o Delphi e o Visual Studio.

Vale a pena lembrar que o NetBeans é um projeto de código aberto e mantido pela Sun.

Pelo fato de ser propriamente desenvolvido em Java é possível executa-lo em Linux, Solaris, MacOS e Windows.

Então, com este brevíssimo histórico, é apresentada a nova versão do NetBeans.

Com o NetBeans desenvolvemos aplicações Java para desktop, enterprise, web, FX e mobile. Além disso é possível trabalhar com C/C++, PHP, JavaScript, Groovy, e Ruby.

O vídeo abaixo é parte inicial de uma coleção de vídeos que apresentam as funcionalidades do NetBeans.

Os outros vídeos podem ser acessados através deste link: http://netbeans.org/kb/docs/intro-screencasts.html

Fica então o convite para conhecer um pouco mais da plataforma Java e como utiliza-la através do NetBeans.