Exchange Library

This is a Java library that contains all the inputs and outputs classes used by the backend: it is possibile to programmatically write code that defines the survey structure , parse the responses obtained by the backend, or the requests.

Minimal survey structure

An example of how to build the structure is available in the LanguageTest experiments of the experiments module.

Once built an object of type SurveyStructure, it is possible to dump it to a JSON file using an ObjectMapper:

SurveyStructure structure = survey.getStructure();
ObjectMapper om = new ObjectMapper();
om.writeValue(new File("adaptive.questionnaire.json"), structure);

And send it to a remote backend.

Requests and responses

For an example on how to communicate using the library to a remote backend, check the Tool class. This class uses an HttpClient object to send and receive data to and from the remote backend.

Integrated experiments

If you are more interested in run experiments on a local machine, without all the burden from the http calls, it is also possible to integrate the whole backend and use the adaptive engine without the need to use teh exchange library or make requests.

For an example, check the AlloyAdaptiveExperimentLocal class.

Note: Always consider the Adaptive Engine when performing the experiments.