us.bpsm.edn.parser

Interface CollectionBuilder

public interface CollectionBuilder

The parser uses each CollectionBuilder to build a set, map, vector or list.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	CollectionBuilder.Factory The parser uses CollectionBuilder.Factory instances to get a fresh CollectionBuilder each time it needs to build a set, map, vector or list.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(Object o) Add an item to the collection being built.
Object	build() Return the collection containing all the elements previously added.

Method Detail

add

void add(Object o)

Add an item to the collection being built. In the case of a map, this will be called an even number of times, first for a key and then for its corresponding value until all key-value pairs of the map have been added.

For other collections is can be called any number of times.

Implementations which construct Maps or Sets an should throw an EdnSyntaxException if they detect a duplicate key (in the case of a map) or a duplicate element (in the case of a set).

add() may not be called after build().

Parameters:

o - an object to add to the collection under construction. o may be null.

build

Object build()

Return the collection containing all the elements previously added. build() may only be called once. After build() has been called, the builder is rendered useless and can be discarded.

Returns:

The collection. Generally a Set, Map or some kind of List.