sipservlet-spec
  1. sipservlet-spec
  2. SIPSERVLET_SPEC-40

Javadoc for SipFactory.createURI is misleading

    Details

    • Type: Bug Bug
    • Status: Resolved
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 2.0-pfd
    • Labels:
      None

      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.

        Activity

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

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

        Show
        binod added a comment - I agree with the statement. It look like a typo in the javadoc.

          People

          • Assignee:
            binod
            Reporter:
            keith-lewis
          • Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: