OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: RE: [odata] [OASIS Issue Tracker] (ODATA-1171) Consider using matrix parameters for filter segments

The use of ";" was defined as a param rule in clause 3.3 Path Component of rfc2396.  That rule is deprecated in rfc3986 and replaced with a more relaxed syntax.  So... still available and should be supported.
The one issue with both formats is that a query portion ("?") is not required.  The query portion is a trigger that suggests/requires the response not be cached.  Can we say that any URI that uses characters from the sub-delims rule should also not be cached?


-----Original Message-----
From: odata@lists.oasis-open.org [mailto:odata@lists.oasis-open.org] On Behalf Of OASIS Issues Tracker
Sent: Thursday, April 05, 2018 7:55 PM
To: odata@lists.oasis-open.org
Subject: [odata] [OASIS Issue Tracker] (ODATA-1171) Consider using matrix parameters for filter segments

Michael Pizzo created ODATA-1171:

             Summary: Consider using matrix parameters for filter segments
                 Key: ODATA-1171
                 URL: https://issues.oasis-open.org/browse/ODATA-1171
             Project: OASIS Open Data Protocol (OData) TC
          Issue Type: Bug
          Components: Protocol, URL Conventions
    Affects Versions: V4.01_CS01
            Reporter: Michael Pizzo
             Fix For: V4.01_CS02

In 4.01 CS01, we introduced the ability to insert a filter into a path using a $filter=@predicat segment (where @predicate is a query string parameter).

It turns out, the facility to append parameter information to a segment was defined many years ago using "matrix parameters" -- basically, a matrix parameter is a way to add a parameter to a path segment using a semi-colon (and, in many cases, can be used instead of a query string parameter, which is exactly the scenario we are trying to enable).

4.01 CS01 syntax:
   Customers/$filter=@q?$@q=name eq 'Smith'
Matrix parameter syntax:
   Customers;$filter=@q?$@q=name eq 'Smith'

Advantages of using matrix parameters:
1) Not inventing something new
2) May already be supported by some systems
3) Similar to syntax for nested expand (and now select) options

This message was sent by Atlassian JIRA

To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail.  Follow this link to all your TCs in OASIS at:

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]