sipurl.java

来自「结构非常清晰的SIP协议栈」· Java 代码 · 共 266 行

/*
 * Copyright (C) 2005 Luca Veltri - University of Parma - Italy
 * 
 * This file is part of MjSip (http://www.mjsip.org)
 * 
 * MjSip is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * MjSip is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with MjSip; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 * 
 * Author(s):
 * Luca Veltri ([e-mail])
 */

package org.zoolu.sip.address;


import org.zoolu.sip.provider.SipParser;
import org.zoolu.tools.Parser;
import java.util.Vector;


/**
<P> Class <i>SipURL</i> implements SIP URLs.
<P> A SIP URL is a string of the form of:
<BR><BLOCKQUOTE><PRE>&nbsp&nbsp sip:[user@]hostname[:port][;parameters] </PRE></BLOCKQUOTE>
<P> If <i>port</i> number is ommitted, -1 is returned
*/
public class SipURL
{
   protected String url;
   
   protected static final String transport_param="transport"; 
   protected static final String maddr_param="maddr"; 
   protected static final String ttl_param="ttl"; 
   protected static final String lr_param="lr"; 

   /** Creates a new SipURL based on a hostname or on a sip url as sip:[user@]hostname[:port][;param1=value1].. */
   public SipURL(String sipurl)
   {  if (sipurl.startsWith("sip:")) url=new String(sipurl);
      else url="sip:"+sipurl;
   }

   /** Creates a new SipURL */
   public SipURL(String username, String hostname)
   {  init(username,hostname,-1);
   }

   /** Creates a new SipURL */
   public SipURL(String hostname, int portnumber)
   {  init(null,hostname,portnumber);
   }

   /** Creates a new SipURL */
   public SipURL(String username, String hostname, int portnumber)
   {  init(username,hostname,portnumber);
   }

   /** Inits the SipURL */
   private void init(String username, String hostname, int portnumber)
   {  StringBuffer sb=new StringBuffer("sip:");
      if (username!=null) sb.append(username).append('@');
      sb.append(hostname);
      if (portnumber>0) sb.append(":"+portnumber);
      url=sb.toString();
   }

   /** Creates and returns a copy of the URL */
   public Object clone()
   {  return new SipURL(url);
   }

   /** Indicates whether some other Object is "equal to" this URL */
   public boolean equals(Object obj)
   {  SipURL newurl=(SipURL)obj;
      return url.toString().equals(newurl.toString());
   }

   /** Gets user name of SipURL (Returns null if user name does not exist) */
   public String getUserName()
   {  int begin=4; // skip "sip:"
      int end=url.indexOf('@',begin);
      if (end<0) return null;
         else return url.substring(begin,end);
   }

   /** Gets host of SipURL */
   public String getHost()
   {  char[] host_terminators={':',';','?'};
      Parser par=new Parser(url);
      int begin=par.indexOf('@'); // skip "sip:user@"
      if (begin<0) begin=4; // skip "sip:"
         else begin++; // skip "@"
      par.setPos(begin);
      int end=par.indexOf(host_terminators);
      if (end<0) return url.substring(begin);
         else return url.substring(begin,end);
   }

   /** Gets port of SipURL; returns -1 if port is not specidfied */
   public int getPort()
   {  char[] port_terminators={';','?'};
      Parser par=new Parser(url,4); // skip "sip:"
      int begin=par.indexOf(':');
      if (begin<0) return -1;
      else
      {  begin++;
         par.setPos(begin);
         int end=par.indexOf(port_terminators);
         if (end<0) return Integer.parseInt(url.substring(begin));
         else return Integer.parseInt(url.substring(begin,end));
      }
   }

   /** Gets boolean value to indicate if SipURL has user name */
   public boolean hasUserName()
   {  return getUserName()!=null;
   }

   /** Gets boolean value to indicate if SipURL has port */
   public boolean hasPort()
   {  return getPort()>=0;
   }

   /** Whether two SipURLs are equals */
   public boolean equals(SipURL sip_url)
   {  return (url==sip_url.url);
   }


   /** Gets string representation of URL */
   public String toString()
   {  return url;
   }

   /** Gets the value of specified parameter.
     * @return null if parameter does not exist. */
   public String getParameter(String name) 
   {  SipParser par=new SipParser(url);
      return ((SipParser)par.goTo(';').skipChar()).getParameter(name);
   }
   
   
   /** Gets a String Vector of parameter names.
     * @return null if no parameter is present */
   public Vector getParameters() 
   {  SipParser par=new SipParser(url);
      return ((SipParser)par.goTo(';').skipChar()).getParameters();
   }
   
   /** Whether there is the specified parameter */
   public boolean hasParameter(String name)
   {  SipParser par=new SipParser(url);
      return ((SipParser)par.goTo(';').skipChar()).hasParameter(name);
   }
   
   /** Whether there are any parameters */
   public boolean hasParameters()
   {  if (url!=null && url.indexOf(';')>=0) return true;
      else return false;
   }
   
   /** Adds a new parameter without a value */
   public void addParameter(String name) 
   {  url=url+";"+name;       
   }
   
   /** Adds a new parameter with value */
   public void addParameter(String name, String value) 
   {  if (value!=null) url=url+";"+name+"="+value;
      else url=url+";"+name;       
   }

   /** Removes all parameters (if any) */
   public void removeParameters() 
   {  int index=url.indexOf(';');
      if (index>=0) url=url.substring(0,index);      
   }

   /** Removes specified parameter (if present) */
   public void removeParameter(String name) 
   {  int index=url.indexOf(';');
      if (index<0) return;
      Parser par=new Parser(url,index);
      while (par.hasMore())
      {  int begin_param=par.getPos();
         par.skipChar();
         if (par.getWord(SipParser.param_separators).equals(name))
         {  String top=url.substring(0,begin_param); 
            par.goToSkippingQuoted(';');
            String bottom="";
            if (par.hasMore()) bottom=url.substring(par.getPos()); 
            url=top.concat(bottom);
            return;
         }
         par.goTo(';');
      }
   }


   /** Gets the value of transport parameter.
     * @return null if no transport parameter is present. */
   public String getTransport() 
   {  return getParameter(transport_param);
   }  
   /** Whether transport parameter is present */
   public boolean hasTransport()
   {  return hasParameter(transport_param);
   }
   /** Adds transport parameter */
   public void addTransport(String proto) 
   {  addParameter(transport_param,proto.toLowerCase());
   }


   /** Gets the value of maddr parameter.
     * @return null if no maddr parameter is present. */
   public String getMaddr() 
   {  return getParameter(maddr_param);
   }  
   /** Whether maddr parameter is present */
   public boolean hasMaddr()
   {  return hasParameter(maddr_param);
   }
   /** Adds maddr parameter */
   public void addMaddr(String maddr) 
   {  addParameter(maddr_param,maddr);
   }


   /** Gets the value of ttl parameter.
     * @return 1 if no ttl parameter is present. */
   public int getTtl() 
   {  try {  return Integer.parseInt(getParameter(ttl_param));  } catch (Exception e) {  return 1;  }
   }  
   /** Whether ttl parameter is present */
   public boolean hasTtl()
   {  return hasParameter(ttl_param);
   }
   /** Adds ttl parameter */
   public void addTtl(int ttl) 
   {  addParameter(ttl_param,Integer.toString(ttl));
   }


   /** Whether lr (loose-route) parameter is present */
   public boolean hasLr()
   {  return hasParameter(lr_param);
   }
   /** Adds lr parameter */
   public void addLr() 
   {  addParameter(lr_param);
   }
}