{"id":9,"date":"2016-04-05T00:16:37","date_gmt":"2016-04-05T00:16:37","guid":{"rendered":"http:\/\/topshot.com\/blog\/?p=7"},"modified":"2016-04-05T12:53:19","modified_gmt":"2016-04-05T16:53:19","slug":"creating-a-json-based-web-server-eclipse-project-2","status":"publish","type":"post","link":"https:\/\/computermoose.topshot.com\/index.php\/2016\/04\/05\/creating-a-json-based-web-server-eclipse-project-2\/","title":{"rendered":"Creating a JSON-based Web Server Eclipse Project"},"content":{"rendered":"

With the current work I am doing for our client as a consultant, I have not had any recent opportunity to work with or let alone, configure a Spring framework.\u00a0 Realizing that I was getting a bit rusty and that Spring 4 had come out since I last worked with Spring, I thought it best to spend a little extra time reviewing Spring by putting together a simple server environment using Spring and JSON (which is a application popular protocol for use with client software).\u00a0 I thought this should only take a couple of hours at most.\u00a0 I figured the latest Eclipse would have everything built-in and it would be just a matter of creating a few application classes.<\/p>\n

Eclipse can indeed create a client\/server project but I saw no sample code for creating JSON controllers. I knew it was just a matter of defining a few annotation items but I had forgotten which ones I needed and their particular syntax.\u00a0 Solution: go to the Internet and search for “json eclipse server example”.\u00a0 I found a number of tutorial sites that included downloadable projects.\u00a0 I tried three of them.\u00a0 None of them worked out of the box.\u00a0 I found this particularly surprising as there were comments and thanks from users who had found the tutorials very useful and presumably had used the downloadable code.\u00a0 I assumed the issue was versioning and so I set out to grab the latest and greatest of everything (at least as of the date that I am writing this article). \u00a0Building with these versions, too, wasn’t as obvious as it should have been. One of the library names had changed. But with a little perseverance, I finally hit on the correct versions of libraries that I needed to produce a functional JSON-based web server project.<\/p>\n

The details are described below.\u00a0 Note that this article is not meant to be a tutorial on JSON.\u00a0 It is simply meant to be informative information for quickly getting a JSON-based web server project up and running.<\/p>\n

Install Java 8<\/h2>\n

I should really be assuming that you have the JDK version of Java 8 installed. How do you expect to develop any software without it?\u00a0 Nevertheless, if you have Java 6 or Java 7 installed, realize that they are no longer supported. You really need to upgrade to Java 8.\u00a0 Here’s a link to the latest Java download page:\u00a0 http:\/\/www.oracle.com\/technetwork\/java\/javase\/downloads\/jdk8-downloads-2133151.html<\/a>.\u00a0 \u00a0You can have more than one version of Java installed at the same time.\u00a0 Just set your PATH and JAVA_HOME variables to the appropriate version.<\/p>\n

Install Tomcat 8<\/h2>\n

Tomcat is one of the easiest application servers to install, configure and run.\u00a0 There are other similarly good app servers but this is the one I chose to use.\u00a0 The latest version of tomcat is version 9 but it’s really very new (and I don’t know what features it has above and beyond version 8) and so I chose to install version 8.\u00a0 Download tomcat from here: https:\/\/tomcat.apache.org\/download-80.cgi<\/a>.\u00a0 I usually download the zip file onto my Windows box and install it in a local directory called util (this is where I drop all my Apache software after downloading the respective zip files).\u00a0 So if my user name is ‘jberry’, I will end up with a directory called jberry\/util\/apache-tomcat-8.0.32.<\/p>\n

Install Eclipse<\/h2>\n

Install the latest version of eclipse.\u00a0 Go to the eclipse download page:\u00a0 https:\/\/eclipse.org\/downloads\/<\/a>.\u00a0 I suggest installing “Eclipse IDE for Java EE Developers”.\u00a0 This gives you all the tools you might need for developing your web-based application.\u00a0 The download file will be a zip file.\u00a0 I unzipped everything into folder jberry\/eclipse.\u00a0 To execute eclipse, go to directory jberry\/eclipse\/jee-mars\/eclipse.\u00a0 There you will find the executable file, eclipse.exe.<\/p>\n

Workspace setup<\/h2>\n

Create a directory called jberry\/workspace (or wherever you want).\u00a0 Download the zip file that includes my source code for the JSON example.\u00a0 The link is here: https:\/\/dl.dropboxusercontent.com\/u\/14719415\/RecordCollection.zip<\/a>.<\/p>\n

Eclipse startup<\/h2>\n

Start eclipse.\u00a0 It will ask you for the location of your workspace.\u00a0 Enter the workspace path from the previous step.\u00a0 After a brief moment, you will see an eclipse window entitled “Eclipse Java EE IDE for Web Developers”.\u00a0 In the upper right corner, press the button “Workbench”.<\/p>\n

From the top pulldown menu, click on WIndow –> Preferences.\u00a0 By the left side of the window, find Java, expand the arrow and click on Installed JREs, as shown here:<\/p>\n

\"InstallJava\"<\/p>\n

Click on the “Add” button and find the path where your Java 8 JDK was installed.<\/p>\n

\"jdk\"<\/p>\n

Press the “Apply” button.<\/p>\n

Setup tomcat within eclipse<\/h2>\n

In the same preferences window, at the left side of the window, find “Server”, open it up and click on Runtime Environments:<\/p>\n

\"runtime\"<\/p>\n

Press the “Add” button you will see a list of servers.<\/p>\n

\"apache\"<\/p>\n

Select Apache Tomcat v8.0 and click on “Next>”.\u00a0 Do not check the box that says Create a new local server.\u00a0\u00a0 Click on the “Browse” button and find where you installed tomcat.\u00a0 Enter that path.\u00a0 Under JRE, click on “Workbench default JRE” and specify your JDK install.\u00a0 Your window should look something like this:<\/p>\n

\"tomcat\"<\/p>\n

Press “OK” to close your window.<\/p>\n

At the bottom of the eclipse window, click on the “Servers” tab, right-click and select “New Server”. A window similar to the follow should pop up.\u00a0 Press “Finish” to create the server.<\/p>\n

\"newserver\"<\/p>\n

Import the JSON project<\/h2>\n

Click on “File” from the top pulldown menu and select “Import…”.\u00a0 Open category General and select “Existing Projects into Workspace” and press “Next>”.\u00a0 Press the “Browse…” button and select the workspace directory that was defined above.\u00a0 You should see an Import Projects dialog box like this one:<\/p>\n

\"importprojects\"<\/p>\n

Click on the “Finish” button.<\/p>\n

Select the “Markers” tab at the bottom of eclipse.\u00a0 There should not be any Java errors. If there are errors, right-click on “RecordCollection” which should appear in the Project Explorer view (far left side of eclipse) and select “Maven” –> “Update Project…”.<\/p>\n

Description of the project<\/h2>\n

The data objects, Artist, Cd, and RegistrationInfo are straight-forward and are defined in package com.topshot.recordcolleciton.model.\u00a0 The two classes, ArtistInfo and CdInfo, are meant to simulate a simple database get or fetch operation but just returned hard-coded values.<\/p>\n

The interesting stuff takes place in the controller package. Note how @RequestMapping, both at the class level and the method level are used to define which method is to be executed see the section called Testing below).\u00a0 And most of all, note that there is no JSON conversion code in the application. Conversion of the various output classes is handled invisibly via Spring and its support libraries.\u00a0 Simply adding produces=”application\/json”<\/em> tells Spring to perform this magic.<\/p>\n

Run the project<\/h2>\n

Select the “Servers” tab at the bottom of eclipse.\u00a0 Then right-click on the tomcat instance and select “Start”.\u00a0 After a moment or so, tomcat will show that it is started and synchronized.\u00a0 This can be verified by opening the console tab.\u00a0 You should see something like this:<\/p>\n

INFO: Server startup in 10395 ms<\/span><\/p>\n

Go back to the server tab and right-click on the server.\u00a0 Select “Add and Remove…”.\u00a0 Select the RecordCollection resource and press the “Add>” button.\u00a0 Your dialog window should look something like this:<\/p>\n

\"addremove\"<\/p>\n

Personally, I always uncheck the box that says “If server is started, publish changes immediately”. But that’s up to you.\u00a0 The pluses and minuses of this choice are best saved for a more detailed discussion on software development and debugging.\u00a0 Press “Finish”.<\/p>\n

Testing<\/h2>\n

Open a browser and enter URL http:\/\/localhost:8080\/RecordCollection\/Records\/artists<\/a>.\u00a0 You should get back the following line:<\/p>\n

[{“name”:”Bob Dylan”},{“name”:”John Prine”},{“name”:”Joan Baez”},{“name”:”Leonard Cohen”}]<\/span><\/p>\n

Now enter http:\/\/localhost:8080\/RecordCollection\/Records\/cd\/CD2<\/a> and\u00a0 you should get back the following line:<\/p>\n

{“title”:”CD2″,”artist”:[{“name”:”John Prine”},{“name”:”Joan Baez”}],”song”:null}<\/span><\/p>\n

 <\/p>\n

In both of the above cases, you were executing HTTP GET commands.\u00a0 In order to execute an HTTP PUT command, a little more setup work is needed.\u00a0 There are many tools available that will generate a PUT command.\u00a0 One such tool is SoapUI.\u00a0 Configuring SoapUI is beyond the scope of this article.\u00a0 See the file README.txt which is part of the RecordCollection project for a little more information on testing PUTs.<\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

With the current work I am doing for our client as a consultant, I have not had any recent opportunity to work with or let alone, configure a Spring framework.\u00a0 Realizing that I was getting a bit rusty and that Spring 4 had come out since I last worked with Spring, I thought it best … Continue reading “Creating a JSON-based Web Server Eclipse Project”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false},"version":2}},"categories":[1],"tags":[],"class_list":["post-9","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p7qelO-9","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/posts\/9","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/comments?post=9"}],"version-history":[{"count":6,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/posts\/9\/revisions"}],"predecessor-version":[{"id":29,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/posts\/9\/revisions\/29"}],"wp:attachment":[{"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/media?parent=9"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/categories?post=9"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/computermoose.topshot.com\/index.php\/wp-json\/wp\/v2\/tags?post=9"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}