...

Application Overview Anchor applicationapplication

This sample application demonstrates a simple order system which can get, delete, and edit ordering data using RESTful Web services. This RESTful Web services application works at XML message level. It uses the Asynchronous JavaScript and XML (Ajax) technique to combine Java technologies, XML, and JavaScript for the web service applications to uses client-side scripting to exchange data with the server. When a user creates a new order or edits an existing one, the resource data is converted into XML schema for processing. This web service is exposed as a Servlet in the Geronimo application server. See RESTful Web services for more information on the concept.

...

The restfulorder-javaee6 application is deployed as a WAR to the application server. The overview of the structural content of this WAR file is given as follows.

...

...

The org.apache.geronimo.samples.javaee6.restfulorder package consists of the following files.

...

...

where,

• The service folder contains the resource classes of the RESTful application.
• The config folder contains the servlet class that extends javax.ws.rs.core.Application to configure the application classes within a JAX-RS runtime. The javax.ws.rs.core.Application class provides methods that can specify a set of root resources and providers accessible from a specified application path. This way users can specify several groups of resources in a single application.
• The converter folder contains Java Architecture for XML Binding (JAXB) annotated classes to support the processing of XML in requests and responses.
• The entities folder contains an entity class that represents the table of order information in the database.
  
  

...

The postJson method, called to send a XMLHttpRequest to the servlet class, uses the Ajax technique provided in the following JavaScript support.js.

...

...

where,

• XMLHttpRequest is a JavaScript object used to send HTTP or HTTPS requests directly to a web server and load the server response data directly back into the script. In this application, an XMLHttpRequest instance xmlHttpReq is created to help a client-side script perform HTTP requests. The HTTP method to use for the request, the destination URL, and the request content type are set on the XMLHttpRequest object with the open function when initializing the request.
• open : function(method2, url2, mimeType, paramLen, async) is the function that opens a connection to the server resource at the specified URL (url2) for the specified method (method2). This function initializes the HTTP and HTTPS requests of the XMLHttpRequest object and must be invoked prior to the actual sending of a request.
• setRequestHeader is a method of the XMLHttpRequest object that is used to set HTTP headers to be send with the request.
• get, post, put and delete are functions responsible for dispatching requests. Each function first obtains an instance of XMLHttpRequest and initialize it with open. Then the requests are sent to the web server and will arrive on the server just like any other HttpServletRequest.
• send is the function used to send requests to the web server. It accepts a single parameter that can contain the content to be sent with the request. The requests perform like HttpServletRequests on the web server and after parsing the request parameters, the servlet will invoke the necessary application logic. For this application, the get, post, put and delete request methods from RestfulordersResource and RestfulorderResource classes are called according to the request type.
  
  

ApplicationConfig is a servlet that extends the javax.ws.rs.core.Application class to configure the application classes within a JAX-RS runtime.

...

...

where,

• @javax.ws.rs.ApplicationPath is an annotation that helps to specify the resource path of the application. The value of this annotation is used as the servlet URL pattern. For example, the URI for the resource presented in this application can be http://localhost:8080/restfulorder-javaee6/resources/restfulorders/, where /resources is the servlet URL. You can also specify this URL patterns in your web.xml file if this annotation is absent.
• javax.ws.rs.core.Application is a class that provides the getClasses and getSingletons methods that can specify a set of root resources and providers accessible from a specified application path respectively. The ApplicationConfig class uses the default implementations of javax.ws.rs.core.Application subclass getClasses and getSingletons methods that return empty sets. In this case, when both methods return empty sets, all root resource classes and providers packaged in the application are included in the published JAX-RS application.
  
  

RestfulordersResource is a resource class that uses JAX-RS annotations to implement the corresponding Web resource. The request methods defined in this class are called when the server receives the corresponding HTTP requests.

...

...

where,

• @Path("/restfulorders/") is the annotation that defines the relative URI to your resource. The base URI is provided by the combination of your hostname, port, application context root, and any URI pattern mappings in the application's web.xml file. For example, the URI for the resource presented by this resource class can be http://localhost:8080/restfulorder-javaee6/resources/restfulorders/.
• @Path("{id}/") annotates a sub-resource locator which returns a RestfulorderResource object to handle HTTP requests. The id parameter in this annotation defines the relative URI under /restfulorders/id to the resource.
• @Context is used in this resource class to inject an instance of UriInfo into the class field.
• UriInfo instances can provide information on the components of a request URI.
• @GET and @POST are request method designators for annotating resource methods in a resource class. Other common request method designators include @PUT, @DELETE, and @HEAD.
• @Consumes and @Produces annotations are used to declare the supported request and response media types. In this resource class, the post and get methods both support application/xml and application/json.
  
  

RestfulordersConverter is a Java Architecture for XML Binding (JAXB) annotated class that support the processing of XML in requests and responses.

...

...

where,

• @XmlRootElement(name = "restfulorders") is an annotation that maps the class to the root of the XML document. In this application, when the user creates a new order with a unique id, for example 01, the XML document containing the corresponding data is located at http://localhost:8080/restfulorder-javaee6/resources/restfulorders/01.
  
  

...

From the <restfulorder-javaee6_home> directory run the following command.

...

...

mvn clean install

...

This process will take a couple of minutes. The binaries will be generated in the corresponding target directory .

...