aboutsummaryrefslogtreecommitdiffstats
path: root/src/net/java/sip/communicator/impl/protocol/jabber/JingleNodesCandidate.java
blob: 6d439e993e627b5ce524c4dd41c78f9ff608755d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
/*
 * 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.jabber;

import java.lang.reflect.*;
import java.net.*;

import org.ice4j.*;
import org.ice4j.ice.*;
import org.ice4j.socket.*;

/**
 * Represents a <tt>Candidate</tt> obtained via Jingle Nodes.
 *
 * @author Sebastien Vincent
 */
public class JingleNodesCandidate
    extends LocalCandidate
{
    /**
     * The socket used to communicate with relay.
     */
    private DatagramSocket socket = null;

    /**
     * The <tt>RelayedCandidateDatagramSocket</tt> of this
     * <tt>JingleNodesCandidate</tt>.
     */
    private JingleNodesCandidateDatagramSocket
        jingleNodesCandidateDatagramSocket = null;

    /**
     * <tt>TransportAddress</tt> of the Jingle Nodes relay where we will send
     * our packet.
     */
    private TransportAddress localEndPoint = null;

    /**
     * Creates a <tt>JingleNodesRelayedCandidate</tt> for the specified
     * transport, address, and base.
     *
     * @param transportAddress  the transport address that this candidate is
     * encapsulating.
     * @param parentComponent the <tt>Component</tt> that this candidate
     * belongs to.
     * @param localEndPoint <tt>TransportAddress</tt> of the Jingle Nodes relay
     * where we will send our packet.
     */
    public JingleNodesCandidate(TransportAddress transportAddress,
            Component parentComponent, TransportAddress localEndPoint)
    {
        super(transportAddress, parentComponent,
                CandidateType.RELAYED_CANDIDATE);
        setBase(this);
        setRelayServerAddress(localEndPoint);
        this.localEndPoint = localEndPoint;
    }

    /**
     * Gets the <tt>JingleNodesCandidateDatagramSocket</tt> of this
     * <tt>JingleNodesCandidate</tt>.
     * <p>
     * <b>Note</b>: The method is part of the internal API of
     * <tt>RelayedCandidate</tt> and <tt>TurnCandidateHarvest</tt> and is not
     * intended for public use.
     * </p>
     *
     * @return the <tt>RelayedCandidateDatagramSocket</tt> of this
     * <tt>RelayedCandidate</tt>
     */
    public synchronized JingleNodesCandidateDatagramSocket
        getRelayedCandidateDatagramSocket()
    {
        if (jingleNodesCandidateDatagramSocket == null)
        {
            try
            {
                jingleNodesCandidateDatagramSocket
                    = new JingleNodesCandidateDatagramSocket(
                            this, localEndPoint);
            }
            catch (SocketException sex)
            {
                throw new UndeclaredThrowableException(sex);
            }
        }
        return jingleNodesCandidateDatagramSocket;
    }

    /**
     * Gets the <tt>DatagramSocket</tt> associated with this <tt>Candidate</tt>.
     *
     * @return the <tt>DatagramSocket</tt> associated with this
     * <tt>Candidate</tt>
     */
    public DatagramSocket getSocket()
    {
        if (socket == null)
        {
            try
            {
                socket
                    = new MultiplexingDatagramSocket(
                            getRelayedCandidateDatagramSocket());
            }
            catch (SocketException sex)
            {
                throw new UndeclaredThrowableException(sex);
            }
        }
        return socket;
    }
}