Query spec does not define behaviour if both oslc.where and oslc.searchTerms is specified

XMLWordPrintable

    • Type: Task
    • Resolution: Unresolved
    • Priority: Major
    • Component/s: Query
    • None
    • Hide

      The specification should define that support for:
      1) oslc.where is a MAY
      2) oslc.searchTerms is a MAY
      3) oslc.where + oslc.search is a MAY
      4) at least one of #1 or #2 is a MUST.

      and that if a server does not implement #1, #2, or #2, that the server SHOULD respond with 501 Not Implemented with an oslc:Error response that describes what capability or capabilities are not supported.
      Describe that a server may choose to treat them as mutually exclusive and return 400 Bad Request if both are specified but not supported.

      Recommend that OSLC clients only use both where it knows a specific implementation supports both.

      Show
      The specification should define that support for: 1) oslc.where is a MAY 2) oslc.searchTerms is a MAY 3) oslc.where + oslc.search is a MAY 4) at least one of #1 or #2 is a MUST. and that if a server does not implement #1, #2, or #2, that the server SHOULD respond with 501 Not Implemented with an oslc:Error response that describes what capability or capabilities are not supported. Describe that a server may choose to treat them as mutually exclusive and return 400 Bad Request if both are specified but not supported. Recommend that OSLC clients only use both where it knows a specific implementation supports both.

      https://open-services.net/bin/view/Main/OSLCCoreSpecQuery defines the behaviour if both oslc.where and oslc.searchTerms is specified. That description could be referenced earlier in the document to answer a reader's obvious question when the terms are first mentioned.

      In practice, oslc.searchTerms is likely to be a free-text search performed by something like Lucene, whereas oslc.where will either be a SPARQL query or some form of SQL query. Many implementations might choose to support query but not free text search, or query and free text search separately, but mutually exclusive. How does a client discover this?

            Assignee:
            James Amsden (Inactive)
            Reporter:
            davidhoney
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated: