Parámetros de matriz URL vs. parámetros de solicitud

Too Demasiado importante para ser relegado a la sección de comentarios.--

No estoy seguro de cuál es el gran problema con las URL de matriz. Según el artículo de diseño del w3c que TBL escribió, era solo una idea de diseño y afirma explícitamente que no es una característica de la web. Cosas como las URL relativas no se implementan cuando se usan. Si quieres usarlo, está bien; simplemente no hay una forma estándar de usarlo porque no es un estándar. - Steve Pomeroy

Así que la respuesta corta es, si necesita RS para propósito comercial, es mejor usar el parámetro de solicitud.

Además de Tim Sylvester asnwer Me gustaría proporcionar un ejemplo de cómo los parámetros de matriz se pueden manejar con JAX-RS .

1. Parámetros Matix en el último elemento de recurso

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

   Puede acceder a ellos utilizando el @MatrixParam anotación

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

   Respuesta

   green
   

   Pero como los estados javadoc

   Observe que el valor de anotación @MatrixParam se refiere al nombre de un parámetro de matriz que reside en el último segmento de ruta coincidente de la estructura Java con anotaciones de ruta que inyecta el valor del parámetro de matriz.

   ... lo que nos lleva al punto 2

2. Parámetros de matriz en medio de una URL

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

   Puede acceder a los parámetros de la matriz en cualquier lugar utilizando variables de ruta y @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;
   }
   

   Respuesta

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

   Dado que los parámetros de la matriz se proporcionan como un MultivaluedMap puede acceder a cada uno por

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

   O si solo necesita el primero

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

3. Obtenga todos los parámetros de la matriz como un parámetro de método

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

   Use un List<PathSegment> para obtenerlos todos

   @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();
   }
   

   Respuesta

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