- \n
- Resources: <\/strong>It is the first key element of RESTful. Suppose a web application on the server contains records of several employees. To access the record of a particular employee using REST, you need to issue some command say https:\/\/www.abc.com\/employee-1, which will tell the server to fetch details of the employee whose employee number is 1.<\/li>\n\n\n\n
- Request Verbs: <\/strong>It describes what to do with the resource. There are many verbs available like POST, PUT, GET, and DELETE. In https:\/\/www.abc.com\/employee-1, the web browser is issuing a GET verb because it wants to fetch the employee record details.<\/li>\n\n\n\n
- Request Headers: <\/strong>The additional information sent with the request (maybe the type of response required or authorization details).<\/li>\n\n\n\n
- Request Body: <\/strong>Here, data is sent with the request. Data is usually sent in the request when a POST request is made.\u00a0<\/li>\n\n\n\n
- Response Body: <\/strong>The main body of the response is Response Body. In https:\/\/www.abc.com\/employee-1, the webserver may return an XML document containing all the details of the employee.<\/li>\n\n\n\n
- Response Status Codes: <\/strong>The general codes, which are returned with the response are Response Status Codes. For example, code 200 is normally returned when there is no error in returning the response.<\/li>\n<\/ul>\n\n\n\n
Methods in RESTful:<\/strong><\/h2>\n\n\n\n
The below diagram shows all the methods used in REST:<\/p>\n\n\n\n
- \n
- POST: It is used to create a resource on the server.<\/li>\n\n\n\n
- GET: It is used to retrieve a resource from the server.<\/li>\n\n\n\n
- PUT: It is used to change the state of the resource or to update it.<\/li>\n\n\n\n
- DELETE: It is used to delete a resource from the server.<\/li>\n<\/ul>\n\n\n\n
Advantages of RESTful:<\/strong><\/h2>\n\n\n\n
- \n
- Heterogeneous languages and environments: Web applications in REST can be developed in various programming languages. Also, they can reside in different environments (maybe Windows or Linux). The result should be that they should be able to talk to each other.<\/li>\n\n\n\n
- The event of devices: Nowadays, everything should work on mobile devices. RESTful Web Service API\u2019s makes it simpler as you don\u2019t need to know what is the underlying layer for the device.<\/li>\n\n\n\n
- The event of the cloud: Nowadays, all the applications are moving to the cloud. All the cloud-based architectures work on the REST principle.<\/li>\n<\/ul>\n\n\n\n
Principles of RESTful:<\/strong><\/h2>\n\n\n\n
The REST architecture depends on the following principles:<\/p>\n\n\n\n
- \n
- RESTful Client-Server: It is the most fundamental principle of REST. If the client sends a request to the server, the server can either reject the request or provide an appropriate response as per the request.<\/li>\n\n\n\n
- Stateless: This concept is required so that the server can process the response adequately. It is a simple independent question-answer sequence. The client asks the question; the server gives the answer. The client again asks the question, but the server responds to the new question independently.<\/li>\n\n\n\n
- Cache: This concept helps in the problem of stateless. If the client asks a question many times, and the server responds to each request independently, it will increase the traffic across the network. Thus, the concept of the cache will store the client\u2019s requests. If the client gives the same request, then instead of going to the server, it will just go to the cache and fetch the required information. This saves the amount of traffic.<\/li>\n\n\n\n
- Layered System: In this principle, any middle layer can be inserted between the client and the server.<\/li>\n\n\n\n
- Interface\/Uniform Contract: These include the techniques on which the RESTful works such as POST, GET, PUT, and DELETE.<\/li>\n<\/ol>\n\n\n\n
How to create the first RESTful Web Service?<\/strong><\/h2>\n\n\n\n
Before writing RESTful Web Services, you need Jersey framework. Step 1: <\/strong>Open Eclipse IDE. Go to File > New > Project. Select Dynamic Web Project. Name your project.<\/p>\n\n\n\n
<\/figure>\n\n\n\n
Step 2: <\/strong>Add Jersey Framework and its dependencies (libraries). Copy all the jar files available from the downloaded Jersey folder in WEB-INF\/lib directory of your project.<\/p>\n\n\n\n
\\jaxrs-ri-2.17\\jaxrs-ri\\api
\\jaxrs-ri-2.17\\jaxrs-ri\\ext
\\jaxrs-ri-2.17\\jaxrs-ri\\lib<\/pre>\n\n\n\nRight-click on your project name and then go to the context menu > Build Path > Configure Build Path.<\/p>\n\n\n\n
Use the Add JARs button present under Libraries to add the JAR files.<\/p>\n\n\n\n
Step 3: <\/strong>Create the source files.<\/p>\n\n\n\n
User.java<\/em><\/strong><\/p>\n\n\n\n
import java.io.Serializable; \nimport javax.xml.bind.annotation.XmlElement; \nimport javax.xml.bind.annotation.XmlRootElement; \n@XmlRootElement(name = \"user\") \npublic class User implements Serializable { \n private static final long serialVersionUID = 1L; \n private int emp_id; \n private String name; \n private String profession; \n public User(){} \n public User(int emp_id, String name, String profession){ \n this.emp_id = emp_id; \n this.name = name; \n this.profession = profession; \n } \n public int getId() { \n return emp_id; \n } \n @XmlElement \n public void setId(int emp_id) { \n this.emp_id = emp_id; \n } \n public String getName() { \n return name; \n } \n @XmlElement\n public void setName(String name) { \n this.name = name; \n } \n public String getProfession() { \n return profession; \n } \n @XmlElement \n public void setProfession(String profession) { \n this.profession = profession; \n } \n}\n<\/pre>\n\n\n\nUserDao.java<\/em><\/strong><\/p>\n\n\n\n
import java.io.File; \nimport java.io.FileInputStream; \nimport java.io.FileNotFoundException; \nimport java.io.FileOutputStream; \nimport java.io.IOException; \nimport java.io.ObjectInputStream; \nimport java.io.ObjectOutputStream; \nimport java.util.ArrayList; \nimport java.util.List; \npublic class UserDao { \n public List<User> getAllUsers(){ \n List<User> userList = null; \n try { \n File file = new File(\"Users.dat\"); \n if (!file.exists()) { \n User user = new User(1, \"Mahesh\", \"Teacher\"); \n userList = new ArrayList<User>(); \n userList.add(user); \n saveUserList(userList); \n } \n else{ \n FileInputStream fis = new FileInputStream(file); \n ObjectInputStream ois = new ObjectInputStream(fis); \n userList = (List<User>) ois.readObject(); \n ois.close(); \n } \n } catch (IOException e) { \n e.printStackTrace(); \n } catch (ClassNotFoundException e) { \n e.printStackTrace(); \n } \n return userList; \n } \n private void saveUserList(List<User> userList){ \n try { \n File file = new File(\"Users.dat\"); \n FileOutputStream fos; \n fos = new FileOutputStream(file); \n ObjectOutputStream oos = new ObjectOutputStream(fos); \n oos.writeObject(userList); \n oos.close(); \n } catch (FileNotFoundException e) { \n e.printStackTrace(); \n } catch (IOException e) { \n e.printStackTrace(); \n } \n } \n}\n<\/pre>\n\n\n\nUserService.java<\/em><\/strong><\/p>\n\n\n\n
import java.util.List; \nimport javax.ws.rs.GET; \nimport javax.ws.rs.Path; \nimport javax.ws.rs.Produces; \nimport javax.ws.rs.core.MediaType; \n@Path(\"\/UserService\") \npublic class UserService { \n UserDao userDao = new UserDao(); \n @GET \n @Path(\"\/users\") \n @Produces(MediaType.APPLICATION_XML) \n public List<User> getUsers(){ \n return userDao.getAllUsers(); \n } \n}\n<\/pre>\n\n\n\nStep 4: <\/strong>Create the web.xml configuration file.<\/p>\n\n\n\n
<?xml version = \"1.0\" encoding = \"UTF-8\"?> \n<web-app xmlns:xsi = \"https:\/\/www.w3.org\/2001\/XMLSchema-instance\" \n xmlns = \"https:\/\/java.sun.com\/xml\/ns\/javaee\" \n xsi:schemaLocation=\"https:\/\/java.sun.com\/xml\/ns\/javaee \n https:\/\/java.sun.com\/xml\/ns\/javaee\/web-app_3_0.xsd\" \n id = \"WebApp_ID\" version = \"3.0\"> \n <display-name>User Management<\/display-name> \n <servlet> \n <servlet-name>Jersey RESTful Application<\/servlet-name> \n <servlet-class>org.glassfish.jersey.servlet.ServletContainer<\/servlet-class> \n <init-param> \n <param-name>jersey.config.server.provider.packages<\/param-name> \n <param-value>com.newproject<\/param-value> \n <\/init-param> \n <\/servlet> \n <servlet-mapping> \n <servlet-name>Jersey RESTful Application<\/servlet-name> \n <url-pattern>\/rest\/*<\/url-pattern> \n <\/servlet-mapping> \n<\/web-app>\n<\/pre>\n\n\n\n
How to Deploy the Project?<\/strong><\/h2>\n\n\n\n
- Request Verbs: <\/strong>It describes what to do with the resource. There are many verbs available like POST, PUT, GET, and DELETE. In https:\/\/www.abc.com\/employee-1, the web browser is issuing a GET verb because it wants to fetch the employee record details.<\/li>\n\n\n\n
![\"RESTful](\"https:\/\/lh4.googleusercontent.com\/0SD1ufci3cuz_BwPNjezwkw20N7TXHeF2c_tTYgw3AuSRiz4HLjq7iz7o8Rt0TQ3G-oOcdxAdCmCpPASp-jnifbL8R16sinLSWJ5kOnk8qf1ZSema5K1ByJH2qmhLzqCWuLZVuRl6mX4k8pYvg\" "\\"\\"")
<\/figure>\n","protected":false},"excerpt":{"rendered":"