net.lecousin.framework.json

Class JSONParser

java.lang.Object

net.lecousin.framework.concurrent.Task<T,TError>

net.lecousin.framework.concurrent.Task.Cpu<Object,Exception>

net.lecousin.framework.json.JSONParser

public class JSONParser
extends net.lecousin.framework.concurrent.Task.Cpu<Object,Exception>

Parse a JSON value from a character stream.

The returned object may be one of:

• A Map<String, Object> for an object structure
• A List<Object> for an array
• A String
• A Number
• A Boolean
• null

Any spaces at the beginning of the stream are ignored. Only the first value is parsed, if there are remaining characters in the stream, they are ignored.

Exceptions that may be raised are:

• IOException in case of error while reading from the character stream, including an EOFException if the end of the stream is reached in the middle of the JSON structure
• JSONParsingException in case the JSON cannot be parsed

Nested Class Summary

Nested classes/interfaces inherited from class net.lecousin.framework.concurrent.Task.Cpu

net.lecousin.framework.concurrent.Task.Cpu.FromRunnable, net.lecousin.framework.concurrent.Task.Cpu.FromSupplierThrows<T,TError extends Exception>, net.lecousin.framework.concurrent.Task.Cpu.Parameter<TParam,TResult,TError extends Exception>

Nested classes/interfaces inherited from class net.lecousin.framework.concurrent.Task

net.lecousin.framework.concurrent.Task.Cpu<T,TError extends Exception>, net.lecousin.framework.concurrent.Task.Done<T,TError extends Exception>, net.lecousin.framework.concurrent.Task.OnFile<T,TError extends Exception>, net.lecousin.framework.concurrent.Task.Output, net.lecousin.framework.concurrent.Task.Unmanaged<TResult,TError extends Exception>

Field Summary

Fields inherited from class net.lecousin.framework.concurrent.Task

NB_PRIORITES, PRIORITY_BACKGROUND, PRIORITY_IMPORTANT, PRIORITY_LOW, PRIORITY_NORMAL, PRIORITY_RATHER_IMPORTANT, PRIORITY_RATHER_LOW, PRIORITY_TOP, PRIORITY_URGENT, STATUS_BLOCKED, STATUS_DONE, STATUS_EXECUTED, STATUS_NOT_STARTED, STATUS_RUNNING, STATUS_STARTED_READY, STATUS_STARTED_WAITING, taskJoin

Constructor Summary

Constructors

Constructor and Description
JSONParser(net.lecousin.framework.io.text.ICharacterStream.Readable.Buffered io, byte priority) Constructor.

Method Summary

Modifier and Type	Method and Description
static net.lecousin.framework.concurrent.async.AsyncSupplier<Object,Exception>	parse(net.lecousin.framework.io.text.ICharacterStream.Readable.Buffered io, byte priority) Utility method to parse a JSON structure.
Object	run()

Methods inherited from class net.lecousin.framework.concurrent.Task

cancel, cancelIfExecutionNotStarted, changeNextExecutionTime, ensureUnblocked, executeAgainAt, executeAgainIn, executeAt, executeEvery, executeIn, executeNextOccurenceNow, executeNextOccurenceNow, getApplication, getCancelEvent, getDescription, getError, getMaxBlockingTimeInNanoBeforeToLog, getOutput, getPriority, getResult, getStatus, getTaskManager, hasError, isCancelled, isCancelling, isDone, isRunning, isStarted, isSuccessful, ondone, setDescription, setDone, setError, setPriority, start, startOn, startOn, startOnDone, stopRepeat, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

JSONParser

public JSONParser(net.lecousin.framework.io.text.ICharacterStream.Readable.Buffered io,
                  byte priority)

Constructor.

Method Detail

parse

public static net.lecousin.framework.concurrent.async.AsyncSupplier<Object,Exception> parse(net.lecousin.framework.io.text.ICharacterStream.Readable.Buffered io,
                                                                                            byte priority)

Utility method to parse a JSON structure.

run

public Object run()
           throws Exception

Specified by:

run in class net.lecousin.framework.concurrent.Task<Object,Exception>

Throws:

Exception