W3C home > Mailing lists > Public > public-ddwg-comments@w3.org > April 2008

DDR Simple API - getDataVersion method

From: JOSE MANUEL CANTERA FONSECA <jmcf@tid.es>
Date: Tue, 15 Apr 2008 12:43:20 +0200
To: "public-ddwg-comments@w3.org" <public-ddwg-comments@w3.org>
Message-id: <93AA9E47B82F684A868C217766F489050397FB9EF3@EXCLU2K7.hi.inet>
Regarding the method getDataVersion of the Service interface,

It is said

"Returns information about the underlying data (values for Properties) if the implementation has a versioning system for that information. If it does have a versioning system for data then this value must change between calls if the implementation can not guarantee that the data is the same. If the implementation does not support versioning of data then a SystemException should be thrown."

In the description of the method the word "if the implementation ..." appears in several occasions. This is a signal of a method that can be specific for some implementations but unneeded for others. Besides, it can be very hard to figure out if the underlying data has changed, for example if there are frequent updates to a database behind a DDR. Additionally there is no point knowing the data version as whole as it does not provide any kind of valuable information to the user of the API.

Proposed Amendment:

+ Remove the getDataVersion method of the Service interface
Received on Tuesday, 15 April 2008 10:44:07 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:41:40 UTC