[jax-rs-spec users] [jsr339-experts] Re: UriBuilder, forward slashes, path and segments

From: Bill Burke <>
Date: Tue, 05 Jun 2012 11:52:09 -0400

On 6/4/12 1:59 PM, Markus KARG wrote:
> Bill,
> when you're finished with being pissed-off, swearing and self-portrayal
> please let me know, so we can come back to the technical discussion. You
> misinterpreted my words and just read what you liked or assumed to read.

I may have misinterpreted you, but my interpretation is pretty much
biased by previous exchanges with you. What I do apologize for is for
forgetting that buildFromEncoded() existed as a method. If I had
remembered, I could have avoided most of this thread.

> I never complained that anybody here is political or not having enough
> insight.

My whole point was that many of us "vendors" deal with both "clever" and
"not-so-clever" JAX-RS users on a daily basis.

> About the slash: If you do not want to encode the slash, either use path()
> or buildFromEncoded(). Neither of these will encode. But build() *must*
> encode, as build() provides CONTENT and CONTENT MUST BE ENCODED ALWAYS. If
> you want a slash, the sole reason can be that you DO NOT WANT CONTENT. So do
> not use build().

build() and buildFromEncoded() need to have Javadoc reflecting the
special treatment of '/'. build() needs to say it encodes '/',
buildFromEncoded() needs to say it doesn't encode '/'.

Bill Burke
JBoss, a division of Red Hat