<chapter id="_MatrixParam">
<title>@MatrixParam</title>

<note>
   <para>
      RESTEasy <link linkend="_NewParam">supports <code>@MatrixParam</code> annotations with no parameter name.</link>.
   </para>
</note>

<para>

The idea of matrix parameters is that they are an arbitrary set of name-value pairs embedded in a uri path segment.
A matrix parameter example is:
</para>
<para>

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

The idea of matrix parameters is that it represents resources that are addressable by their
   attributes as well as their raw id.  The @MatrixParam annotation allows URI matrix parameters
   to be injected into a method invocation.
</para>
<para>

<programlisting>
@GET
public String getBook(@MatrixParam("name") String name, @MatrixParam("author") String author) {...}
</programlisting>
</para>
<para>

There is one big problem with @MatrixParam that the current version of the specification does
   not resolve.  What if the same MatrixParam exists twice in different path segments?  In
   this case, it is better to use PathParam combined with PathSegment.
</para>
<para>

</para>
<para>

</para>
<para>


</para>
</chapter>
