burlap.oomdp.legacy

Class StateJSONParser

java.lang.Object

burlap.oomdp.legacy.StateJSONParser

All Implemented Interfaces:

StateParser

public class StateJSONParser
extends java.lang.Object
implements StateParser

A StateParser class that uses the JSON file format and can can convert states to JSON strings (and back from them) for any possible input domain. Use of this class requires the Jackson java library. This class also provides methods for preparing an OO-MDP State into a datastructure that can be easily parsed into an JSON representation and for taking a datastructure preapred for a JSON representation and converting it into an OO-MDP State.

Author:

James MacGlashan, Stephen Brawner

Field Summary

Fields

Modifier and Type	Field and Description
protected Domain	domain The domain holding the object class definitions that states represented in JSON strings will be converted to.

Constructor Summary

Constructors

Constructor and Description
StateJSONParser(Domain domain) Initializes with a given domain object.

Method Summary

Methods

Modifier and Type	Method and Description
java.util.List<java.util.Map<java.lang.String,java.lang.Object>>	getJSONPrepared(State s) Returns the data structure of a state that is passed to JSON.
State	JSONPreparedToState(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> objects) Takes a JSON prepared datastructure representation of a state and turns it into an actual state object.
java.lang.String	stateToString(State s) Converts state s into a parsable string representation.
State	stringToState(java.lang.String str) Converts a string into a State object assuming the string representation was produced using this state parser.

Methods inherited from class java.lang.Object

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

Field Detail

domain

protected Domain domain

The domain holding the object class definitions that states represented in JSON strings will be converted to. This is not necessary if parsing will only go from states to strings and not strings to states.

Constructor Detail

StateJSONParser

public StateJSONParser(Domain domain)

Initializes with a given domain object. The domain object is used for converting from strings to states. Specifically, the object instances will be assigned to the object class in the domain object with the given name in the state string.

Parameters:

domain - the domain object to which state objects will be associated.

Method Detail

getJSONPrepared

public java.util.List<java.util.Map<java.lang.String,java.lang.Object>> getJSONPrepared(State s)

Returns the data structure of a state that is passed to JSON.

Parameters:

s - the input state to turn into a JSON prepared datastructure

Returns:

JSON prepared data structure representation of the state

stateToString

public java.lang.String stateToString(State s)

Description copied from interface: StateParser

Converts state s into a parsable string representation.

Specified by:

stateToString in interface StateParser

Parameters:

s - the state to convert

Returns:

a parsable string representation of state s.

stringToState

public State stringToState(java.lang.String str)

Description copied from interface: StateParser

Converts a string into a State object assuming the string representation was produced using this state parser.

Specified by:

stringToState in interface StateParser

Parameters:

str - a string representation of a state

Returns:

the state object that corresponds to the string representation.

JSONPreparedToState

public State JSONPreparedToState(java.util.List<java.util.Map<java.lang.String,java.lang.Object>> objects)

Takes a JSON prepared datastructure representation of a state and turns it into an actual state object. The JSON prepared version is a list of maps. Each map represents an object instance which stores the objects name, name of the object's class, and the value for each attribute.

Parameters:

objects - the list of OO-MDP object instances

Returns:

and OO-MDP State object.