edu.umass.cs.surveyman.input.json

Class JSONParser

java.lang.Object

edu.umass.cs.surveyman.input.AbstractParser

edu.umass.cs.surveyman.input.json.JSONParser

public final class JSONParser
extends AbstractParser

Class to parse SurveyMan JSON input.

Field Summary

Fields

Modifier and Type	Field and Description
String	json The string JSON representation of the survey.
String	source A String indicating the survey source (e.g., filename, url).

Fields inherited from class edu.umass.cs.surveyman.input.AbstractParser

allBlockLookUp, ANSWER, BLOCK, BRANCH, CORRELATION, correlationMap, CUSTOM_ID, defaultValues, EXCLUSIVE, FREETEXT, INPUT_SCHEMA, knownHeaders, LOGGER, OPTIONS, ORDERED, PERMIT_BREAKOFF, QUESTION, RANDOMIZE, RESOURCE, topLevelBlocks

Constructor Summary

Constructors

Constructor and Description
JSONParser(String json) Returns a JSONParser for some string input JSON.

Method Summary

Methods

Modifier and Type	Method and Description
static JSONParser	makeParser(String filename) Creates a JSONParser from a source file containing the JSON represenatation of a survey.
Survey	parse() Validates and parses the survey.

Methods inherited from class edu.umass.cs.surveyman.input.AbstractParser

addPhantomBlocks, boolType, initializeAllOneBlock, parseBool, parseComponent, propagateBranchParadigm, propagateBranchParadigms

Methods inherited from class java.lang.Object

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

Field Detail

json

public final String json

The string JSON representation of the survey.

source

public final String source

A String indicating the survey source (e.g., filename, url).

Constructor Detail

JSONParser

public JSONParser(String json)

Returns a JSONParser for some string input JSON. This constructor should be used when constructing a programmatic pipeline, such as piping the JSON output of a program into the SurveyMan language and runtime system. If the data is instead staged, use makeParser.

Parameters:

json - The JSON representation of a survey.

Method Detail

makeParser

public static JSONParser makeParser(String filename)
                             throws IOException

Creates a JSONParser from a source file containing the JSON represenatation of a survey.

Parameters:

filename - The source file name for the JSON represenation of the survey.

Returns:

A JSONParser instance.

Throws:

IOException

parse

public Survey parse()
             throws SurveyException

Validates and parses the survey.

Specified by:

parse in class AbstractParser

Returns:

A Survey object.

Throws:

SurveyException