mirror of https://github.com/sipwise/jitsi.git
Transfers a Call upon receiving a REFER request. The new Call being referred to/created as part of the transfer is still not displayed in the UI.
Lyubomir Marinov
17 years ago
parent
c1bf31bad2
commit
bbfcbea0ec
@ -0,0 +1,255 @@
|
||||
/*
|
||||
* SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
|
||||
*
|
||||
* Distributable under LGPL license.
|
||||
* See terms of license at gnu.org.
|
||||
*/
|
||||
package net.java.sip.communicator.impl.protocol.sip;
|
||||
|
||||
import java.util.*;
|
||||
import javax.sip.*;
|
||||
|
||||
/**
|
||||
* Implements utility methods to aid the manipulation of {@link Dialog}
|
||||
* instances and extend the mentioned type with additional functionality.
|
||||
*
|
||||
* @author Lubomir Marinov
|
||||
*/
|
||||
public final class DialogUtils
|
||||
{
|
||||
|
||||
/**
|
||||
* Associates a specific subscription with the a given <code>Dialog</code>
|
||||
* in order to allow it to keep the dialog in question alive even after a
|
||||
* BYE request.
|
||||
*
|
||||
* @param dialog the <code>Dialog</code> to associate the subscription with
|
||||
* and to be kept alive after a BYE request because of the
|
||||
* subscription
|
||||
* @param subscription the subscription to be associated with
|
||||
* <code>dialog</code> and keep it alive after a BYE request
|
||||
* @return <tt>true</tt> if the specified subscription was associated with
|
||||
* the given dialog; <tt>false</tt> if no changes were applied
|
||||
* @throws SipException
|
||||
*/
|
||||
public static boolean addSubscription(Dialog dialog, Object subscription)
|
||||
throws SipException
|
||||
{
|
||||
synchronized (dialog)
|
||||
{
|
||||
DialogApplicationData applicationData =
|
||||
(DialogApplicationData) dialog.getApplicationData();
|
||||
if (applicationData == null)
|
||||
{
|
||||
applicationData = new DialogApplicationData();
|
||||
dialog.setApplicationData(applicationData);
|
||||
}
|
||||
|
||||
if (applicationData.addSubscription(subscription))
|
||||
{
|
||||
try
|
||||
{
|
||||
dialog.terminateOnBye(false);
|
||||
return true;
|
||||
}
|
||||
catch (SipException ex)
|
||||
{
|
||||
|
||||
/*
|
||||
* Since the subscription didn't quite register, undo the
|
||||
* part of the registration which did succeed.
|
||||
*/
|
||||
applicationData.removeSubscription(subscription);
|
||||
throw ex;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Processes a BYE request in a specific <code>Dialog</code> for the
|
||||
* purposes of subscription associations and returns an indicator which
|
||||
* determines whether the specified dialog should still be considered alive
|
||||
* after the processing of the BYE request.
|
||||
*
|
||||
* @param dialog the <code>Dialog</code> in which a BYE request has arrived
|
||||
* @return <tt>true</tt> if <code>dialog</code> should still be considered
|
||||
* alive after processing the mentioned BYE request; <tt>false</tt>
|
||||
* if <code>dialog</code> is to be expected to die after processing
|
||||
* the request in question
|
||||
* @throws SipException
|
||||
*/
|
||||
public static boolean processByeThenIsDialogAlive(Dialog dialog)
|
||||
throws SipException
|
||||
{
|
||||
synchronized (dialog)
|
||||
{
|
||||
DialogApplicationData applicationData =
|
||||
(DialogApplicationData) dialog.getApplicationData();
|
||||
if (applicationData != null)
|
||||
{
|
||||
applicationData.setByeProcessed(true);
|
||||
|
||||
if (applicationData.getSubscriptionCount() > 0)
|
||||
{
|
||||
dialog.terminateOnBye(false);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Dissociates a specific subscription with a given <code>Dialog</code> in
|
||||
* order to no longer allow it to keep the dialog in question alive even
|
||||
* after a BYE request, deletes the dialog if there are no other
|
||||
* subscriptions associated with it and a BYE request has already been
|
||||
* received and returns an indicator which determines whether the specified
|
||||
* dialog is still alive after the dissociation of the given subscription.
|
||||
*
|
||||
* @param dialog the <code>Dialog</code> to dissociate the subscription with
|
||||
* and to no longer be kept alive after a BYE request because of
|
||||
* the subscription
|
||||
* @param subscription the subscription to be dissociated with
|
||||
* <code>dialog</code> and to no longer be kept alive after a BYE
|
||||
* request because of the subscription
|
||||
* @return <tt>true</tt> if the dialog is still alive after the
|
||||
* dissociation; <tt>false</tt> if the dialog was terminated because
|
||||
* of the dissociation
|
||||
*/
|
||||
public static boolean removeSubscriptionThenIsDialogAlive(Dialog dialog,
|
||||
Object subscription)
|
||||
{
|
||||
synchronized (dialog)
|
||||
{
|
||||
DialogApplicationData applicationData =
|
||||
(DialogApplicationData) dialog.getApplicationData();
|
||||
if ((applicationData != null)
|
||||
&& applicationData.removeSubscription(subscription)
|
||||
&& (applicationData.getSubscriptionCount() <= 0)
|
||||
&& applicationData.isByeProcessed())
|
||||
{
|
||||
dialog.delete();
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Prevents the creation of <code>DialogUtils</code> instances.
|
||||
*/
|
||||
private DialogUtils()
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
* Represents the application-specific data which the SIP protocol provider
|
||||
* associates with {@link #Dialog} instances.
|
||||
* <p>
|
||||
* The implementation at the time of this writing allows tracking
|
||||
* subscriptions in a specific <code>Dialog</code> in order to make it
|
||||
* possible to determine whether a BYE request should terminate the
|
||||
* respective dialog.
|
||||
* </p>
|
||||
*/
|
||||
private static class DialogApplicationData
|
||||
{
|
||||
|
||||
/**
|
||||
* The indicator which determines whether a BYE request has already been
|
||||
* processed in the owning <code>Dialog</code> and thus allows
|
||||
* determining whether the dialog in question should be terminated when
|
||||
* the last associated subscription is terminated.
|
||||
*/
|
||||
private boolean byeIsProcessed;
|
||||
|
||||
/**
|
||||
* The set of subscriptions not yet terminated in the owning
|
||||
* <code>Dialog</code> i.e. keeping it alive even after a BYE request.
|
||||
*/
|
||||
private final List<Object> subscriptions = new ArrayList<Object>();
|
||||
|
||||
/**
|
||||
* Associates a specific subscription with the owning
|
||||
* <code>Dialog</code> in order to allow it to keep the dialog in
|
||||
* question alive even after a BYE request.
|
||||
*
|
||||
* @param subscription the subscription with no specific type of
|
||||
* interest to this implementation to be associated with the
|
||||
* owning <code>Dialog</code>
|
||||
* @return <tt>true</tt> if the specified subscription caused a
|
||||
* modification of the list of associated subscriptions;
|
||||
* <tt>false</tt> if no change to the mentioned list was applied
|
||||
*/
|
||||
public boolean addSubscription(Object subscription)
|
||||
{
|
||||
if (!subscriptions.contains(subscription))
|
||||
{
|
||||
return subscriptions.add(subscription);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether a BYE request has already been processed in the
|
||||
* owning <code>Dialog</code> and thus allows determining whether the
|
||||
* dialog in question should be terminated when the last associated
|
||||
* subscription is terminated.
|
||||
*
|
||||
* @return <tt>true</tt> if a BYE request has already been processed in
|
||||
* the owning <code>Dialog</code>; <tt>false</tt>, otherwise
|
||||
*/
|
||||
public boolean isByeProcessed()
|
||||
{
|
||||
return byeIsProcessed;
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines the number of subscriptions associated with the owning
|
||||
* <code>Dialog</code> i.e. keeping it alive even after a BYE request.
|
||||
*
|
||||
* @return the number of subscriptions associated with the owning
|
||||
* <code>Dialog</code> i.e. keeping it alive even after a BYE
|
||||
* request
|
||||
*/
|
||||
public int getSubscriptionCount()
|
||||
{
|
||||
return subscriptions.size();
|
||||
}
|
||||
|
||||
/**
|
||||
* Dissociates a specific subscription with the owning
|
||||
* <code>Dialog</code> in order to no longer allow it to keep the dialog
|
||||
* in question alive even after a BYE request.
|
||||
*
|
||||
* @param subscription the subscription with no specific type of
|
||||
* interest to this implementation to be dissociated with the
|
||||
* owning <code>Dialog</code>
|
||||
* @return <tt>true</tt> if the specified subscription caused a
|
||||
* modification of the list of associated subscriptions;
|
||||
* <tt>false</tt> if no change to the mentioned list was applied
|
||||
*/
|
||||
public boolean removeSubscription(Object subscription)
|
||||
{
|
||||
return subscriptions.remove(subscription);
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the indicator which determines whether a BYE request has already
|
||||
* been processed in the owning <code>Dialog</code> and thus allows
|
||||
* determining whether the dialog in question should be terminated when
|
||||
* the last associated subscription is terminated.
|
||||
*
|
||||
* @param byeIsProcessed <tt>true</tt> if a BYE request has already been
|
||||
* processed in the owning <code>Dialog</code>;
|
||||
* <tt>false</tt>, otherwise
|
||||
*/
|
||||
public void setByeProcessed(boolean byeIsProcessed)
|
||||
{
|
||||
this.byeIsProcessed = byeIsProcessed;
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,61 @@
|
||||
/*
|
||||
* SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
|
||||
*
|
||||
* Distributable under LGPL license.
|
||||
* See terms of license at gnu.org.
|
||||
*/
|
||||
package net.java.sip.communicator.service.protocol.event;
|
||||
|
||||
/**
|
||||
* An abstract adapter class for receiving call-state (change) events. This
|
||||
* class exists only as a convenience for creating listener objects.
|
||||
* <p>
|
||||
* Extend this class to create a <code>CallChangeEvent</code> listener and
|
||||
* override the methods for the events of interest. (If you implement the
|
||||
* <code>CallChangeListener</code> interface, you have to define all of the
|
||||
* methods in it. This abstract class defines null methods for them all, so you
|
||||
* only have to define methods for events you care about.)
|
||||
* </p>
|
||||
*
|
||||
* @see CallChangeEvent
|
||||
* @see CallChangeListener
|
||||
*
|
||||
* @author Lubomir Marinov
|
||||
*/
|
||||
public abstract class CallChangeAdapter
|
||||
implements CallChangeListener
|
||||
{
|
||||
|
||||
/*
|
||||
* (non-Javadoc)
|
||||
*
|
||||
* @seenet.java.sip.communicator.service.protocol.event.CallChangeListener#
|
||||
* callParticipantAdded
|
||||
* (net.java.sip.communicator.service.protocol.event.CallParticipantEvent)
|
||||
*/
|
||||
public void callParticipantAdded(CallParticipantEvent evt)
|
||||
{
|
||||
}
|
||||
|
||||
/*
|
||||
* (non-Javadoc)
|
||||
*
|
||||
* @seenet.java.sip.communicator.service.protocol.event.CallChangeListener#
|
||||
* callParticipantRemoved
|
||||
* (net.java.sip.communicator.service.protocol.event.CallParticipantEvent)
|
||||
*/
|
||||
public void callParticipantRemoved(CallParticipantEvent evt)
|
||||
{
|
||||
}
|
||||
|
||||
/*
|
||||
* (non-Javadoc)
|
||||
*
|
||||
* @seenet.java.sip.communicator.service.protocol.event.CallChangeListener#
|
||||
* callStateChanged
|
||||
* (net.java.sip.communicator.service.protocol.event.CallChangeEvent)
|
||||
*/
|
||||
public void callStateChanged(CallChangeEvent evt)
|
||||
{
|
||||
}
|
||||
}
|
||||
Loading…
Reference in new issue