DDR Simple API - getDataVersion method

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