Syntax of a Direct REST Request

A Direct REST request is sent from a client as an HTTP verb (GET, POST, PUT, or DELETE), followed by the URL of the resource. The syntax is similar to that of other types of Jade web‑enabled applications.

Verb REST server URL:port‑number/path[.xml|json|jsonn][&extra_info]
     <‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑> <‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑> <‑‑‑‑‑‑‑‑‑‑>
              first part              second part       third part

The following Jade Direct REST service request retrieves information in JSON format for a customer with an identifier of 123.

GET://localhost:port-number/customer/123.json
     <‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑> <‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑>
           first part          second part

The first part of the URL is the address and port number of the Direct REST application.

http://localhost:543

In this example, the host is the local machine and :543 is its port number.

The second part of the URL contains the following.

Identifier of the resource, which in this example is customer.

The JadeRestService method that is invoked for a GET request on the resource /customer is obtained by converting the HTTP verb to lowercase (get) and appending the name with the first letter capitalized (Customer), resulting in the method name getCustomer.
Each additional URL path level is a parameter passed to the called method. Each string value is converted to the required method parameter type. An exception is raised if the data is invalid or there is a mismatch in the number of parameters.

A GET request for /customer/123 would result in a getCustomer(123) method call; that is, the getCustomer method would require the first parameter to be of the Integer type.

A GET request for /customer/Clark Kent would result in a getCustomer("Clark Kent") method call; that is, the getCustomer method would require the first parameter to be of the String type.

Direct REST requests must be URL-encoded before the request is sent, so that /customer/Clark Kent would become /customer/Clark%20Kent.

A GET request for /customer/Clark Kent/Smallville would result in a getCustomer("Clark Kent", "Smallville") method call; that is, the getCustomer method would require the type of the first and second parameters to be String.

URL path levels separated by the slash character (/) are used to pass primitive parameters. An object parameter is passed as XML or JSON as the body of the data received. You can pass one object parameter only in a Direct REST service request.

A ParamListType parameter can be used in the method signature to receive multiple path parameters from the URL but it must be the last parameter of the Jade method. All parameters passed for a ParamListType parameter are assumed to be strings.
You can include the output format of the data at the end of the path information.
- /customer/123.xml returns customer information in Microsoft XML format
- /customer/123.json returns customer information in Microsoft JSON format
- /customer/123.jsonn returns customer information in NewtonSoft JSON format
If the output format is not specified (/customer/123), data is returned in Microsoft JSON format.

The third part of the URL is the query string.

GET http://localhost/customer/123.json

For a GET request, you can append a dot character (.) followed by the XML or JSON for an object, if the REST service method has an object parameter in the signature.

For a POST, PUT, or DELETE request, you can supply the XML or JSON for an object in the request body, if the REST service method has an object parameter in the signature.