1 /*
2 * Conditions Of Use
3 *
4 * This software was developed by employees of the National Institute of
5 * Standards and Technology (NIST), an agency of the Federal Government.
6 * Pursuant to title 15 Untied States Code Section 105, works of NIST
7 * employees are not subject to copyright protection in the United States
8 * and are considered to be in the public domain.  As a result, a formal
9 * license is not needed to use the software.
10 *
11 * This software is provided by NIST as a service and is expressly
12 * provided "AS IS."  NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED
13 * OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF
14 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT
15 * AND DATA ACCURACY.  NIST does not warrant or make any representations
16 * regarding the use of the software or the results thereof, including but
17 * not limited to the correctness, accuracy, reliability or usefulness of
18 * the software.
19 *
20 * Permission to use this software is contingent upon your acceptance
21 * of the terms of this agreement
22 *
23 * .
24 *
25 */
26 package gov.nist.core.net;
27 
28 import java.net.InetAddress;
29 import java.net.UnknownHostException;
30 
31 import javax.sip.address.Hop;
32 
33 /**
34  * An interface that allows you to customize address lookup.
35  * The user can implement this interface to do DNS lookups or other lookup
36  * schemes and register it with the stack.
37  * The default implementation of the address resolver does nothing more than just return back
38  * the Hop that it was passed (fixing up the port if necessary).
39  * However, this behavior can be overriden. To override
40  * implement this interface and register it with the stack using
41  * {@link gov.nist.javax.sip.SipStackExt#setAddressResolver(AddressResolver)}.
42  * This interface will be incorporated into version 2.0 of the JAIN-SIP Specification.
43  *
44  * @since 2.0
45  *
46  *
47  * @author M. Ranganathan
48  *
49  */
50 public interface AddressResolver {
51 
52     /**
53      * Do a name lookup and resolve the given IP address.
54      * The default implementation is just an identity mapping
55      * (returns the argument).
56      *
57      * @param hop - an incoming Hop containing a potenitally unresolved address.
58      * @return a new hop ( if the address is recomputed ) or the original hop
59      * if this is just an identity mapping ( the default behavior ).
60      */
resolveAddress( Hop hop)61     public Hop resolveAddress( Hop hop);
62 
63 
64 
65 
66 
67 }
68