CS 3220 Web and Internet Programming RESTful Web

CS 3220 Web and Internet Programming RESTful Web Service Chengyu Sun California State University, Los Angeles

Example: Files and Folders Documents Users John Courses CS 3220 File. java files. sql CS 5220 Homework 1. pdf contacts. xls Jane log. txt

The Need to Exchange Data Between Client and Server Ajax Folder Expand Client + Documents + Users log. txt Server Folder ID List of files and subfolders in the folder

Usage of RESTful Web Service Web Applications Server Mobile Apps RESTful Web Service Desktop Applications Other Web Services

A RESTful Web Service Example Implementation n File Db. Utils File. Servlet Request Get file with id=1: /file/1 JSON Response mapped to /file/* { “id”: 1, “name”: “Documents”, “parent. Id”: null, “folder”: true }

Is That Really A Web Service? Why does it look like a web application? Why is it called RESTful?

A Brief History of Web Service • Remote Procedure Call • Simplifies network programming RPC CORBA • Cross-platform RPC (Traditional) Web Services • Cross-platform RPC over HTTP • SOAP – complex and not efficient RESTful Web Services

Why Does It Look Like A Web Application? Answer: it does, and it’s a good thing. Now all web technologies/languages can be used to create web services (and you don’t have to implement complex specifications like SOAP).

Why Is It Called RESTful? REpresentational State Transfer Introduced by Roy Fielding in his Ph. D. dissertation on network-base software architecture Describes the common characteristics of scalable, maintainable, and efficient distributed software systems

The REST Constraints Client and server Stateless Support caching Uniformly accessible Layered (Optional) support code-on-demand

RESTful Web Services Web applications for programs n Generate responses in formats to be read by machines (i. e. JSON and XML) rather than by humans (i. e. HTML) Simulate how the static web (the largest REST system) works n n n Use URLs that look like URLs for static web pages Utilize HTTP request methods and headers Stateless, i. e. no session

RESTful Web Service Example Files and folders n n n Get Add Update Delete List w All the top-level files and folders w All the files and folders under a folder

Create a RESTful Web Service Identify resources and operations Determine resource representation, i. e. data exchange format between the service and the clients Design URL and request mapping Implement the operations

Resource Representation Data format should be easily “understandable” by all programming languages XML n n Already widely in use as a platform independent data exchange format XML parsers are readily available in many languages JSON n n Much more concise than XML Can be used directly in Java. Script

URL Design and Request Mapping Conventions (1) Operation: get a file/folder URL n n /file/{id} or /file/get? id={id} Path variable based design is usually preferred to request parameter based design.

URL Design and Request Mapping Conventions (2) Operation: get a file/folder Choose which data format to use to communicate with a client Solution: n n /file/{id}. {format}, or Check the Accept request header

URL Design and Request Mapping Conventions (3) Map HTTP Request Methods to CRUD operations n n POST (or PUT) GET PUT (or POST) DELETE n n Create Retrieve Update Delete

Request Mapping Example (I) Operation Get a file HTTP Request GET /file/1 HTTP 1. 1 Delete a file DELETE /file/1 HTTP 1. 1 Update a file PUT /file/1 HTTP 1. 1 { “id”: 1, “name”: “Documents 2”, “parent. Id”: null, “folder”: true }

Request Mapping Example (II) Operation HTTP Request List top-level files GET /files HTTP 1. 1 List files under a folder Add a file GET /files/1 HTTP 1. 1 POST /files HTTP 1. 1 { “id”: null, “name”: “Lab 1. pdf”, “parent. Id”: 7, “folder”: false }

Implement RESTful Web Service In theory any web application technology would do, but in practice it should be n n n Easy to handle request methods and request/response headers Easy to handle “path parameters” like /file/{id} Easy to handle data in XML and/or JSON format

Service Implementation – Know Your Libraries Modern webapp frameworks like Spring Jersey - https: //jersey. java. net/ Convert between objects and XML/JSON n n Jackson https: //github. com/Faster. XML/jackson Gson, JAXB, Simple XML Serialization …

Serialization/Marshalling and Deserialization/Unmarshalling Serialization/ Marshalling Java Object XML/JSON De-serialization/ Un-marshalling

Service Access – Libraries on the Client Side HTTP client n n n Client-side Java. Script for web applications Apache Http. Client for Java applications Http. Url. Connection for Android apps Various XML/JSON parsers, e. g. Jackson, Xml. Pull. Parser, Json. Reader, …

Service Testing Browser addons/extensions Standalone clients, e. g. Postman Full-featured test software like Selenium

Service Implementation Using Jersey https: //jersey. java. net/ A Java library for creating and accessing RESTful web services The reference implementation of the JAX-RS (Java API for RESTful Web Services) specification

Use Maven for Dependency Management Convert an Eclipse Dynamic Web Project to a Maven Project: right click on project -> Configure -> Convert to Maven Project Maven is a project management tool for Java n n Project Object Model (POM) Project Lifecycles Dependency Management Plugin Framework

Maven Coordinates group. Id n Name of the company, organization, team etc. , usually using the reverse URL naming convention artifact. Id n A unique name for the project under group. Id version packaging, default: jar classifier Maven coordinates uniquely identifies a project.

Why Not Just Use Project Name Rage-quit: Coder unpublished 17 lines of Java. Script and “broke the Internet”

Dependency Management A dependency of a project is a library that the project depends on Adding a dependency to a project is as simple as adding the coordinates of the library to pom. xml Maven automatically downloads the library from an online repository and store it locally for future use

Dependency Example <dependencies> <dependency> <group. Id>javax. servlet</group. Id> <artifact. Id>jstl</artifact. Id> <version>1. 2</version> </dependency> </dependencies> Add a dependency to pom. xml Add a dependency in Eclipse

More About Dependency Management Dependencies of a dependency are automatically included Dependency conflicts are automatically resolved

Jersey Dependencies org. glassfish. jersey. containers: jerseycontainer-servlet org. glassfish. jersey. media: jersey-mediajson-jackson

Example: Get File in Jersey URL: /service/file/{id} Basic Jersey terminology n n Dispatcher servlet Resource class w Resource method (i. e. sub-resource) n Provider w Entity Provider

Understand Request Routing in Jersey /service/file/1 /service/* Request URI Servlet mapping for the Jersey dispatcher servlet in web. xml @Path(“/file”) Path annotation for resource class @Path(“/{id}”) Path annotation for resource method (optional)

Common Jersey Annotations … @Path. Param n Map part of the path to an argument of a resource method @GET, @POST, @PUT, @DELETE

… Common Jersey Annotations @Produces n n n Tell Jersey which data format the return value should be converted to Help mapping a request to a resource method based on the Accept header in the request Set the Content-Type header in response @Consumes n n Tell Jersey the data format of the data in the request body Help mapping a request to a resource method based on the Content-Type header in the request

Example: RESTful Web Service Implementation and Access Complete the rest of the operations Test the operations Implement AJAX Folder Expand

Run the Code Example Download the zip file from https: //csns. calstatela. edu/download? file. Id=5 956689 Unzip it to a local folder In Eclipse, select File Import Existing Maven Project Follow the instructions in README. md In Eclipse, right click on the project and select Run As Run on Server

Application Deployment Deploy Application Computer for Development Server Hosting the Web Application

WAR Files Web application ARchive A JAR file for packaging, distributing, and deploying Java web applications Ways to create WAR files n n n The command line tool jar Eclipse Export -> Web -> WAR file mvn package

Deploy WAR Files to a Tomcat Server Copy the WAR file to the webapps folder Use the Manager App n Need a user with the manager-gui role More options at http: //tomcat. apache. org/tomcat-8. 5 doc/deployer-howto. html