Paramètres de matrice D'URL en fonction des paramètres de requête

-- trop important pour être relégué à la section des commentaires.--

Je ne suis pas sûr de ce qu'il y a de plus important avec les URL de matrix. Selon l'article sur le design du w3c que TBL a écrit, il s'agissait simplement d'une idée de design et il stipule explicitement que ce n'est pas une caractéristique du web. Des choses comme les URLs relatives ne sont pas implémentées quand on les utilise. Si vous voulez l'utiliser, c'est très bien; il n'y a tout simplement pas de façon standard de l'utiliser parce que ce n'est pas une norme. - Steve Pomeroy

So la réponse courte est, si vous avez besoin de RS à des fins commerciales, vous êtes mieux à l'aide du paramètre request.

En plus de Tim Sylvester asnwer j'aimerais donner un exemple de matrice de paramètres peuvent être traitées avec des JAX-RS .

1. Matix paramètres lors de la dernière ressource de l'élément

   http://localhost:8080/res/categories/objects;name=green
   

   vous pouvez y accéder en utilisant le @MatrixParam annotation

   @GET
   @Path("categories/objects")
   public String objects(@MatrixParam("name") String objectName) {
     return objectName;
   }
   

   réponse

   green
   

   mais comme le dit javadoc

   notez que la valeur d'annotation @MatrixParam fait référence à un nom d'un paramètre de matrice qui réside dans le dernier segment de chemin apparié de la structure Java annotée de chemin qui injecte la valeur du paramètre de matrice.

   ... ce qui nous amène au point 2

2. Matrice des paramètres au moyen d'une URL

   http://localhost:8080/res/categories;name=foo/objects;name=green
   

   vous pouvez accéder aux paramètres de matrice n'importe où en utilisant des variables de chemin et @PathParam PathSegment .

   @GET
   @Path("{categoryVar:categories}/objects")
   public String objectsByCatecory(@PathParam("categoryVar") PathSegment categorySegment, 
                                   @MatrixParam("name") String objectName) {
     MultivaluedMap<String, String> matrixParameters = categorySegment.getMatrixParameters();
     String categorySegmentPath = categorySegment.getPath();
     String string = String.format("object %s, path:%s, matrixParams:%s%n", objectName,
             categorySegmentPath, matrixParameters);
     return string;
   }
   

   réponse

   object green, path:categories, matrixParams:[name=foo]
   

   depuis les paramètres de la matrice sont fournis comme un MultivaluedMap vous pouvez accéder à chacun par

   List<String> names = matrixParameters.get("name");
   

   ou si vous n'avez besoin que du premier

   String name = matrixParameters.getFirst("name");
   

3. Obtenez tous les paramètres de la matrice comme un paramètre de la méthode

   http://localhost:8080/res/categories;name=foo/objects;name=green//attributes;name=size
   

   utilisez un List<PathSegment> pour les obtenir tous

   @GET
   @Path("all/{var:.+}")
   public String allSegments(@PathParam("var") List<PathSegment> pathSegments) {
     StringBuilder sb =  new StringBuilder();
   
     for (PathSegment pathSegment : pathSegments) {
       sb.append("path: ");
       sb.append(pathSegment.getPath());
       sb.append(", matrix parameters ");
       sb.append(pathSegment.getMatrixParameters());
       sb.append("<br/>");
     }
   
     return sb.toString();
   }
   

   réponse

   path: categories, matrix parameters [name=foo]
   path: objects, matrix parameters [name=green]
   path: attributes, matrix parameters [name=size]