Mercury-IM/Smack
Mercury-IM/Smack
1
0
Fork 0
mirror of https://codeberg.org/Mercury-IM/Smack synced 2025-12-07 13:41:08 +01:00
Code Issues Releases Wiki Activity

Fix all javadoc warnings

Browse source
This commit is contained in:
Florian Schmaus 2014-03-10 18:31:45 +01:00
parent 0058631ed6
commit b8a5437b28
42 changed files with 137 additions and 205 deletions
Download patch file Download diff file Expand all files Collapse all files

4
jingle/src/main/java/org/jivesoftware/smackx/jingle/ContentNegotiator.java
View file

@ -124,7 +124,7 @@ public class ContentNegotiator extends JingleNegotiator {
}
/**
* @return
* @return the JingleTransportManager
*/
public JingleTransportManager getTransportManager() {
return jingleTransportManager;
@ -134,7 +134,7 @@ public class ContentNegotiator extends JingleNegotiator {
* Called from above when starting a new session.
*/
protected void doStart() {
JingleContent result = new JingleContent(creator, name);
// JingleContent result = new JingleContent(creator, name);
// result.setDescription(mediaNeg.start());
// result.addJingleTransport(transNeg.start());

10
jingle/src/main/java/org/jivesoftware/smackx/jingle/JingleManager.java
View file

@ -204,7 +204,7 @@ public class JingleManager implements JingleSessionListener {
* If a fully implemented JingleMediaSession is entered, JingleManager manage Jingle signalling and jmf
*
* @param connection XMPP XMPPConnection to be used
* @param jingleMediaManager an implemeted JingleMediaManager to be used.
* @param jingleMediaManagers an implemeted JingleMediaManager to be used.
*/
public JingleManager(XMPPConnection connection, List<JingleMediaManager> jingleMediaManagers) {
this.connection = connection;
@ -321,7 +321,7 @@ public class JingleManager implements JingleSessionListener {
/**
* Get the Media Managers of this Jingle Manager
*
* @return
* @return the list of JingleMediaManagers
*/
public List<JingleMediaManager> getMediaManagers() {
return jingleMediaManagers;
@ -330,7 +330,7 @@ public class JingleManager implements JingleSessionListener {
/**
* Set the Media Managers of this Jingle Manager
*
* @param jingleMediaManager JingleMediaManager to be used for open, close, start and stop jmf streamings
* @param jingleMediaManagers JingleMediaManager to be used for open, close, start and stop jmf streamings
*/
public void setMediaManagers(List<JingleMediaManager> jingleMediaManagers) {
this.jingleMediaManagers = jingleMediaManagers;
@ -516,7 +516,6 @@ public class JingleManager implements JingleSessionListener {
*
* @param responder the fully qualified jabber ID with resource of the other
* user.
* @param payloadTypes list of supported payload types
* @return The session on which the negotiation can be run.
*/
public JingleSession createOutgoingJingleSession(String responder) throws XMPPException {
@ -549,7 +548,6 @@ public class JingleManager implements JingleSessionListener {
* will create an JingleSession which allows the negotiation to procede.
*
* @param request the remote request that is being accepted.
* @param payloadTypes the list of supported Payload types that can be accepted
* @return the session which manages the rest of the negotiation.
*/
public JingleSession createIncomingJingleSession(JingleSessionRequest request) throws XMPPException {
@ -585,7 +583,7 @@ public class JingleManager implements JingleSessionListener {
* Get a session with the informed JID. If no session is found, return null.
*
* @param jid
* @return
* @return the JingleSession
*/
public JingleSession getSession(String jid) {
for (JingleSession jingleSession : jingleSessions) {

6
jingle/src/main/java/org/jivesoftware/smackx/jingle/JingleNegotiator.java
View file

@ -65,7 +65,7 @@ public abstract class JingleNegotiator {
/**
* Default constructor with a Connection
*
* @param connection the connection associated
* @param session the jingle session
*/
public JingleNegotiator(JingleSession session) {
this.session = session;
@ -119,7 +119,7 @@ public abstract class JingleNegotiator {
/**
* Set the XMPP connection associated.
*
* @param connection the connection to set
* @param session the jingle session
*/
public void setSession(JingleSession session) {
this.session = session;
@ -140,7 +140,7 @@ public abstract class JingleNegotiator {
* Check if the passed ID is the expected ID
*
* @param id
* @return
* @return true if is expected id
*/
public boolean isExpectedId(String id) {
if (id != null) {

15
jingle/src/main/java/org/jivesoftware/smackx/jingle/JingleSession.java
View file

@ -102,7 +102,7 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
* the responder JID
* @param sessionid
* the session ID
* @param jingleMediaManager
* @param jingleMediaManagers
* the jingleMediaManager
*/
public JingleSession(XMPPConnection conn, String initiator, String responder, String sessionid,
@ -136,7 +136,7 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
* the initiator JID
* @param responder
* the responder JID
* @param jingleMediaManager
* @param jingleMediaManagers
* the jingleMediaManager
*/
public JingleSession(XMPPConnection conn, JingleSessionRequest request, String initiator, String responder,
@ -171,7 +171,7 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
/**
* Get the Media Manager of this Jingle Session
*
* @return
* @return the JingleMediaManagers
*/
public List<JingleMediaManager> getMediaManagers() {
return jingleMediaManagers;
@ -180,7 +180,7 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
/**
* Set the Media Manager of this Jingle Session
*
* @param jingleMediaManager
* @param jingleMediaManagers
*/
public void setMediaManagers(List<JingleMediaManager> jingleMediaManagers) {
this.jingleMediaManagers = jingleMediaManagers;
@ -272,7 +272,6 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
*
* @param iq
* the packet received
* @return the new Jingle packet to send.
* @throws XMPPException
*/
public synchronized void receivePacketAndRespond(IQ iq) throws XMPPException {
@ -1055,8 +1054,8 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
* From whom the packet is sent.
* @param errCode
* The error code.
* @param errStr
* The error string.
* @param error
* The XMPPError string.
* @return The created IQ packet.
*/
public static IQ createError(String ID, String to, String from, int errCode, XMPPError error) {
@ -1076,7 +1075,7 @@ public class JingleSession extends JingleNegotiator implements MediaReceivedList
*
* @param iq
* The Jingle packet we are responing to
* @param error
* @param jingleError
* the IQ packet we want to complete and send
*/
public IQ createJingleError(IQ iq, JingleError jingleError) {

2
jingle/src/main/java/org/jivesoftware/smackx/jingle/media/JingleMediaManager.java
View file

@ -72,7 +72,7 @@ public abstract class JingleMediaManager {
* @param payloadType
* @param remote
* @param local
* @return
* @return the media session
*/
public abstract JingleMediaSession createMediaSession(PayloadType payloadType, final TransportCandidate remote,
final TransportCandidate local, JingleSession jingleSession);

6
jingle/src/main/java/org/jivesoftware/smackx/jingle/media/JingleMediaSession.java
View file

@ -69,7 +69,7 @@ public abstract class JingleMediaSession {
/**
* Returns the PayloadType of the Media Session
*
* @return
* @return the PayloadType
*/
public PayloadType getPayloadType() {
return payloadType;
@ -78,7 +78,7 @@ public abstract class JingleMediaSession {
/**
* Returns the Media Session local Candidate
*
* @return
* @return the TransportCandidate
*/
public TransportCandidate getLocal() {
return local;
@ -87,7 +87,7 @@ public abstract class JingleMediaSession {
/**
* Returns the Media Session remote Candidate
*
* @return
* @return the TransportCandidate
*/
public TransportCandidate getRemote() {
return remote;

49
jingle/src/main/java/org/jivesoftware/smackx/jingle/media/MediaNegotiator.java
View file

@ -66,7 +66,7 @@ public class MediaNegotiator extends JingleNegotiator {
* but it does not start the negotiation. For starting the negotiation, call
* startNegotiation.
*
* @param js
* @param session
* The jingle session.
*/
public MediaNegotiator(JingleSession session, JingleMediaManager mediaManager, List<PayloadType> pts,
@ -198,7 +198,7 @@ public class MediaNegotiator extends JingleNegotiator {
* will be the best payload type to use.
*
* @param jingle
* @return
* @return the iq
*/
private IQ receiveContentAcceptAction(Jingle jingle, JingleDescription description) throws XMPPException {
IQ response = null;
@ -228,7 +228,7 @@ public class MediaNegotiator extends JingleNegotiator {
* Receive a session-initiate packet.
* @param jingle
* @param description
* @return
* @return the iq
*/
private IQ receiveSessionInitiateAction(Jingle jingle, JingleDescription description) {
IQ response = null;
@ -416,27 +416,27 @@ public class MediaNegotiator extends JingleNegotiator {
}
}
/**
* Create an offer for the list of audio payload types.
*
* @return a new Jingle packet with the list of audio Payload Types
*/
private Jingle createAudioPayloadTypesOffer() {
JingleContent jingleContent = new JingleContent(parentNegotiator.getCreator(), parentNegotiator.getName());
JingleDescription audioDescr = new JingleDescription.Audio();
// Add the list of payloads for audio and create a
// JingleDescription
// where we announce our payloads...
audioDescr.addAudioPayloadTypes(localAudioPts);
jingleContent.setDescription(audioDescr);
Jingle jingle = new Jingle(JingleActionEnum.CONTENT_ACCEPT);
jingle.addContent(jingleContent);
return jingle;
}
// /**
// * Create an offer for the list of audio payload types.
// *
// * @return a new Jingle packet with the list of audio Payload Types
// */
// private Jingle createAudioPayloadTypesOffer() {
//
// JingleContent jingleContent = new JingleContent(parentNegotiator.getCreator(), parentNegotiator.getName());
// JingleDescription audioDescr = new JingleDescription.Audio();
//
// // Add the list of payloads for audio and create a
// // JingleDescription
// // where we announce our payloads...
// audioDescr.addAudioPayloadTypes(localAudioPts);
// jingleContent.setDescription(audioDescr);
//
// Jingle jingle = new Jingle(JingleActionEnum.CONTENT_ACCEPT);
// jingle.addContent(jingleContent);
//
// return jingle;
// }
// Predefined messages and Errors
@ -502,7 +502,6 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Called from above when starting a new session.
* @return
*/
protected void doStart() {

2
jingle/src/main/java/org/jivesoftware/smackx/jingle/mediaimpl/jmf/AudioChannel.java
View file

@ -311,7 +311,7 @@ public class AudioChannel {
*
* @param codecFormat
* @param milliseconds
* @return
* @return the best packet size
* @throws IllegalArgumentException
*/
private int getPacketSize(Format codecFormat, int milliseconds) throws IllegalArgumentException {

4
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/JingleTransportManager.java
View file

@ -49,7 +49,7 @@ public abstract class JingleTransportManager {
/**
* Get a new Transport Resolver to be used in a Jingle Session
*
* @return
* @return the TransportResolver to be used
*/
public TransportResolver getResolver(JingleSession session) throws XMPPException {
TransportResolver resolver = createResolver(session);
@ -64,7 +64,7 @@ public abstract class JingleTransportManager {
/**
* Create a Transport Resolver instance according to the implementation.
*
* @return
* @return the TransportResolver
*/
protected abstract TransportResolver createResolver(JingleSession session);

28
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/RTPBridge.java
View file

@ -148,7 +148,7 @@ public class RTPBridge extends IQ {
/**
* Get the Session ID of the Packet (usually same as Jingle Session ID)
*
* @return
* @return the session ID
*/
public String getSid() {
return sid;
@ -166,7 +166,7 @@ public class RTPBridge extends IQ {
/**
* Get the Host A IP Address
*
* @return
* @return the Host A IP Address
*/
public String getHostA() {
return hostA;
@ -184,7 +184,7 @@ public class RTPBridge extends IQ {
/**
* Get the Host B IP Address
*
* @return
* @return the Host B IP Address
*/
public String getHostB() {
return hostB;
@ -202,7 +202,7 @@ public class RTPBridge extends IQ {
/**
* Get Side A receive port
*
* @return
* @return the side A receive prot
*/
public int getPortA() {
return portA;
@ -220,7 +220,7 @@ public class RTPBridge extends IQ {
/**
* Get Side B receive port
*
* @return
* @return the side B receive port
*/
public int getPortB() {
return portB;
@ -238,7 +238,7 @@ public class RTPBridge extends IQ {
/**
* Get the RTP Bridge IP
*
* @return
* @return the RTP Bridge IP
*/
public String getIp() {
return ip;
@ -256,7 +256,7 @@ public class RTPBridge extends IQ {
/**
* Get the RTP Agent Pass
*
* @return
* @return the RTP Agent Pass
*/
public String getPass() {
return pass;
@ -274,7 +274,7 @@ public class RTPBridge extends IQ {
/**
* Get the name of the Candidate
*
* @return
* @return the name of the Candidate
*/
public String getName() {
return name;
@ -292,7 +292,7 @@ public class RTPBridge extends IQ {
/**
* Get the Child Element XML of the Packet
*
* @return
* @return the Child Element XML of the Packet
*/
public String getChildElementXML() {
StringBuilder str = new StringBuilder();
@ -327,7 +327,6 @@ public class RTPBridge extends IQ {
int eventType;
String elementName;
String namespace;
if (!parser.getNamespace().equals(RTPBridge.NAMESPACE))
throw new Exception("Not a RTP Bridge packet");
@ -343,7 +342,6 @@ public class RTPBridge extends IQ {
while (!done) {
eventType = parser.next();
elementName = parser.getName();
namespace = parser.getNamespace();
if (eventType == XmlPullParser.START_TAG) {
if (elementName.equals("candidate")) {
@ -361,8 +359,6 @@ public class RTPBridge extends IQ {
}
}
else if (elementName.equals("publicip")) {
//String p = parser.getAttributeName(0);
int x = parser.getAttributeCount();
for (int i = 0; i < parser.getAttributeCount(); i++) {
if (parser.getAttributeName(i).equals("ip"))
iq.setIp(parser.getAttributeValue(i));
@ -385,7 +381,7 @@ public class RTPBridge extends IQ {
*
* @param connection
* @param sessionID
* @return
* @return the new RTPBridge
*/
public static RTPBridge getRTPBridge(XMPPConnection connection, String sessionID) {
@ -410,7 +406,7 @@ public class RTPBridge extends IQ {
* Check if the server support RTPBridge Service.
*
* @param connection
* @return
* @return true if the server supports the RTPBridge service
*/
public static boolean serviceAvailable(XMPPConnection connection) {
@ -452,7 +448,7 @@ public class RTPBridge extends IQ {
* Check if the server support RTPBridge Service.
*
* @param connection
* @return
* @return the RTPBridge
*/
public static RTPBridge relaySession(XMPPConnection connection, String sessionID, String pass, TransportCandidate proxyCandidate, TransportCandidate localCandidate) {

21
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/STUN.java
View file

@ -19,6 +19,7 @@ package org.jivesoftware.smackx.jingle.nat;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.jivesoftware.smack.XMPPConnection;
@ -77,7 +78,7 @@ public class STUN extends IQ {
/**
* Get a list of STUN Servers recommended by the Server
*
* @return
* @return the list of STUN servers
*/
public List<StunServerAddress> getServers() {
return servers;
@ -86,7 +87,7 @@ public class STUN extends IQ {
/**
* Get Public Ip returned from the XMPP server
*
* @return
* @return the public IP
*/
public String getPublicIp() {
return publicIp;
@ -104,7 +105,7 @@ public class STUN extends IQ {
/**
* Get the Child Element XML of the Packet
*
* @return
* @return the child element XML
*/
public String getChildElementXML() {
StringBuilder str = new StringBuilder();
@ -130,7 +131,6 @@ public class STUN extends IQ {
int eventType;
String elementName;
String namespace;
if (!parser.getNamespace().equals(NAMESPACE))
throw new Exception("Not a STUN packet");
@ -141,7 +141,6 @@ public class STUN extends IQ {
while (!done) {
eventType = parser.next();
elementName = parser.getName();
namespace = parser.getNamespace();
if (eventType == XmlPullParser.START_TAG) {
if (elementName.equals("server")) {
@ -181,7 +180,7 @@ public class STUN extends IQ {
* If a error occurs or the server don't support STUN Service, null is returned.
*
* @param connection
* @return
* @return the STUN server address
*/
public static STUN getSTUNServer(XMPPConnection connection) {
@ -205,8 +204,8 @@ public class STUN extends IQ {
/**
* Check if the server support STUN Service.
*
* @param xmppConnection
* @return
* @param connection the connection
* @return true if the server support STUN
*/
public static boolean serviceAvailable(XMPPConnection connection) {
@ -239,7 +238,7 @@ public class STUN extends IQ {
}
}
catch (XMPPException e) {
e.printStackTrace();
LOGGER.log(Level.SEVERE, "serviceAvailable", e);
}
return false;
}
@ -260,7 +259,7 @@ public class STUN extends IQ {
/**
* Get the Host Address
*
* @return
* @return the host address
*/
public String getServer() {
return server;
@ -269,7 +268,7 @@ public class STUN extends IQ {
/**
* Get the Server Port
*
* @return
* @return the server port
*/
public String getPort() {
return port;

10
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/TransportCandidate.java
View file

@ -103,7 +103,7 @@ public abstract class TransportCandidate {
/**
* Get local IP to bind to this candidate
*
* @return
* @return the local IP
*/
public String getLocalIp() {
return localIp == null ? ip : localIp;
@ -119,9 +119,9 @@ public abstract class TransportCandidate {
}
/**
* Get the symetric candidate for this candidate if it exists.
* Get the symmetric candidate for this candidate if it exists.
*
* @return
* @return the symmetric candidate
*/
public TransportCandidate getSymmetric() {
return symmetric;
@ -157,7 +157,7 @@ public abstract class TransportCandidate {
/**
* Get the XMPPConnection use to send or receive this candidate
*
* @return
* @return the connection
*/
public XMPPConnection getConnection() {
return connection;
@ -175,7 +175,7 @@ public abstract class TransportCandidate {
/**
* Get the jingle's sessionId that is using this candidate
*
* @return
* @return the session ID
*/
public String getSessionId() {
return sessionId;

12
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/TransportNegotiator.java
View file

@ -87,7 +87,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* Default constructor.
*
* @param js The Jingle session
* @param session The Jingle session
* @param transResolver The JingleTransportManager to use
*/
public TransportNegotiator(JingleSession session, TransportResolver transResolver, ContentNegotiator parentNegotiator) {
@ -503,10 +503,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
return result;
}
private boolean isOfferStarted() {
return resolver.isResolving() || resolver.isResolved();
}
/**
* Send an offer for a transport candidate
*
@ -658,7 +654,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* @param jingle
* @param jingleTransport
* @return
* @return the iq
*/
private IQ receiveSessionInitiateAction(Jingle jingle) throws XMPPException {
IQ response = null;
@ -682,7 +678,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* @param jingle
* @param jingleTransport
* @return
* @return the iq
*/
private IQ receiveTransportInfoAction(Jingle jingle) throws XMPPException {
IQ response = null;
@ -744,7 +740,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* @param jingle
* @return
* @return the iq
*/
private IQ receiveSessionAcceptAction(Jingle jingle) {
IQ response = null;

2
jingle/src/main/java/org/jivesoftware/smackx/jingle/nat/TransportResolver.java
View file

@ -140,7 +140,7 @@ public abstract class TransportResolver {
/**
* Chack if the Transport Resolver is initialized
*
* @return
* @return true if initialized
*/
public synchronized boolean isInitialized() {
return initialized;