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

RE: [API] Mistake on section

From: Rotan Hanrahan <rotan.hanrahan@mobileaware.com>
Date: Tue, 12 Aug 2008 18:01:48 +0100
Message-ID: <D89E87B15A5C124AAED358AB9B58285104BD34@mail2.mobileaware.com>
To: "JOSE MANUEL CANTERA FONSECA" <jmcf@tid.es>, <public-ddwg@w3.org>

Thanks Josť,
It will be observed that all of the polymorphic methods in the API differ only in their input parameters. This means the methods return the same data type and are capable of raising the same exceptions.
In the unique case of getPropertyValues(Evidence) this particular form of the polymorphic getPropertyValues method is technically permitted to raise the NameException but there are no circumstances in which doing so would be appropriate. However, to maintain the harmony with the rest of its siblings in the polymorphic set, it seems OK to leave it with the "throws NameException" signature.
A "fix" is unnecessary, assuming the design concept of polymorphism based solely on the input signature is accepted. But as this is a unique and unusual situation, it may be advised to document it in the implementation experience pages of the wiki. (This would also have the added benefit of avoiding any Process issues that would threaten to delay the specification.)


From: public-ddwg-request@w3.org on behalf of JOSE MANUEL CANTERA FONSECA
Sent: Tue 12/08/2008 08:53
To: public-ddwg@w3.org
Subject: [API] Mistake on section



On the current editor's draft there is a mistake [1] :


public PropertyValues getPropertyValues(Evidence evidence)

       throws NameException;


getPropertyValues should not raise NameException as it retrieves all known properties in all vocabularies.


If would be good if it could be fixed before the PR publication


Best Regards


[1] http://www.w3.org/2005/MWI/DDWG/drafts/api/080602#sec-Service-getPropertyValues-1


Received on Tuesday, 12 August 2008 17:06:02 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:00:16 UTC