Tham số ma trận URL so với tham số truy vấn

Tôi đang tự hỏi nên sử dụng ma trận hoặc tham số truy vấn trong URL của mình. Tôi tìm thấy một cuộc thảo luận cũ hơn cho chủ đề đó không thỏa mãn.

Ví dụ

• URL với thông số truy vấn: http: //some.where/thing? ParamA = 1 & paramB = 6542
• URL có tham số ma trận: http: //some.where/thing; paramA = 1; paramB = 6542

Thoạt nhìn ma trận params dường như chỉ có lợi thế:

• dễ đọc hơn
• không yêu cầu mã hóa và giải mã "&" trong tài liệu XML
• URL có "?" không được lưu trữ trong nhiều trường hợp; Các URL có tham số ma trận được lưu trữ
• tham số ma trận có thể xuất hiện ở mọi nơi trong đường dẫn và không giới hạn ở phần cuối của nó
• tham số ma trận có thể có nhiều hơn một giá trị: paramA=val1,val2

Nhưng cũng có những nhược điểm:

• chỉ một vài khung như tham số ma trận hỗ trợ JAX-RS
• Khi trình duyệt gửi biểu mẫu qua GET, thông số sẽ trở thành thông số truy vấn. Vì vậy, nó kết thúc trong hai loại tham số cho cùng một nhiệm vụ. Để không gây nhầm lẫn cho người dùng dịch vụ REST và hạn chế nỗ lực cho các nhà phát triển dịch vụ, sẽ dễ dàng hơn khi sử dụng luôn truy vấn params - trong lĩnh vực này.

Vì nhà phát triển dịch vụ có thể chọn một khung có hỗ trợ ma trận param, nên nhược điểm duy nhất còn lại là các trình duyệt được tạo bởi các tham số truy vấn mặc định.

Có bất kỳ nhược điểm nào khác không? Bạn sẽ làm gì?

Sự khác biệt quan trọng là các tham số ma trận áp dụng cho một phần tử đường dẫn cụ thể trong khi các tham số truy vấn áp dụng cho toàn bộ yêu cầu. Điều này phát huy tác dụng khi thực hiện một truy vấn kiểu REST phức tạp tới nhiều cấp tài nguyên và tài nguyên phụ:

http://example.com/res/categories;name=foo/objects;name=green/?page=1

Nó thực sự đi xuống không gian tên.

Lưu ý: 'cấp độ' tài nguyên ở đây là categoriesvà objects.

Nếu chỉ các tham số truy vấn được sử dụng cho URL đa cấp, bạn sẽ kết thúc bằng

http://example.com/res?categories_name=foo&objects_name=green&page=1

Bằng cách này, bạn cũng sẽ mất đi sự rõ ràng được thêm vào bởi địa phương của các tham số trong yêu cầu. Ngoài ra, khi sử dụng một khung như JAX-RS, tất cả các tham số truy vấn sẽ hiển thị trong mỗi trình xử lý tài nguyên, dẫn đến xung đột và nhầm lẫn tiềm ẩn.

Nếu truy vấn của bạn chỉ có một "cấp độ", thì sự khác biệt không thực sự quan trọng và hai loại tham số có thể thay thế cho nhau một cách hiệu quả, tuy nhiên, các tham số truy vấn thường được hỗ trợ tốt hơn và được công nhận rộng rãi hơn. Nói chung, tôi khuyên bạn nên gắn bó với các tham số truy vấn cho những thứ như biểu mẫu HTML và API HTTP đơn cấp, đơn giản.

Ngoài câu trả lời của Tim Sylvester, tôi muốn cung cấp một ví dụ về cách xử lý các tham số ma trận với JAX-RS .

1. Các tham số ma trận ở phần tử tài nguyên cuối cùng

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

   Bạn có thể truy cập chúng bằng cách sử dụng @MatrixParamchú thích

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

   Phản ứng

   green

   Nhưng giống như các quốc gia Javadoc

   Lưu ý rằng @MatrixParamgiá trị chú thích đề cập đến tên của một tham số ma trận nằm trong phân đoạn đường dẫn phù hợp cuối cùng của cấu trúc Java có chú thích Đường dẫn tiêm giá trị của tham số ma trận.

   ... điều gì đưa chúng ta đến điểm 2

2. Các tham số ma trận ở giữa một URL

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

   Bạn có thể truy cập các tham số ma trận bất cứ nơi nào bằng cách sử dụng các biến đường dẫn và @PathParam PathSegment.

   @GET
   @Path("{categoryVar:categories}/objects")
   public String objectsByCategory(@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;
   }
   

   Phản ứng

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

   Vì các tham số ma trận được cung cấp dưới dạng MultivaluedMapbạn có thể truy cập từng

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

   hoặc nếu bạn chỉ cần cái đầu tiên

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

3. Nhận tất cả các tham số ma trận làm một tham số phương thức

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

   Sử dụng một List<PathSegment>để có được tất cả

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

   Phản ứng

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

--Too quan trọng để được xuống hạng để bình luận .--

Tôi không chắc vấn đề lớn với URL ma trận là gì. Theo bài viết thiết kế w3c mà TBL đã viết, đó chỉ là một ý tưởng thiết kế và tuyên bố rõ ràng rằng đó không phải là một tính năng của web. Những thứ như URL tương đối không được triển khai khi sử dụng nó. Nếu bạn muốn sử dụng nó, điều đó tốt; không có cách tiêu chuẩn nào để sử dụng nó vì nó không phải là một tiêu chuẩn. - Steve Pomeroy

Vì vậy, câu trả lời ngắn gọn là, nếu bạn cần RS cho mục đích kinh doanh, tốt hơn hết bạn nên sử dụng tham số yêu cầu.