Current media-types note [1] Section 3.1 indicates that the
expectedMediaType annotation is only a hint:
Applications that need to specify expected media types SHOULD use the
schema annotation to declare the range of expected values. The
annotation should be considered only as a hint.
The second statement is misleading with the one that preceeds it. While
the media-types document makes no recommendation whether the content
must be valid with respect to the attribute declaration per resolution
of Issues 198 [2] and Issue 199 [2], stating that it is a hint does not
promote its use for applications that need to enable data binding based
on the expected media type. For example, data binding specifications,
such as JAXRPC/JAXB, may be able to consume the annotation for
providing stronger data binding based on the media type, if needed.
Therefore, we propose to resolve this problem by removing the sentence
Applications that need to specify expected media types SHOULD use the
schema annotation to declare the range of expected values.
[1] http://www.w3.org/TR/xml-media-types/
[2]
http://dev.w3.org/cvsweb/%7Echeckout%7E/2002/ws/desc/issues/wsd-issues.html#x198
[3]
http://dev.w3.org/cvsweb/%7Echeckout%7E/2002/ws/desc/issues/wsd-issues.html#x199
--
Umit Yalcinalp
Consulting Member of Technical Staff
ORACLE
Phone: +1 650 607 6154
Email: umit.yalcinalp@oracle.com