messengerhop.java

It is Java for SIP phone

/*******************************************************************************
 * Product of NIST/ITL Advanced Networking Technologies Division (ANTD).        *
 *******************************************************************************/
package gov.nist.applet.phone.ua.router;

import java.util.StringTokenizer;

/** 
 * Routing algorithms return a list of hops to which the request is
 * routed.
 *
 * @version  JAIN-SIP-1.1 $Revision: 1.2 $ $Date: 2004/04/22 22:50:32 $
 *
 * @author M. Ranganathan <[e-mail]>  <br/>
 *
 * <a href="{@docRoot}/uncopyright.html">This code is in the public domain.</a>
 *
 * IPv6 Support added by Emil Ivov ([e-mail])<br/>
 * Network Research Team (http://www-r2.u-strasbg.fr))<br/>
 * Louis Pasteur University - Strasbourg - France<br/>
 *
 */
public class MessengerHop extends Object implements javax.sip.address.Hop {
	protected String host;
	protected int port;
	protected String transport;
	protected boolean explicitRoute; // this is generated from a ROUTE header.
	protected boolean defaultRoute; // This is generated from the proxy addr
	protected boolean uriRoute; // This is extracted from the requestURI.

	/**
	 * Debugging println.
	 */
	public String toString() {
		return host + ":" + port + "/" + transport;
	}

	/**
	 * Create new hop given host, port and transport.
	 * @param hostName hostname
	 * @param portNumber port
	 * @param trans transport
	 */
	public MessengerHop(String hostName, int portNumber, String trans) {
		host = hostName;
		port = portNumber;
		transport = trans;
	}

	/**
	 * Creates new Hop
	 * @param hop is a hop string in the form of host:port/Transport
	 * @throws IllegalArgument exception if string is not properly formatted or null.
	 */
	public MessengerHop(String hop) throws IllegalArgumentException {
		if (hop == null)
			throw new IllegalArgumentException("Null arg!");
		// System.out.println("hop = " + hop);
		StringTokenizer stringTokenizer = new StringTokenizer(hop + "/");
		String hostPort = stringTokenizer.nextToken("/").trim();
		transport = stringTokenizer.nextToken().trim();
		// System.out.println("Hop: transport = " + transport);
		if (transport == null)
			transport = "UDP";
		else if (transport == "")
			transport = "UDP";
		if (transport.compareToIgnoreCase("UDP") != 0
			&& transport.compareToIgnoreCase("TCP") != 0) {
			System.out.println("Bad transport string " + transport);
			throw new IllegalArgumentException(hop);
		}

		String portString = null;
		//IPv6 hostport
		if (hostPort.charAt(0) == '[') {
			int rightSqBrackIndex = hostPort.indexOf(']');
			if (rightSqBrackIndex == -1)
				throw new IllegalArgumentException("Bad IPv6 reference spec");

			host = hostPort.substring(0, rightSqBrackIndex + 1);

			int portColon = hostPort.indexOf(':', rightSqBrackIndex);
			if (portColon != -1)
				try {
					portString = hostPort.substring(portColon + 1).trim();
				} catch (IndexOutOfBoundsException exc) {
					//Do nothing - handled later
				}
		}
		//IPv6 address and no port
		else if (hostPort.indexOf(':') != hostPort.lastIndexOf(":")) {
			host = '[' + hostPort + ']';
		} else //no square brackets and a single or zero colons => IPv4 hostPort
			{
			int portColon = hostPort.indexOf(':');
			if (portColon == -1)
				host = hostPort;
			else {
				host = hostPort.substring(0, portColon).trim();
				try {
					portString = hostPort.substring(portColon + 1).trim();
				} catch (IndexOutOfBoundsException exc) {
					//Do nothing - handled later
				}
			}
		}

		if (host == null || host.equals(""))
			throw new IllegalArgumentException("no host!");
		if (portString == null || portString.equals("")) {
			port = 5060;
		} else {
			try {
				port = Integer.parseInt(portString);
			} catch (NumberFormatException ex) {
				throw new IllegalArgumentException("Bad port spec");
			}
		}
	}

	/**
	 * Retruns the host string.
	 * @return host String
	 */
	public String getHost() {
		return host;
	}

	/**
	 * Returns the port.
	 * @return port integer.
	 */
	public int getPort() {
		return port;
	}

	/** returns the transport string.
	 */
	public String getTransport() {
		return transport;
	}

	/** Return true if this is an explicit route (ie. extrcted from a ROUTE
	 * Header)
	 */
	public boolean isExplicitRoute() {
		return explicitRoute;
	}

	/** Return true if this is a default route (ie. next hop proxy address)
	 */
	public boolean isDefaultRoute() {
		return defaultRoute;
	}

	/** Return true if this is uriRoute
	 */
	public boolean isURIRoute() {
		return uriRoute;
	}

	/** Set the URIRoute flag.
	 */
	public void setURIRouteFlag() {
		uriRoute = true;
	}

	/** Set the defaultRouteFlag.
	 */
	public void setDefaultRouteFlag() {
		defaultRoute = true;
	}

	/** Set the explicitRoute flag.
	 */
	public void setExplicitRouteFlag() {
		explicitRoute = true;
	}
	
	/**
	 * Set the host of the router
	 * @param host - host of the router
	 */
	public void setHost(String host){
		if(host!=null)    		
			this.host=host;
	}
	/**
	 * Set the port of the router
	 * @param port - port of the router
	 */
	public void setPort(int port){
		if(port>0)    		
			this.port=port;
	}
	/**
	 * Set the transport of the router
	 * @param host - transport of the router
	 */
	public void setTransport(String transport){
		if(transport!=null)    		
			this.transport=transport;
	}
}