Awesome

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 <a href="https://github.com/brettwooldridge/HikariCP" target="_blank">HikariCP</a>. You can checkout Tomcat's guide on DBCP configuration with MySQL or other databases.

Notes

Sample Java web application containing REST APIs developed using <a href="https://github.com/metamug/mason" target="_blank">Mason</a> REST API framework.