[SIPSERVLET_SPEC-40] Javadoc for SipFactory.createURI is misleading Created: 04/Mar/14  Updated: 24/Nov/14  Resolved: 24/Nov/14

Status: Resolved
Project: sipservlet-spec
Component/s: None
Affects Version/s: None
Fix Version/s: 2.0-pfd

Type: Bug Priority: Major
Reporter: keith-lewis Assignee: binod
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   

The createURI method must be called with a string that is an escaped URI - such as might be found in a SIP header.
This is clearly stated in the first sentence of the javadoc.

Confusingly the Javadoc then goes on to include the following sentence

If the specified URI string contains any reserved characters, then the container is responsible for escaping them, in accordance with RFC2396.

In fact the container should do the opposite - if it encounters any escaped characters in the string it should unescape them. The various getters on URI and its sub-interfaces should return unescaped strings.



 Comments   
Comment by binod [ 07/Mar/14 ]

I agree with the statement. It look like a typo in the javadoc.

Comment by binod [ 24/Nov/14 ]

https://sipservlet-spec.java.net/javadoc/2.0/draft/javax/servlet/sip/SipFactory.html#createURI%28java.lang.String%29

Generated at Sat Mar 28 22:21:43 UTC 2015 using JIRA 6.2.3#6260-sha1:63ef1d6dac3f4f4d7db4c1effd405ba38ccdc558.