René's URL Explorer Experiment

{"@context":"https://schema.org","@graph":[{"@type":"Article","@id":"https://examples.javacodegeeks.com/java-api-tutorial/#article","isPartOf":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/"},"author":{"name":"Shankar Mata","@id":"https://examples.javacodegeeks.com/#/schema/person/6ccfe029dad934ef487efab0cfa6ab41"},"headline":"Java API Tutorial","datePublished":"2020-10-26T09:00:00+00:00","dateModified":"2022-07-07T12:20:19+00:00","mainEntityOfPage":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/"},"wordCount":1189,"commentCount":1,"publisher":{"@id":"https://examples.javacodegeeks.com/#organization"},"image":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/#primaryimage"},"thumbnailUrl":"https://examples.javacodegeeks.com/wp-content/uploads/2012/12/java-logo.jpg","articleSection":["Core Java"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https://examples.javacodegeeks.com/java-api-tutorial/#respond"]}]},{"@type":"WebPage","@id":"https://examples.javacodegeeks.com/java-api-tutorial/","url":"https://examples.javacodegeeks.com/java-api-tutorial/","name":"Java API Tutorial - Java Code Geeks","isPartOf":{"@id":"https://examples.javacodegeeks.com/#website"},"primaryImageOfPage":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/#primaryimage"},"image":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/#primaryimage"},"thumbnailUrl":"https://examples.javacodegeeks.com/wp-content/uploads/2012/12/java-logo.jpg","datePublished":"2020-10-26T09:00:00+00:00","dateModified":"2022-07-07T12:20:19+00:00","description":"In this article, we will learn about Java API and working with Java API. We will discuss different types of API requests and what does REST API mean. We","breadcrumb":{"@id":"https://examples.javacodegeeks.com/java-api-tutorial/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https://examples.javacodegeeks.com/java-api-tutorial/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https://examples.javacodegeeks.com/java-api-tutorial/#primaryimage","url":"https://examples.javacodegeeks.com/wp-content/uploads/2012/12/java-logo.jpg","contentUrl":"https://examples.javacodegeeks.com/wp-content/uploads/2012/12/java-logo.jpg","width":150,"height":150,"caption":"Bipartite Graph"},{"@type":"BreadcrumbList","@id":"https://examples.javacodegeeks.com/java-api-tutorial/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://examples.javacodegeeks.com/"},{"@type":"ListItem","position":2,"name":"Java Development","item":"https://examples.javacodegeeks.com/category/java-development/"},{"@type":"ListItem","position":3,"name":"Core Java","item":"https://examples.javacodegeeks.com/category/java-development/core-java/"},{"@type":"ListItem","position":4,"name":"Java API Tutorial"}]},{"@type":"WebSite","@id":"https://examples.javacodegeeks.com/#website","url":"https://examples.javacodegeeks.com/","name":"Java Code Geeks","description":"Java Examples and Code Snippets","publisher":{"@id":"https://examples.javacodegeeks.com/#organization"},"alternateName":"JCG","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://examples.javacodegeeks.com/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https://examples.javacodegeeks.com/#organization","name":"Exelixis Media P.C.","url":"https://examples.javacodegeeks.com/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https://examples.javacodegeeks.com/#/schema/logo/image/","url":"https://examples.javacodegeeks.com/wp-content/uploads/2022/06/exelixis-logo.png","contentUrl":"https://examples.javacodegeeks.com/wp-content/uploads/2022/06/exelixis-logo.png","width":864,"height":246,"caption":"Exelixis Media P.C."},"image":{"@id":"https://examples.javacodegeeks.com/#/schema/logo/image/"},"sameAs":["https://www.facebook.com/javacodegeeks","https://x.com/javacodegeeks"]},{"@type":"Person","@id":"https://examples.javacodegeeks.com/#/schema/person/6ccfe029dad934ef487efab0cfa6ab41","name":"Shankar Mata","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https://examples.javacodegeeks.com/#/schema/person/image/","url":"https://examples.javacodegeeks.com/wp-content/uploads/2020/08/shankar.mata_-96x96.jpeg","contentUrl":"https://examples.javacodegeeks.com/wp-content/uploads/2020/08/shankar.mata_-96x96.jpeg","caption":"Shankar Mata"},"description":"Shankar works as a Lead Software Engineer in a leading company and has developed several applications. He is one of the decision makers for the design and architecture for all the applications in his team. He along with his team develop and deploy cloud native services. He had been working in the field of Java and cloud technologies. He is also Amazon and Microsoft certified solution architect for AWS and Azure respectively. He has done his Masters in Computer science from University of New Mexico, US and Bachelors from GITAM University India. He is also experienced in Angular Framework and developed several applications.","sameAs":["https://www.linkedin.com/in/mshankarrao/"],"url":"https://examples.javacodegeeks.com/author/shankar-mata/"}]}

{"@context":"http:\/\/schema.org","@type":"BreadcrumbList","@id":"#Breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"item":{"name":"Home","@id":"https:\/\/examples.javacodegeeks.com\/"}},{"@type":"ListItem","position":2,"item":{"name":"Java Development","@id":"https:\/\/examples.javacodegeeks.com\/category\/java-development\/"}},{"@type":"ListItem","position":3,"item":{"name":"Core Java","@id":"https:\/\/examples.javacodegeeks.com\/category\/java-development\/core-java\/"}}]}

{"@context":"http:\/\/schema.org","@type":"Article","dateCreated":"2020-10-26T11:00:00+02:00","datePublished":"2020-10-26T11:00:00+02:00","dateModified":"2022-07-07T15:20:19+03:00","headline":"Java API Tutorial","name":"Java API Tutorial","keywords":[],"url":"https:\/\/examples.javacodegeeks.com\/java-api-tutorial\/","description":"In this article, we will learn about Java API and working with Java API. We will discuss different types of API requests and what does REST API mean. We will also see an example of a REST API. You can","copyrightYear":"2020","articleSection":"Core Java","articleBody":"\nIn this article, we will learn about Java API and working with Java API. We will discuss different types of API requests and what does REST API mean. We will also see an example of a REST API.\n\n\n\nYou can also check this tutorial in the following video:\n\n\n\nJava Web Services Tutorial - video\n\n\n\n1. Java API\n\n\n\nAn API stands for Application Programming Interface, and it is an interface that allows communication between different applications using the packages it comprises. Java API comprises a collection of interfaces, classes, and packages. It helps us to use the packaged classes and interfaces to build our applications and supports reusability. Whenever we write any program in java, we use the Java API to do so. For example, we use JDBC API in java to connect to any database server to perform several transactions using java.\n\n\n\n2. How to use an API with Java\n\n\n\nIn Java, we use API to access other software applications and build java API's to allow other systems to access our resources. In other words, we can either create a client for an existing API or an API service to be used by others.\n\n\n\n2.1 As a Client(as an API consumer)\n\n\n\nIf we want to access an API, we build a java API client for accessing the API based on the rules and controls provided by the API developer. We can access resources that we want from another system using the API exposed\/provided by the other system.\n\n\n\n2.2 As an API provider\n\n\n\nWe create an API so that the other system can access our resources via the API exposed\/provided by us. To access our API, they have to follow the standards and rules set up and build an API client.\n\n\n\n3. Types of API Requests\n\n\n\nThere are various kinds of API request based on the operation need to be performed. The most commonly used APIs requests are \n\n\n\n3.1 GET\n\n\n\nGET is the most commonly used request and is used to get any resource from the server using an API. When a user requests an API using GET, the server returns the user's data if it is available on the server.\n\n\n\n3.2 POST \n\n\n\nThis request type adds or posts any new data to the server. When a user requests an API using POST, the server adds the data into its resource and returns the status of whether the posting was a success or a failure.\n\n\n\n3.3 PUT\n\n\n\nThis request type updates\/modifies the data on the server. When a user requests an API using PUT, then the server updates the data into its resource and returns the status whether the update was a success or a failure.\n\n\n\n3.4 DELETE\n\n\n\nThis request type deletes the data from the server. When a user requests an API using DELETE, then the server removes the data from the resource and returns the status of whether the delete was successful or a failure.\n\n\n\n4. What does REST mean\n\n\n\nREST stands for Representational State Transfer, and it's an architectural pattern that defines a set of rules for developing web-services. And the web services built using these constraints are called Restful web service.Rest APIs deal with client-server architecture and are stateless, meaning the server doesn't store states, and each request is separate and independent.\n\n\n\n5. Simple API in java\n\n\n\nWe can create a REST API in java using several ways. And one of the most common way to create the java REST API is using Jersey. Follow the steps below to create the simple REST API\n\n\n\n5.1 Creating the web project with maven\n\n\n\nThe first step for creating any application is to have a project. You can do that using any IDE(Integrated Development Tool). I will show the sample using the IntelliJ Idea IDE. You can choose any other as well like one of the alternatives is Eclipse IDE. After creating the maven project, please add the below code into your pom.xml file to get the required dependencies.\n\n\n\nMaven dependencies in pom.xml file\n\n\n\n<project xmlns=\"http:\/\/maven.apache.org\/POM\/4.0.0\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n  xsi:schemaLocation=\"http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/maven-v4_0_0.xsd\">\n  <modelVersion>4.0.0<\/modelVersion>\n\n  <groupId>demo.jcg.restapi<\/groupId>\n  <artifactId>demoRestAPI<\/artifactId>\n  <packaging>war<\/packaging>\n  <version>1.0-SNAPSHOT<\/version>\n  <name>demoRestAPI<\/name>\n\n  <url>http:\/\/maven.apache.org<\/url>\n  <repositories>\n\t\t<repository>\n\t\t\t<id>maven2-repository.java.net<\/id>\n\t\t\t<name>Java.net Repository for Maven<\/name>\n\t\t\t<url>http:\/\/download.java.net\/maven\/2\/<\/url>\n\t\t\t<layout>default<\/layout>\n\t\t<\/repository>\n\t<\/repositories>\n  <dependencies>\n    <dependency>\n\t\t<groupId>com.sun.jersey<\/groupId>\n\t\t<artifactId>jersey-server<\/artifactId>\n\t\t<version>1.19.4<\/version>\n\t<\/dependency>\n\t<dependency>\n\t\t<groupId>com.sun.jersey<\/groupId>\n\t\t<artifactId>jersey-core<\/artifactId>\n\t\t<version>1.19.4<\/version>\n\t<\/dependency>\n\t<dependency>\n\t\t<groupId>com.sun.jersey<\/groupId>\n\t\t<artifactId>jersey-servlet<\/artifactId>\n\t\t<version>1.19.4<\/version>\n\t<\/dependency>\n  <\/dependencies>\n  \n  <build>\n    <finalName>demoRestAPI<\/finalName>\n\t    <plugins>\n\t\t    <plugin>\n\t\t      <artifactId>maven-compiler-plugin<\/artifactId>\n\t\t        <configuration>\n\t\t          <source>1.8<\/source>\n\t\t          <target>1.8<\/target>\n\t\t        <\/configuration>\n\t\t    <\/plugin>\n\t  <\/plugins>\n  <\/build>\n<\/project>\n\n\n\n\n\nWith the above configuration, your project will have all the dependencies to create a REST API. \n\n\n\n5.2 Creating the java rest service class\n\n\n\nAfter having all the dependencies setup, we need to create the rest service class where we will write our API. Have a look into the code below\n\n\n\nRest service class\n\n\n\npackage demo.jcg.restapi;\n\nimport javax.ws.rs.GET;\nimport javax.ws.rs.Path;\nimport javax.ws.rs.PathParam;\n\n@Path(\"\/demo\")\npublic class RestAPIDemo\n{\n\t@GET\n\t@Path(\"\/{name}\")\n\tpublic String greetings(@PathParam(\"name\") String name)\n\t{\n\t\treturn  name.toUpperCase()+ \", from Java Code Geeks\";\n\t}\n}\n\n\n\n\n\nNow let's understand the class above, here the class RestAPIDemo is has used certain annotations which are\n\n\n\n@Path: This annotation makes your API's path into the server resource, i.e. specifies the URI using which this API can be accessed.\n\n\n\n@GET:  This annotation specifies the type of request that can be made to this method. As discussed above GET is used to get some resource from the REST API\n\n\n\n@PathParam: This annotation tells that the URI path contains a parameter that needs to be passed when accessing this API resource.\n\n\n\nIn the above program, we are exposing a GET method through our REST API, where the user will access the API by passing the name in the path param. They get the name appended with the greeting. For example \"Shankar, from Java Code Geeks\". All the annotations are coming from the Jersey API library used.\n\n\n\n5.3 Configuring the web.xml\n\n\n\nNow the final step before we can deploy our REST API, we need to do the configuration for our web.xml as shown below\n\n\n\nConfiguration for web.xml\n\n\n\n<!DOCTYPE web-app PUBLIC\n \"-\/\/Sun Microsystems, Inc.\/\/DTD Web Application 2.3\/\/EN\"\n \"http:\/\/java.sun.com\/dtd\/web-app_2_3.dtd\" >\n\n<web-app>\n\n  <display-name>Archetype Created Web Application<\/display-name>\n  \n  <servlet>\n\t\t<servlet-name>jersey-serlvet<\/servlet-name>\n\t\t<servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer<\/servlet-class>\n\t\t<init-param>\n\t\t     <param-name>com.sun.jersey.config.property.packages<\/param-name>\n\t\t     <param-value>demo.jcg.restapi<\/param-value>\n\t\t<\/init-param>\n\t\t<load-on-startup>1<\/load-on-startup>\n\t<\/servlet>\n \n\t<servlet-mapping>\n\t\t<servlet-name>jersey-serlvet<\/servlet-name>\n\t\t<url-pattern>\/*<\/url-pattern>\n\t<\/servlet-mapping>\n\t\n<\/web-app>\n\n\n\n\n\nIn the above web.xml file, we have to make sure that our servlet is added as Jersey's servlet container within the servlet-class tags.\n\n\n\ncom.sun.jersey.spi.container.servlet.ServletContainer\n\n\n\n5.4 Deploying our application\n\n\n\nThe final step to make our REST API running is to deploy the application into a server to serve the request made to this API.\n\n\n\nAdding a server in an IDE is very simple. For the above example, we use Apache Tomcat and then deploy the rest API into the server.\n\n\n\nNote: If you cannot add the server into the IDE due to some issues. We can directly place our war(Web-Archive) file inside the web apps folder of your tomcat server home directory. The war file is inside the target directory of our project.\n\n\n\nYou can download the tomcat server here\n\n\n\nCheck the final project structure of the project structure below\n\n\n\nProject structure of the REST API\n\n\n\n5.5 Testing your application\n\n\n\nOnce deployed, we can test our REST API in any browser using the URL http:\/\/localhost:8080\/demo\/Shankar. As we saw in the rest service class, the path \"demo\" is part of the REST API URL. The output is\n\n\n\nOutput of the rest call\n\n\n\n6. Summary\n\n\n\nIn this article, we saw what Java API is, how we can use APIs with Java. We looked at the different types of API requests and discussed the REST API. We also created a sample REST API and tested it.\n\n\n\n7. More articles\n\n\n\nJava Tutorial for Beginners150 Java Interview Questions and AnswersBest Way to Learn Java Programming OnlineDownload and Install Java Development Kit (JDK) 13\n\n\n\n8. Download the source code\n\n\n\nThis was the REST API example using java.\n\n\n\nDownload\nYou can download the full source code of this example here: Java API Tutorial\n\n\n\nLast updated on Apr. 28th, 2021\n","publisher":{"@id":"#Publisher","@type":"Organization","name":"Examples Java Code Geeks","logo":{"@type":"ImageObject","url":"\/wp-content\/uploads\/2013\/05\/JavaCodeGeeks-logo.png"},"sameAs":["https:\/\/feeds.feedburner.com\/examplesjavacodegeeks","https:\/\/www.facebook.com\/javacodegeeks","https:\/\/twitter.com\/javacodegeeks","https:\/\/www.linkedin.com\/groups\/3810709\/","https:\/\/www.youtube.com\/channel\/UCxoUc7Rar2q90Gu0nT2ffuQ","https:\/\/github.com\/javacodegeeks\/"]},"sourceOrganization":{"@id":"#Publisher"},"copyrightHolder":{"@id":"#Publisher"},"mainEntityOfPage":{"@type":"WebPage","@id":"https:\/\/examples.javacodegeeks.com\/java-api-tutorial\/","breadcrumb":{"@id":"#Breadcrumb"}},"author":{"@type":"Person","name":"Shankar Mata","url":"https:\/\/examples.javacodegeeks.com\/author\/shankar-mata\/"},"image":{"@type":"ImageObject","url":"https:\/\/examples.javacodegeeks.com\/wp-content\/uploads\/2012\/12\/java-logo.jpg","width":1200,"height":150}}