Step 1: Obtain information about Web service resources
To access a RESTful Web services server, you must first get information about the services offered by a server from the service provider.
In REST, the name of the resources or functions and what query parameters or arguments to use with them are generally all that you require, as this information contains everything the client needs to interact with the required resource.
Add Function
In the code example for the Calculator RESTFul Web
services server application, we know that the calculator demo service performs various
calculator functions. Our client application simply wants to access the function to add values.
# Calculator Web Service add function
FUNCTION add()
LET add_out.r = add_in.a + add_in.b
LET add_out.status.code = 0
LET add_out.status.desc = "OK"
END FUNCTION
The HTTP request must therefore use a URI with a resource name and the
required parameters that matches the calculator function defined in the calculator Web service
server side. http[
s]
://host:port/resource-name[
?query-params]
- host:port is the base URL from the server.
- resource-name is the name of the resource.
- query-params is a set of URL query parameters.
Therefore, Add becomes the resource name part of the URI we need to include in our code.
# Sample request to add two numbers
GET http://localhost:8090/add?a=1&b=2
In the next step we start to code the client application, Step 2: Import extension packages (com, xml, util)