Chapter 7. @MatrixParam

Matrix parameters are an arbitrary set of name-value pairs embedded in a URI path segment. An example of a matrix parameter is:

GET http://host.com/library/book;name=EJB 3.0;author=Bill Burke

Matrix parameters represent resources that can be addressed by their attributes as well as their raw ID. The @MatrixParam annotation lets you injext URI matrix parameters into your method invocation.

   @GET
   public String getBook(@MatrixParam("name") String name, @MatrixParam("author") String author) {...}

One limitation with @MatrixParam is that the current version of the specification does not resolve. If, for example, the same MatrixParam exists simultaneously in different path segments, at present we recommend using PathParam combined with PathSegment.