Getting Started with Java API’s

The Java API Web Service Cheap Seats

Where does it all start to get rocking with cool Java API Web Services?

Technology: API | JSON | REST | HTTP

API – Application Programming Interface, a set of programming instructions and standards for accessing a Web-based software application or Web tool. A company releases its API to the public so that other software developers can design products that are powered by its service

JSON – Javascript Object Notion, is a syntax for storing and exchanging data. JSON uses JavaScript syntax, but the JSON format is text only, just like XML. Is a primary data format used for asynchronous browser/server communication

REST – Representational State Transfer, an Architecture Style by decoupling architecture of API’s from Business Logic with a stateless uniform interface. RESTful systems typically, but not always, communicate over Hypertext Transfer Protocol (HTTP) with the same HTTP verbs (GET, POST, PUT, DELETE, etc.) which web browsers use to retrieve web pages and to send data to remote servers

HTTP – Hypertext Transfer Protocol, the most common protocol for communication of digital content. In the case of API’s, it allows us to Get (Retrieve a resource), POST (Create a resource), PUT (Update a resource), DELETE (Delete a resource)

Products: Java | Eclipse | Maven | Tomcat | Jersey | Swagger



  1. You will need both the Java SDK and the Java Run-Time as a foundation for all the technology to work together as this contains the libraries and execution layers. As of April 2015, the JDK 7 will no longer provide updates however Oracle is in the process of migrating users from Java 7 to Java 8 through the auto update feature which took place after the January 2015 CPU release.
  2. First, download and installations the two components for getting started.



We need something we can interact with to write code or drag and drop using some sort of IDE. Eclipse is a very common tool for Java developers, to build Java EE and Web applications, including a Java IDE, tools for Java EE, JPA, JSF, Mylyn, EGit and others.

Getting Started with Eclipse:



The Apache Maven is a tool that can be used for building and managing any Java-based project. This tool can be leveraged by Eclipse to store the developer projects.

Maven’s primary goal is to allow a developer to comprehend the complete state of a development effort in the shortest period of time

Maven – Download Apache Maven

It is strongly recommended to use the latest release version of Apache Maven to take advantage of newest features and bug fixes.



Tomcat 9 will be needed to serving up content via HTTP within a browser. This can run locally on your PC or on a virtual server.

Apache Tomcat™ is an open source software implementation of the Java Servlet, JavaServer Pages, Java Expression Language and Java WebSocket technologies. It also is an open software developed by the ASF or Apache Software Foundation. Designed to broker the web-serving features of JavaServer Pages. Allows integration of servlets through Java Servlet technology.


Developing RESTful Web services that seamlessly support exposing your data in a variety of representation media types and abstract away the low-level details of the client-server communication is not an easy task without a good toolkit. In order to simplify development of RESTful Web services and their clients in Java, a standard and portable JAX-RS API has been designed


Swagger is a simple yet powerful representation of your RESTful API. With the largest ecosystem of API tooling on the planet, thousands of developers are supporting Swagger in almost every modern programming language and deployment environment. With a Swagger-enabled API, you get interactive documentation, client SDK generation and discoverability


Leave a Reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Blog at

Up ↑

%d bloggers like this: