Changes between Version 30 and Version 31 of Clients

Timestamp:

Oct 11, 2016, 8:07:13 AM (8 years ago)

Author:

Bang Pham Huu

Comment:

add Rasql Servlet description with detail.

Clients

@@ -23 +23 @@
 }}}
 * '''rasql queries''' can also be invoked via a Web service by default listening at `localhost:8080/rasdaman/rasql`. To this end, the corresponding servlet needs to be started (see [browser:manuals_and_examples/manuals/doc-guides/inst-guide.pdf Installation Guide]).
-    + Syntax: http://{service}/{path}/rasdaman/rasql?params (e.g: http://www.acme.com/rasdaman?query=select rgb.red rgb.green from rgb&username=rasguest
-&password=rasguest)
-    + This servlet endpoint accepts KVP requests with the following parameters:
-       * query=q where q is a valid rasql query, appropriately escaped as per http specification.
-       * username=u where u is the user name for logging into rasdaman (current: rasguest for retrieval query (select) and rasadmin for the editting query (insert, update, delete,...).
-       * password=p where p is the password for logging into rasdaman (current: rasguest for username: rasguest and rasadmin for username: rasadmin).
-    + To upload data to server, it is needed to attach the data in HTTP message's body and send the POST request to the Servlet endpoint. In Linux, one tool can support this feature is cURL. Here is an example: 
-       
-{{{
-       curl -F 'image=/home/rasdaman/rasdaman/systemtest/testcases_services/test_all_wcst_import/test_data/wcps_mr/mr_1.png' 'http://localhost:8080/rasdaman/rasql?username=rasadmin&password=rasadmin&query=update%20test_mr_test1%20set%20mr_test1%20assign%20decode(%241)'
+ * Syntax: 
+{{{
+http://{service}/{path}/rasdaman/rasql?params
+
+Example: 
+http://www.acme.com/rasdaman?query=select%20rgb.red+rgb.green%20from%20rgb&username=rasguest&password=rasguest
+}}}
+ * This servlet endpoint accepts KVP requests with the following parameters:
+   * ''query=q'' where q is a valid rasql query, appropriately escaped as per http pecification.
+   * ''username=u'' where u is the user name for logging into rasdaman (current: ''rasguest'' for retrieval query (select) and ''rasadmin'' for the editable query (insert, update, delete,...).
+   * ''password=p'' where p is the password for logging into rasdaman (current: ''rasguest'' for username: ''rasguest'' and ''rasadmin'' for username: ''rasadmin'').
+ * To upload data to server, it is needed to attach the data in HTTP message's body and send the POST request to the Servlet endpoint with user have the write permission (e.g: rasadmin). In Linux, one tool can support this feature is cURL.  Syntax: 
+{{{
+curl -F 'image=@{/Path_To_Image}' '{http://Rasql_Servlet_Endpoint?username=rasadmin&password=rasadmin&query={insert/update query}'
+}}}
+   * Here is an example:
+{{{
+Collection: test_mr_test1
+
+Insert file to collection:
+curl -F 'image=@/home/rasdaman/rasdaman/systemtest/testcases_services/test_all_wcst_import/test_data/wcps_mr/mr_1.png' 'http://localhost:8080/rasdaman/rasql?username=rasadmin&password=rasadmin&query=insert%20into%20test_mr_test1%20values%20decode(%241)' 
+
+Update file to collection:
+curl -F 'image=@/home/rasdaman/rasdaman/systemtest/testcases_services/test_all_wcst_import/test_data/wcps_mr/mr_1.png' 'http://localhost:8080/rasdaman/rasql?username=rasadmin&password=rasadmin&query=update%20test_mr_test1%20set%20test_mr_test1%20assign%20decode(%241)'
+
 }}}