This is a simple application that aims to create a REST full web services using embedded tomcat and jersey, for configuration information use yml file. This application also uses jsp and freemarker template that is rendered through REST api call. It mainly focuses to register the object instance to ResourceConfig instead of registering class.

• Tomcat v8.x
• Jersey v2.5.1
• JSP
• YML
• Freemarker
• HTML/Angular/JavaScript

Application creates two tomcat context path. one for REST full api end point is /api and another one for web page is /webapp that is directly load from tomcat webapp base directory location /src/main/webapp.

File base = new File("src/main/webapp");
Context context = tomcat.addContext("/api", base.getAbsolutePath());
tomcat.addWebapp(null, "/webapp", base.getAbsolutePath());

This application uses a yml file for application configuration. First read configuration.yml file and pass the configuration to application.

#configuration.yml
#setting server configuration
server:
  port: 9292

#configure user name
user: "eigenharsha"

ResourceConfig is an extension of JAX-RS Application class but it provides some registration methods to make registering resources and providers more friendly. This applciation registered resource through class instance using public ResourceConfig register(Object component).

JspMvcFeature and FreemarkerMvcFeature used for jsp and freemarker template, html/angular/javascript directly loaded in web browser.

final ResourceConfig config = new ResourceConfig()
    .packages(Main.class.getPackage().getName())
    .register(new Resource(new Core(), configuration)) // create instance of Resource and dynamically register
    .register(JspMvcFeature.class) // register jspMVC
    .register(FreemarkerMvcFeature.class) // register FreemarkerMVC
    .property(ServletProperties.FILTER_FORWARD_ON_404, true);

return new ServletContainer(config);

An in-depth tutorial for Programmatic API for Building Resources is available here.

This project requires maven.

$ git clone https://github.com/eigenharsha/jersey-mvc-jsp-freemarker-with-embedded-tomcat.git
$ cd jersey-mvc-jsp-freemarker-with-embedded-tomcat
$ mvn clean install

I created a Procfile for deploying on Heroku. An in-depth tutorial for deploying on Heroku is available here.

$ web: sh target/bin/webapp

When this application be deployed then we will be able to access this REST services

Questions or suggestions? Please don't hesitate to email me at [email protected]