On Jul 2, 2008, at 9:51 AM, Stephan Koops wrote:
>>> you are right, the current javadoc says nothing what should happen
>>> with @Path(value="{abc}/def", limited=false). If I remeber right,
>>> the limited is only checked for trailing variables, so it is
>>> ignored in this example. Marc, perhaps you could defines explicit,
>>> that the limited attribute is ignored for all not trailing
>>> template variables.
>> Its already pretty explicit in the javadoc:
>>
>> https://jsr311.dev.java.net/nonav/javadoc/javax/ws/rs/
>> Path.html#limited()
> I mean to add a sentence like "Template variables not at the end of
> the path are not affected". I didn't understand this right, and if I
> understood James right, he also didn't understand it right.
> For wide used specificatiosn it is IMO better to make things a
> little bit too clear than to less clear.
>
I strive for conciseness. Which part of "Controls whether a trailing
template variable is limited to a single path segment (true) or not
(false)." isn't clear ? Would adding "Has no effect if value does not
end with a template variable." clear up the confusion ?
Marc.
---
Marc Hadley <marc.hadley at sun.com>
CTO Office, Sun Microsystems.