com.dropbox.core.json

Class JsonReader<T>

java.lang.Object

com.dropbox.core.json.JsonReader<T>

Direct Known Subclasses:

DbxDelta.Entry.Reader, DbxDelta.Reader, DbxDeltaC.Entry.Reader, DbxDeltaC.Reader, DbxEntry.WithChildrenC.Reader, DbxEntry.WithChildrenC.ReaderMaybeDeleted, JsonArrayReader

public abstract class JsonReader<T>
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JsonReader.FieldMapping If you're implementing a JsonReader for a JSON object, you can use this to map field names to a number you can switch on to efficiently locate assign a field.
static class	JsonReader.FileLoadException

Field Summary

Fields

Modifier and Type	Field and Description
static JsonReader<Boolean>	BooleanReader
static JsonReader<String>	StringReader

Constructor Summary

Constructors

Constructor and Description
JsonReader()

Method Summary

Methods

Modifier and Type	Method and Description
static com.fasterxml.jackson.core.JsonLocation	expectArrayStart(com.fasterxml.jackson.core.JsonParser parser)
static void	expectObjectEnd(com.fasterxml.jackson.core.JsonParser parser)
static com.fasterxml.jackson.core.JsonLocation	expectObjectStart(com.fasterxml.jackson.core.JsonParser parser)
static boolean	isArrayEnd(com.fasterxml.jackson.core.JsonParser parser)
static com.fasterxml.jackson.core.JsonToken	nextToken(com.fasterxml.jackson.core.JsonParser parser) A wrapper around 'JsonParser.nextToken' that throws our own better JsonReadException instead of Jackson's JsonParseException.
abstract T	read(com.fasterxml.jackson.core.JsonParser parser)
static boolean	readBoolean(com.fasterxml.jackson.core.JsonParser parser)
T	readField(com.fasterxml.jackson.core.JsonParser parser, String fieldName, T v)
T	readFromFile(File file)
T	readFromFile(String filePath)
T	readFully(byte[] utf8Body)
T	readFully(InputStream utf8Body)
T	readFully(com.fasterxml.jackson.core.JsonParser parser)
T	readFully(String body)
T	readOptional(com.fasterxml.jackson.core.JsonParser parser)
static long	readUnsignedLong(com.fasterxml.jackson.core.JsonParser parser)
static long	readUnsignedLongField(com.fasterxml.jackson.core.JsonParser parser, String fieldName, long v)
static void	skipValue(com.fasterxml.jackson.core.JsonParser parser)

Methods inherited from class java.lang.Object

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

Field Detail

StringReader

public static final JsonReader<String> StringReader

BooleanReader

public static final JsonReader<Boolean> BooleanReader

Constructor Detail

JsonReader

public JsonReader()

Method Detail

read

public abstract T read(com.fasterxml.jackson.core.JsonParser parser)
                throws IOException,
                       JsonReadException

Throws:

IOException

JsonReadException

readField

public final T readField(com.fasterxml.jackson.core.JsonParser parser,
          String fieldName,
          T v)
                  throws IOException,
                         JsonReadException

Throws:

IOException

JsonReadException

readOptional

public final T readOptional(com.fasterxml.jackson.core.JsonParser parser)
                     throws IOException,
                            JsonReadException

Throws:

IOException

JsonReadException

nextToken

public static com.fasterxml.jackson.core.JsonToken nextToken(com.fasterxml.jackson.core.JsonParser parser)
                                                      throws IOException,
                                                             JsonReadException

A wrapper around 'JsonParser.nextToken' that throws our own better JsonReadException instead of Jackson's JsonParseException.

JsonParseException is bad for two reasons. First, it extends IOException, which makes it easy to miss. Second, there's no way to get the original error message, which makes it hard to chain logical location information (see JsonReadException.addFieldContext(java.lang.String) and JsonReadException.addArrayContext(int)).

Throws:

IOException

JsonReadException

expectObjectStart

public static com.fasterxml.jackson.core.JsonLocation expectObjectStart(com.fasterxml.jackson.core.JsonParser parser)
                                                                 throws IOException,
                                                                        JsonReadException

Throws:

IOException

JsonReadException

expectObjectEnd

public static void expectObjectEnd(com.fasterxml.jackson.core.JsonParser parser)
                            throws IOException,
                                   JsonReadException

Throws:

IOException

JsonReadException

expectArrayStart

public static com.fasterxml.jackson.core.JsonLocation expectArrayStart(com.fasterxml.jackson.core.JsonParser parser)
                                                                throws IOException,
                                                                       JsonReadException

Throws:

IOException

JsonReadException

isArrayEnd

public static boolean isArrayEnd(com.fasterxml.jackson.core.JsonParser parser)

skipValue

public static void skipValue(com.fasterxml.jackson.core.JsonParser parser)
                      throws IOException,
                             JsonReadException

Throws:

IOException

JsonReadException

readUnsignedLong

public static long readUnsignedLong(com.fasterxml.jackson.core.JsonParser parser)
                             throws IOException,
                                    JsonReadException

Throws:

IOException

JsonReadException

readUnsignedLongField

public static long readUnsignedLongField(com.fasterxml.jackson.core.JsonParser parser,
                         String fieldName,
                         long v)
                                  throws IOException,
                                         JsonReadException

Throws:

IOException

JsonReadException

readBoolean

public static boolean readBoolean(com.fasterxml.jackson.core.JsonParser parser)
                           throws IOException,
                                  JsonReadException

Throws:

IOException

JsonReadException

readFully

public T readFully(InputStream utf8Body)
            throws IOException,
                   JsonReadException

Throws:

IOException

JsonReadException

readFully

public T readFully(String body)
            throws JsonReadException

Throws:

JsonReadException

readFully

public T readFully(byte[] utf8Body)
            throws JsonReadException

Throws:

JsonReadException

readFromFile

public T readFromFile(String filePath)
               throws JsonReader.FileLoadException

Throws:

JsonReader.FileLoadException

readFromFile

public T readFromFile(File file)
               throws JsonReader.FileLoadException

Throws:

JsonReader.FileLoadException

readFully

public T readFully(com.fasterxml.jackson.core.JsonParser parser)
            throws IOException,
                   JsonReadException

Throws:

IOException

JsonReadException