tecgraf.javautils.xml
Class XMLListIterator

java.lang.Object
  tecgraf.javautils.xml.XMLListIterator

All Implemented Interfaces:

XMLListIteratorInterface

Deprecated. use ImprovedXMLListIterator

@Deprecated
public class XMLListIterator
extends Object
implements XMLListIteratorInterface

A classe XMLListIterator implementa um iterador sobre uma lista de elementos do tipo XMLElementInterface, retornando a cada iteração o próximo elemento cuja tag é igual à tag especificada no construtor (ou null caso não existam mais elementos com esta tag). Esta implementação assume que os objetos são adjacentes na lista.

Author:

costa

Field Summary

static String

ANY Deprecated. Tag usada para iterar sobre qualquer elemento

Constructor Summary

XMLListIterator(List<XMLElementInterface> list)
Deprecated. Constrói um iterador sobre qualquer elemento (tag de referência "ANY").

XMLListIterator(List<XMLElementInterface> list, String tag)
Deprecated. Constrói um iterador sobre uma lista, buscando por uma tag específica.

Method Summary

String	getTag() Deprecated. Retorna a tag de referência para o iterador (o valor que será usado na comparação com os elementos da lista).
boolean	hasNext() Deprecated. Indica se existe mais algum elemento na lista cuja tag seja igual à solicitada.
XMLElementInterface	next() Deprecated. Retorna o próximo elemento com tipo igual ao que vínhamos buscando ou null caso não haja mais elementos deste tipo.
XMLElementInterface	next(String _tag) Deprecated. Obtém o próximo elemento da lista que possui a tag desejada, ou null caso não haja mais elementos com esta tag. Se a tag solicitada é a mesma que vínhamos buscando, simplesmente continuamos a iteração.
void	reset() Deprecated. Reinicializa o iterador, usando a tag ANY como tag de busca.
void	reset(String _tag) Deprecated. Reinicializa o iterador, redefinindo a tag de busca.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ANY

public static final String ANY

Deprecated.

Tag usada para iterar sobre qualquer elemento

See Also:

Constant Field Values

Constructor Detail

XMLListIterator

public XMLListIterator(List<XMLElementInterface> list,
                       String tag)

Deprecated.

Constrói um iterador sobre uma lista, buscando por uma tag específica.

Parameters:

list - lista de elementos

tag - tag a ser buscada

Throws:

IllegalArgumentException - se a lista é null

XMLListIterator

public XMLListIterator(List<XMLElementInterface> list)

Deprecated.

Constrói um iterador sobre qualquer elemento (tag de referência "ANY").

Parameters:

list - lista de elementos

Method Detail

reset

public void reset(String _tag)

Deprecated.

Reinicializa o iterador, redefinindo a tag de busca.

Specified by:

reset in interface XMLListIteratorInterface

Parameters:

_tag - nova tag de busca

reset

public void reset()

Deprecated.

Reinicializa o iterador, usando a tag ANY como tag de busca.

Specified by:

reset in interface XMLListIteratorInterface

next

public XMLElementInterface next()

Deprecated.

Retorna o próximo elemento com tipo igual ao que vínhamos buscando ou null caso não haja mais elementos deste tipo.

Specified by:

next in interface XMLListIteratorInterface

Returns:

o proximo elemento.

next

public XMLElementInterface next(String _tag)

Deprecated.

Obtém o próximo elemento da lista que possui a tag desejada, ou null caso não haja mais elementos com esta tag.
Se a tag solicitada é a mesma que vínhamos buscando, simplesmente continuamos a iteração. Neste caso, se não encontramos mais nenhum elemento retornamos null mas mantemos o iterador no próximo elemento diferente do solicitado, para que este possa ser reaproveitado em buscas subsequentes. Isto permite que o percorrimento seja retomado caso a busca por um determinado elemento já tenha sido esgotada.
Se porém a tag solicitada for diferente da que vínhamos buscando, o iterador buscará um elemento do tipo solicitado até encontrá-lo ou até ter percorrido toda a lista de elementos. Caso a lista tenha sido "esgotada", qualquer tentativa posterior de busca por um elemento resultará em null.

Specified by:

next in interface XMLListIteratorInterface

Parameters:

_tag - nova tag de busca

Returns:

próximo elemento do tipo solicitado ou null caso este não exista. Mesmoq que o valor retornado seja null, ainda assim a lista pode ainda ter elementos a serem percorridos (ver observação acima)

hasNext

public boolean hasNext()

Deprecated.

Indica se existe mais algum elemento na lista cuja tag seja igual à solicitada.

Specified by:

hasNext in interface XMLListIteratorInterface

Returns:

true se o elemento seguinte na lista possui tag igual à tag de busca, false caso contrário.

getTag

public String getTag()

Deprecated.

Retorna a tag de referência para o iterador (o valor que será usado na comparação com os elementos da lista).

Specified by:

getTag in interface XMLListIteratorInterface

Returns:

tag de referência para o iterador