[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Updated: (OBIX-4) Chapter 11 "Watches" - add support for transient (or non-persistent) watches
[ http://tools.oasis-open.org/issues/browse/OBIX-4?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Craig Gemmill updated OBIX-4:
------------------------------
Description:
Add the following text:
The client can either 1) periodically poll the Watch URI using the pollChanges operation to obtain the events which have occurred since the last poll or 2) if the Watch was created with the makePush operation the updates will be pushed to the client as they occur as long as the connection is open.
WatchService is then composed of two operations:
<obj href="obix:WatchService">
<op name="make" in="obix:Nil" out="obix:Watch"/>
<op name="makePush" in="obix:Nil" out="obix:Watch"/>
</obj>
WatchService.makePush creates a transient watch which will be deleted on disconnection of the client.
For an Watch object which was created by this operation the existing Watch operations have following semantics:
1) Watch.add: as the existing
2) Watch.remove: as the existing
3) Watch.pollChanges: will throw an err
4) Watch.pollRefresh: will throw an err
5) Watch.delete: will throw an err
Proposal: (was: Add the following text:
The client can either 1) periodically poll the Watch URI using the pollChanges operation to obtain the events which have occurred since the last poll or 2) if the Watch was created with the makePush operation the updates will be pushed to the client as they occur as long as the connection is open.
WatchService is then composed of two operations:
<obj href="obix:WatchService">
<op name="make" in="obix:Nil" out="obix:Watch"/>
<op name="makePush" in="obix:Nil" out="obix:Watch"/>
</obj>
WatchService.makePush creates a transient watch which will be deleted on disconnection of the client.
For an Watch object which was created by this operation the existing Watch operations have following semantics:
1) Watch.add: as the existing
2) Watch.remove: as the existing
3) Watch.pollChanges: will throw an err
4) Watch.pollRefresh: will throw an err
5) Watch.delete: will throw an err
)
I moved the text in "Proposal" to "Description" since this is a desired change to the spec, and Proposal would be our proposed solution to the issue of "this behavior is needed".
I suggest this one needs some further TC discussion time. We need to resolve:
* Are we trying to get the WebSockets binding out as part of the 1.1 document group?
* Are we agreed that the WebSockets binding doc as currently proposed is ready for PR? It seemed at last discussion that this was not as mature as the other docs, so I'm not sure we're ready to put these changes into the core spec.
Seeking additional TC input here...
> Chapter 11 "Watches" - add support for transient (or non-persistent) watches
> ----------------------------------------------------------------------------
>
> Key: OBIX-4
> URL: http://tools.oasis-open.org/issues/browse/OBIX-4
> Project: OASIS Open Building Information Exchange (oBIX) TC
> Issue Type: Improvement
> Components: OBIX 1.1 Specification
> Affects Versions: oBIX 1.1 PR01
> Environment: Matthias Hub
> Reporter: Toby Considine
> Assignee: Craig Gemmill
> Fix For: oBIX 1.1 PR01
>
>
> Add the following text:
> The client can either 1) periodically poll the Watch URI using the pollChanges operation to obtain the events which have occurred since the last poll or 2) if the Watch was created with the makePush operation the updates will be pushed to the client as they occur as long as the connection is open.
> WatchService is then composed of two operations:
> <obj href="obix:WatchService">
> <op name="make" in="obix:Nil" out="obix:Watch"/>
> <op name="makePush" in="obix:Nil" out="obix:Watch"/>
> </obj>
> WatchService.makePush creates a transient watch which will be deleted on disconnection of the client.
> For an Watch object which was created by this operation the existing Watch operations have following semantics:
> 1) Watch.add: as the existing
> 2) Watch.remove: as the existing
> 3) Watch.pollChanges: will throw an err
> 4) Watch.pollRefresh: will throw an err
> 5) Watch.delete: will throw an err
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]