REP deployment Quick Start

Software requirements

To build and run the REP example code you need to meet following requirements:

• Java 6.0 SDK ​http://java.sun.com/javase/downloads/index.jsp
• eclipse ​http://eclipse.org/downloads/
• Java REST framework 'restlet' by ​http://www.restlet.org/
• REP example code: eclipse project 'JavaREP' which can be found as an attachment on the bottom of this page

run the Example REP Project

In order to run the code samples please follow the steps below:

1. extract the zip archive and import the eclipse project into your eclipse workspace
2. fix missing class path errors (add the restlet libraries 'org.restlet.jar' and 'org.restlet.ext.xml.jar' to the project classpath
3. after that the project structure should look like this:

4. run uk.ac.surrey.sensei.rep.REPTest.java

The REPTest class provides a couple of test cases. Please uncomment the sections you want to have tested. By default REPTest.java creates a REP listening on HTTP port 8185. It attaches a RAIHandler of type SensorType? for a dummy light sensor. The hard coded light value is read from the file xml/sensors/light.rdf. It can be requested by a REST GET method call on ​http://localhost:8185/rep/s/light.

The response is the Observation and Measurement value in XML-RDF syntax.

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE rdf:RDF [
	<!ENTITY rdf  'http://www.w3.org/1999/02/22-rdf-syntax-ns#'>
	<!ENTITY rdfs 'http://www.w3.org/2000/01/rdf-schema#'>
	<!ENTITY sensor   'http://www.ict-sensei.org/Sensor#'>
	<!ENTITY mo 'http://www.ict-sensei.org/MeasurementAndObservation#'>
	<!ENTITY provider456 'http://www.resource-provider-456.com/resources#'>
]>
<rdf:RDF xmlns:rdf="&rdf;" xmlns:rdfs="&rdfs;" xmlns:provider456="&provider456;"
	 xmlns:mo="&mo;" xmlns:sensor="&sensor;">
<sensor:Light rdf:about="&provider456;LightSensor15" 
		mo:hasTimeStamp="Thu Jan 14 09:15:36 2009"	 
		mo:hasDecimalValue="0.23"
		mo:hasUnit="percent">
</sensor:Light>
</rdf:RDF>

REST client tools

GET and POST requests can be easily tested by using a web browser. For testing other REST methods like PUT, DELETE, and OPTIONS dedicated REST client tools are available, like:

• RESTClient: plug-in for Firefox: ​https://addons.mozilla.org/en-US/firefox/addon/9780
• Java GUI tool: ​http://code.google.com/p/rest-client/
• soapUI: ​http://www.soapui.org/userguide/rest/index.html