W3C home > Mailing lists > Public > public-ws-resource-access-notifications@w3.org > October 2009

[Bug 8072] New: Enum: inconsistency around invalid EnumContext

From: <bugzilla@wiggum.w3.org>
Date: Mon, 26 Oct 2009 14:28:17 +0000
To: public-ws-resource-access-notifications@w3.org
Message-ID: <bug-8072-2780@http.www.w3.org/Bugs/Public/>
http://www.w3.org/Bugs/Public/show_bug.cgi?id=8072

           Summary: Enum: inconsistency around invalid EnumContext
           Product: WS-Resource Access
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Enumeration
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: dug@us.ibm.com
         QAContact: public-ws-resource-access-notifications@w3.org


The Pull section says:
- - - - - - -
 The data source MUST fail the request and MUST generate the
wsen:InvalidEnumerationContext fault if the data source is able to determine
that the enumeration context is invalid for any reason including:

   1. Context replaced in the response to another Pull request
   2. Context completed (i.e. an EndOfSequence has been returned in a Pull
response)
   3. Context released
   4. Context expired 
- - - - - - -

Which is sort of ok.  However, later on the spec we talk about how data sources 
SHOULD fault requests messages that use an invalid Enum Context 
(See Renew for an example).

Proposal:
Modify any occurrence of the SHOULD with a MUST, in particular change:
- - - - - - -
If the enumeration context is not valid, either because it has been replaced in
the response to another Pull request, or because it has completed
(EndOfSequence has been returned in a Pull response), or because it has been
Released, or because it has expired, or because the data source has had to
invalidate the context, then the data source SHOULD fail the request, and if
so, MUST generate a wsen:InvalidEnumerationContext fault. 
- - - - - - -

to a much less annoying verbose paragraph:
- - - - - - -
If the enumeration context is not valid then the data source MUST generate 
a wsen:InvalidEnumerationContext fault.
- - - - - - -

At the same time I'd like to remove the reference in the Pull operation to
"failing requests". It is an impl choice whether to send the fault so to
be consistent with other specs we should just say what fault MUST be generated
and leave it at that.

So, change:
The data source MUST fail the request and MUST generate the
wsen:InvalidEnumerationContext fault...

to:
The data source MUST generate a wsen:InvalidEnumerationContext fault...


-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.
Received on Monday, 26 October 2009 14:28:22 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 26 October 2009 14:28:22 GMT