org.mobicents.ext.javax.sip.dns

Interface DNSServerLocator

All Known Implementing Classes:

DefaultDNSServerLocator

public interface DNSServerLocator

Interface to implement for discovering servers according to RFC 3263 and/or ENUM support.

Author:

jean.deruelle@gmail.com

Method Summary

Methods

Modifier and Type	Method and Description
void	addLocalHostName(String localHostName) Adds a local host name for which the DNS lookups can be bypassed, by example if an URI is targeted at the local server
void	addSupportedTransport(String supportedTransport) Add a supported transport (UDP, TCP, TLS, SCTP) to the set of supported transports.
DNSLookupPerformer	getDnsLookupPerformer() Retrieve the DNSLookupPerformer performing the DNS lookups
javax.sip.address.SipURI	getSipURI(javax.sip.address.URI uri) From the uri passed in parameter, try to find the corresponding SipURI.
Queue<javax.sip.address.Hop>	locateHops(javax.sip.address.URI uri) Discovers servers according to RFC 3263 and/or ENUM support for the given uri passed in parameters
void	mapLocalHostNameToIP(String localHostName, Set<String> ipAddresses) Adds a local host name for which the DNS lookups that are bypassed DNSJava can resolve to a set of IP Addresses
void	removeLocalHostName(String localHostName) Removes a local host name for which the DNS lookups can be bypassed, by example if an URI is targeted at the local server
void	removeSupportedTransport(String supportedTransport) Remove a supported transport (UDP, TCP, TLS, SCTP) to the set of supported transports.
Queue<javax.sip.address.Hop>	resolveHostByAandAAAALookup(String hopHost, int hopPort, String hopTransport) Resolve Hostname to lookup IPAddresses corresponding to a given host including local Host Names as DNSJava is bypassing /etc/hosts
void	setDnsLookupPerformer(DNSLookupPerformer dnsLookupPerformer) Sets the DNSLookupPerformer to perform the DNS lookups
void	unmapLocalHostNameToIP(String localHostName) Removes a local host name to ip addresses mapping

Method Detail

locateHops

Queue<javax.sip.address.Hop> locateHops(javax.sip.address.URI uri)

Discovers servers according to RFC 3263 and/or ENUM support for the given uri passed in parameters

Parameters:

uri - the uri for which the DNS lookups have to be done

Returns:

a queue of Hop that have to be tried each one in turn.

resolveHostByAandAAAALookup

Queue<javax.sip.address.Hop> resolveHostByAandAAAALookup(String hopHost,
                                                       int hopPort,
                                                       String hopTransport)

Resolve Hostname to lookup IPAddresses corresponding to a given host including local Host Names as DNSJava is bypassing /etc/hosts

Parameters:

hopHost - hostname to lookup

hopPort - port if any (not useful for lookup, will just be added in the resulting Hop from the Queue)

hopTransport - transport if any (not useful for lookup, will just be added in the resulting Hop from the Queue)

Returns:

getSipURI

javax.sip.address.SipURI getSipURI(javax.sip.address.URI uri)

From the uri passed in parameter, try to find the corresponding SipURI. If the uri in parameter is already a SipURI without a user=phone param, it is just returned If the uri in parameter is a TelURL or SipURI with a user=phone param, the phone number is converted to a domain name then a corresponding NAPTR DNS lookup is done to find the SipURI

Usage Example

        
 try {
                URI uri = addressFactory.createTelURL("+12153208617");
                SipURI sipURI = dnsServerLocator.getSipURI(uri);
 } catch (ServletParseException e) {
                logger.error("Impossible to create the tel URL", e);
 }
 

Parameters:

uri - the uri used to find the corresponding SipURI

Returns:

the SipURI found through ENUM methods or the uri itself if the uri is already a SipURI without a user=phone param

addLocalHostName

void addLocalHostName(String localHostName)

Adds a local host name for which the DNS lookups can be bypassed, by example if an URI is targeted at the local server

Parameters:

localHostName - the name of the local host to add

removeLocalHostName

void removeLocalHostName(String localHostName)

Removes a local host name for which the DNS lookups can be bypassed, by example if an URI is targeted at the local server

Parameters:

localHostName - the name of the local host to remove

mapLocalHostNameToIP

void mapLocalHostNameToIP(String localHostName,
                        Set<String> ipAddresses)

Adds a local host name for which the DNS lookups that are bypassed DNSJava can resolve to a set of IP Addresses

Parameters:

localHostName - the name of the local host to add

ipAddresses - the list of ip addresses to map to that hostname

unmapLocalHostNameToIP

void unmapLocalHostNameToIP(String localHostName)

Removes a local host name to ip addresses mapping

Parameters:

localHostName - the name of the local host to remove

addSupportedTransport

void addSupportedTransport(String supportedTransport)

Add a supported transport (UDP, TCP, TLS, SCTP) to the set of supported transports. The supported transports are needed for supporting RFC 3263 in specific cases

Parameters:

supportedTransport - the supported transport to add

removeSupportedTransport

void removeSupportedTransport(String supportedTransport)

Remove a supported transport (UDP, TCP, TLS, SCTP) to the set of supported transports. The supported transports are needed for supporting RFC 3263 in specific cases

Parameters:

supportedTransport - the supported transport to remove

setDnsLookupPerformer

void setDnsLookupPerformer(DNSLookupPerformer dnsLookupPerformer)

Sets the DNSLookupPerformer to perform the DNS lookups

Parameters:

dnsLookupPerformer - the dnsLookupPerformer to set

getDnsLookupPerformer

DNSLookupPerformer getDnsLookupPerformer()

Retrieve the DNSLookupPerformer performing the DNS lookups

Returns:

the dnsLookupPerformer