You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tika.apache.org by Apache Wiki <wi...@apache.org> on 2012/04/04 17:21:27 UTC

[Tika Wiki] Update of "TikaJAXRS" by ChrisMattmann

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tika Wiki" for change notification.

The "TikaJAXRS" page has been changed by ChrisMattmann:
http://wiki.apache.org/tika/TikaJAXRS?action=diff&rev1=3&rev2=4

Comment:
- add documentation on HELLO; reorganize page

- This is placeholder stub for documentation on tika's JSR 311 network server, tika-server.
+ = Introduction = 
+ This page is documentation on tika's JSR 311 network server, tika-server. The server package uses the [[http://cxf.apache.org/|Apache CXF]] framework that provides an implementation of JAX-RS for Java. The Tika server component builds to a standalone package in Tika, tika-server. Releases of Tika version 1.2 and beyond will ship with tika-server enabled, but to get the software before then and to experiment you can follow the below steps:
  
- Services:
+ # svn export http://svn.apache.org/repos/tika/trunk/tika-server
+ # mvn install
+ # java -jar target/tika-server-X.Y.jar
+ 
+ You will then see a message such as the following:
+ 
+ {{{
+ $ java -jar target/tika-server-1.2-SNAPSHOT.jar 
+ Apr 4, 2012 7:48:49 AM org.apache.tika.server.TikaServerCli main
+ INFO: Starting Tikaserver ${project.version}
+ Apr 4, 2012 7:48:50 AM org.apache.cxf.endpoint.ServerImpl initDestination
+ INFO: Setting the server's publish address to be http://localhost:9998/
+ 2012-04-04 07:48:50.316:INFO:oejs.Server:jetty-7.x.y-SNAPSHOT
+ 2012-04-04 07:48:50.375:INFO:oejs.AbstractConnector:Started SelectChannelConnector@localhost:9998 STARTING
+ 2012-04-04 07:48:50.399:INFO:oejsh.ContextHandler:started o.e.j.s.h.ContextHandler{,null}
+ Apr 4, 2012 7:48:50 AM org.apache.tika.server.TikaServerCli main
+ INFO: Started
+ }}} 
+ 
+ Which lets you know that it started correctly. Below is some basic documentation on how to 
+ interact with the services using cURL and HTTP.
+ 
+ = Services = 
  
  {{{
  /meta
@@ -14, +37 @@

  }}}
  HTTP PUTs a document to the /tika service and you get back the extracted text. HTTP GET prints a greeting stating the server is up.
  
+ Some Example calls with cURL:
+ 
+ == Get HELLO message back ==
+ 
+ {{{
+ $ curl -X GET http://localhost:9998/tika
+ This is Tika Server. Please PUT 
+ }}}
+ 
+ 
+ 
  {{{
  /unpacker
  }}}