ezvcard
Class Ezvcard.ParserChainJsonReader

java.lang.Object
  ezvcard.Ezvcard.ParserChainJsonReader

Enclosing class:

Ezvcard

public static class Ezvcard.ParserChainJsonReader
extends Object

Chainer class for parsing JSON-encoded vCards (jCard).

See Also:

Ezvcard.parseJson(InputStream), Ezvcard.parseJson(File), Ezvcard.parseJson(Reader)

Method Summary

List<VCard>	all() Reads all vCards from the stream.
VCard	first() Reads the first vCard from the stream.
Ezvcard.ParserChainJsonReader	register(VCardPropertyScribe<? extends VCardProperty> scribe) Registers a property scribe.
Ezvcard.ParserChainJsonReader	warnings(List<List<String>> warnings) Provides a list object that any unmarshal warnings will be put into.

Methods inherited from class java.lang.Object

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

Method Detail

register

public Ezvcard.ParserChainJsonReader register(VCardPropertyScribe<? extends VCardProperty> scribe)

Registers a property scribe.

Parameters:

scribe - the scribe

Returns:

this

warnings

public Ezvcard.ParserChainJsonReader warnings(List<List<String>> warnings)

Provides a list object that any unmarshal warnings will be put into.

Parameters:

warnings - the list object that will be populated with the warnings of each unmarshalled vCard. Each element of the list is the list of warnings for one of the unmarshalled vCards. Therefore, the size of this list will be equal to the number of parsed vCards. If a vCard does not have any warnings, then its warning list will be empty.

Returns:

this

first

public VCard first()
            throws IOException

Reads the first vCard from the stream.

Returns:

the vCard or null if there are no vCards

Throws:

JCardParseException - if the jCard syntax is incorrect (the JSON syntax may be valid, but it is not in the correct jCard format).

JsonParseException - if the JSON syntax is incorrect

IOException - if there's an I/O problem

all

public List<VCard> all()
                throws IOException

Reads all vCards from the stream.

Returns:

the parsed vCards

Throws:

JCardParseException - if the jCard syntax is incorrect (the JSON syntax may be valid, but it is not in the correct jCard format).

JsonParseException - if the JSON syntax is incorrect

IOException - if there's an I/O problem