Adds to x-tra classes for STUN support of STUN

This commit is contained in:
emcho 2010-02-15 22:51:18 +00:00
parent 143229ad06
commit 0b0e5da5b5
2 changed files with 171 additions and 0 deletions

View File

@ -0,0 +1,128 @@
/*
* ice4j, the OpenSource Java Solution for NAT and Firewall Traversal.
* Maintained by the SIP Communicator community (http://sip-communicator.org).
*
* Distributable under LGPL license. See terms of license at gnu.org.
*/
package org.ice4j;
import java.util.*;
import org.ice4j.message.*;
import org.ice4j.stack.*;
/**
* The class is used to dispatch events that occur when a STUN transaction
* fails asynchronously for reasons like a port unreachable exception for
* example.
*
* @author Emil Ivov
*/
public class StunFailureEvent
extends EventObject
{
/**
* Serial version UID for this Serializable class.
*/
private static final long serialVersionUID = 41232541L;
/**
* The message that the corresponding transaction was about.
*/
private final Message message;
/**
* The <tt>TransactionID</tt> of the transaction that the source message
* is related to.
*/
private final TransactionID transactionID;
/**
* The <tt>Exception</tt> that caused this failure.
*/
private final Throwable cause;
/**
* Constructs a <tt>StunFailureEvent</tt> according to the specified
* message.
*
* @param message the message itself
* @param localAddress the local address that the message was sent from.
* @param cause the <tt>Exception</tt> that caused this failure or
* <tt>null</tt> if there's no <tt>Exception</tt> associated with this
* failure
*/
public StunFailureEvent(Message message,
TransportAddress localAddress,
Throwable cause)
{
super(localAddress);
this.message = message;
this.transactionID = TransactionID.createTransactionID(message
.getTransactionID());
this.cause = cause;
}
/**
* Returns the <tt>TransportAddress</tt> that the message was supposed to
* leave from.
*
* @return the <tt>TransportAddress</tt> that the message was supposed to
* leave from.
*/
public TransportAddress getLocalAddress()
{
return (TransportAddress)getSource();
}
/**
* Returns the <tt>Message</tt> whose transaction has just failed.
*
* @return the <tt>Message</tt> whose transaction has just failed.
*/
public Message getMessage()
{
return message;
}
/**
* Returns the id of the transaction that has just failed.
*
* @return the <tt>TransactionID</tt> of the transaction that has just
* failed.
*/
public TransactionID getTransactionID()
{
return transactionID;
}
/**
* Returns the <tt>Exception</tt> that cause this failure or <tt>null</tt>
* if the failure is not related to an <tt>Exception</tt>.
*
* @return the <tt>Exception</tt> that cause this failure or <tt>null</tt>
* if the failure is not related to an <tt>Exception</tt>.
*/
public Throwable getCause()
{
return cause;
}
/**
* Returns a <tt>String</tt> representation of this event, containing the
* corresponding message, and local address.
*
* @return a <tt>String</tt> representation of this event, containing the
* corresponding message, and local address.
*/
public String toString()
{
StringBuffer buff = new StringBuffer("StunTimeoutEvent:\n\tMessage=");
buff.append(getMessage());
buff.append(" localAddr=").append(getLocalAddress());
return buff.toString();
}
}

View File

@ -0,0 +1,43 @@
package org.ice4j.ice;
import org.ice4j.*;
/**
* <tt>ServerReflexiveCandidate</tt>s are candidates whose IP address and port
* are a binding allocated by a NAT for an agent when it sent a packet through
* the NAT to a server. <tt>ServerReflexiveCandidate</tt>s can be learned by
* STUN servers using the Binding Request, or TURN servers, which provides
* both a Relayed and Server Reflexive candidate.
* <p>
* This class does not contain a socket itself and in order to send bytes
* over the network, one has to retrieve the socket of its basis.
* </p>
*
* @author Emil Ivov
*/
public class ServerReflexiveCandidate extends Candidate
{
/**
* Creates a <tt>ServerReflexiveCandidate</tt> for the specified transport
* address, and base.
*
* @param address the {@link TransportAddress} that this <tt>Candidate</tt>
* is representing.
* @param base the {@link HostCandidate} that this server reflexive
* candidate was obtained through.
* @param stunSrvrAddr the {@link TransportAddress} of the stun server that
* reflected this candidate.
*/
public ServerReflexiveCandidate(TransportAddress address,
HostCandidate base,
TransportAddress stunSrvrAddr)
{
super(address,
base.getParentComponent(),
CandidateType.SERVER_REFLEXIVE_CANDIDATE);
setBase(base);
setStunServerAddress(stunSrvrAddr);
}
}