b4j.core.session

Class HttpBugzillaSession.BugzillaBugIterator

java.lang.Object

b4j.core.session.HttpBugzillaSession.BugzillaBugIterator

All Implemented Interfaces:

Iterator<Issue>

Enclosing class:

HttpBugzillaSession

protected class HttpBugzillaSession.BugzillaBugIterator
extends Object
implements Iterator<Issue>

Implementation of a bug iterator. This implementation is based on Silberschatz' proposal for synchronizing a reader and a writer thread. The first call to next() will spawn the writer thread that actually retrieves bug data from Bugzilla.

Author:

Ralph Schuster

Constructor Summary

Constructors

Constructor and Description
HttpBugzillaSession.BugzillaBugIterator(List<String> bugList) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addBug(Issue bug) Adds a new bug to the list of available bugs.
boolean	hasNext() Returns true while number of delivered bugs (calls to next() are less than number of bugs in request list.
Issue	next() Delivers the next bug.
void	remove() Always throws an exception.
protected void	startXmlParser() Starts the writer's thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpBugzillaSession.BugzillaBugIterator

public HttpBugzillaSession.BugzillaBugIterator(List<String> bugList)

Default constructor.

Parameters:

bugList - - bug ID list to retrieve

Method Detail

hasNext

public boolean hasNext()

Returns true while number of delivered bugs (calls to next() are less than number of bugs in request list.

Specified by:

hasNext in interface Iterator<Issue>

Returns:

true if there are still bugs in the queue to read.

next

public Issue next()

Delivers the next bug. The first call will trigger spawning of the writer thread. This implementation is based on Silberschatz' synchronization solution for reader and writer threads (reader's part here). That means, the call will wait until the next bug is available if required.

Specified by:

next in interface Iterator<Issue>

Returns:

next bug in queue

addBug

protected void addBug(Issue bug)

Adds a new bug to the list of available bugs. This implementation is based on Silberschatz' synchronization solution for reader and writer threads (writer's part here).

Parameters:

bug - - bug to add to queue

remove

public void remove()

Always throws an exception.

Specified by:

remove in interface Iterator<Issue>

startXmlParser

protected void startXmlParser()

Starts the writer's thread. This method will create the appropriate POST request to the Bugzilla instance and hand over the connection to the new thread. Internal variables are set to indicate that the writer thread is running.