Jersey (JAX-RS) matrix URI parameters handling guide

URL with matrix URI looks like:;lat=50;long=20;scale=32000

;lat=50;long=20;scale=32000 represents matrix parameters. Please refer W3C article on it.

Using @MatrixParam annotation we can get matrix parameters value from API URI in Jersey Resources classes.

Using @MatrixParam at instance variable and method parameters

File :

package in.geekmj.resource;

import java.util.HashMap;
import java.util.Map;


public class MatrixUriResource {

* We can inject matrix URI parameter as an instance variables
* using @MatrixParam

private Integer latitude;

private Integer longitude;

/* We can inject matrix URI parameter method using @MatrixParam */
@SuppressWarnings({ "unchecked", "rawtypes" })
public Map getRequestCookie(@MatrixParam("scale") Integer scale, @MatrixParam("type") String type) {

Map matrixParams = new HashMap();
matrixParams.put("latitude", latitude);
matrixParams.put("longitude", longitude);
matrixParams.put("scale", scale);
matrixParams.put("type", type);
return matrixParams;

Testing https://localhost:8080/matrix-uri;lat=50;long=20;scale=32000;type=geo with Postman chrome plugin.

 API URI with matrix parameters handling in jersey


"latitude": 50,
"scale": 32000,
"type": "geo",
"longitude": 20


  1. To know more about Matrix URIs, click here.

  2. Official Jersey Documentation

  3. Download the Full Project

  4. Follow Project On Github

Leave a Comment

Your email address will not be published.