{"id":1765,"date":"2011-03-21T07:39:13","date_gmt":"2011-03-21T12:39:13","guid":{"rendered":"http:\/\/www.andygibson.net\/blog\/?p=1765"},"modified":"2011-03-16T14:50:38","modified_gmt":"2011-03-16T19:50:38","slug":"simple-restful-services-in-glassfish-pt-2","status":"publish","type":"post","link":"https:\/\/www.andygibson.net\/blog\/tutorial\/simple-restful-services-in-glassfish-pt-2\/","title":{"rendered":"Simple RESTful services in Glassfish Pt 2"},"content":{"rendered":"

In part 2 of this article, we are going to create a data driven web service that will return JSON and XML to the client, and then use jQuery to add a new item to the database and display it in our page.
\n
\nIn part 1, we looked at creating simple web services and now we’re going to look at making something more practical and interesting. We’ll start from where we left off with the source code as it was at the end of the part 1 which you can download from here (restwebdemo_pt1<\/a>) if you want to follow along. If not, the final source can be downloaded from here (restwebdemo_pt2<\/a>).<\/p>\n

    \n
  1. First off, we’re going to change the entity manager that is available for injection to be request scoped. To do this, open up DataRepositoryProducer.java<\/code> and change the @ConversationScoped<\/code> annotation on the getEntityManager()<\/code> method to be @RequestScoped<\/code>. The reason for this is documented here in A Little Less Conversation<\/a>.<\/li>\n
  2. Next we are going to create a simple dao for Course objects, and the only reason to do this is to demonstrate the integration of CDI and the ability to layer your code. Create a new class called CourseDao<\/code> with the following code.\n
    \r\npackage org.fluttercode.restwebdemo.bean;\r\n\r\n@Stateless\r\n@LocalBean\r\npublic class CourseDao {\r\n\r\n\t@Inject @DataRepository\r\n\tprivate EntityManager entityManager;\r\n\t\r\n\tpublic void save(Course course) {\r\n\t\tentityManager.persist(course);\r\n\t}\r\n\t\r\n\tpublic Course update(Course course) {\r\n\t\treturn entityManager.merge(course);\r\n\t}\r\n\t\r\n\tpublic Course find(Long id) {\r\n\t\treturn entityManager.find(Course.class, id);\r\n\t}\r\n}\r\n<\/pre>\n
    This just injects an entityManager and uses it to locate, save and update Course objects.\n<\/li>\n
  3. Now create a new CourseService<\/code> bean that will handle the web services. To start with we want to make it a stateless EJB and inject the course Dao. We are going start by re-implementing the method to return the course name for the given id.\n
    \r\n\t@Path("courseName\/{id}")\r\n\t@GET\r\n\tpublic String getCourseName(@PathParam("id") Long id) {\r\n\t\tCourse course = courseDao.find(id);\r\n\t\tif (course == null) {\r\n\t\t\treturn "Course not found";\r\n\t\t} else {\r\n\t\t\treturn course.getTitle();\r\n\t\t}\r\n\t}\r\n<\/pre>\n<\/ol>\n
    To see this method in action, deploy the application and go to http:\/\/localhost:8080\/restwebdemo\/rest\/course\/courseName\/126<\/a>. Now we know everything is working and hooked up together, we can look at adding some new functionality. <\/p>\n
    Let’s start by returning a course with a given id from the service. This is fairly simple given what we already know. The only thing to determine now is what format to return the object as and to convert it to that type. Luckily, Java EE already provides JAXB which can take an object graph and convert it to XML for us as long as we annotate the classes with the annotations to let the JAXB implementation know how to convert it. The same annotations can be used by the body writer that handles JSON.<\/p>\n
    First we’ll annotate the Course<\/code> class and make a couple of changes that we need to. Next we’ll create methods to return a Cource<\/code> object from the service in XML or JSON format.<\/p>\n
      \n
    1. Open the Course<\/code> class and add the following annotations to the class.\n
      \r\n@Entity\r\n@XmlRootElement\r\n@XmlAccessorType(XmlAccessType.FIELD)\r\npublic class Course extends BaseEntity {\r\n   ...\r\n   ...\r\n}\r\n<\/pre>\n
      This tells the JAXB processor that this class can be serialized and to access the values using fields in the class. This also means that any other annotations we want to add to control the serialization needs to be applied to the fields.\n<\/li>\n
      This is a simple example, so we don’t want to serialize the teacher<\/code> or enrolled<\/code> properties which we can do by marking them with the @XmlTransient<\/code> attributes. Also, remove the @NotNull<\/code> annotation from the teacher<\/code> attribute as we will need it blank later. The following code shows the fields with both the JAXB and JPA annotations. JAXB (like JPA) uses default conventions for fields that don’t have annotations : <\/p>\n
      \r\n\t@Column(length = 32, nullable = false)\r\n\t@Size(max = 32)\r\n\t@NotEmpty(message = "title is required")\r\n\tprivate String title;\r\n\r\n\t@Column(length = 8, nullable = false)\r\n\t@Size(max = 8  )\r\n\t@NotEmpty(message = "code is required")\r\n\tprivate String code;\r\n\r\n\t@ManyToOne(fetch = FetchType.LAZY)\r\n\t@XmlTransient\r\n\tprivate Teacher teacher;\r\n\r\n\t@ManyToMany(mappedBy = "enrolled")\r\n\t@XmlTransient\r\n\tprivate List<Student> students = new ArrayList<Student>();\r\n<\/pre>\n
      We are just using a simple JAXB model for the sake of the example which is why we aren’t including the Teacher<\/code> and Student<\/code> classes.\n<\/li>\n
    2. Now in our CourseService<\/code> class we will create methods to return the course entity and we will create one for JSON and one for XML.\n
      \r\n\t@Path("find\/{id}\/xml")\r\n\t@GET\r\n\t@Produces(MediaType.APPLICATION_XML)\r\n\tpublic Course getCourseAsXml(@PathParam("id") Long id) {\r\n\t\treturn courseDao.find(id);\r\n\t}\r\n\t\r\n\t@Path("find\/{id}\/json")\r\n\t@GET\r\n\t@Produces(MediaType.APPLICATION_JSON)\r\n\tpublic Course getCourseAsJson(@PathParam("id") Long id) {\r\n\t\treturn courseDao.find(id);\r\n\t}\r\n<\/pre>\n<\/li>\n
      (note : At this point, I had to switch to using Hibernate as the JPA provider since JAXB didn’t like the interface EclipseLink used for proxying the properties. You can do this using the Glassfish update tool).<\/small>
      \nIf you redeploy the application and browse to       http:\/\/localhost:8080\/restwebdemo\/rest\/course\/find\/1\/json<\/a> you should be prompted to save a file, or it will display the text, but the content should be something like : <\/p>\n
      \r\n{"createdOn":"2010-08-27T16:36:57.015-04:00",\r\n  "id":"1",\r\n  "modifiedOn":"2010-08-27T16:36:57.015-04:00",\r\n  "title":"Computing for Beginners",\r\n   "code":"CS101"}\r\n<\/pre>\n
      or if you go to http:\/\/localhost:8080\/restwebdemo\/rest\/course\/find\/1\/xml<\/a> you will get an XML version :<\/p>\n
      \r\n<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<course>\r\n\t<createdOn>2010-08-27T16:36:57.015-04:00<\/createdOn>\r\n\t<id>1<\/id>\r\n\t<modifiedOn>2010-08-27T16:36:57.015-04:00<\/modifiedOn>\r\n\t<title>Computing for Beginners<\/title>\r\n\t<code>CS101<\/code>\r\n<\/course>\r\n<\/pre>\n
      Now we can grab objects from our web service, we should look at creating objects from the service. We add a new method that takes the title and code values, creates a new Course<\/code> with those values and saves it using the courseDao<\/code>.<\/p>\n
      \r\n\t@Path("create")\r\n\t@PUT\r\n\t@Produces(MediaType.APPLICATION_JSON)\r\n\tpublic Course createCourse(@FormParam("title") String title,@FormParam("code") String code) {\r\n\t\tCourse course = new Course();\r\n\t\tcourse.setTitle(title);\r\n\t\tcourse.setCode(code);\t\t\r\n\t\tcourseDao.save(course);\t\t\r\n\t\treturn course;\r\n\t}\r\n<\/pre>\n
      Here I’ve used the FormParam<\/code> annotations to plug form values into the method call. You’ll notice that using REST conventions, the method to create a course uses the PUT type of request. Now let’s create a page to enter a title and code and create the course. Notice that our method returns the created course so we can return the course back to the user. This is probably not ideal, but suits for the purposes of demonstration. Now lets create a new HTML page to allow for data entry and calling the web service to create the Course.<\/p>\n
      \r\n<html>\r\n<head>\r\n<title>Insert title here<\/title>\r\n<script type="text\/javascript"\r\n\tsrc="http:\/\/localhost:8080\/restwebdemo\/jquery-1.4.min.js">\r\n<\/script>\r\n<\/head>\r\n<body>\r\n<div id="message"\r\n\tstyle="display: none; background: #d0d0f0; padding: 12px">Message Div<\/div>\r\n<form action="rest\/course\/create" method="POST">\r\n\t\r\n    <fieldset>\r\n    \t<legend>Create Course<\/legend>\r\n    \t<p>\r\n\t        Title<br \/>\r\n    \t    <input id="title" \/><br \/>\r\n    \t<\/p>\r\n    \t<p>\r\n        \tCode<br \/>\r\n        \t<input id="code" \/><br \/>\r\n    \t<\/p>\r\n    \t<input type="submit" id="submit" \/>\r\n\t<\/fieldset>\r\n<\/form>\r\n<\/body>\r\n\r\n<script type="text\/javascript">\r\n\r\n\/\/jquery pieces\r\n$(document).ready(function() {\r\n\t\t\r\n    \/\/change the submit button behaviouus.\r\n    $('#submit').click(function () {   \t\t\r\n\t\tvar title = $("input#title").val();\r\n\t\tvar code = $("input#code").val();\r\n\r\n\t\tparams = "title="+title+"&code="+code;\r\n\t\t\/\/alert("posting form : "+data);\t\t\r\n        $.ajax({  \r\n               type: "PUT",  \r\n               url: "rest\/course\/create",  \r\n               data: params,  \r\n               success: function(result) {\r\n        \t\t   showMessage("Created Course "+result.title+" with id "+result.id+" on "+result.createdOn);\r\n               }  \r\n        });  \r\n\t\treturn false;\t\t\t\t\r\n    });\r\n});\r\n\r\nfunction showMessage(msg) {\r\n\t  $('#message').html(msg);\r\n\t  $('#message').fadeIn('fast');\r\n\t   $('#message').delay(3000).fadeOut('slow');\r\n}\r\n<\/script>\r\n<\/html>\r\n<\/pre>\n
      This looks a lot code, but not really. We import jquery to help us post our form, and we create our form with the two fields. We use JQuery to add an event handler so when you click submit, it packages up the form, calls our web service with a PUT type of request and grabs the returned object as a JSON object, and displays a message using the values from the new instance obtained from the server. To verify that your course has been created, go to the front page<\/a> and you should see it listed.<\/p>\n
      That about wraps it up for this post, the source code can be downloaded from (restwebdemo_pt2<\/a>), just unzip it, use mvn clean package<\/code> and deploy the war to glassfish and use the URLs mentioned in the article.<\/p>\n","protected":false},"excerpt":{"rendered":"
      In part 2 of this article, we are going to create a data driven web service that will return JSON and XML to the client, and then use jQuery to add a new item to the database and display it in our page.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0},"categories":[64],"tags":[49,52,6,72,50,67,106,104,103],"_links":{"self":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/1765"}],"collection":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/comments?post=1765"}],"version-history":[{"count":5,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/1765\/revisions"}],"predecessor-version":[{"id":1770,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/posts\/1765\/revisions\/1770"}],"wp:attachment":[{"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/media?parent=1765"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/categories?post=1765"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.andygibson.net\/blog\/wp-json\/wp\/v2\/tags?post=1765"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}