freemarker.template
Class FastIndexedWriteableIterator

java.lang.Object
  freemarker.template.FastIndexedWriteableIterator

All Implemented Interfaces:

TemplateIteratorModel, TemplateModel, TemplateWriteableIteratorModel

public class FastIndexedWriteableIterator
extends java.lang.Object
implements TemplateWriteableIteratorModel

An iterator that operates over a TemplateIndexedModel implementation that also implements TemplateWriteableIndexedModel. The assumption here is that we have constant-time random access to the underlying implementation.

Since:

1.9

See Also:

FastIndexedIterator

Field Summary

protected long	currentIndex The current index into the model.
protected long	endIndex The end index of the model.
protected TemplateWriteableIndexedModel	indexModel The model that we will index into.
protected long	startIndex The beginning index of the model.

Constructor Summary

FastIndexedWriteableIterator(TemplateWriteableIndexedModel model, long startIndex, long endIndex)
Constructor that takes the object we're iterating over as an argument

Method Summary

boolean	hasNext() Do we have a next value?
boolean	isEmpty() Is the iterator empty?
TemplateModel	next() Return the next value in the indexModel, and increment the counter to point to the next value.
void	set(TemplateModel model) Inserts the specified element into the list.
java.lang.String	toString() Returns a string representation of the object.

Methods inherited from class java.lang.Object

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

Field Detail

indexModel

protected final TemplateWriteableIndexedModel indexModel

The model that we will index into.

startIndex

protected final long startIndex

The beginning index of the model.

endIndex

protected final long endIndex

The end index of the model.

currentIndex

protected long currentIndex

The current index into the model.

Constructor Detail

FastIndexedWriteableIterator

public FastIndexedWriteableIterator(TemplateWriteableIndexedModel model,
                                    long startIndex,
                                    long endIndex)

Constructor that takes the object we're iterating over as an argument

Parameters:

model - the indexed list model to iterate over

Method Detail

isEmpty

public boolean isEmpty()
                throws TemplateModelException

Is the iterator empty?

Specified by:

isEmpty in interface TemplateModel

Returns:

false, indicating the iterator is not empty

Throws:

TemplateModelException

hasNext

public boolean hasNext()

Do we have a next value?

Specified by:

hasNext in interface TemplateIteratorModel

Returns:

true if more values exist in the list, otherwise false

next

public TemplateModel next()
                   throws TemplateModelException

Return the next value in the indexModel, and increment the counter to point to the next value.

Specified by:

next in interface TemplateIteratorModel

Returns:

a TemplateModel representing the next value in the list

Throws:

TemplateModelException - the next item couldn't be retrieved, or we're at the end of the list

set

public void set(TemplateModel model)
         throws TemplateModelException

Inserts the specified element into the list. The element is inserted immediately before the next element that would be returned by next, if any.

Specified by:

set in interface TemplateWriteableIteratorModel

Parameters:

model - the model to insert into the list

Throws:

TemplateModelException - the model could not be assigned to the list

toString

public java.lang.String toString()

Returns a string representation of the object.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of the object.