kXML - Fazendo parser de um XML com J2ME

kXML - Fazendo parser de um XML com J2ME

O kXML � um parser de XML est�vel e otimizado, para ser utilizado em pequenos dispositivos com recursos limitados de mem�ria e processamento, e desta forma sendo ideal para ser utilizado com J2ME.

Existem algumas t�cnicas conhecidas para realizar o parser de um XML. Uma das mais utilizadas � o DOM, que utiliza um modelo baseado em �rvore, criando uma estrutura de dados na mem�ria, onde � poss�vel acessar essa estrutura atrav�s de um conjunto de objetos. O DOM � muito simples de utilizar, mas sendo que muitos objetos s�o armazenados em mem�ria, ele n�o � recomendado para ser utilizado com J2ME.

Outra t�cnica conhecida � chamada de �push parser�, que � orientada a eventos, onde ao ler um XML, um objeto �listener� � notificado sempre que novas tags s�o encontradas. Esta forma � como o popular SAX trabalha.

O kXML utiliza um outro modelo, conhecido como �pull parser�, onde uma pequena quantidade de dados � analisada de cada vez. A aplicaç�o faz o parser do XML solicitando sempre a pr�xima parte que deve ser processada, isto geralmente � feito em um loop at� o fim do XML. Desta forma, a aplicaç�o pode exibir as informaç�es do XML a medida que o parser � efetuado, como por exemplo, ao fazer um download de um arquivo do servidor. J� um parser que utiliza DOM, precisaria ler o documento inteiro para montar uma estrutura de �rvores, para somente depois exibir as informaç�es.

Fazendo o download

A vers�o utilizada neste artigo � a 2.2.2:

http://prdownloads.sourceforge.net/kxml/kxml2-min-2.2.2.jar?download

Exemplo do arquivo XML

Neste artigo vamos criar um simples Midlet, que vai fazer o parser do arquivo XML abaixo, e exibir� os dados na tela.

C�digo fonte do Midlet

O c�digo fonte do Midlet � muito simples. O c�digo abre uma InputStream para o XML exibido anteriormente, que � utilizada para criar uma inst�ncia de org.kxml2.io.KXmlParser.

Os m�todos require() e nextTag() s�o utilizados para percorrer o XML. O m�todo nextTag() obviamente retorna a pr�xima tag e o m�todo require() obriga o parser a posicionar o �cursor� na posiç�o desejada. A medida que o parser � realizado, os dados das pessoas existentes s�o exibidas na tela do dispositivo.

 

package javamagazine;

 

import �

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParser;

import org.xmlpull.v1.XmlPullParserException;

 

public class XMLParserMidlet extends MIDlet {

 

Form form = new Form("Pessoas");

 

protected void startApp() throws MIDletStateChangeException {

InputStream in = getClass().getResourceAsStream("pessoas.xml");

 

try {

Display.getDisplay(this).setCurrent(form);

 

parser(in);

} catch (Exception e) {

e.printStackTrace();

}

 

private void parser(InputStream in) throws Exception {

//Inicia o XMLParser

KXmlParser parser = new KXmlParser();

parser.setInput(new InputStreamReader(in));

 

parser.nextTag();

 

//Posiciona na tag <agenda>

parser.require(XmlPullParser.START_TAG, null, "agenda");

 

//Enquanto � diferente de END_TAG

while (parser.nextTag () != XmlPullParser.END_TAG)

{

 //Posiciona na tag <pessoa>

 parser.require(XmlPullParser.START_TAG, null, "pessoa");

 

 parserPessoa(parser);

 

 form.append("\n");

 

parser.require(XmlPullParser.END_TAG, null, "pessoa");

}

 

parser.require(XmlPullParser.END_TAG, null, "agenda");

parser.next();

 

parser.require(XmlPullParser.END_DOCUMENT, null, null);

}

 

private void parserPessoa(KXmlParser parser) throws Exception {

//Enquanto � diferente de </pessoa>

while (parser.nextTag() != XmlPullParser.END_TAG) {

 

//Posiciona em uma tag "START". Ex: <nome> ou <fone>

parser.require(XmlPullParser.START_TAG, null, null);

 

String name = parser.getName();

String text = parser.nextText();

System.out.println("Tag: " + name + " -> " + text);

 

//Adiciona o texto no Form

form.append(text);

 

//Posiciona no fim da tag </nome> ou </fone>

parser.require(XmlPullParser.END_TAG, null, name);

}

 

pauseApp�

 

destroyApp�

}

 

Ao executar o exemplo, a seguinte tela vai aparecer:

Entendendo o exemplo

O c�digo abre uma InputStream utilizando o m�todo getResourceAsStream(), mas em uma aplicaç�o real provavelmente o XML seria obtido atrav�s de uma conex�o Http ou um socket:

 

InputStream in = getClass().getResourceAsStream("pessoas.xml");

 

Depois de abrir uma InputStream, pode-se criar uma inst�ncia da classe KXmlParser conforme mostrado abaixo:

 

InputStream in = �.

KXmlParser parser = new KXmlParser();

parser.setInput(new InputStreamReader(in));

O pr�ximo passo � chamar o m�todo require() para posicionar o parser na tag desejada, neste caso: <agenda>.

parser.require(XmlPullParser.START_TAG, null, "agenda");

Para ler todas as pessoas, o m�todo require(�pessoa�) � chamado sucessivamente para buscar a pr�xima tag <pessoa> que deve ser processada, at� encontrar o fim da tag </agenda>.

while (parser.nextTag () != XmlPullParser.END_TAG)

{

//Posiciona na tag <pessoa>

parser.require(XmlPullParser.START_TAG, null, "pessoa");

parserPessoa(parser);

form.append("\n");

parser.require(XmlPullParser.END_TAG, null, "pessoa");

}

Para cada tag <pessoa> encontrada, o m�todo parserPessoa(parser) � chamado para ler os seus elementos.

Note que dentro do loop, o m�todo �parser.require(XmlPullParser.START_TAG, null, null);� � chamado para posicionar o cursor na pr�xima tag <nome> ou <fone>, para posteriormente obter o conte�do deste elemento utilizando o m�todo parser.nextText().

private void parserPessoa(KXmlParser parser) throws Exception {

//Enquanto � diferente de </pessoa>

while (parser.nextTag() != XmlPullParser.END_TAG) {

//Posiciona em uma tag "START". Ex: <nome> ou <fone>

parser.require(XmlPullParser.START_TAG, null, null);

String text = parser.nextText();

form.append(text);

//Posiciona no fim da tag </nome> ou </fone>

parser.require(XmlPullParser.END_TAG, null, name);

}

Conclus�o

Neste artigo foi demonstrado como fazer um parser de um XML, utilizando o kXML, uma API simples e otimizada, ideal para ser utilizada com J2ME.

Espero que tenham gostado e at� a pr�xima.

kXML - Fazendo parser de um XML com J2ME

Aprenda neste artigo o que é o kXML, e saiba como utiliza-lo com J2ME.

Artigos relacionados