Skip to main content

[JIRA] Commented: (SIPSERVLET_SPEC-14) SIP DNS/Tel ENUM Resolver

  • From: "binod (JIRA)" < >
  • To:
  • Subject: [JIRA] Commented: (SIPSERVLET_SPEC-14) SIP DNS/Tel ENUM Resolver
  • Date: Mon, 18 Nov 2013 09:27:49 +0000 (UTC)
  • Auto-submitted: auto-generated


    [ 
https://java.net/jira/browse/SIPSERVLET_SPEC-14?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=370866#action_370866
 ] 

binod commented on SIPSERVLET_SPEC-14:
--------------------------------------

Here is a proposal for the same. 


/**
 * Interface encapsulating DNS resolution. It resolves a {@code TelURL} or a 
{@code SipURI} that contains
 * telephone numbers to SipURIs.
 *
 * <p>An instance of this interface can be accessed through the 
<code>ServletContext</code>
 * parameter named <code>javax.servlet.sip.DnsResolver</code> or it can be 
injected
 * using the @Resource or @Inject annotations.
 *
 * @since 2.0
 */
public interface DnsResolver {

    /**
     * Get string representation of a {@code TelURL} or a {@code SipURI} in 
ENUM format, per RFC 6116.
     *
     * @param uri a {@code TelURL} or {@code SipURI} with a user=phone 
parameter
     * @return ENUM formatted string.
     * @throws IllegalArgumentException if the {@code uri} is null or does 
not represent a telephone number
     */
    String toEnum(URI uri);

    /**
     * Resolve a {@code TelURL} or a {@code SipURI} with user=phone parameter
     * to a SIP URI according to the procedures specified in RFC 3824 and RFC 
6116.
     * Only SIP enumservice ("E2U+SIP") will be used for resolution. If there 
are
     * multiple NAPTR records matching the SIP enum service, it returns the 
SIP URI
     * with highest precedence by order and preference of NAPTR records.
     *
     * @param uri a {@code TelURL} or {@code SipURI} with a user=phone 
parameter
     * @return Resolved SIP URI or null, if there is no resolved SIP URI.
     * @throws java.io.IOException if the DNS resolution fails.
     * @throws IllegalArgumentException if the {@code uri} is null or does 
not represent a telephone number
     */
    SipURI resolveToSipURI(URI uri);

    /**
     * Resolve a {@code TelURL} or a {@code SipURI} with user=phone parameter
     * to SIP URIs according to the procedures specified in RFC 3824 and RFC 
6116.
     * Only SIP enumservice ("E2U+SIP") will be used for resolution. The 
returned
     * Sip URIs are ordered first by order and then by preference of the 
NAPTR records.
     *
     * @param uri a {@code TelURL} or {@code SipURI} with a user=phone 
parameter
     * @return Resolved SIP URIs or empty list, if there is no resolved SIP 
URI.
     * @throws java.io.IOException if the DNS resolution fails.
     * @throws IllegalArgumentException if the {@code uri} is null or does 
not represent a telephone number
     */
    List<SipURI> resolveToSipURIs(URI uri);

    /**
     * Resolve a {@code TelURL} or a {@code SipURI} with user=phone parameter
     * to URIs according to the procedures specified in RFC 6116 for the
     * specified enum service. The enum services are listed in RFC 6118.
     * The returned URIs are ordered first by order and then by preference
     * of the NAPTR records.
     *
     * @param uri a {@code TelURL} or {@code SipURI} with a user=phone 
parameter
     * @param enumService Name of the enum service. Eg: "E2U+pres"  or 
"E2U+email"
     * @return Resolved URIs as strings or empty list, if there is no 
resolved URI.
     * @throws java.io.IOException if the DNS resolution fails.
     * @throws IllegalArgumentException if the {@code uri} is null or does 
not represent a telephone number
     */
    List<String> resolveToStrings(URI uri, String enumService);



> SIP DNS/Tel ENUM Resolver
> -------------------------
>
>                 Key: SIPSERVLET_SPEC-14
>                 URL: https://java.net/jira/browse/SIPSERVLET_SPEC-14
>             Project: sipservlet-spec
>          Issue Type: New Feature
>            Reporter: deruelle_jean
>            Assignee: binod
>
> Allows for applications to perform DNS/ENUM queries to resolve a SIP Or 
> TelURI to use the results in a SIP Message or share the corresponding 
> SIPURi in a Web Page, ...

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
https://java.net/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        


[JIRA] Commented: (SIPSERVLET_SPEC-14) SIP DNS/Tel ENUM Resolver

binod (JIRA) 11/18/2013
 
 
Close
loading
Please Confirm
Close