users@jax-rs-spec.java.net

[jax-rs-spec users] [jsr339-experts] Should only UriBuilder build methods have an optional encodePathSlash parameter ?

From: Sergey Beryozkin <sberyozkin_at_talend.com>
Date: Mon, 3 Dec 2012 11:05:19 +0000

I'm looking at implementing UriBuilder.replaceTemplate methods and the
fact that one of the methods accepts 'encodePathSlash' makes it
ambiguous given that the final UriBuilder build() will also accept an
optional encodePathSlash.

I've also checked the docs at [1]


It sort of protects against the case where this final variation of
build() is given a null array. Is empty array acceptable ? If yes then
at the build time we can get an ambiguity issue -
UriBuilder.replaceTemplate requested that one of the path vars should be
treated as per 'encodePathSlash' parameter value, while later, at the
build time, the user just requests the opposite...

IMHO, either [1] should have empty arrays blocked too or only build()
methods should have 'encodePathSlash' parameters

Does it make sense ?

Sergey

[1]
http://jax-rs-spec.java.net/nonav/2.0-SNAPSHOT/apidocs/javax/ws/rs/core/UriBuilder.html#build(java.lang.Object[],%20boolean)