Setup

Download tomcat and place the folder mason-sample in the /webapps directory.

MySQL

Sample comes with MySQL Driver. You need a running mysql server on your localhost 👈. Run the SQL Script movie.sql to create the movie database.

JSP REST Resources

The JSPs representing the REST resources can be found inside the WEB_INF/resources directory separated by folders representing the version string.

The URL endpoint for the REST API created by each resource JSP is /{webappDirectoryName}/{version}/{resourceName}.

Example

For example, the endpoint for the resource file WEB_INF/resources/v1.0/customer.jsp shall be /{webappDirectoryName}/v1.0/customer. Assuming you deploy this webapp on Tomcat, you can make API request at

http://localhost:8080/mason-sample/v1.0/movie

You will get the following response.

{
  "getResult": [
    {
      "releaseDate": "2017-01-27 15:34:22.0",
      "name": "Reader",
      "rating": 3.1,
      "id": 1
    },
    {
      "releaseDate": "2017-01-27 15:34:22.0",
      "name": "The Dark Knight",
      "rating": 5,
      "id": 2
    },
    {
      "releaseDate": "2017-01-27 15:34:22.0",
      "name": "The Happening",
      "rating": 4,
      "id": 3
    },
    {
      "releaseDate": "2016-01-05 00:00:00.0",
      "name": "hi there;",
      "rating": 5.5,
      "id": 4
    }
  ]
}

You can create more resources in the same manner.

Database Connection

You can find the database connection in META-INF/context.xml file. This project uses HikariCP. You can checkout Tomcat's guide on DBCP configuration with MySQL or other databases.

Notes

Sample Java web application containing REST APIs developed using Mason REST API framework.