/* * This file was derived from libdissipate, an open source SIP library. The original file  * was modified on 1/23/2001.  Please see * http://www.div8.net/dissipate for more information. * * Copyright (c) 2000 Billy Biggs <bbiggs@div8.net> * * * This library is free software; you can redistribute it and/or modify it * under the terms of the GNU Library General Public License as published by * the Free Software Foundation; either version 2 of the License, or (at your * option) any later version. *  * This library 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 Library General Public * License for more details. *  * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB.  If not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, * MA 02111-1307, USA. * *//** * class SipCallMember *  * Object to reference a member of a call.  Contains the remote URI, their * current Contact URI, and their current status in the call.  It also contains * their current session description, and a copy of our local session * description for this call leg. * * This class also provides an API for modifying call state to this member of * the call, such as sending an invitation to join the session, or accepting a * call. */package org.mitre.jsip;import java.awt.Toolkit;import org.mitre.jsip.event.*;public class SipCallMember extends Object{    /**     * Creates a new member for this call with the given URI.  Initially,     * this sets the Contact URI for the call member to be the same.     * @param parent     * @param uri     */    public SipCallMember(SipCall parent, SipUri uri)    {	call = parent;	memberuri = uri;	contacturi = uri;	local = null;	remote = null;	status = Disconnected;	parent.addMember( this );    }    /**     * Returns the current status of the call member.     *     * @return Status     */    public int getStatus()    { return status; }    /**     * Returns the most recent session description provided by the member      * for sending media to them.     *     * @return String     */    public String getSessionDescription()    { return sessiondesc; }    /**     * Returns the MIME Content Type of the session description provided by     * the call member.  If none was provided, this function returns NULL.     * @return MimeContentType     */    public MimeContentType getSessionDescriptionType()    { return sessiontype; }    /**     * Returns the most recently sent local session description.  Provided     * for reference.     * @return String     */    public String getLocalSessionDescription()    { return localsessiondesc; }    /**     * Returns the MIME Content Type of the most recently sent local     * session description.     * @return MimeContentType     */    public MimeContentType getLocalSessionDescriptionType()    { return localsessiontype; }    /**     * Returns a text description of our current status.  Basically, this     * is the text from the response line of the last message we received,     * or a text description of what we're currently doing or waiting for.     * Useful for showing the user what is going on.     * @return String     */    public String getLocalStatusDescription()    { return statusdesc; }    /**     * Returns the most recent message body we received that was not a     * session description.     * @return String     */    public String getMostRecentMessageBody()    { return recentbody; }        /**     * Returns the MIME type of the most recent message body we received     * that was not a session description.     * @return MimeContentType     */    public MimeContentType getMostRecentMessageBodyType()    { return recentbodytype; }    /**     * Sends a SIP INVITE request, asking the member to join in the session     * described in the given body.  The body and MIME type provided will     * become the new local session description for this call member.     */       public void requestInvite( String body, MimeContentType bodytype )   {    if ( local != null ) {	//      local.cancelRequest();	local = null;      //      disconnect( local, 0, this, 0 );    }    if ( body != null ) {      localsessiondesc = body;      localsessiontype = bodytype;    }    if ( status == Connected ) {      status = ReInviteRequested;      statusdesc = "Requesting session update";    } else {      status = InviteRequested;      statusdesc = "Requesting remote end to join session";    }    local = call.newRequest( this, Sip.INVITE, body, bodytype );    // *** LOOK AT ***    //connect( local, statusUpdated(), this, localStatusUpdated() );    //statusUpdated();    //    localStatusUpdated();  }  /**   * Sends a SIP BYE request to disconnect the session.   */    public void requestDisconnect( String body, MimeContentType bodytype )  {    if ( status == Disconnected ) return;    if ( local != null ) {	//      local.cancelRequest();	local = null;      //      disconnect( local, 0, this, 0 );    }    status = Disconnecting;    statusdesc = "Disconnecting";    local = call.newRequest( this, Sip.BYE, body, bodytype );    // *** LOOK AT ***    //connect ( local, statusUpdate(), this, localStatusUpdated() );    //statusUpdated();    localStatusUpdated();  }  /**   * Disconnects the session with a request to transfer to another party.   */  public void requestTransfer( SipUri transferto, String body, MimeContentType bodytype )  {    if ( status == Disconnected ) return;    if ( local != null ) {	//      local.cancelRequest();	local = null;      //      disconnect( local, 0, this, 0 );    }    status = Disconnecting;    statusdesc = "Transfering";    local = call.newRequest( this, Sip.BYE, body, bodytype, transferto );    // **** LOOK AT ****    //connect( local, statusUpdated(), this, localStatusUpdated() );    //statusUpdated();    localStatusUpdated();  }    /**     * Sends a MESSAGE request     */    public void requestMessage( String messageBody )    {	if ( local != null ) {	    //	    local.cancelRequest();	    local = null;	}	statusdesc = "Sending message";	status = MessageRequested;	MimeContentType bodytype = new MimeContentType( "text/plain" );	local = call.newRequest( this, Sip.MESSAGE, messageBody, bodytype );		//	localStatusUpdated();    }  /**   * Sends a SIP OPTIONS request, asking the member what they support.   * The body and MIME type provided serve no known purpose at this time.   * The response to the OPTIONS request will become the new remote   * session description, so this should not be called on an active call.   * It is provided here for consistency.   */  public void requestOptions( String body, MimeContentType bodytype )   {    if ( local != null ) {	//      local.cancelRequest();	local = null;      //      disconnect( local, 0, this, 0 );    }    statusdesc = "Querying options";    local = call.newRequest( this, Sip.OPTIONS, body, bodytype );    // *** LOOK AT ***    //connect( local, statusUpdated(), this, localStatusUpdated() );    //statusUpdated();    localStatusUpdated();  }  /**   * Accepts the invitation to join the session sent by the call member.   * The body and MIME type provided will become the new local session   * description for this call member.   */  public void acceptInvite( String body, MimeContentType bodytype )   {    if ( remote == null ) return;    if ( body != null ) {      localsessiondesc = body;      localsessiontype = bodytype;    }    remote.sendResponse( new SipStatus( 200 ), body, bodytype );    status = Connected;    statusdesc = "Connected";    //statusUpdated();    localStatusUpdated();  }  /**   * Declines the invitation to join the session sent by the call member.   * The body and MIME type provided are for possibly giving a reason as   * to why the call was declined.   */  public void declineInvite( String body, MimeContentType bodytype )   {    if ( remote == null ) return;    remote.sendResponse( new SipStatus( 603 ), body, bodytype );    status = Disconnected;    statusdesc = "Rejecting call invitation";    //statusUpdated();    localStatusUpdated();  }  /**   * Returns the URI for this call member.   *   * @return SipUri &   */  public SipUri getUri()  { return memberuri; }  /**   * Returns the current Contact URI for this call member.   *   * @return SipUri &   */  public SipUri getContactUri()  { return contacturi; }  /**   * Sets the Contact URI for this call member.   *   * @param newcontact   */  public void setContactUri(SipUri newcontact)  {    contacturi = newcontact;  }  /**   * Updates the URI for this call member.   *   * @param newuri   */  public void setUri(SipUri newuri)  {    memberuri = newuri;  }  /**   * Returns the list of URIs where we were redirected.   *   * @return SipUriList &   */  public SipUriList getRedirectList()  { return redirectlist; }  /**   * This signal is sent whenever the status of this call member has changed.   *   */      //private void statusUpdated() {    // SipCall.statusUpdated();    //}  /**   * localStatusUpdated   */  void localStatusUpdated()  {    MimeContentType mtype;        if( local == null ) {      if (SipClient.DEBUG) System.out.println( "SipCallMember: Received what was likely a retransmission, badly ignoring..." );      return;    }    if (SipClient.DEBUG) System.out.println( "SipCallMember: localStatusUpdated: " + local.getStatus().getCode() );    mtype = local.getFinalContentType();    if( mtype.type().equals( "application/sdp" ) ) {      sessiondesc = local.getFinalMessageBody();      localsessiontype = mtype;    } else {      recentbody = local.getFinalMessageBody();      recentbodytype = mtype;    }    if( status == InviteRequested || status == ReInviteRequested ) {      if( local.wasCancelled() ) {	status = Disconnected;	statusdesc = "Request cancelled";	local = null;      } else if( local.getStatus().getCode() < 200 ) {	statusdesc = local.getStatus().getReasonPhrase();      } else if( local.getStatus().getCode() < 300 ) {	status = Connected;	statusdesc = "Connected: " + local.getStatus().getReasonPhrase();	local = null;      } else if( local.getStatus().getCode() < 400 ) {	status = Redirected;	statusdesc = "Redirected: " + local.getStatus().getReasonPhrase();	redirectlist = local.getFinalContactList();	local = null;      } else {	status = Disconnected;	statusdesc = "Call Failed: " + local.getStatus().getReasonPhrase();	local = null;      }    } else if( status == Disconnecting ) {      if( local.getStatus().getCode() >= 200 ) {	status = Disconnected;	statusdesc = "Response: " + local.getStatus().getReasonPhrase();	local = null;      }    } else {      if( local.getStatus().getCode() >= 200 ) {	statusdesc = "Response: " + local.getStatus().getReasonPhrase();	local = null;      }    }    //statusUpdated();  }  /**   * remoteStatusUpdated   */  void remoteStatusUpdated()  {    if( status == RequestingInvite ) {      if( remote.wasCancelled() ) {	status = Disconnected;	statusdesc = "Request cancelled";	//statusUpdated();      }    }  }  /**   * incomingTransaction   * @param newtrans   */  void incomingTransaction(SipTransaction  newtrans)  {      MimeContentType mtype;            remote = newtrans;      if( remote.getRequest().getMethod() == Sip.INVITE ) {	  	  // *** LOOK AT ***	  //connect( remote, statusUpdated(), this, remoteStatusUpdated() );	  	  if( status == Disconnected ) {	      status = RequestingInvite;	      statusdesc = "Invitation received";	      remote.sendResponse( new SipStatus( 180 ) );	  } else {	      status = RequestingReInvite;	      statusdesc = "Session update requested";	  }	  	  mtype = remote.getRequestMessageContentType();	  if( ( mtype != null ) && ( mtype.type().equals( "application/sdp" ) ) ) {	      sessiontype = mtype;	      sessiondesc = remote.getRequestMessageBody();	  } else {	      recentbodytype = mtype;	      recentbody = remote.getRequestMessageBody();	  }		  // send a CallEvent here to notify the user of the request	  if (SipClient.DEBUG) System.out.println("Sending CallEvent request ");	  CallListener callListener = SipClient.getSipClient().getCallListener();	  if ( callListener != null ) {	      //	      Toolkit.getDefaultToolkit().getSystemEventQueue().postEvent( new CallEvent( SipClient.getSipClient(), remote.getRequest(), CallEvent.CALLREQUEST_ID ) );	      CallEvent ce = new CallEvent( SipClient.getSipClient(), remote.getRequest(), CallEvent.CALLREQUEST_ID );	      callListener.requestReceived( ce );	  }      } else if( remote.getRequest().getMethod() == Sip.BYE ) {	  	  status = Disconnected;	  statusdesc = "Remote end disconnected";	        }            // statusUpdated();      remoteStatusUpdated(); // I think  }      SipUri memberuri;  SipUri contacturi;  int status;  SipCall   call;  SipTransaction   local;  SipTransaction   remote;  SipUriList redirectlist;  String sessiondesc;  MimeContentType sessiontype;  String localsessiondesc;  MimeContentType localsessiontype;  String statusdesc;  String recentbody;  MimeContentType recentbodytype;  // class variables   static final int Disconnected = 0;  static final int InviteRequested = 1;  static final int ReInviteRequested = 2;  static final int RequestingInvite = 3;  static final int RequestingReInvite = 4;  static final int Redirected = 5;  static final int Connected = 6;  static final int Disconnecting = 7;    static final int MessageRequested = 8;  }