{"id":2030,"date":"2017-03-23T21:48:34","date_gmt":"2017-03-23T21:48:34","guid":{"rendered":"http:\/\/blog.paranoidprofessor.com\/?p=2030"},"modified":"2017-04-28T18:50:01","modified_gmt":"2017-04-28T18:50:01","slug":"restful-services-in-java-simple-server-example","status":"publish","type":"post","link":"https:\/\/blog.paranoidprofessor.com\/index.php\/2017\/03\/23\/restful-services-in-java-simple-server-example\/","title":{"rendered":"Restful services in Java – simple server example"},"content":{"rendered":"

There are probably a lot of ways to create web services programs\u00a0but the simplest way I could think of was to create a project using Eclipse and Jersey.<\/p>\n

It turns out that restful services are really easy to summarize but a bit more involved to describe in the way of a teaching tutorial.<\/p>\n

I have read up on the topic in the O’Reilly published book “RESTful Java with JAX-RS 2.0” by Bill Burke. \u00a0 \u00a0There is a lot of information starting with how to do this the hard way from scratch all the while moving on to how JAX-RS and markup can simplify the task.<\/p>\n

I will not summarize everything that is described in\u00a0the book but I will say that it if you want to get a working knowledge of restful services this is a pretty easy way to go about it. \u00a0The book is pretty focused on the server side itself. \u00a0The nice thing about creating a server like this is that it is easy enough to test using a simple web browser.<\/p>\n

I have gone a small bit further and my examples will include some client code that will actually use the services that I created. \u00a0This is was done both as a simple java client and also with a simple html client that also used a bit of java script.<\/p>\n

It was this last part that actually seemed the most interesting as you can then control the entire “application” from server to client. \u00a0The book uses xml examples but I did also get do some research on both java script, JSON and html\/css. \u00a0It is possible that these are also highlighted in the future but at the moment they are not of a great interest to me.<\/p>\n

 <\/p>\n

Restful Services Setup from Scratch<\/h2>\n

There are a number of things that need to be setup for creating a web service and there are a number of ways to get this properly setup. \u00a0The way I choose was to create a new “Dynamic web project” in eclipse.<\/p>\n

I created a new workspace to ensure that all setup needs to be done from scratch.<\/p>\n

<\/a><\/p>\n

In this first dialogbox you can see that the “Target runtime” is an empty list. \u00a0This is because no web server has been defined.<\/p>\n

Simply click on new runtime to define one.<\/p>\n

<\/a><\/p>\n

Simply select which version of Tomcat is installed on your computer. The version that I had installed was 8.5.11.<\/p>\n

<\/a><\/p>\n

Basically select the install directory of Tomcat.<\/p>\n

Note: The structure of the Tomcat installation should be the same regardless of what the install directory is called. \u00a0However, when I was first trying to get the permissions for Tomcat setup I had problems using any path other than \/opt\/tomcat. \u00a0Once the permissions were corrected any path could be used.<\/p>\n

Once the Tomcat server is defined, it is just a matter clicking through the next three dialog boxes.<\/p>\n

<\/a><\/p>\n

<\/a><\/p>\n

<\/a>

We can set the context root of our URI to anything at here.This example it is FirstRestful.<\/p><\/div>\n

Once you press Finish the rest of the structure is created.<\/p>\n

<\/a><\/p>\n

Step 2 – adding Jersey<\/h2>\n

What is Jersey? \u00a0It is an implementation of JAX-WS (Java API for XML Web Services) for creating web services in XML format.\u00a0\u00a0<\/span>This makes it really easy for creating a small server. \u00a0All that needs to be done is to move\u00a0the Jersey libraries<\/a>\u00a0into the correct spot under the WebContent folder. \u00a0Once this has been done then the basic framework is in place.<\/p>\n

There is both a version 1 and version 2 of Jersey available on this site, newer must be\u00a0better so of course I downloaded 2.25.1.<\/p>\n

jaxrs-ri-2.25.1.zip<\/strong><\/p><\/blockquote>\n

This zip file contained three directories full of jar files, add all of these to the project. Simply unpack the zip and put all of the jars\u00a0files into the root of the WebContent\/WEB-INF\/lib directory.<\/p>\n

Now that Jersey is added to the project all that is left is the source code.<\/p>\n

Step 3 – adding the code<\/h2>\n

The last bit is to add the restful code to the project. \u00a0This first example actually does little more than display “Hello World”.<\/p>\n

Ok, ok, I did get a bit ahead of myself and you can also see that I have created sayHelloXml and sayHelloHtml as well. \u00a0These were actually only used from the browser, you can forget about them for right now.<\/p>\n

\r\npackage com.acmesoft;\r\n\r\nimport javax.ws.rs.GET;\r\nimport javax.ws.rs.Path;\r\nimport javax.ws.rs.Produces;\r\nimport javax.ws.rs.core.MediaType;\r\n\r\n@Path("\/Communicate")\r\npublic class HelloWorldEx {\r\n\r\n    @GET\r\n    @Path("\/hello")\r\n    @Produces(MediaType.TEXT_PLAIN)\r\n    public String sayHelloTxt() {\r\n    \treturn "Hello World\\nHaving a great time!";\r\n    }\r\n\r\n    @GET\r\n    @Path("\/hello")\r\n    @Produces( {MediaType.APPLICATION_XML})\r\n    public String sayHelloXml() {\r\n      \treturn "<Magazine>" +\r\n\t\t"<Year>2016<\/Year>" +\r\n\t\t"<Month>6<\/Month>" +\r\n\t\t"<Title>Economist<\/Title>" +\r\n\t\t"<Price>9.99<\/Price>" +\r\n\t"<\/Magazine>";\r\n    }\r\n\r\n    @GET\r\n    @Path("\/html")\r\n    @Produces(MediaType.TEXT_PLAIN)\r\n    public String sayHelloHtml() {\r\n    \treturn "<h1>This is 'h1' heading<\/h1>";\r\n    }\r\n}\r\n<\/pre>\n
There is one other small file that needs to be setup, it is the web.xml file. This is the configuration file to setup the Jersey for this servlet.<\/p>\n
\r\n<?xml version="1.0" encoding="UTF-8"?>\r\n<web-app xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xmlns="http:\/\/java.sun.com\/xml\/ns\/javaee" xsi:schemaLocation="http:\/\/java.sun.com\/xml\/ns\/javaee http:\/\/java.sun.com\/xml\/ns\/javaee\/web-app_3_0.xsd" id="WebApp_ID" version="3.0">\r\n   <display-name>User Management<\/display-name>\r\n   <servlet>\r\n      <servlet-name>Jersey RESTful Application<\/servlet-name>\r\n      <servlet-class>org.glassfish.jersey.servlet.ServletContainer<\/servlet-class>\r\n         <init-param>\r\n            <param-name>jersey.config.server.provider.packages<\/param-name>\r\n            <param-value>com.acmesoft<\/param-value>\r\n         <\/init-param>\r\n      <\/servlet>\r\n   <servlet-mapping>\r\n   <servlet-name>Jersey RESTful Application<\/servlet-name>\r\n      <url-pattern>\/*<\/url-pattern>\r\n   <\/servlet-mapping>  \r\n<\/web-app>\r\n<\/pre>\n
This example creates a small hello world application using restful web services. \u00a0You can see that the URI to get the hello world is \/Communicate\/hello, but this is only a part.<\/p>\n
Eclipse does a lot for you. \u00a0One of the things it does is to create the context root of the URI. We can set it to any value we wish in the last step while creating our dynamic web project.<\/p>\n
http:\/\/192.168.178.70:8080\/FirstRestful<\/strong>\/Communicate\/hello<\/p><\/blockquote>\n
Step 4\u00a0– creating war file<\/h2>\n
The process of creating a war file couldn’t actually be much easier. \u00a0Simply right click on the project and select export and select war file. \u00a0This will open up the following dialog.<\/p>\n
<\/a><\/p>\n
The destination in this case is \/tmp. \u00a0The file is then copied to the \/opt\/tomcat\/webapps directory in a second step. I could have set the permissions on the webapps directory to allow my user to write to it directly, however, that is not very security minded. \u00a0This isn’t an issue on a development machine but perhaps it is a bad habit to get into in general, thus the manual extra copy step.<\/p>\n
The three checkboxes are reasonably clear to their purpose. \u00a0It is possible to optimize for a specific version of tomcat. \u00a0Export source files simply includes the source code in the war file. \u00a0This might be interesting for an internal application for your company\u00a0but probably a bad idea if you are selling your application.<\/p>\n
Step 5\u00a0–\u00a0releasing application to tomcat<\/h2>\n
Releasing the application is as simple as copying the war file to the\/opt\/tomcat\/webapps.<\/p>\n
    \n
  1. stop Tomcat<\/li>\n
  2. copy application to webapps directory<\/li>\n
  3. start Tomcat<\/li>\n<\/ol>\n
    Tomcat will unpack the war file into the webapps directory.<\/p>\n