kodgemisi/servlet-url-mapper

A library helps to use multiple different URLs with one Servlet with ease.

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.kodgemisi:servlet-url-mapper:1.2.0'
	}

	dependencies {
		implementation("com.github.kodgemisi:servlet-url-mapper:1.2.0")
	}

	<dependency>
	    <groupId>com.github.kodgemisi</groupId>
	    <artifactId>servlet-url-mapper</artifactId>
	    <version>1.2.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.kodgemisi" % "servlet-url-mapper" % "1.2.0"


                            
    :dependencies [[com.github.kodgemisi/servlet-url-mapper "1.2.0"]]

Readme

Servlet Url Mapper

This small and non-invasive library is intended to be used in servlet-only environments where for some reasons developers are forced to use Servlet API directly (like in Atlassian plugin SDK).

In such servlet-only environments, this library helps to handle nested URL structures in one servlet.

Non-invasive: You don't need to use servlet url mapper in every servlet, you can use only in some of them.

Assume you have a ProductsServlet with /products, /products/* URL mapping. Then you would handle request like follows:

Traditional way

doGet method gets messy.

| URL | Method | Handling Method | |------------------------|--------|------------------------| | /products | GET | ProductsServlet#doGet | | /products/13 | GET | ProductsServlet#doGet | | /products/13/campaigns | GET | ProductsServlet#doGet | | /products | POST | ProductsServlet#doPost |

<br/>

Servlet URL Mapper way

You can use different methods for different URLs in the same servlet. You can even use another Class' method to handle requests.

| URL | Method | Handling Method | |------------------------|--------|------------------------| | /products | GET | ProductsServlet#list | | /products/13 | GET | ProductsServlet#show | | /products/13/campaigns | GET | CampaignsHelper#show | | /products | POST | ProductsServlet#create |

Quick start

Add the dependency

You should use jitpack to add this library as a dependency for Maven or Gradle (or others).

<repositories>
  <repository>
      <id>jitpack.io</id>
      <url>https://jitpack.io</url>
  </repository>
</repositories>

<dependency>
    <groupId>com.github.kodgemisi</groupId>
    <artifactId>servlet-url-mapper</artifactId>
    <version>1.2.0</version>
</dependency>

See https://jitpack.io/#kodgemisi/servlet-url-mapper

Extend your servlet from MappingServlet

public class MyServlet extends MappingServlet {
	//...
}

Register your url mappings via protected urlMappingRegistrar field from MappingServlet. You can do this either in constructor or in init method.

@WebServlet(urlPatterns = {"/products", "/products/"})
public class MyServlet extends MappingServlet {
  public MyServlet() {
      this.urlMappingRegistrar
      
             // matches GET request to "host/context-root/products"
             .get("/", this::list)

             // matches GET request to "host/context-root/products/all"
             .get("/all", this::list) // note that the same method can be used for multiple url mappings

             // matches GET request to "host/context-root/products/{id}"
             .get("/{id}", this::show)

             // matches POST request to "host/context-root/products"
             .post("/", this::create)

             // matches POST request to "host/context-root/products/{id}/address"
             .post("/{id}/address", AddressHelper::addAddress);
      // and so on...
  }

  // any access modifier can be used
  private void list(HttpServletRequest request, HttpServletResponse response, ServletUrl servletUrl) throws ServletException, IOException {
      // your code...
  }

  private void show(HttpServletRequest request, HttpServletResponse response, ServletUrl servletUrl) throws ServletException, IOException {
      Integer id = servletUrl.variable("id"); // this is parsed from url: /{id}
      // your code...
  }

  // and rest of your methods...
}

Java 8 usage remainder: Note that (assuming you have an AddressHelper class in your project) AddressHelper::addAddress usage implies that addAddress is a static method. You can use non-static methods by providing an object instead of Class name like addressHelper::addAddress assuming addressHelper is an object of AddressHelper class.

License and Copyright

All material in this library's repository is copyrighted by Kod Gemisi Ltd unless stated otherwise.

This library is subject to the terms of the Mozilla Public License, v. 2.0. You can find full license in license.txt file or at http://mozilla.org/MPL/2.0/ adress.

There is also an easy to understand version of the license.