Jersey front-end to the FISE engine =================================== Goals for this sub-project: - RESTful web services API to FISE for machines. - Human-friendly HTML interface to quickly test the service and document the API. Building from source -------------------- Checkount and build both iks-autotagging and FISE: $ svn checkout http://iks-project.googlecode.com/svn/sandbox/iks-autotagging/trunk iks-autotagging $ cd iks-autotagging $ mvn clean install -DskipTests $ cd .. $ svn checkout http://iks-project.googlecode.com/svn/sandbox/fise/trunk fise $ cd fise $ mvn clean install -DskipTests Deployment ---------- Go to `launchers/sling/target` and run:: rm -rf sling && java -jar org.apache.stanbol.fise.launchers.sling-*-SNAPSHOT.jar Once deployed (check the logs) you can either use the HTML interface: http://localhost:8080 To submit data to engines using a simple form: http://localhost:8080/engines If that page gives errors such as class not found, no web provider, stop and restart the jersey-server bundle. There's a bug in Jersey 1.2 that causes those if the core bundle starts before the server bundle. You can setup an apache virtualhost to blend a fise instance on you domain name using a ``NameVirtualHost *:80`` instruction in you global apache configuration and the following virtualhost parameters:: ServerName fise.example.com CustomLog logs/fise.example.com.access.log combined ErrorLog logs/fise.example.com.error.log ProxyPass/ http://localhost:8080/ ProxyPassReverse/ http://localhost:8080/ ProxyPreserveHostOn Stateless operation ------------------- You can use the HTTP (somewhat RESTful) API directly with cURL for instance: $ curl -X POST -H "Content-type: text/plain" --data "Paris is a beautiful city." http://localhost:8080/engines/ You can force a specific RDF serialization scheme by setting the "Accept" HTTP header: $ curl -X POST -H "Content-type: text/plain" -H "Accept: application/rdf+xml" --data "Paris is a beautiful city." http://localhost:8080/engines/ Or to upload the content of a file: $ curl -X POST -H "Content-type: text/plain" -H "Accept: text/rdf+nt" --data @/path/to/my_local_file.txt http://localhost:8080/engines/ Asynchronous and stateful operation ----------------------------------- TODO: implement and document me!