Package org.apache.http.message

Class BasicTokenIterator

java.lang.Object

org.apache.http.message.BasicTokenIterator

All Implemented Interfaces:

Iterator<Object>, TokenIterator

public class BasicTokenIterator
extends Object
implements TokenIterator

Basic implementation of a TokenIterator. This implementation parses #token sequences as defined by RFC 2616, section 2. It extends that definition somewhat beyond US-ASCII.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	HTTP_SEPARATORS	The HTTP separator characters.

Constructor Summary

Constructors

Constructor	Description
BasicTokenIterator(HeaderIterator headerIterator)	Creates a new instance of BasicTokenIterator.

Method Summary

Modifier and Type	Method	Description
boolean	hasNext()	Indicates whether there is another token in this iteration.
final Object	next()	Returns the next token.
String	nextToken()	Obtains the next token from this iteration.
final void	remove()	Removing tokens is not supported.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Details

HTTP_SEPARATORS

public static final String HTTP_SEPARATORS

The HTTP separator characters. Defined in RFC 2616, section 2.2.

See Also:

• Constant Field Values

Constructor Details

BasicTokenIterator

public BasicTokenIterator(HeaderIterator headerIterator)

Creates a new instance of BasicTokenIterator.

Parameters:

headerIterator - the iterator for the headers to tokenize

Method Details

hasNext

public boolean hasNext()

Description copied from interface: TokenIterator

Indicates whether there is another token in this iteration.

Specified by:

hasNext in interface Iterator<Object>

Specified by:

hasNext in interface TokenIterator

Returns:

true if there is another token, false otherwise

nextToken

public String nextToken()
                 throws NoSuchElementException,
ParseException

Obtains the next token from this iteration.

Specified by:

nextToken in interface TokenIterator

Returns:

the next token in this iteration

Throws:

NoSuchElementException - if the iteration is already over

ParseException - if an invalid header value is encountered

next

public final Object next()
                  throws NoSuchElementException,
ParseException

Returns the next token. Same as nextToken(), but with generic return type.

Specified by:

next in interface Iterator<Object>

Returns:

the next token in this iteration

Throws:

NoSuchElementException - if there are no more tokens

ParseException - if an invalid header value is encountered

remove

public final void remove()
                  throws UnsupportedOperationException

Removing tokens is not supported.

Specified by:

remove in interface Iterator<Object>

Throws:

UnsupportedOperationException - always