- itemsToAdd) {
if (itemsToAdd == null) return;
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferListener.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferListener.java
index 2559b88a1..d54b19ae9 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferListener.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferListener.java
@@ -26,7 +26,7 @@ public interface FileTransferListener {
/**
* A request to send a file has been received from another user.
*
- * @param request TODO javadoc me please
+ * @param request
* The request from the other user.
*/
void fileTransferRequest(FileTransferRequest request);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferManager.java
index f34ed352b..dc44d4b11 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferManager.java
@@ -65,7 +65,7 @@ public final class FileTransferManager extends Manager {
/**
* Creates a file transfer manager to initiate and receive file transfers.
*
- * @param connection TODO javadoc me please
+ * @param connection
* The XMPPConnection that the file transfers will use.
*/
private FileTransferManager(XMPPConnection connection) {
@@ -90,7 +90,7 @@ public final class FileTransferManager extends Manager {
* Add a file transfer listener to listen to incoming file transfer
* requests.
*
- * @param li TODO javadoc me please
+ * @param li
* The listener
* @see #removeFileTransferListener(FileTransferListener)
* @see FileTransferListener
@@ -102,7 +102,7 @@ public final class FileTransferManager extends Manager {
/**
* Removes a file transfer listener.
*
- * @param li TODO javadoc me please
+ * @param li
* The file transfer listener to be removed
* @see FileTransferListener
*/
@@ -113,7 +113,7 @@ public final class FileTransferManager extends Manager {
/**
* Creates an OutgoingFileTransfer to send a file to another user.
*
- * @param userID TODO javadoc me please
+ * @param userID
* The fully qualified jabber ID (i.e. full JID) with resource of the user to
* send the file to.
* @return The send file object on which the negotiated transfer can be run.
@@ -137,7 +137,7 @@ public final class FileTransferManager extends Manager {
* invoked. It will create an IncomingFileTransfer which allows the
* transmission of the file to proceed.
*
- * @param request TODO javadoc me please
+ * @param request
* The remote request that is being accepted.
* @return The IncomingFileTransfer which manages the download of the file
* from the transfer initiator.
@@ -160,9 +160,9 @@ public final class FileTransferManager extends Manager {
*
* Specified in XEP-95 4.2 and 3.2 Example 8
*
- * @param request TODO javadoc me please
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param request
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
protected void rejectIncomingFileTransfer(FileTransferRequest request) throws NotConnectedException, InterruptedException {
StreamInitiation initiation = request.getStreamInitiation();
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferNegotiator.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferNegotiator.java
index c9195fa8c..c3a16df11 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferNegotiator.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferNegotiator.java
@@ -182,9 +182,9 @@ public final class FileTransferNegotiator extends Manager {
* @return The file transfer object that handles the transfer
* @throws NoStreamMethodsOfferedException If there are either no stream methods contained in the packet, or
* there is not an appropriate stream method.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws NoAcceptableTransferMechanisms if no acceptable transfer mechanisms are available
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws NoAcceptableTransferMechanisms
+ * @throws InterruptedException
*/
public StreamNegotiator selectStreamNegotiator(
FileTransferRequest request) throws NotConnectedException, NoStreamMethodsOfferedException, NoAcceptableTransferMechanisms, InterruptedException {
@@ -296,10 +296,10 @@ public final class FileTransferNegotiator extends Manager {
* user to respond. If they do not respond in time, this
* @return Returns the stream negotiator selected by the peer.
* @throws XMPPErrorException Thrown if there is an error negotiating the file transfer.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NoAcceptableTransferMechanisms if no acceptable transfer mechanisms are available
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws NoResponseException
+ * @throws NoAcceptableTransferMechanisms
+ * @throws InterruptedException
*/
public StreamNegotiator negotiateOutgoingTransfer(final Jid userID,
final String streamID, final String fileName, final long size,
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferRequest.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferRequest.java
index d0c17d34f..d6d732c3a 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferRequest.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/FileTransferRequest.java
@@ -37,10 +37,10 @@ public class FileTransferRequest {
* A receive request is constructed from the Stream Initiation request
* received from the initiator.
*
- * @param manager TODO javadoc me please
+ * @param manager
* The manager handling this file transfer
*
- * @param si TODO javadoc me please
+ * @param si
* The Stream initiation received from the initiator.
*/
public FileTransferRequest(FileTransferManager manager, StreamInitiation si) {
@@ -131,8 +131,8 @@ public class FileTransferRequest {
/**
* Rejects the file transfer request.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void reject() throws NotConnectedException, InterruptedException {
manager.rejectIncomingFileTransfer(this);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/IncomingFileTransfer.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/IncomingFileTransfer.java
index 0e972b26d..6fadab1bc 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/IncomingFileTransfer.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/IncomingFileTransfer.java
@@ -74,10 +74,10 @@ public class IncomingFileTransfer extends FileTransfer {
* the negotiated stream.
*
* @return The negotiated InputStream from which to read the data.
- * @throws SmackException if Smack detected an exceptional situation.
+ * @throws SmackException
* @throws XMPPErrorException If there is an error in the negotiation process an exception
* is thrown.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public InputStream receiveFile() throws SmackException, XMPPErrorException, InterruptedException {
if (inputStream != null) {
@@ -110,7 +110,7 @@ public class IncomingFileTransfer extends FileTransfer {
*
* @param file The location to save the file.
* @throws SmackException when the file transfer fails
- * @throws IOException if an I/O error occured.
+ * @throws IOException
* @throws IllegalArgumentException This exception is thrown when the the provided file is
* either null, or cannot be written to.
*/
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/OutgoingFileTransfer.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/OutgoingFileTransfer.java
index 3e33208e6..41f55d4b8 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/OutgoingFileTransfer.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/OutgoingFileTransfer.java
@@ -63,7 +63,7 @@ public class OutgoingFileTransfer extends FileTransfer {
* Sets the time in milliseconds after which the file transfer negotiation
* process will timeout if the other user has not responded.
*
- * @param responseTimeout TODO javadoc me please
+ * @param responseTimeout
* The timeout time in milliseconds.
*/
public static void setResponseTimeout(int responseTimeout) {
@@ -108,21 +108,21 @@ public class OutgoingFileTransfer extends FileTransfer {
* This method handles the negotiation of the file transfer and the stream,
* it only returns the created stream after the negotiation has been completed.
*
- * @param fileName TODO javadoc me please
+ * @param fileName
* The name of the file that will be transmitted. It is
* preferable for this name to have an extension as it will be
* used to determine the type of file it is.
- * @param fileSize TODO javadoc me please
+ * @param fileSize
* The size in bytes of the file that will be transmitted.
- * @param description TODO javadoc me please
+ * @param description
* A description of the file that will be transmitted.
* @return The OutputStream that is connected to the peer to transmit the
* file.
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws XMPPException
* Thrown if an error occurs during the file transfer
* negotiation process.
* @throws SmackException if there was no response from the server.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public synchronized OutputStream sendFile(String fileName, long fileSize,
String description) throws XMPPException, SmackException, InterruptedException {
@@ -146,15 +146,15 @@ public class OutgoingFileTransfer extends FileTransfer {
* returns immediately and its progress will be updated through the
* {@link NegotiationProgress} callback.
*
- * @param fileName TODO javadoc me please
+ * @param fileName
* The name of the file that will be transmitted. It is
* preferable for this name to have an extension as it will be
* used to determine the type of file it is.
- * @param fileSize TODO javadoc me please
+ * @param fileSize
* The size in bytes of the file that will be transmitted.
- * @param description TODO javadoc me please
+ * @param description
* A description of the file that will be transmitted.
- * @param progress TODO javadoc me please
+ * @param progress
* A callback to monitor the progress of the file transfer
* negotiation process and to retrieve the OutputStream when it
* is complete.
@@ -212,7 +212,7 @@ public class OutgoingFileTransfer extends FileTransfer {
*
* @param file the file to transfer to the remote entity.
* @param description a description for the file to transfer.
- * @throws SmackException if Smack detected an exceptional situation.
+ * @throws SmackException
* If there is an error during the negotiation process or the
* sending of the file.
*/
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/StreamNegotiator.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/StreamNegotiator.java
index 08031b6d3..393be25e6 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/StreamNegotiator.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/filetransfer/StreamNegotiator.java
@@ -152,7 +152,7 @@ public abstract class StreamNegotiator extends Manager {
* @throws XMPPErrorException If an error occurs during this process an XMPPException is
* thrown.
* @throws InterruptedException If thread is interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
+ * @throws SmackException
*/
public abstract InputStream createIncomingStream(StreamInitiation initiation)
throws XMPPErrorException, InterruptedException, SmackException;
@@ -168,9 +168,9 @@ public abstract class StreamNegotiator extends Manager {
* @param target The fully-qualified JID of the target or receiver of the file
* transfer.
* @return The negotiated stream ready for data.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws InterruptedException
*/
public abstract OutputStream createOutgoingStream(String streamID,
Jid initiator, Jid target) throws SmackException, XMPPException, InterruptedException;
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/forward/packet/Forwarded.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/forward/packet/Forwarded.java
index 72d9fdb88..17ebf299c 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/forward/packet/Forwarded.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/forward/packet/Forwarded.java
@@ -111,7 +111,7 @@ public class Forwarded implements ExtensionElement {
/**
* Get the forwarded extension.
- * @param packet TODO javadoc me please
+ * @param packet
* @return the Forwarded extension or null
*/
public static Forwarded from(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/geoloc/GeoLocationManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/geoloc/GeoLocationManager.java
index b8c0ff414..1adb99b85 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/geoloc/GeoLocationManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/geoloc/GeoLocationManager.java
@@ -100,12 +100,12 @@ public final class GeoLocationManager extends Manager {
/**
* Send geolocation through the PubSub node.
*
- * @param geoLocation TODO javadoc me please
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @param geoLocation
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotALeafNodeException
*/
public void sendGeolocation(GeoLocation geoLocation)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, NotALeafNodeException {
@@ -115,11 +115,11 @@ public final class GeoLocationManager extends Manager {
/**
* Send empty geolocation through the PubSub node.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotALeafNodeException
*/
public void stopPublishingGeolocation()
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, NotALeafNodeException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqlast/LastActivityManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqlast/LastActivityManager.java
index 3b3ea38a7..551c27682 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqlast/LastActivityManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqlast/LastActivityManager.java
@@ -76,6 +76,7 @@ import org.jxmpp.jid.Jid;
*
* To get the uptime of a host, you simple send the LastActivity stanza to it,
* as in the following code example:
+ *
*
*
* LastActivity activity = LastActivity.getLastActivity(con, "jabber.org");
@@ -97,7 +98,7 @@ public final class LastActivityManager extends Manager {
/**
* Enable or disable Last Activity for new XMPPConnections.
*
- * @param enabledPerDefault TODO javadoc me please
+ * @param enabledPerDefault
*/
public static void setEnabledPerDefault(boolean enabledPerDefault) {
LastActivityManager.enabledPerDefault = enabledPerDefault;
@@ -126,7 +127,7 @@ public final class LastActivityManager extends Manager {
/**
* Creates a last activity manager to response last activity requests.
*
- * @param connection TODO javadoc me please
+ * @param connection
* The XMPPConnection that the last activity requests will use.
*/
private LastActivityManager(XMPPConnection connection) {
@@ -225,14 +226,14 @@ public final class LastActivityManager extends Manager {
* Moreover, when the jid is a server or component (e.g., a JID of the form
* 'host') the last activity is the uptime.
*
- * @param jid TODO javadoc me please
+ * @param jid
* the JID of the user.
* @return the LastActivity stanza of the jid.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* thrown if a server error has occured.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public LastActivity getLastActivity(Jid jid) throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException {
@@ -245,10 +246,10 @@ public final class LastActivityManager extends Manager {
*
* @param jid a JID to be tested for Last Activity support
* @return true if Last Activity is supported, otherwise false
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws InterruptedException
*/
public boolean isLastActivitySupported(Jid jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).supportsFeature(jid, LastActivity.NAMESPACE);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/PrivateDataManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/PrivateDataManager.java
index e93c560de..7a1149ea6 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/PrivateDataManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/PrivateDataManager.java
@@ -154,10 +154,10 @@ public final class PrivateDataManager extends Manager {
* @param elementName the element name.
* @param namespace the namespace.
* @return the private data.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public PrivateData getPrivateData(final String elementName, final String namespace) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Create an IQ packet to get the private data.
@@ -174,10 +174,10 @@ public final class PrivateDataManager extends Manager {
* element name and namespace, then the new private data will overwrite the old value.
*
* @param privateData the private data.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void setPrivateData(final PrivateData privateData) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Create an IQ packet to set the private data.
@@ -207,10 +207,10 @@ public final class PrivateDataManager extends Manager {
* Check if the service supports private data.
*
* @return true if the service supports private data, false otherwise.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
* @since 4.2
*/
public boolean isSupported() throws NoResponseException, NotConnectedException,
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/provider/PrivateDataProvider.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/provider/PrivateDataProvider.java
index 4f21a318c..6c8f72d3e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/provider/PrivateDataProvider.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqprivate/provider/PrivateDataProvider.java
@@ -41,8 +41,8 @@ public interface PrivateDataProvider {
*
* @param parser an XML parser.
* @return a new PrivateData instance.
- * @throws XmlPullParserException if an error in the XML parser occured.
- * @throws IOException if an I/O error occured.
+ * @throws XmlPullParserException
+ * @throws IOException
*/
PrivateData parsePrivateData(XmlPullParser parser) throws XmlPullParserException, IOException;
}
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqregister/AccountManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqregister/AccountManager.java
index 293cb5cbc..af955915b 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqregister/AccountManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqregister/AccountManager.java
@@ -70,7 +70,7 @@ public final class AccountManager extends Manager {
/**
* The default value used by new account managers for allowSensitiveOperationOverInsecureConnection.
*
- * @param allow TODO javadoc me please
+ * @param allow
* @see #sensitiveOperationOverInsecureConnection(boolean)
* @since 4.1
*/
@@ -87,7 +87,7 @@ public final class AccountManager extends Manager {
* unencrypted) connections.
*
*
- * @param allow TODO javadoc me please
+ * @param allow
* @since 4.1
*/
public void sensitiveOperationOverInsecureConnection(boolean allow) {
@@ -131,10 +131,10 @@ public final class AccountManager extends Manager {
* behavior is to only create new accounts before having logged in to a server.
*
* @return true if the server support creating new accounts.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean supportsAccountCreation() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// TODO: Replace this body with isSupported() and possible deprecate this method.
@@ -176,10 +176,10 @@ public final class AccountManager extends Manager {
* the user's email address.
*
* @return the required account attributes.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Set getAccountAttributes() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
if (info == null) {
@@ -200,10 +200,10 @@ public final class AccountManager extends Manager {
* @param name the name of the account attribute to return its value.
* @return the value of the account attribute or null if an account
* attribute wasn't found for the requested name.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public String getAccountAttribute(String name) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
if (info == null) {
@@ -218,10 +218,10 @@ public final class AccountManager extends Manager {
* that will complete the registration process.
*
* @return the account creation instructions, or null if there are none.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public String getAccountInstructions() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
if (info == null) {
@@ -240,10 +240,10 @@ public final class AccountManager extends Manager {
*
* @param username the username.
* @param password the password.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void createAccount(Localpart username, String password) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Create a map for all the required attributes, but give them blank values.
@@ -264,8 +264,8 @@ public final class AccountManager extends Manager {
* @param attributes the account attributes.
* @throws XMPPErrorException if an error occurs creating the account.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see #getAccountAttributes()
*/
public void createAccount(Localpart username, String password, Map attributes)
@@ -298,8 +298,8 @@ public final class AccountManager extends Manager {
* @throws IllegalStateException if not currently logged-in to the server.
* @throws XMPPErrorException if an error occurs when changing the password.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void changePassword(String newPassword) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
if (!connection().isSecureConnection() && !allowSensitiveOperationOverInsecureConnection) {
@@ -322,8 +322,8 @@ public final class AccountManager extends Manager {
* @throws IllegalStateException if not currently logged-in to the server.
* @throws XMPPErrorException if an error occurs when deleting the account.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteAccount() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Map attributes = new HashMap<>();
@@ -356,10 +356,10 @@ public final class AccountManager extends Manager {
/**
* Gets the account registration info from the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
* @throws XMPPException if an error occurs.
* @throws SmackException if there was no response from the server.
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqversion/VersionManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqversion/VersionManager.java
index b111838d2..4dce8988e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/iqversion/VersionManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/iqversion/VersionManager.java
@@ -135,12 +135,12 @@ public final class VersionManager extends Manager {
/**
* Request version information from a given JID.
*
- * @param jid TODO javadoc me please
+ * @param jid
* @return the version information or {@code null} if not supported by JID
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Version getVersion(Jid jid) throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/jingle/element/JingleError.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/jingle/element/JingleError.java
index 15a07f1e0..2931973ee 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/jingle/element/JingleError.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/jingle/element/JingleError.java
@@ -62,10 +62,7 @@ public final class JingleError implements ExtensionElement {
}
/**
- * Returns a error instance associated with the String value.
- *
- * @param value the input String.
- * @return the jingle error instance associated with the input String.
+ * Returns a Action instance associated with the String value.
*/
public static JingleError fromString(String value) {
value = value.toLowerCase(Locale.US);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/JivePropertiesManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/JivePropertiesManager.java
index 8bbe7812d..8074f052d 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/JivePropertiesManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/JivePropertiesManager.java
@@ -68,8 +68,8 @@ public class JivePropertiesManager {
* Convenience method to get a property from a packet. Will return null if the stanza contains
* not property with the given name.
*
- * @param packet TODO javadoc me please
- * @param name TODO javadoc me please
+ * @param packet
+ * @param name
* @return the property or null if none found.
*/
public static Object getProperty(Stanza packet, String name) {
@@ -85,7 +85,7 @@ public class JivePropertiesManager {
* Return a collection of the names of all properties of the given packet. If the packet
* contains no properties extension, then an empty collection will be returned.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return a collection of the names of all properties.
*/
public static Collection getPropertiesNames(Stanza packet) {
@@ -100,7 +100,7 @@ public class JivePropertiesManager {
* Return a map of all properties of the given packet. If the stanza contains no properties
* extension, an empty map will be returned.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return a map of all properties of the given packet.
*/
public static Map getProperties(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/provider/JivePropertiesExtensionProvider.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/provider/JivePropertiesExtensionProvider.java
index d88b30708..1e3eb2a91 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/provider/JivePropertiesExtensionProvider.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/jiveproperties/provider/JivePropertiesExtensionProvider.java
@@ -48,8 +48,8 @@ public class JivePropertiesExtensionProvider extends ExtensionElementProvider
*
* @param multiUserChat the MUC for this configuration form.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
*/
MucConfigFormManager(MultiUserChat multiUserChat) throws NoResponseException,
XMPPErrorException, NotConnectedException, InterruptedException {
@@ -156,7 +156,7 @@ public class MucConfigFormManager {
* Make the room for members only.
*
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager makeMembersOnly() throws MucConfigurationNotSupportedException {
return setMembersOnly(true);
@@ -167,7 +167,7 @@ public class MucConfigFormManager {
*
* @param isMembersOnly if the room should be members only.
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager setMembersOnly(boolean isMembersOnly) throws MucConfigurationNotSupportedException {
if (!supportsMembersOnly()) {
@@ -192,7 +192,7 @@ public class MucConfigFormManager {
*
* @param password the password to set.
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager setAndEnablePassword(String password)
throws MucConfigurationNotSupportedException {
@@ -203,7 +203,7 @@ public class MucConfigFormManager {
* Make the room password protected.
*
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager makePasswordProtected() throws MucConfigurationNotSupportedException {
return setIsPasswordProtected(true);
@@ -212,9 +212,9 @@ public class MucConfigFormManager {
/**
* Set if this room is password protected. Rooms are by default not password protected.
*
- * @param isPasswordProtected TODO javadoc me please
+ * @param isPasswordProtected
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager setIsPasswordProtected(boolean isPasswordProtected)
throws MucConfigurationNotSupportedException {
@@ -232,7 +232,7 @@ public class MucConfigFormManager {
*
* @param secret the secret/password.
* @return a reference to this object.
- * @throws MucConfigurationNotSupportedException if the requested MUC configuration is not supported by the MUC service.
+ * @throws MucConfigurationNotSupportedException
*/
public MucConfigFormManager setRoomSecret(String secret)
throws MucConfigurationNotSupportedException {
@@ -247,9 +247,9 @@ public class MucConfigFormManager {
* Submit the configuration as {@link Form} to the room.
*
* @throws NoResponseException if there was no response from the room.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void submitConfigurationForm() throws NoResponseException, XMPPErrorException, NotConnectedException,
InterruptedException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MucEnterConfiguration.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MucEnterConfiguration.java
index 681d1e8a9..b9120f671 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MucEnterConfiguration.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MucEnterConfiguration.java
@@ -101,7 +101,7 @@ public final class MucEnterConfiguration {
* 'available', otherwise an {@link IllegalArgumentException} will be thrown.
*
*
- * @param presence TODO javadoc me please
+ * @param presence
* @return a reference to this builder.
*/
public Builder withPresence(Presence presence) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChat.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChat.java
index 605eaff2e..15f0b20ff 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChat.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChat.java
@@ -318,11 +318,11 @@ public class MultiUserChat {
*
* @param conf the configuration used to enter the room.
* @return the returned presence by the service after the client send the initial presence in order to enter the room.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NotConnectedException
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws InterruptedException
+ * @throws NotAMucServiceException
* @see XEP-45 7.2 Entering a Room
*/
private Presence enter(MucEnterConfiguration conf) throws NotConnectedException, NoResponseException,
@@ -444,11 +444,11 @@ public class MultiUserChat {
* @throws XMPPErrorException if the room couldn't be created for some reason (e.g. 405 error if
* the user is not allowed to create the room)
* @throws NoResponseException if there was no response from the server.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws MucAlreadyJoinedException if already joined the Multi-User Chat.7y
- * @throws MissingMucCreationAcknowledgeException if there MUC creation was not acknowledged by the service.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws MucAlreadyJoinedException
+ * @throws MissingMucCreationAcknowledgeException
+ * @throws NotAMucServiceException
*/
public synchronized MucCreateConfigFormHandle create(Resourcepart nickname) throws NoResponseException,
XMPPErrorException, InterruptedException, MucAlreadyJoinedException,
@@ -477,12 +477,12 @@ public class MultiUserChat {
*
* @param nickname the nickname to use in the MUC room.
* @return A {@link MucCreateConfigFormHandle} if the room was created while joining, or {@code null} if the room was just joined.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws MucAlreadyJoinedException if already joined the Multi-User Chat.7y
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws MucAlreadyJoinedException
+ * @throws NotAMucServiceException
*/
public synchronized MucCreateConfigFormHandle createOrJoin(Resourcepart nickname) throws NoResponseException, XMPPErrorException,
InterruptedException, MucAlreadyJoinedException, NotConnectedException, NotAMucServiceException {
@@ -501,10 +501,10 @@ public class MultiUserChat {
* @throws XMPPErrorException if the room couldn't be created for some reason (e.g. 405 error if
* the user is not allowed to create the room)
* @throws NoResponseException if there was no response from the server.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
* @throws MucAlreadyJoinedException if the MUC is already joined
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NotConnectedException
+ * @throws NotAMucServiceException
*/
public synchronized MucCreateConfigFormHandle createOrJoin(MucEnterConfiguration mucEnterConfiguration)
throws NoResponseException, XMPPErrorException, InterruptedException, MucAlreadyJoinedException, NotConnectedException, NotAMucServiceException {
@@ -539,10 +539,10 @@ public class MultiUserChat {
* Create an instant room. The default configuration will be accepted and the room will become unlocked, i.e.
* other users are able to join.
*
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-45 § 10.1.2 Creating an
* Instant Room
*/
@@ -555,10 +555,10 @@ public class MultiUserChat {
* Alias for {@link MultiUserChat#getConfigFormManager()}.
*
* @return a MUC configuration form manager for this room.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see MultiUserChat#getConfigFormManager()
*/
public MucConfigFormManager getConfigFormManager() throws NoResponseException,
@@ -573,11 +573,11 @@ public class MultiUserChat {
* @param nickname the required nickname to use.
* @param password the optional password required to join
* @return A {@link MucCreateConfigFormHandle} if the room was created while joining, or {@code null} if the room was just joined.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotAMucServiceException
*/
public MucCreateConfigFormHandle createOrJoinIfNecessary(Resourcepart nickname, String password) throws NoResponseException,
XMPPErrorException, NotConnectedException, InterruptedException, NotAMucServiceException {
@@ -602,7 +602,7 @@ public class MultiUserChat {
* joining the room, the room will decide the amount of history to send.
*
* @param nickname the nickname to use.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws NoResponseException
* @throws XMPPErrorException if an error occurs joining the room. In particular, a
* 401 error can occur if no password was provided and one is required; or a
* 403 error can occur if the user is banned; or a
@@ -610,9 +610,9 @@ public class MultiUserChat {
* 407 error can occur if user is not on the member list; or a
* 409 error can occur if someone is already in the group chat with the same nickname.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotAMucServiceException
*/
public void join(Resourcepart nickname) throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException, NotAMucServiceException {
@@ -638,10 +638,10 @@ public class MultiUserChat {
* 404 error can occur if the room does not exist or is locked; or a
* 407 error can occur if user is not on the member list; or a
* 409 error can occur if someone is already in the group chat with the same nickname.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
+ * @throws InterruptedException
+ * @throws NotConnectedException
* @throws NoResponseException if there was no response from the server.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NotAMucServiceException
*/
public void join(Resourcepart nickname, String password) throws XMPPErrorException, InterruptedException, NoResponseException, NotConnectedException, NotAMucServiceException {
MucEnterConfiguration.Builder builder = getEnterConfigurationBuilder(nickname).withPassword(
@@ -671,9 +671,9 @@ public class MultiUserChat {
* 407 error can occur if user is not on the member list; or a
* 409 error can occur if someone is already in the group chat with the same nickname.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotAMucServiceException
*/
public synchronized void join(MucEnterConfiguration mucEnterConfiguration)
throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException, NotAMucServiceException {
@@ -704,11 +704,11 @@ public class MultiUserChat {
* Leave the chat room.
*
* @return the leave presence as reflected by the MUC.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws MucNotJoinedException
* @deprecated use {@link #leave()} instead.
*/
@Deprecated
@@ -721,11 +721,11 @@ public class MultiUserChat {
* Leave the chat room.
*
* @return the leave presence as reflected by the MUC.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws MucNotJoinedException
*/
public synchronized Presence leave()
throws NotConnectedException, InterruptedException, NoResponseException, XMPPErrorException, MucNotJoinedException {
@@ -768,10 +768,10 @@ public class MultiUserChat {
*
*
* @return a MUC configuration form manager for this room.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-45 § 10.2 Subsequent Room Configuration
* @since 4.2
*/
@@ -789,8 +789,8 @@ public class MultiUserChat {
* null if no configuration is possible.
* @throws XMPPErrorException if an error occurs asking the configuration form for the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getConfigurationForm() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCOwner iq = new MUCOwner();
@@ -808,8 +808,8 @@ public class MultiUserChat {
* @param form the form with the new settings.
* @throws XMPPErrorException if an error occurs setting the new rooms' configuration.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendConfigurationForm(Form form) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCOwner iq = new MUCOwner();
@@ -834,8 +834,8 @@ public class MultiUserChat {
* @throws XMPPErrorException if an error occurs asking the registration form for the room or a
* 405 error if the user is not allowed to register with the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getRegistrationForm() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Registration reg = new Registration();
@@ -860,8 +860,8 @@ public class MultiUserChat {
* 409 error can occur if the desired room nickname is already reserved for that room;
* or a 503 error can occur if the room does not support registration.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendRegistrationForm(Form form) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Registration reg = new Registration();
@@ -884,8 +884,8 @@ public class MultiUserChat {
* XMPP error code 403. The error code can be used to present more
* appropiate error messages to end-users.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void destroy(String reason, EntityBareJid alternateJID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCOwner iq = new MUCOwner();
@@ -923,8 +923,8 @@ public class MultiUserChat {
*
* @param user the user to invite to the room.(e.g. hecate@shakespeare.lit)
* @param reason the reason why the user is being invited.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void invite(EntityBareJid user, String reason) throws NotConnectedException, InterruptedException {
invite(new Message(), user, reason);
@@ -940,8 +940,8 @@ public class MultiUserChat {
* @param message the message to use for sending the invitation.
* @param user the user to invite to the room.(e.g. hecate@shakespeare.lit)
* @param reason the reason why the user is being invited.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void invite(Message message, EntityBareJid user, String reason) throws NotConnectedException, InterruptedException {
// TODO listen for 404 error code when inviter supplies a non-existent JID
@@ -1067,7 +1067,7 @@ public class MultiUserChat {
*
* @return the reserved room nickname or null if none.
* @throws SmackException if there was no response from the server.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public String getReservedNickname() throws SmackException, InterruptedException {
try {
@@ -1111,9 +1111,9 @@ public class MultiUserChat {
* @param nickname the new nickname within the room.
* @throws XMPPErrorException if the new nickname is already in use by another occupant.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws MucNotJoinedException
*/
public synchronized void changeNickname(Resourcepart nickname) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, MucNotJoinedException {
Objects.requireNonNull(nickname, "Nickname must not be null or blank.");
@@ -1150,9 +1150,9 @@ public class MultiUserChat {
*
* @param status a text message describing the presence update.
* @param mode the mode type for the presence update.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws MucNotJoinedException
*/
public void changeAvailabilityStatus(String status, Presence.Mode mode) throws NotConnectedException, InterruptedException, MucNotJoinedException {
final EntityFullJid myRoomJid = this.myRoomJid;
@@ -1194,8 +1194,8 @@ public class MultiUserChat {
* not have kicking privileges (i.e. Forbidden error); or a
* 400 error can occur if the provided nickname is not present in the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void kickParticipant(Resourcepart nickname, String reason) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nickname, MUCRole.none, reason);
@@ -1204,8 +1204,8 @@ public class MultiUserChat {
/**
* Sends a voice request to the MUC. The room moderators usually need to approve this request.
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-45 § 7.13 Requesting
* Voice
* @since 4.1
@@ -1236,8 +1236,8 @@ public class MultiUserChat {
* a moderator in this room (i.e. Forbidden error); or a
* 400 error can occur if the provided nickname is not present in the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantVoice(Collection nicknames) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nicknames, MUCRole.participant);
@@ -1254,8 +1254,8 @@ public class MultiUserChat {
* a moderator in this room (i.e. Forbidden error); or a
* 400 error can occur if the provided nickname is not present in the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantVoice(Resourcepart nickname) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nickname, MUCRole.participant, null);
@@ -1272,8 +1272,8 @@ public class MultiUserChat {
* was tried to revoke his voice (i.e. Not Allowed error); or a
* 400 error can occur if the provided nickname is not present in the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeVoice(Collection nicknames) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nicknames, MUCRole.visitor);
@@ -1290,8 +1290,8 @@ public class MultiUserChat {
* was tried to revoke his voice (i.e. Not Allowed error); or a
* 400 error can occur if the provided nickname is not present in the room.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeVoice(Resourcepart nickname) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nickname, MUCRole.visitor, null);
@@ -1309,8 +1309,8 @@ public class MultiUserChat {
* 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin"
* was tried to be banned (i.e. Not Allowed error).
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void banUsers(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.outcast);
@@ -1329,8 +1329,8 @@ public class MultiUserChat {
* 405 error can occur if a moderator or a user with an affiliation of "owner" or "admin"
* was tried to be banned (i.e. Not Allowed error).
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void banUser(Jid jid, String reason) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.outcast, reason);
@@ -1344,8 +1344,8 @@ public class MultiUserChat {
* @param jids the XMPP user IDs of the users to grant membership.
* @throws XMPPErrorException if an error occurs granting membership to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantMembership(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.member);
@@ -1359,8 +1359,8 @@ public class MultiUserChat {
* @param jid the XMPP user ID of the user to grant membership (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs granting membership to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantMembership(Jid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.member, null);
@@ -1375,8 +1375,8 @@ public class MultiUserChat {
* @param jids the bare XMPP user IDs of the users to revoke membership.
* @throws XMPPErrorException if an error occurs revoking membership to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeMembership(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.none);
@@ -1391,8 +1391,8 @@ public class MultiUserChat {
* @param jid the bare XMPP user ID of the user to revoke membership (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs revoking membership to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeMembership(Jid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.none, null);
@@ -1406,8 +1406,8 @@ public class MultiUserChat {
* @param nicknames the nicknames of the occupants to grant moderator privileges.
* @throws XMPPErrorException if an error occurs granting moderator privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantModerator(Collection nicknames) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nicknames, MUCRole.moderator);
@@ -1421,8 +1421,8 @@ public class MultiUserChat {
* @param nickname the nickname of the occupant to grant moderator privileges.
* @throws XMPPErrorException if an error occurs granting moderator privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantModerator(Resourcepart nickname) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nickname, MUCRole.moderator, null);
@@ -1437,8 +1437,8 @@ public class MultiUserChat {
* @param nicknames the nicknames of the occupants to revoke moderator privileges.
* @throws XMPPErrorException if an error occurs revoking moderator privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeModerator(Collection nicknames) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nicknames, MUCRole.participant);
@@ -1453,8 +1453,8 @@ public class MultiUserChat {
* @param nickname the nickname of the occupant to revoke moderator privileges.
* @throws XMPPErrorException if an error occurs revoking moderator privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeModerator(Resourcepart nickname) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeRole(nickname, MUCRole.participant, null);
@@ -1469,8 +1469,8 @@ public class MultiUserChat {
* @param jids the collection of bare XMPP user IDs of the users to grant ownership.
* @throws XMPPErrorException if an error occurs granting ownership privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantOwnership(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.owner);
@@ -1485,8 +1485,8 @@ public class MultiUserChat {
* @param jid the bare XMPP user ID of the user to grant ownership (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs granting ownership privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantOwnership(Jid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.owner, null);
@@ -1500,8 +1500,8 @@ public class MultiUserChat {
* @param jids the bare XMPP user IDs of the users to revoke ownership.
* @throws XMPPErrorException if an error occurs revoking ownership privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeOwnership(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.admin);
@@ -1515,8 +1515,8 @@ public class MultiUserChat {
* @param jid the bare XMPP user ID of the user to revoke ownership (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs revoking ownership privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeOwnership(Jid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.admin, null);
@@ -1530,8 +1530,8 @@ public class MultiUserChat {
* @param jids the bare XMPP user IDs of the users to grant administrator privileges.
* @throws XMPPErrorException if an error occurs granting administrator privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantAdmin(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.admin);
@@ -1546,8 +1546,8 @@ public class MultiUserChat {
* (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs granting administrator privileges to a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void grantAdmin(Jid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.admin);
@@ -1561,8 +1561,8 @@ public class MultiUserChat {
* @param jids the bare XMPP user IDs of the user to revoke administrator privileges.
* @throws XMPPErrorException if an error occurs revoking administrator privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeAdmin(Collection jids) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jids, MUCAffiliation.admin);
@@ -1577,8 +1577,8 @@ public class MultiUserChat {
* (e.g. "user@host.org").
* @throws XMPPErrorException if an error occurs revoking administrator privileges from a user.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void revokeAdmin(EntityJid jid) throws XMPPErrorException, NoResponseException, NotConnectedException, InterruptedException {
changeAffiliationByAdmin(jid, MUCAffiliation.member);
@@ -1587,12 +1587,12 @@ public class MultiUserChat {
/**
* Tries to change the affiliation with an 'muc#admin' namespace
*
- * @param jid TODO javadoc me please
- * @param affiliation TODO javadoc me please
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param jid
+ * @param affiliation
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private void changeAffiliationByAdmin(Jid jid, MUCAffiliation affiliation)
throws NoResponseException, XMPPErrorException,
@@ -1603,13 +1603,13 @@ public class MultiUserChat {
/**
* Tries to change the affiliation with an 'muc#admin' namespace
*
- * @param jid TODO javadoc me please
- * @param affiliation TODO javadoc me please
+ * @param jid
+ * @param affiliation
* @param reason the reason for the affiliation change (optional)
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private void changeAffiliationByAdmin(Jid jid, MUCAffiliation affiliation, String reason) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCAdmin iq = new MUCAdmin();
@@ -1750,8 +1750,8 @@ public class MultiUserChat {
* @return a list of Affiliate with the room owners.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getOwners() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getAffiliatesByAdmin(MUCAffiliation.owner);
@@ -1763,8 +1763,8 @@ public class MultiUserChat {
* @return a list of Affiliate with the room administrators.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getAdmins() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getAffiliatesByAdmin(MUCAffiliation.admin);
@@ -1776,8 +1776,8 @@ public class MultiUserChat {
* @return a list of Affiliate with the room members.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getMembers() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getAffiliatesByAdmin(MUCAffiliation.member);
@@ -1789,8 +1789,8 @@ public class MultiUserChat {
* @return a list of Affiliate with the room outcasts.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getOutcasts() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getAffiliatesByAdmin(MUCAffiliation.outcast);
@@ -1804,8 +1804,8 @@ public class MultiUserChat {
* @return a collection of Affiliate that have the specified room affiliation.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private List getAffiliatesByAdmin(MUCAffiliation affiliation) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCAdmin iq = new MUCAdmin();
@@ -1831,8 +1831,8 @@ public class MultiUserChat {
* @return a list of Occupant with the room moderators.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getModerators() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getOccupants(MUCRole.moderator);
@@ -1844,8 +1844,8 @@ public class MultiUserChat {
* @return a list of Occupant with the room participants.
* @throws XMPPErrorException if you don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getParticipants() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getOccupants(MUCRole.participant);
@@ -1859,8 +1859,8 @@ public class MultiUserChat {
* @throws XMPPErrorException if an error occured while performing the request to the server or you
* don't have enough privileges to get this information.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private List getOccupants(MUCRole role) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCAdmin iq = new MUCAdmin();
@@ -1883,8 +1883,8 @@ public class MultiUserChat {
* Sends a message to the chat room.
*
* @param text the text of the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendMessage(String text) throws NotConnectedException, InterruptedException {
Message message = createMessage();
@@ -1923,8 +1923,8 @@ public class MultiUserChat {
* Sends a Message to the chat room.
*
* @param message the message.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendMessage(Message message) throws NotConnectedException, InterruptedException {
message.setTo(room);
@@ -1942,7 +1942,7 @@ public class MultiUserChat {
*
* @return the next message if one is immediately available and
* null otherwise.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
+ * @throws MucNotJoinedException
*/
public Message pollMessage() throws MucNotJoinedException {
if (messageCollector == null) {
@@ -1956,8 +1956,8 @@ public class MultiUserChat {
* (not return) until a message is available.
*
* @return the next message.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws MucNotJoinedException
+ * @throws InterruptedException
*/
public Message nextMessage() throws MucNotJoinedException, InterruptedException {
if (messageCollector == null) {
@@ -1974,8 +1974,8 @@ public class MultiUserChat {
* @param timeout the maximum amount of time to wait for the next message.
* @return the next message, or null if the timeout elapses without a
* message becoming available.
- * @throws MucNotJoinedException if not joined to the Multi-User Chat.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws MucNotJoinedException
+ * @throws InterruptedException
*/
public Message nextMessage(long timeout) throws MucNotJoinedException, InterruptedException {
if (messageCollector == null) {
@@ -2020,8 +2020,8 @@ public class MultiUserChat {
* @throws XMPPErrorException if someone without appropriate privileges attempts to change the
* room subject will throw an error with code 403 (i.e. Forbidden)
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void changeSubject(final String subject) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Message message = createMessage();
@@ -2367,10 +2367,10 @@ public class MultiUserChat {
/**
* Fires events according to the received presence code.
*
- * @param statusCodes TODO javadoc me please
- * @param isUserModification TODO javadoc me please
- * @param mucUser TODO javadoc me please
- * @param from TODO javadoc me please
+ * @param statusCodes
+ * @param isUserModification
+ * @param mucUser
+ * @param from
*/
private void checkPresenceCode(
Set statusCodes,
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChatManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChatManager.java
index d2cb2e122..97d70a862 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChatManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/MultiUserChatManager.java
@@ -120,7 +120,7 @@ public final class MultiUserChatManager extends Manager {
/**
* Get a instance of a multi user chat manager for the given connection.
*
- * @param connection TODO javadoc me please
+ * @param connection
* @return a multi user chat manager.
*/
public static synchronized MultiUserChatManager getInstanceFor(XMPPConnection connection) {
@@ -281,10 +281,10 @@ public final class MultiUserChatManager extends Manager {
*
* @param user the user to check. A fully qualified xmpp ID, e.g. jdoe@example.com.
* @return a boolean indicating whether the specified user supports the MUC protocol.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean isServiceEnabled(Jid user) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return serviceDiscoveryManager.supportsFeature(user, MUCInitialPresence.NAMESPACE);
@@ -309,10 +309,10 @@ public final class MultiUserChatManager extends Manager {
*
* @param user the user to check. A fully qualified xmpp ID, e.g. jdoe@example.com.
* @return a List of the rooms where the requested user has joined.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getJoinedRooms(EntityFullJid user) throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException {
@@ -338,10 +338,10 @@ public final class MultiUserChatManager extends Manager {
*
* @param room the name of the room in the form "roomName@service" of which we want to discover its information.
* @return the discovered information of a given room without actually having to join the room.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public RoomInfo getRoomInfo(EntityBareJid room) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
DiscoverInfo info = serviceDiscoveryManager.discoverInfo(room);
@@ -352,10 +352,10 @@ public final class MultiUserChatManager extends Manager {
* Returns a collection with the XMPP addresses of the Multi-User Chat services.
*
* @return a collection with the XMPP addresses of the Multi-User Chat services.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getMucServiceDomains() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return serviceDiscoveryManager.findServices(MUCInitialPresence.NAMESPACE, false, false);
@@ -365,10 +365,10 @@ public final class MultiUserChatManager extends Manager {
* Returns a collection with the XMPP addresses of the Multi-User Chat services.
*
* @return a collection with the XMPP addresses of the Multi-User Chat services.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link #getMucServiceDomains()} instead.
*/
// TODO: Remove in Smack 4.5
@@ -382,10 +382,10 @@ public final class MultiUserChatManager extends Manager {
*
* @param domainBareJid the domain bare JID to check.
* @return true if the provided JID provides a MUC service, false otherwise.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-45 § 6.2 Discovering the Features Supported by a MUC Service
* @since 4.2
*/
@@ -402,11 +402,11 @@ public final class MultiUserChatManager extends Manager {
*
* @param serviceName the service that is hosting the rooms to discover.
* @return a map from the room's address to its HostedRoom information.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAMucServiceException if the entity is not a MUC serivce.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotAMucServiceException
* @since 4.3.1
*/
public Map getRoomsHostedBy(DomainBareJid serviceName) throws NoResponseException, XMPPErrorException,
@@ -434,8 +434,8 @@ public final class MultiUserChatManager extends Manager {
* @param room the room that sent the original invitation.
* @param inviter the inviter of the declined invitation.
* @param reason the reason why the invitee is declining the invitation.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void decline(EntityBareJid room, EntityBareJid inviter, String reason) throws NotConnectedException, InterruptedException {
Message message = new Message(room);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/GroupChatInvitation.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/GroupChatInvitation.java
index f1244870e..d00f71586 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/GroupChatInvitation.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/GroupChatInvitation.java
@@ -113,7 +113,7 @@ public class GroupChatInvitation implements ExtensionElement {
/**
* Deprecated.
- * @param packet TODO javadoc me please
+ * @param packet
* @return the GroupChatInvitation or null
* @deprecated use {@link #from(Stanza)} instead
*/
@@ -124,7 +124,7 @@ public class GroupChatInvitation implements ExtensionElement {
/**
* Get the group chat invitation from the given stanza.
- * @param packet TODO javadoc me please
+ * @param packet
* @return the GroupChatInvitation or null
*/
public static GroupChatInvitation from(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCInitialPresence.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCInitialPresence.java
index e47450932..f96e5e835 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCInitialPresence.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCInitialPresence.java
@@ -140,7 +140,7 @@ public class MUCInitialPresence implements ExtensionElement {
/**
* Retrieve the MUCInitialPresence PacketExtension from packet, if any.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return the MUCInitialPresence PacketExtension or {@code null}
* @deprecated use {@link #from(Stanza)} instead
*/
@@ -152,7 +152,7 @@ public class MUCInitialPresence implements ExtensionElement {
/**
* Retrieve the MUCInitialPresence PacketExtension from packet, if any.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return the MUCInitialPresence PacketExtension or {@code null}
*/
public static MUCInitialPresence from(Stanza packet) {
@@ -169,10 +169,22 @@ public class MUCInitialPresence implements ExtensionElement {
public static final String ELEMENT = "history";
- private final int maxChars;
- private final int maxStanzas;
- private final int seconds;
- private final Date since;
+ // TODO make those fields final once the deprecated setter methods have been removed.
+ private int maxChars;
+ private int maxStanzas;
+ private int seconds;
+ private Date since;
+
+ /**
+ * Deprecated constructor.
+ * @deprecated use {@link #History(int, int, int, Date)} instead.
+ */
+ @Deprecated
+ public History() {
+ this.maxChars = -1;
+ this.maxStanzas = -1;
+ this.seconds = -1;
+ }
public History(int maxChars, int maxStanzas, int seconds, Date since) {
if (maxChars < 0 && maxStanzas < 0 && seconds < 0 && since == null) {
@@ -224,6 +236,55 @@ public class MUCInitialPresence implements ExtensionElement {
return since;
}
+ /**
+ * Sets the total number of characters to receive in the history.
+ *
+ * @param maxChars the total number of characters to receive in the history.
+ * @deprecated use {@link #History(int, int, int, Date)} instead.
+ */
+ @Deprecated
+ public void setMaxChars(int maxChars) {
+ this.maxChars = maxChars;
+ }
+
+ /**
+ * Sets the total number of messages to receive in the history.
+ *
+ * @param maxStanzas the total number of messages to receive in the history.
+ * @deprecated use {@link #History(int, int, int, Date)} instead.
+ */
+ @Deprecated
+ public void setMaxStanzas(int maxStanzas) {
+ this.maxStanzas = maxStanzas;
+ }
+
+ /**
+ * Sets the number of seconds to use to filter the messages received during that time.
+ * In other words, only the messages received in the last "X" seconds will be included in
+ * the history.
+ *
+ * @param seconds the number of seconds to use to filter the messages received during
+ * that time.
+ * @deprecated use {@link #History(int, int, int, Date)} instead.
+ */
+ @Deprecated
+ public void setSeconds(int seconds) {
+ this.seconds = seconds;
+ }
+
+ /**
+ * Sets the since date to use to filter the messages received during that time.
+ * In other words, only the messages received since the datetime specified will be
+ * included in the history.
+ *
+ * @param since the since date to use to filter the messages received during that time.
+ * @deprecated use {@link #History(int, int, int, Date)} instead.
+ */
+ @Deprecated
+ public void setSince(Date since) {
+ this.since = since;
+ }
+
@Override
public XmlStringBuilder toXML(org.jivesoftware.smack.packet.XmlEnvironment enclosingNamespace) {
XmlStringBuilder xml = new XmlStringBuilder(this);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCItem.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCItem.java
index c1ee5ae28..b2b49c9b7 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCItem.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCItem.java
@@ -71,11 +71,11 @@ public class MUCItem implements NamedElement {
*
* @param affiliation the actor's affiliation to the room
* @param role the privilege level of an occupant within a room.
- * @param actor TODO javadoc me please
- * @param reason TODO javadoc me please
- * @param jid TODO javadoc me please
- * @param nick TODO javadoc me please
- * @param actorNick TODO javadoc me please
+ * @param actor
+ * @param reason
+ * @param jid
+ * @param nick
+ * @param actorNick
*/
public MUCItem(MUCAffiliation affiliation, MUCRole role, Jid actor,
String reason, Jid jid, Resourcepart nick, Resourcepart actorNick) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCUser.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCUser.java
index 9d5ff84a9..eba5144fe 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCUser.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/packet/MUCUser.java
@@ -220,7 +220,7 @@ public class MUCUser implements ExtensionElement {
/**
* Retrieve the MUCUser PacketExtension from packet, if any.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return the MUCUser PacketExtension or {@code null}
* @deprecated use {@link #from(Stanza)} instead
*/
@@ -232,7 +232,7 @@ public class MUCUser implements ExtensionElement {
/**
* Retrieve the MUCUser PacketExtension from packet, if any.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return the MUCUser PacketExtension or {@code null}
*/
public static MUCUser from(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/provider/MUCUserProvider.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/provider/MUCUserProvider.java
index 4eed95435..d96f1fc42 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/provider/MUCUserProvider.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/muc/provider/MUCUserProvider.java
@@ -43,8 +43,8 @@ public class MUCUserProvider extends ExtensionElementProvider {
*
* @param parser the XML parser, positioned at the starting element of the extension.
* @return a PacketExtension.
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public MUCUser parse(XmlPullParser parser, int initialDepth, XmlEnvironment xmlEnvironment) throws XmlPullParserException, IOException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/OfflineMessageManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/OfflineMessageManager.java
index 367e7811a..f1bbb7d7e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/OfflineMessageManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/OfflineMessageManager.java
@@ -81,8 +81,8 @@ public class OfflineMessageManager {
* @return a boolean indicating if the server supports Flexible Offline Message Retrieval.
* @throws XMPPErrorException If the user is not allowed to make this request.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean supportsFlexibleRetrieval() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection).serverSupportsFeature(namespace);
@@ -95,8 +95,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public int getMessageCount() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
DiscoverInfo info = ServiceDiscoveryManager.getInstanceFor(connection).discoverInfo(null,
@@ -119,8 +119,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getHeaders() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
List answer = new ArrayList<>();
@@ -144,8 +144,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getMessages(final List nodes) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
List messages = new ArrayList<>(nodes.size());
@@ -192,8 +192,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getMessages() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
OfflineMessageRequest request = new OfflineMessageRequest();
@@ -226,8 +226,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteMessages(List nodes) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
OfflineMessageRequest request = new OfflineMessageRequest();
@@ -246,8 +246,8 @@ public class OfflineMessageManager {
* @throws XMPPErrorException If the user is not allowed to make this request or the server does
* not support offline message retrieval.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteMessages() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
OfflineMessageRequest request = new OfflineMessageRequest();
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/packet/OfflineMessageInfo.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/packet/OfflineMessageInfo.java
index ee80d5a9b..0bbb078ba 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/packet/OfflineMessageInfo.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/offline/packet/OfflineMessageInfo.java
@@ -99,8 +99,8 @@ public class OfflineMessageInfo implements ExtensionElement {
*
* @param parser the XML parser, positioned at the starting element of the extension.
* @return a PacketExtension.
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public OfflineMessageInfo parse(XmlPullParser parser,
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pep/PepManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pep/PepManager.java
index b31a3d3e2..d41d4b89d 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pep/PepManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pep/PepManager.java
@@ -153,11 +153,11 @@ public final class PepManager extends Manager {
* @param nodeId the ID of the node to publish on.
* @param item the item to publish.
* @return the leaf node the item was published on.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotALeafNodeException
*/
public LeafNode publish(String nodeId, Item item) throws NotConnectedException, InterruptedException,
NoResponseException, XMPPErrorException, NotALeafNodeException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/ping/PingManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/ping/PingManager.java
index 0bb1b0e65..89d4b5bb3 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/ping/PingManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/ping/PingManager.java
@@ -79,7 +79,7 @@ public final class PingManager extends Manager {
* Retrieves a {@link PingManager} for the specified {@link XMPPConnection}, creating one if it doesn't already
* exist.
*
- * @param connection TODO javadoc me please
+ * @param connection
* The connection the manager is attached to.
* @return The new or existing manager.
*/
@@ -223,8 +223,8 @@ public final class PingManager extends Manager {
* @param pingTimeout The time to wait for a reply in milliseconds
* @return true if a reply was received from the entity, false otherwise.
* @throws NoResponseException if there was no response from the jid.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean ping(Jid jid, long pingTimeout) throws NotConnectedException, NoResponseException, InterruptedException {
final XMPPConnection connection = connection();
@@ -249,9 +249,9 @@ public final class PingManager extends Manager {
*
* @param jid The id of the entity the ping is being sent to
* @return true if a reply was received from the entity, false otherwise.
- * @throws NotConnectedException if the XMPP connection is not connected.
+ * @throws NotConnectedException
* @throws NoResponseException if there was no response from the jid.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public boolean ping(Jid jid) throws NotConnectedException, NoResponseException, InterruptedException {
return ping(jid, connection().getReplyTimeout());
@@ -264,8 +264,8 @@ public final class PingManager extends Manager {
* @return true if it supports ping, false otherwise.
* @throws XMPPErrorException An XMPP related error occurred during the request
* @throws NoResponseException if there was no response from the jid.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean isPingSupported(Jid jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).supportsFeature(jid, Ping.NAMESPACE);
@@ -279,8 +279,8 @@ public final class PingManager extends Manager {
* {@link #isPingSupported(Jid)} is false.
*
* @return true if a reply was received from the server, false otherwise.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean pingMyServer() throws NotConnectedException, InterruptedException {
return pingMyServer(true);
@@ -295,8 +295,8 @@ public final class PingManager extends Manager {
*
* @param notifyListeners Notify the PingFailedListener in case of error if true
* @return true if the user's server could be pinged.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean pingMyServer(boolean notifyListeners) throws NotConnectedException, InterruptedException {
return pingMyServer(notifyListeners, connection().getReplyTimeout());
@@ -312,8 +312,8 @@ public final class PingManager extends Manager {
* @param notifyListeners Notify the PingFailedListener in case of error if true
* @param pingTimeout The time to wait for a reply in milliseconds
* @return true if the user's server could be pinged.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean pingMyServer(boolean notifyListeners, long pingTimeout) throws NotConnectedException, InterruptedException {
boolean res;
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/privacy/PrivacyListManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/privacy/PrivacyListManager.java
index bf40cc8e6..6e3dcd405 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/privacy/PrivacyListManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/privacy/PrivacyListManager.java
@@ -224,10 +224,10 @@ public final class PrivacyListManager extends Manager {
* @param requestPrivacy is the {@link Privacy} stanza configured properly whose XML
* will be sent to the server.
* @return a new {@link Privacy} with the data received from the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private Privacy getRequest(Privacy requestPrivacy) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request is a get iq type
@@ -243,10 +243,10 @@ public final class PrivacyListManager extends Manager {
* @param requestPrivacy is the {@link Privacy} stanza configured properly whose xml will be
* sent to the server.
* @return a new {@link Privacy} with the data received from the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private Stanza setRequest(Privacy requestPrivacy) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request is a get iq type
@@ -259,10 +259,10 @@ public final class PrivacyListManager extends Manager {
* Answer a privacy containing the list structure without {@link PrivacyItem}.
*
* @return a Privacy with the list names.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private Privacy getPrivacyWithListNames() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an empty privacy message
@@ -276,10 +276,10 @@ public final class PrivacyListManager extends Manager {
* Answer the active privacy list. Returns null if there is no active list.
*
* @return the privacy list of the active list.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public PrivacyList getActiveList() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Privacy privacyAnswer = this.getPrivacyWithListNames();
@@ -295,10 +295,10 @@ public final class PrivacyListManager extends Manager {
* Get the name of the active list.
*
* @return the name of the active list or null if there is none set.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.1
*/
public String getActiveListName() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -312,10 +312,10 @@ public final class PrivacyListManager extends Manager {
* Answer the default privacy list. Returns null if there is no default list.
*
* @return the privacy list of the default list.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public PrivacyList getDefaultList() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Privacy privacyAnswer = this.getPrivacyWithListNames();
@@ -331,10 +331,10 @@ public final class PrivacyListManager extends Manager {
* Get the name of the default list.
*
* @return the name of the default list or null if there is none set.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.1
*/
public String getDefaultListName() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -352,10 +352,10 @@ public final class PrivacyListManager extends Manager {
*
*
* @return the name of the effective privacy list or null if there is none set.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.1
*/
public String getEffectiveListName() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -371,10 +371,10 @@ public final class PrivacyListManager extends Manager {
*
* @param listName the name of the list to get the allowed and blocked permissions.
* @return a list of privacy items under the list listName.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private List getPrivacyListItems(String listName) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
assert StringUtils.isNotEmpty(listName);
@@ -393,10 +393,10 @@ public final class PrivacyListManager extends Manager {
*
* @param listName the name of the list to get the allowed and blocked permissions.
* @return a privacy list under the list listName.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public PrivacyList getPrivacyList(String listName) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
listName = StringUtils.requireNotNullNorEmpty(listName, "List name must not be null");
@@ -407,10 +407,10 @@ public final class PrivacyListManager extends Manager {
* Answer every privacy list with the allowed and blocked permissions.
*
* @return an array of privacy lists.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getPrivacyLists() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Privacy privacyAnswer = getPrivacyWithListNames();
@@ -429,10 +429,10 @@ public final class PrivacyListManager extends Manager {
* Set or change the active list to listName.
*
* @param listName the list name to set as the active one.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void setActiveListName(String listName) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an privacy message with an empty list
@@ -445,10 +445,10 @@ public final class PrivacyListManager extends Manager {
/**
* Client declines the use of active lists.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void declineActiveList() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an privacy message with an empty list
@@ -463,10 +463,10 @@ public final class PrivacyListManager extends Manager {
* Set or change the default list to listName.
*
* @param listName the list name to set as the default one.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void setDefaultListName(String listName) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an privacy message with an empty list
@@ -479,10 +479,10 @@ public final class PrivacyListManager extends Manager {
/**
* Client declines the use of default lists.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void declineDefaultList() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an privacy message with an empty list
@@ -498,10 +498,10 @@ public final class PrivacyListManager extends Manager {
*
* @param listName the list that has changed its content.
* @param privacyItems a List with every privacy item in the list.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void createPrivacyList(String listName, List privacyItems) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
updatePrivacyList(listName, privacyItems);
@@ -514,10 +514,10 @@ public final class PrivacyListManager extends Manager {
*
* @param listName the list that has changed its content.
* @param privacyItems a List with every privacy item in the list.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void updatePrivacyList(String listName, List privacyItems) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Build the privacy package to add or update the new list
@@ -532,10 +532,10 @@ public final class PrivacyListManager extends Manager {
* Remove a privacy list.
*
* @param listName the list that has changed its content.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deletePrivacyList(String listName) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// The request of the list is an privacy message with an empty list
@@ -560,7 +560,7 @@ public final class PrivacyListManager extends Manager {
/**
* Removes the privacy list listener.
*
- * @param listener TODO javadoc me please
+ * @param listener
* @return true, if the listener was removed.
*/
public boolean removeListener(PrivacyListListener listener) {
@@ -571,10 +571,10 @@ public final class PrivacyListManager extends Manager {
* Check if the user's server supports privacy lists.
*
* @return true, if the server supports privacy lists, false otherwise.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean isSupported() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).serverSupportsFeature(NAMESPACE);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Affiliation.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Affiliation.java
index 982f8668d..65195cca0 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Affiliation.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Affiliation.java
@@ -95,8 +95,8 @@ public class Affiliation implements ExtensionElement {
/**
* Construct a affiliation modification request.
*
- * @param jid TODO javadoc me please
- * @param affiliation TODO javadoc me please
+ * @param jid
+ * @param affiliation
*/
public Affiliation(BareJid jid, Type affiliation) {
this(jid, affiliation, AffiliationNamespace.owner);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ConfigureForm.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ConfigureForm.java
index d77602583..f3671d07b 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ConfigureForm.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ConfigureForm.java
@@ -39,7 +39,7 @@ public class ConfigureForm extends Form {
* Create a decorator from an existing {@link DataForm} that has been
* retrieved from parsing a node configuration request.
*
- * @param configDataForm TODO javadoc me please
+ * @param configDataForm
*/
public ConfigureForm(DataForm configDataForm) {
super(configDataForm);
@@ -50,7 +50,7 @@ public class ConfigureForm extends Form {
* Typically, this can be used to create a decorator for an answer form
* by using the result of {@link #createAnswerForm()} as the input parameter.
*
- * @param nodeConfigForm TODO javadoc me please
+ * @param nodeConfigForm
*/
public ConfigureForm(Form nodeConfigForm) {
super(nodeConfigForm.getDataFormToSend());
@@ -61,7 +61,7 @@ public class ConfigureForm extends Form {
* when creating and configuring a node at the same time via {@link PubSubManager#createNode(String, Form)}, since
* configuration of an existing node is typically accomplished by calling {@link LeafNode#getNodeConfiguration()} and
* using the resulting form to create a answer form. See {@link #ConfigureForm(Form)}.
- * @param formType TODO javadoc me please
+ * @param formType
*/
public ConfigureForm(DataForm.Type formType) {
super(formType);
@@ -84,7 +84,7 @@ public class ConfigureForm extends Form {
/**
* Sets the value of access model.
*
- * @param accessModel TODO javadoc me please
+ * @param accessModel
*/
public void setAccessModel(AccessModel accessModel) {
addField(ConfigureNodeFields.access_model, FormField.Type.list_single);
@@ -124,7 +124,7 @@ public class ConfigureForm extends Form {
/**
* Set the list of child node ids that are associated with a collection node.
*
- * @param children TODO javadoc me please
+ * @param children
*/
public void setChildren(List children) {
addField(ConfigureNodeFields.children, FormField.Type.text_multi);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Item.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Item.java
index eaee0b168..04f277339 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Item.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Item.java
@@ -99,7 +99,6 @@ public class Item extends NodeExtension {
* Create an Item with an id but no payload. This is a valid item for nodes which are configured
* so that {@link ConfigureForm#isDeliverPayloads()} is false.
*
- * @param itemNamespace the namespace of the item.
* @param itemId The id if the item. It must be unique within the node unless overwriting and existing item.
* Passing null is the equivalent of calling {@link #Item()}.
*/
@@ -130,7 +129,6 @@ public class Item extends NodeExtension {
* (via {@link LeafNode#publish(Item)}, the server may return an
* error for an invalid packet.
*
- * @param itemNamespace the namespace of the item.
* @param itemId The id of the item.
* @param nodeId The id of the node which the item was published to.
*/
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ItemsExtension.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ItemsExtension.java
index 12d7a4aa6..c960a8843 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ItemsExtension.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/ItemsExtension.java
@@ -106,7 +106,7 @@ public class ItemsExtension extends NodeExtension implements EmbeddedPacketExten
*
* @param nodeId The node to which the items are being sent or deleted
* @param items The list of {@link Item} or {@link RetractItem}
- * @param notify TODO javadoc me please
+ * @param notify
*/
public ItemsExtension(String nodeId, List items, boolean notify) {
super(ItemsElementType.retract.getNodeElement(), nodeId);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/LeafNode.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/LeafNode.java
index be658275e..f2ea6abf0 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/LeafNode.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/LeafNode.java
@@ -47,10 +47,10 @@ public class LeafNode extends Node {
* {@link DiscoverItems} format.
*
* @return The item details in {@link DiscoverItems} format
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public DiscoverItems discoverItems() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
DiscoverItems items = new DiscoverItems();
@@ -64,10 +64,10 @@ public class LeafNode extends Node {
*
* @param type of the items.
* @return List of {@link Item} in the node
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getItems((List) null, null);
@@ -83,10 +83,10 @@ public class LeafNode extends Node {
* @param type of the items.
*
* @return List of {@link Item} in the node
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems(String subscriptionId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = createPubsubPacket(Type.get, new GetItemsRequest(getId(), subscriptionId));
@@ -104,10 +104,10 @@ public class LeafNode extends Node {
* @param type of the items.
*
* @return The list of {@link Item} with payload
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems(Collection ids) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
List- itemList = new ArrayList<>(ids.size());
@@ -126,10 +126,10 @@ public class LeafNode extends Node {
* @param type of the items.
*
* @return List of {@link Item}
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems(int maxItems) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = createPubsubPacket(Type.get, new GetItemsRequest(getId(), maxItems));
@@ -147,10 +147,10 @@ public class LeafNode extends Node {
* @return List of {@link Item}
* @param type of the items.
*
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems(int maxItems, String subscriptionId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = createPubsubPacket(Type.get, new GetItemsRequest(getId(), subscriptionId, maxItems));
@@ -171,10 +171,10 @@ public class LeafNode extends Node {
* @param type of the items.
*
* @return List of {@link Item}
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getItems(List additionalExtensions,
List returnedExtensions) throws NoResponseException,
@@ -208,10 +208,10 @@ public class LeafNode extends Node {
* This is only acceptable for nodes with {@link ConfigureForm#isPersistItems()}=false
* and {@link ConfigureForm#isDeliverPayloads()}=false.
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
* @deprecated use {@link #publish()} instead.
*/
@Deprecated
@@ -230,10 +230,10 @@ public class LeafNode extends Node {
* @param item - The item being sent
* @param type of the items.
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
* @deprecated use {@link #publish(Item)} instead.
*/
@SuppressWarnings("unchecked")
@@ -251,10 +251,10 @@ public class LeafNode extends Node {
* @param items - The collection of items being sent
* @param type of the items.
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
* @deprecated use {@link #publish(Collection)} instead.
*/
@Deprecated
@@ -269,10 +269,10 @@ public class LeafNode extends Node {
* This is only acceptable for nodes with {@link ConfigureForm#isPersistItems()}=false
* and {@link ConfigureForm#isDeliverPayloads()}=false.
*
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public void publish() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -296,10 +296,10 @@ public class LeafNode extends Node {
* @param item - The item being sent
* @param type of the items.
*
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
@SuppressWarnings("unchecked")
@@ -318,10 +318,10 @@ public class LeafNode extends Node {
* @param items - The collection of {@link Item} objects being sent
* @param type of the items.
*
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public void publish(Collection items) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -335,10 +335,10 @@ public class LeafNode extends Node {
*
*
Note: Some implementations may keep the last item
* sent.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteAllItems() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = createPubsubPacket(Type.set, new NodeExtension(PubSubElementType.PURGE_OWNER, getId()));
@@ -350,10 +350,10 @@ public class LeafNode extends Node {
* Delete the item with the specified id from the node.
*
* @param itemId The id of the item
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteItem(String itemId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Collection items = new ArrayList<>(1);
@@ -365,10 +365,10 @@ public class LeafNode extends Node {
* Delete the items with the specified id's from the node.
*
* @param itemIds The list of id's of items to delete
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void deleteItem(Collection itemIds) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
List- items = new ArrayList<>(itemIds.size());
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Node.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Node.java
index 2af5c3b19..05def395b 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Node.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/Node.java
@@ -83,10 +83,10 @@ public abstract class Node {
* via the {@link #sendConfigurationForm(Form)}.
*
* @return the configuration form
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ConfigureForm getNodeConfiguration() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub pubSub = createPubsubPacket(Type.get, new NodeExtension(
@@ -98,11 +98,11 @@ public abstract class Node {
/**
* Update the configuration with the contents of the new {@link Form}.
*
- * @param submitForm TODO javadoc me please
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param submitForm
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendConfigurationForm(Form submitForm) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub packet = createPubsubPacket(Type.set, new FormNode(FormNodeType.CONFIGURE_OWNER,
@@ -114,10 +114,10 @@ public abstract class Node {
* Discover node information in standard {@link DiscoverInfo} format.
*
* @return The discovery information about the node.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public DiscoverInfo discoverInfo() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
DiscoverInfo info = new DiscoverInfo();
@@ -130,10 +130,10 @@ public abstract class Node {
* Get the subscriptions currently associated with this node.
*
* @return List of {@link Subscription}
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public List getSubscriptions() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -147,14 +147,14 @@ public abstract class Node {
* {@code returnedExtensions} will be filled with the stanza extensions found in the answer.
*
*
- * @param additionalExtensions TODO javadoc me please
+ * @param additionalExtensions
* @param returnedExtensions a collection that will be filled with the returned packet
* extensions
* @return List of {@link Subscription}
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getSubscriptions(List additionalExtensions, Collection returnedExtensions)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -165,10 +165,10 @@ public abstract class Node {
* Get the subscriptions currently associated with this node as owner.
*
* @return List of {@link Subscription}
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see #getSubscriptionsAsOwner(List, Collection)
* @since 4.1
*/
@@ -189,13 +189,13 @@ public abstract class Node {
* {@code returnedExtensions} will be filled with the stanza extensions found in the answer.
*
*
- * @param additionalExtensions TODO javadoc me please
+ * @param additionalExtensions
* @param returnedExtensions a collection that will be filled with the returned stanza extensions
* @return List of {@link Subscription}
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-60 § 8.8.1 -
* Retrieve Subscriptions List
* @since 4.1
@@ -234,10 +234,10 @@ public abstract class Node {
*
* @param changedSubs subscriptions that have changed
* @return null or a PubSub stanza with additional information on success.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-60 § 8.8.2 Modify Subscriptions
* @since 4.3
*/
@@ -253,10 +253,10 @@ public abstract class Node {
* Get the affiliations of this node.
*
* @return List of {@link Affiliation}
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getAffiliations() throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException {
@@ -274,10 +274,10 @@ public abstract class Node {
* @param returnedExtensions a collection that will be filled with the returned packet
* extensions
* @return List of {@link Affiliation}
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getAffiliations(List additionalExtensions, Collection returnedExtensions)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -289,10 +289,10 @@ public abstract class Node {
* Retrieve the affiliation list for this node as owner.
*
* @return list of entities whose affiliation is not 'none'.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see #getAffiliations(List, Collection)
* @since 4.2
*/
@@ -312,10 +312,10 @@ public abstract class Node {
* @param returnedExtensions an optional collection that will be filled with the returned
* extension elements.
* @return list of entities whose affiliation is not 'none'.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-60 § 8.9.1 Retrieve Affiliations List
* @since 4.2
*/
@@ -351,12 +351,12 @@ public abstract class Node {
* Note that this is an optional PubSub feature ('pubsub#modify-affiliations').
*
*
- * @param affiliations TODO javadoc me please
+ * @param affiliations
* @return null or a PubSub stanza with additional information on success.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-60 § 8.9.2 Modify Affiliation
* @since 4.2
*/
@@ -385,10 +385,10 @@ public abstract class Node {
* the caller can configure it but is not required to do so.
* @param jid The jid to subscribe as.
* @return The subscription
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Subscription subscribe(Jid jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub pubSub = createPubsubPacket(Type.set, new SubscribeExtension(jid, getId()));
@@ -410,10 +410,10 @@ public abstract class Node {
*
* @param jidString The jid to subscribe as.
* @return The subscription
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @throws IllegalArgumentException if the provided string is not a valid JID.
* @deprecated use {@link #subscribe(Jid)} instead.
*/
@@ -443,13 +443,13 @@ public abstract class Node {
* the caller can configure it but is not required to do so.
*
* @param jid The jid to subscribe as.
- * @param subForm TODO javadoc me please
+ * @param subForm
*
* @return The subscription
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Subscription subscribe(Jid jid, SubscribeForm subForm) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = createPubsubPacket(Type.set, new SubscribeExtension(jid, getId()));
@@ -472,13 +472,13 @@ public abstract class Node {
* the caller can configure it but is not required to do so.
*
* @param jidString The jid to subscribe as.
- * @param subForm TODO javadoc me please
+ * @param subForm
*
* @return The subscription
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @throws IllegalArgumentException if the provided string is not a valid JID.
* @deprecated use {@link #subscribe(Jid, SubscribeForm)} instead.
*/
@@ -500,10 +500,10 @@ public abstract class Node {
* use {@link #unsubscribe(String, String)}.
*
* @param jid The JID used to subscribe to the node
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public void unsubscribe(String jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -515,10 +515,10 @@ public abstract class Node {
*
* @param jid The JID used to subscribe to the node
* @param subscriptionId The id of the subscription being removed
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void unsubscribe(String jid, String subscriptionId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
sendPubsubPacket(createPubsubPacket(Type.set, new UnsubscribeExtension(jid, getId(), subscriptionId)));
@@ -528,13 +528,13 @@ public abstract class Node {
* Returns a SubscribeForm for subscriptions, from which you can create an answer form to be submitted
* via the {@link #sendConfigurationForm(Form)}.
*
- * @param jid TODO javadoc me please
+ * @param jid
*
* @return A subscription options form
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public SubscribeForm getSubscriptionOptions(String jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return getSubscriptionOptions(jid, null);
@@ -548,10 +548,10 @@ public abstract class Node {
* @param subscriptionId The subscription id
*
* @return The subscription option form
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public SubscribeForm getSubscriptionOptions(String jid, String subscriptionId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PayloadItem.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PayloadItem.java
index f2c9058aa..ca843a805 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PayloadItem.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PayloadItem.java
@@ -107,7 +107,6 @@ public class PayloadItem extends Item {
* error for an invalid packet.
*
*
- * @param itemNamespace the namespace of the item.
* @param itemId The id of this item.
* @param nodeId The id of the node the item was published to.
* @param payloadExt A {@link ExtensionElement} which represents the payload data.
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PubSubManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PubSubManager.java
index be92f373b..85e37e25e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PubSubManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/PubSubManager.java
@@ -86,7 +86,7 @@ public final class PubSubManager extends Manager {
/**
* Get a PubSub manager for the default PubSub service of the connection.
*
- * @param connection TODO javadoc me please
+ * @param connection
* @return the default PubSub manager.
*/
// CHECKSTYLE:OFF:RegexpSingleline
@@ -155,8 +155,6 @@ public final class PubSubManager extends Manager {
/**
* Deprecated.
*
- * @param connection the connection.
- * @return the PubSub manager for the given connection.
* @deprecated use {@link #getInstanceFor(XMPPConnection)} instead.
*/
@Deprecated
@@ -168,9 +166,6 @@ public final class PubSubManager extends Manager {
/**
* Deprecated.
*
- * @param connection the connection.
- * @param pubSubService the XMPP address of the PubSub service.
- * @return the PubSub manager for the given connection.
* @deprecated use {@link #getInstanceFor(XMPPConnection, BareJid)} instead.
*/
@Deprecated
@@ -206,10 +201,10 @@ public final class PubSubManager extends Manager {
* Creates an instant node, if supported.
*
* @return The node that was created
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public LeafNode createNode() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub reply = sendPubsubPacket(Type.set, new NodeExtension(PubSubElementType.CREATE), null);
@@ -227,10 +222,10 @@ public final class PubSubManager extends Manager {
* @param nodeId The id of the node, which must be unique within the
* pubsub service
* @return The node that was created
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public LeafNode createNode(String nodeId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return (LeafNode) createNode(nodeId, null);
@@ -245,10 +240,10 @@ public final class PubSubManager extends Manager {
* pubsub service
* @param config The configuration for the node
* @return The node that was created
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Node createNode(String nodeId, Form config) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
PubSub request = PubSub.createPubsubPacket(pubSubService, Type.set, new NodeExtension(PubSubElementType.CREATE, nodeId));
@@ -280,9 +275,9 @@ public final class PubSubManager extends Manager {
* @return the node
* @throws XMPPErrorException The node does not exist
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotAPubSubNodeException if a involved node is not a PubSub node.
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotAPubSubNodeException
*/
public Node getNode(String id) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException, NotAPubSubNodeException {
StringUtils.requireNotNullNorEmpty(id, "The node ID can not be null or the empty string");
@@ -314,10 +309,10 @@ public final class PubSubManager extends Manager {
*
* @param id The unique ID of the node.
* @return the leaf node.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
* @throws NotALeafNodeException in case the node already exists as collection node.
* @since 4.2.1
*/
@@ -366,11 +361,11 @@ public final class PubSubManager extends Manager {
* @param id the node ID.
* @return the requested leaf node.
* @throws NotALeafNodeException in case the node exists but is a collection node.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotAPubSubNodeException if a involved node is not a PubSub node.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
+ * @throws NotAPubSubNodeException
* @since 4.2.1
*/
public LeafNode getLeafNode(String id) throws NotALeafNodeException, NoResponseException, NotConnectedException,
@@ -436,11 +431,11 @@ public final class PubSubManager extends Manager {
* @param type of the item.
*
* @return the LeafNode on which the item was published.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws NotALeafNodeException
* @since 4.2.1
*/
public LeafNode tryToPublishAndPossibleAutoCreate(String id, I item)
@@ -472,10 +467,10 @@ public final class PubSubManager extends Manager {
* @param nodeId - The id of the collection node for which the child
* nodes will be returned.
* @return {@link DiscoverItems} representing the existing nodes
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public DiscoverItems discoverNodes(String nodeId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
DiscoverItems items = new DiscoverItems();
@@ -491,10 +486,10 @@ public final class PubSubManager extends Manager {
* Gets the subscriptions on the root node.
*
* @return List of exceptions
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getSubscriptions() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Stanza reply = sendPubsubPacket(Type.get, new NodeExtension(PubSubElementType.SUBSCRIPTIONS), null);
@@ -506,10 +501,10 @@ public final class PubSubManager extends Manager {
* Gets the affiliations on the root node.
*
* @return List of affiliations
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*
*/
public List getAffiliations() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -521,11 +516,11 @@ public final class PubSubManager extends Manager {
/**
* Delete the specified node.
*
- * @param nodeId TODO javadoc me please
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param nodeId
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @return true if this node existed and was deleted and false if this node did not exist.
*/
public boolean deleteNode(String nodeId) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -547,10 +542,10 @@ public final class PubSubManager extends Manager {
* Returns the default settings for Node configuration.
*
* @return configuration form containing the default settings.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ConfigureForm getDefaultConfiguration() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Errors will cause exceptions in getReply, so it only returns
@@ -573,10 +568,10 @@ public final class PubSubManager extends Manager {
* as a standard {@link DiscoverInfo} instance.
*
* @return The supported features
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public DiscoverInfo getSupportedFeatures() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
ServiceDiscoveryManager mgr = ServiceDiscoveryManager.getInstanceFor(connection());
@@ -587,10 +582,10 @@ public final class PubSubManager extends Manager {
* Check if the PubSub service supports automatic node creation.
*
* @return true if the PubSub service supports automatic node creation.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.2.1
* @see XEP-0060 § 7.1.4 Automatic Node Creation
*/
@@ -611,10 +606,10 @@ public final class PubSubManager extends Manager {
*
*
* @return true if it is possible to create nodes, false otherwise.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
+ * @throws XMPPErrorException
*/
public boolean canCreateNodesAndPublishItems() throws NoResponseException, NotConnectedException, InterruptedException, XMPPErrorException {
LeafNode leafNode = null;
@@ -669,12 +664,12 @@ public final class PubSubManager extends Manager {
* simply an arbitrary XMPP service with the PubSub feature and an identity of category "pubsub"
* and type "service".
*
- * @param connection TODO javadoc me please
+ * @param connection
* @return the default PubSub service or null.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-60 § 5.1 Discover
* Features
*/
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/SubscribeForm.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/SubscribeForm.java
index 857c61054..f68524d16 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/SubscribeForm.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/SubscribeForm.java
@@ -65,7 +65,7 @@ public class SubscribeForm extends Form {
/**
* Sets whether an entity wants to receive notifications.
*
- * @param deliverNotifications TODO javadoc me please
+ * @param deliverNotifications
*/
public void setDeliverOn(boolean deliverNotifications) {
addField(SubscribeOptionFields.deliver, FormField.Type.bool);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/util/NodeUtils.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/util/NodeUtils.java
index b505b364b..43a2ee002 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/util/NodeUtils.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/pubsub/util/NodeUtils.java
@@ -32,8 +32,8 @@ public class NodeUtils {
/**
* Get a {@link ConfigureForm} from a packet.
*
- * @param packet TODO javadoc me please
- * @param elem TODO javadoc me please
+ * @param packet
+ * @param elem
* @return The configuration form
*/
public static ConfigureForm getFormFromPacket(Stanza packet, PubSubElementType elem) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/receipts/DeliveryReceiptManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/receipts/DeliveryReceiptManager.java
index 0fc5d1cdd..ca15cb0cc 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/receipts/DeliveryReceiptManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/receipts/DeliveryReceiptManager.java
@@ -207,11 +207,11 @@ public final class DeliveryReceiptManager extends Manager {
/**
* Returns true if Delivery Receipts are supported by a given JID.
*
- * @param jid TODO javadoc me please
+ * @param jid
* @return true if supported
* @throws SmackException if there was no response from the server.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws InterruptedException
*/
public boolean isSupported(Jid jid) throws SmackException, XMPPException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).supportsFeature(jid,
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearch.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearch.java
index 2b734f61d..cf22f3266 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearch.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearch.java
@@ -65,10 +65,10 @@ public class UserSearch extends SimpleIQ {
* @param con the current XMPPConnection.
* @param searchService the search service to use. (ex. search.jivesoftware.com)
* @return the search form received by the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getSearchForm(XMPPConnection con, DomainBareJid searchService) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
UserSearch search = new UserSearch();
@@ -86,10 +86,10 @@ public class UserSearch extends SimpleIQ {
* @param searchForm the Form to send for querying.
* @param searchService the search service to use. (ex. search.jivesoftware.com)
* @return ReportedData the data found from the query.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ReportedData sendSearchForm(XMPPConnection con, Form searchForm, DomainBareJid searchService) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
UserSearch search = new UserSearch();
@@ -108,10 +108,10 @@ public class UserSearch extends SimpleIQ {
* @param searchForm the Form to send for querying.
* @param searchService the search service to use. (ex. search.jivesoftware.com)
* @return ReportedData the data found from the query.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ReportedData sendSimpleSearchForm(XMPPConnection con, Form searchForm, DomainBareJid searchService) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
SimpleUserSearch search = new SimpleUserSearch();
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearchManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearchManager.java
index 85bcddd6f..2566a548e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearchManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/search/UserSearchManager.java
@@ -66,10 +66,10 @@ public class UserSearchManager {
*
* @param searchService the search service to query.
* @return the form to fill out to perform a search.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getSearchForm(DomainBareJid searchService) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return userSearch.getSearchForm(con, searchService);
@@ -82,10 +82,10 @@ public class UserSearchManager {
* @param searchForm the Form to submit for searching.
* @param searchService the name of the search service to use.
* @return the ReportedData returned by the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ReportedData getSearchResults(Form searchForm, DomainBareJid searchService) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return userSearch.sendSearchForm(con, searchForm, searchService);
@@ -96,10 +96,10 @@ public class UserSearchManager {
* Returns a collection of search services found on the server.
*
* @return a Collection of search services found on the server.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public List getSearchServices() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(con);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/sharedgroups/SharedGroupManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/sharedgroups/SharedGroupManager.java
index 3ed412f57..21d500a96 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/sharedgroups/SharedGroupManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/sharedgroups/SharedGroupManager.java
@@ -42,10 +42,10 @@ public class SharedGroupManager {
*
* @param connection connection to use to get the user's shared groups.
* @return collection with the shared groups' name of the logged user.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public static List getSharedGroups(XMPPConnection connection) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Discover the shared groups of the logged user
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/shim/packet/HeadersExtension.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/shim/packet/HeadersExtension.java
index 914f6dfa5..d56051289 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/shim/packet/HeadersExtension.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/shim/packet/HeadersExtension.java
@@ -70,7 +70,7 @@ public class HeadersExtension implements ExtensionElement {
/**
* Return the SHIM headers extension of this stanza or null if there is none.
*
- * @param packet TODO javadoc me please
+ * @param packet
* @return the headers extension or null.
*/
public static HeadersExtension from(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/VCardManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/VCardManager.java
index 28e126d7f..01579f09e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/VCardManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/VCardManager.java
@@ -69,13 +69,13 @@ public final class VCardManager extends Manager {
/**
* Returns true if the given entity understands the vCard-XML format and allows the exchange of such.
*
- * @param jid TODO javadoc me please
- * @param connection TODO javadoc me please
+ * @param jid
+ * @param connection
* @return true if the given entity understands the vCard-XML format and exchange.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link #isSupported(Jid)} instead.
*/
@Deprecated
@@ -96,8 +96,8 @@ public final class VCardManager extends Manager {
*
* @throws XMPPErrorException thrown if there was an issue setting the VCard in the server.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void saveVCard(VCard vcard) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// XEP-54 § 3.2 "A user may publish or update his or her vCard by sending an IQ of type "set" with no 'to' address…"
@@ -113,10 +113,10 @@ public final class VCardManager extends Manager {
* Load the VCard of the current user.
*
* @return VCard.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public VCard loadVCard() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return loadVCard(null);
@@ -128,10 +128,10 @@ public final class VCardManager extends Manager {
* @param bareJid bareJid of the user.
*
* @return VCard.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public VCard loadVCard(EntityBareJid bareJid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
VCard vcardRequest = new VCard();
@@ -143,12 +143,12 @@ public final class VCardManager extends Manager {
/**
* Returns true if the given entity understands the vCard-XML format and allows the exchange of such.
*
- * @param jid TODO javadoc me please
+ * @param jid
* @return true if the given entity understands the vCard-XML format and exchange.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean isSupported(Jid jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).supportsFeature(jid, NAMESPACE);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/packet/VCard.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/packet/VCard.java
index 58d5d6eee..244762f4a 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/packet/VCard.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/vcardtemp/packet/VCard.java
@@ -547,8 +547,8 @@ public final class VCard extends IQ {
* @param connection the XMPPConnection to use.
* @throws XMPPErrorException thrown if there was an issue setting the VCard in the server.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link VCardManager#saveVCard(VCard)} instead.
*/
@Deprecated
@@ -561,10 +561,10 @@ public final class VCard extends IQ {
* and not anonymous.
*
* @param connection connection.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link VCardManager#loadVCard()} instead.
*/
@Deprecated
@@ -578,10 +578,10 @@ public final class VCard extends IQ {
* @param connection connection.
* @param user user whos information we want to load.
*
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws XMPPErrorException
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link VCardManager#loadVCard(EntityBareJid)} instead.
*/
@Deprecated
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/FormField.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/FormField.java
index 387c1e7fd..6eca9b39e 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/FormField.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/FormField.java
@@ -491,7 +491,6 @@ public final class FormField implements FullyQualifiedElement {
* Sets an indicative of the format for the data to answer.
*
* @param type an indicative of the format for the data to answer.
- * @return a reference to this builder.
* @see Type
*/
public Builder setType(Type type) {
@@ -518,7 +517,6 @@ public final class FormField implements FullyQualifiedElement {
*
*
* @param description provides extra clarification about the question.
- * @return a reference to this builder.
*/
public Builder setDescription(String description) {
Description descriptionElement = new Description(description);
@@ -531,7 +529,6 @@ public final class FormField implements FullyQualifiedElement {
* fill out the form.
*
* @param label the label of the question.
- * @return a reference to this builder.
*/
public Builder setLabel(String label) {
this.label = label;
@@ -542,7 +539,6 @@ public final class FormField implements FullyQualifiedElement {
* Sets if the question must be answered in order to complete the questionnaire.
*
* @param required if the question must be answered in order to complete the questionnaire.
- * @return a reference to this builder.
*/
public Builder setRequired(boolean required) {
setOnlyElement(Required.INSTANCE, Required.class);
@@ -554,7 +550,6 @@ public final class FormField implements FullyQualifiedElement {
* Otherwise, adds an answered value to the question.
*
* @param value a default value or an answered value of the question.
- * @return a reference to this builder.
*/
public Builder addValue(CharSequence value) {
return addFormFieldChildElement(new Value(value));
@@ -565,7 +560,6 @@ public final class FormField implements FullyQualifiedElement {
* instance was formated.
*
* @param date the date instance to add as XEP-0082 formated string.
- * @return a reference to this builder.
*/
public Builder addValue(Date date) {
String dateString = XmppDateTime.formatXEP0082Date(date);
@@ -577,7 +571,6 @@ public final class FormField implements FullyQualifiedElement {
* Otherwise, adds an answered values to the question.
*
* @param values default values or an answered values of the question.
- * @return a reference to this builder.
*/
public Builder addValues(Collection values) {
for (CharSequence value : values) {
@@ -595,7 +588,6 @@ public final class FormField implements FullyQualifiedElement {
* the question.
*
* @param option a new available option for the question.
- * @return a reference to this builder.
*/
public Builder addOption(Option option) {
return addFormFieldChildElement(option);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/XDataManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/XDataManager.java
index fc6a23d84..38099fa1c 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/XDataManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/XDataManager.java
@@ -88,10 +88,10 @@ public final class XDataManager extends Manager {
*
* @param jid the JID of the entity to check.
* @return true if the entity supports data forms.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws XMPPErrorException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @see XEP-0004: Data Forms § 6. Service Discovery
* @since 4.1
*/
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/packet/DataForm.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/packet/DataForm.java
index 661f3bd08..5c53a24e1 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/packet/DataForm.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdata/packet/DataForm.java
@@ -151,7 +151,7 @@ public class DataForm implements ExtensionElement {
/**
* Return the form field with the given variable name or null.
*
- * @param variableName TODO javadoc me please
+ * @param variableName
* @return the form field or null.
* @since 4.1
*/
@@ -175,7 +175,7 @@ public class DataForm implements ExtensionElement {
/**
* Check if a form field with the given variable name exists.
*
- * @param variableName TODO javadoc me please
+ * @param variableName
* @return true if a form field with the variable name exists, false otherwise.
* @since 4.2
*/
@@ -250,7 +250,7 @@ public class DataForm implements ExtensionElement {
/**
* Add the given fields to this form.
*
- * @param fieldsToAdd TODO javadoc me please
+ * @param fieldsToAdd
* @return true if a field was overridden.
* @since 4.3.0
*/
@@ -357,7 +357,7 @@ public class DataForm implements ExtensionElement {
/**
* Get data form from stanza.
- * @param packet TODO javadoc me please
+ * @param packet
* @return the DataForm or null
*/
public static DataForm from(Stanza packet) {
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatalayout/packet/DataLayout.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatalayout/packet/DataLayout.java
index 4d5720829..59f0e2f72 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatalayout/packet/DataLayout.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatalayout/packet/DataLayout.java
@@ -41,7 +41,7 @@ public class DataLayout implements ExtensionElement {
/**
* Data layout constructor.
- * @param label TODO javadoc me please
+ * @param label
*/
public DataLayout(String label) {
this.label = label;
@@ -104,8 +104,8 @@ public class DataLayout implements ExtensionElement {
}
/**
- * @param buf TODO javadoc me please
- * @param pageLayout TODO javadoc me please
+ * @param buf
+ * @param pageLayout
*/
private static void walkList(XmlStringBuilder buf, List pageLayout) {
for (DataFormLayoutElement object : pageLayout) {
@@ -158,7 +158,7 @@ public class DataLayout implements ExtensionElement {
/**
* Section constructor.
- * @param label TODO javadoc me please
+ * @param label
*/
public Section(String label) {
this.label = label;
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/ValidationConsistencyException.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/ValidationConsistencyException.java
index 66aa3b9d1..3a0c8a33c 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/ValidationConsistencyException.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/ValidationConsistencyException.java
@@ -33,7 +33,7 @@ public class ValidationConsistencyException extends IllegalArgumentException {
/**
* Validation consistency exception constructor.
- * @param message TODO javadoc me please
+ * @param message
*/
public ValidationConsistencyException(String message) {
super(message);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/packet/ValidateElement.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/packet/ValidateElement.java
index 83edfdf1c..cf2be2b09 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/packet/ValidateElement.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xdatavalidation/packet/ValidateElement.java
@@ -108,7 +108,7 @@ public abstract class ValidateElement implements FormFieldChildElement {
}
/**
- * @param buf TODO javadoc me please
+ * @param buf
*/
protected abstract void appendXML(XmlStringBuilder buf);
@@ -152,7 +152,7 @@ public abstract class ValidateElement implements FormFieldChildElement {
/**
* Basic validate element constructor.
- * @param datatype TODO javadoc me please
+ * @param datatype
* @see #getDatatype()
*/
public BasicValidateElement(String datatype) {
@@ -195,7 +195,7 @@ public abstract class ValidateElement implements FormFieldChildElement {
/**
* Open validate element constructor.
- * @param datatype TODO javadoc me please
+ * @param datatype
* @see #getDatatype()
*/
public OpenValidateElement(String datatype) {
@@ -237,7 +237,7 @@ public abstract class ValidateElement implements FormFieldChildElement {
/**
* Range validate element constructor.
- * @param datatype TODO javadoc me please
+ * @param datatype
* @param min the minimum allowable value. This attribute is OPTIONAL. The value depends on the datatype in use.
* @param max the maximum allowable value. This attribute is OPTIONAL. The value depends on the datatype in use.
* @see #getDatatype()
@@ -302,8 +302,8 @@ public abstract class ValidateElement implements FormFieldChildElement {
/**
* Regex validate element.
- * @param datatype TODO javadoc me please
- * @param regex TODO javadoc me please
+ * @param datatype
+ * @param regex
* @see #getDatatype()
*/
public RegexValidateElement(String datatype, String regex) {
@@ -351,8 +351,8 @@ public abstract class ValidateElement implements FormFieldChildElement {
* specifies the minimum allowable number of selected/entered values. Both attributes are optional, but at
* least one must bet set, and the value must be within the range of a unsigned 32-bit integer.
*
- * @param min TODO javadoc me please
- * @param max TODO javadoc me please
+ * @param min
+ * @param max
*/
public ListRange(UInt32 min, UInt32 max) {
if (max == null && min == null) {
@@ -400,7 +400,7 @@ public abstract class ValidateElement implements FormFieldChildElement {
* The >list-range/< element SHOULD be included only when the <field/> is of type "list-multi" and SHOULD be ignored
* otherwise.
*
- * @param formField TODO javadoc me please
+ * @param formField
*/
protected void checkListRangeConsistency(FormField.Builder formField) {
ListRange listRange = getListRange();
@@ -417,8 +417,8 @@ public abstract class ValidateElement implements FormFieldChildElement {
}
/**
- * @param formField TODO javadoc me please
- * @param method TODO javadoc me please
+ * @param formField
+ * @param method
*/
protected void checkNonMultiConsistency(FormField.Builder formField, String method) {
checkListRangeConsistency(formField);
diff --git a/smack-extensions/src/main/java/org/jivesoftware/smackx/xhtmlim/XHTMLManager.java b/smack-extensions/src/main/java/org/jivesoftware/smackx/xhtmlim/XHTMLManager.java
index 6a72b855c..665a10026 100644
--- a/smack-extensions/src/main/java/org/jivesoftware/smackx/xhtmlim/XHTMLManager.java
+++ b/smack-extensions/src/main/java/org/jivesoftware/smackx/xhtmlim/XHTMLManager.java
@@ -129,10 +129,10 @@ public class XHTMLManager {
* @param connection the connection to use to perform the service discovery
* @param userID the user to check. A fully qualified xmpp ID, e.g. jdoe@example.com
* @return a boolean indicating whether the specified user handles XHTML messages
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public static boolean isServiceEnabled(XMPPConnection connection, Jid userID)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamManagerTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamManagerTest.java
index 7032ff1f7..43bede073 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamManagerTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamManagerTest.java
@@ -61,9 +61,9 @@ public class InBandBytestreamManagerTest extends InitExtensions {
/**
* Initialize fields used in the tests.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Before
public void setup() throws XMPPException, SmackException, InterruptedException {
@@ -105,9 +105,9 @@ public class InBandBytestreamManagerTest extends InitExtensions {
* Invoking {@link InBandBytestreamManager#establishSession(org.jxmpp.jid.Jid)} should
* throw an exception if the given target does not support in-band
* bytestream.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws InterruptedException
*/
@Test
public void shouldFailIfTargetDoesNotSupportIBB() throws SmackException, XMPPException, InterruptedException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamRequestTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamRequestTest.java
index 5f5ae2974..44bbc0dd2 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamRequestTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamRequestTest.java
@@ -71,8 +71,8 @@ public class InBandBytestreamRequestTest extends InitExtensions {
/**
* Test reject() method.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Test
public void shouldReplyWithErrorIfRequestIsRejected() throws NotConnectedException, InterruptedException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionMessageTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionMessageTest.java
index eb172880a..f4c2f7be8 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionMessageTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionMessageTest.java
@@ -75,9 +75,9 @@ public class InBandBytestreamSessionMessageTest extends InitExtensions {
/**
* Initialize fields used in the tests.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Before
public void setup() throws XMPPException, SmackException, InterruptedException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionTest.java
index f1cb3bb61..477859996 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/ibb/InBandBytestreamSessionTest.java
@@ -76,9 +76,9 @@ public class InBandBytestreamSessionTest extends InitExtensions {
/**
* Initialize fields used in the tests.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Before
public void setup() throws XMPPException, SmackException, InterruptedException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamManagerTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamManagerTest.java
index a84a90996..0b297c1ad 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamManagerTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamManagerTest.java
@@ -109,9 +109,9 @@ public class Socks5ByteStreamManagerTest {
* The SOCKS5 Bytestream feature should be removed form the service discovery manager if Socks5
* bytestream feature is disabled.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPErrorException if there was an XMPP error returned.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPErrorException
*/
@Test
public void shouldDisableService() throws XMPPErrorException, SmackException, InterruptedException {
@@ -131,10 +131,10 @@ public class Socks5ByteStreamManagerTest {
/**
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid)} should throw an exception
* if the given target does not support SOCKS5 Bytestream.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws IOException if an I/O error occured.
+ * @throws XMPPException
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws IOException
*/
@Test
public void shouldFailIfTargetDoesNotSupportSocks5()
@@ -159,10 +159,10 @@ public class Socks5ByteStreamManagerTest {
/**
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if XMPP
* server doesn't return any proxies.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldFailIfNoSocks5ProxyFound1()
@@ -211,10 +211,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if no
* proxy is a SOCKS5 proxy.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldFailIfNoSocks5ProxyFound2()
@@ -273,10 +273,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if no
* SOCKS5 proxy can be found. If it turns out that a proxy is not a SOCKS5 proxy it should not
* be queried again.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldBlacklistNonSocks5Proxies() throws SmackException, InterruptedException, IOException, XMPPException {
@@ -355,10 +355,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if the
* target does not accept a SOCKS5 Bytestream. See XEP-0065 Section 5.2 A2
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldFailIfTargetDoesNotAcceptSocks5Bytestream() throws SmackException, InterruptedException, IOException, XMPPException {
@@ -435,10 +435,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if the
* proxy used by target is invalid.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldFailIfTargetUsesInvalidSocks5Proxy()
@@ -517,10 +517,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should fail if
* initiator can not connect to the SOCKS5 proxy used by target.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws XmppStringprepException if the provided string is invalid.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws XmppStringprepException
*/
@Test
public void shouldFailIfInitiatorCannotConnectToSocks5Proxy()
@@ -617,10 +617,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} should successfully
* negotiate and return a SOCKS5 Bytestream connection.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*/
@Test
public void shouldNegotiateSocks5BytestreamAndTransferData()
@@ -737,11 +737,11 @@ public class Socks5ByteStreamManagerTest {
* If multiple network addresses are added to the local SOCKS5 proxy, all of them should be
* contained in the SOCKS5 Bytestream request.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws IOException if an I/O error occured.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws TimeoutException if there was a timeout.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws IOException
+ * @throws XMPPException
+ * @throws TimeoutException
*/
@Test
public void shouldUseMultipleAddressesForLocalSocks5Proxy()
@@ -843,10 +843,10 @@ public class Socks5ByteStreamManagerTest {
* Invoking {@link Socks5BytestreamManager#establishSession(org.jxmpp.jid.Jid, String)} the first time
* should successfully negotiate a SOCKS5 Bytestream via the second SOCKS5 proxy and should
* prioritize this proxy for a second SOCKS5 Bytestream negotiation.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
*
*/
@Test
@@ -932,10 +932,10 @@ public class Socks5ByteStreamManagerTest {
* should successfully negotiate a SOCKS5 Bytestream via the second SOCKS5 proxy. The second
* negotiation should run in the same manner if prioritization is disabled.
*
- * @throws IOException if an I/O error occured.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws IOException
+ * @throws InterruptedException
+ * @throws SmackException
+ * @throws XMPPException
*
*/
@Test
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamRequestTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamRequestTest.java
index 33d038aaf..59d5f99c1 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamRequestTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5ByteStreamRequestTest.java
@@ -98,7 +98,7 @@ public class Socks5ByteStreamRequestTest {
* Accepting a SOCKS5 Bytestream request should fail if target is not able to connect to any of
* the provided SOCKS5 proxies.
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
@Test
public void shouldFailIfRequestHasInvalidStreamHosts() throws Exception {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/caps/EntityCapsManagerTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/caps/EntityCapsManagerTest.java
index 518d0142e..bd6908d4b 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/caps/EntityCapsManagerTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/caps/EntityCapsManagerTest.java
@@ -47,7 +47,7 @@ public class EntityCapsManagerTest extends InitExtensions {
/**
* XEP-
* 0115 Complex Generation Example.
- * @throws XmppStringprepException if the provided string is invalid.
+ * @throws XmppStringprepException
*/
@Test
public void testComplexGenerationExample() throws XmppStringprepException {
diff --git a/smack-extensions/src/test/java/org/jivesoftware/smackx/ping/PingTest.java b/smack-extensions/src/test/java/org/jivesoftware/smackx/ping/PingTest.java
index 3eef31b83..18a528d90 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/smackx/ping/PingTest.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/smackx/ping/PingTest.java
@@ -98,10 +98,10 @@ public class PingTest extends InitExtensions {
/**
* DummyConnection will not reply so it will timeout.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws IOException
+ * @throws InterruptedException
*/
@Test
public void checkFailedPingOnTimeout() throws SmackException, IOException, XMPPException, InterruptedException {
@@ -119,7 +119,7 @@ public class PingTest extends InitExtensions {
/**
* Server returns an exception for entity.
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
@Test
public void checkFailedPingToEntityError() throws Exception {
@@ -155,7 +155,7 @@ public class PingTest extends InitExtensions {
/**
* Server returns an exception.
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
@Test
public void checkPingToServerError() throws Exception {
@@ -243,10 +243,10 @@ public class PingTest extends InitExtensions {
* The returned connection won't send replies to IQs
*
* @return
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws IOException
+ * @throws SmackException
+ * @throws InterruptedException
*/
private static DummyConnection getAuthenticatedDummyConnectionWithoutIqReplies() throws SmackException, IOException, XMPPException, InterruptedException {
DummyConnection con = new DummyConnection();
diff --git a/smack-extensions/src/test/java/org/jivesoftware/util/ConnectionUtils.java b/smack-extensions/src/test/java/org/jivesoftware/util/ConnectionUtils.java
index cc90c29ca..79f0db915 100644
--- a/smack-extensions/src/test/java/org/jivesoftware/util/ConnectionUtils.java
+++ b/smack-extensions/src/test/java/org/jivesoftware/util/ConnectionUtils.java
@@ -64,9 +64,9 @@ public class ConnectionUtils {
* @param protocol protocol helper containing answer packets
* @param initiatorJID the user associated to the XMPP connection
* @return a mocked XMPP connection
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws XMPPErrorException
+ * @throws InterruptedException
*/
public static XMPPConnection createMockedConnection(final Protocol protocol,
EntityFullJid initiatorJID) throws SmackException, XMPPErrorException, InterruptedException {
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/chat/Chat.java b/smack-im/src/main/java/org/jivesoftware/smack/chat/Chat.java
index f5df0834f..41bbddb6c 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/chat/Chat.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/chat/Chat.java
@@ -94,8 +94,8 @@ public class Chat {
*
*
* @param text the text to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendMessage(String text) throws NotConnectedException, InterruptedException {
Message message = new Message();
@@ -108,8 +108,8 @@ public class Chat {
* and message type of the message will automatically set to those of this chat.
*
* @param message the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendMessage(Message message) throws NotConnectedException, InterruptedException {
// Force the recipient, message type, and thread ID since the user elected
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManager.java b/smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManager.java
index 1cc6c12ff..fa5699a97 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManager.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/chat/ChatManager.java
@@ -279,7 +279,7 @@ public final class ChatManager extends Manager{
* Creates a new {@link Chat} based on the message. May returns null if no chat could be
* created, e.g. because the message comes without from.
*
- * @param message TODO javadoc me please
+ * @param message
* @return a Chat or null if none can be created
*/
private Chat createChat(Message message) {
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/Roster.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/Roster.java
index e1d49d8ed..790e4d059 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/Roster.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/Roster.java
@@ -437,8 +437,8 @@ public final class Roster extends Manager {
* which means the method will return immediately, and the roster will be
* reloaded at a later point when the server responds to the reload request.
* @throws NotLoggedInException If not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void reload() throws NotLoggedInException, NotConnectedException, InterruptedException {
final XMPPConnection connection = getAuthenticatedConnectionOrThrow();
@@ -474,9 +474,9 @@ public final class Roster extends Manager {
/**
* Reload the roster and block until it is reloaded.
*
- * @throws NotLoggedInException if the XMPP connection is not authenticated.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotLoggedInException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.1
*/
public void reloadAndWait() throws NotLoggedInException, NotConnectedException, InterruptedException {
@@ -487,7 +487,7 @@ public final class Roster extends Manager {
/**
* Set the roster store, may cause a roster reload.
*
- * @param rosterStore TODO javadoc me please
+ * @param rosterStore
* @return true if the roster reload was initiated, false otherwise.
* @since 4.1
*/
@@ -642,8 +642,8 @@ public final class Roster extends Manager {
* @throws NoResponseException if there was no response from the server.
* @throws XMPPErrorException if an XMPP exception occurs.
* @throws NotLoggedInException If not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @deprecated use {@link #createItemAndRequestSubscription(BareJid, String, String[])} instead.
*/
// TODO: Remove in Smack 4.5.
@@ -667,8 +667,8 @@ public final class Roster extends Manager {
* @throws NoResponseException if there was no response from the server.
* @throws XMPPErrorException if an XMPP exception occurs.
* @throws NotLoggedInException If not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.4.0
*/
public void createItem(BareJid jid, String name, String[] groups) throws NotLoggedInException, NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -700,8 +700,8 @@ public final class Roster extends Manager {
* @throws NoResponseException if there was no response from the server.
* @throws XMPPErrorException if an XMPP exception occurs.
* @throws NotLoggedInException If not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.4.0
*/
public void createItemAndRequestSubscription(BareJid jid, String name, String[] groups) throws NotLoggedInException, NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -721,8 +721,8 @@ public final class Roster extends Manager {
* @throws NoResponseException if there was no response from the server.
* @throws XMPPErrorException if an XMPP exception occurs.
* @throws NotLoggedInException if not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @throws FeatureNotSupportedException if pre-approving is not supported.
* @since 4.2
*/
@@ -736,8 +736,8 @@ public final class Roster extends Manager {
*
* @param user the user. (e.g. johndoe@jabber.org)
* @throws NotLoggedInException if not logged in.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @throws FeatureNotSupportedException if pre-approving is not supported.
* @since 4.2
*/
@@ -795,7 +795,7 @@ public final class Roster extends Manager {
* Remove a subscribe listener. Also restores the previous subscription mode
* state, if the last listener got removed.
*
- * @param subscribeListener TODO javadoc me please
+ * @param subscribeListener
* the subscribe listener to remove.
* @return true if the listener registered and got removed.
* @since 4.2
@@ -818,8 +818,8 @@ public final class Roster extends Manager {
* @throws XMPPErrorException if an XMPP error occurs.
* @throws NotLoggedInException if not logged in.
* @throws NoResponseException SmackException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void removeEntry(RosterEntry entry) throws NotLoggedInException, NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
final XMPPConnection connection = getAuthenticatedConnectionOrThrow();
@@ -971,7 +971,7 @@ public final class Roster extends Manager {
* Returns the presence info for a particular user. If the user is offline, or
* if no presence data is available (such as when you are not subscribed to the
* user's presence updates), unavailable presence will be returned.
- *
+ *
* If the user has several presences (one for each resource), then the presence with
* highest priority will be returned. If multiple presences have the same priority,
* the one with the "most available" presence mode will be returned. In order,
@@ -979,8 +979,8 @@ public final class Roster extends Manager {
* {@link org.jivesoftware.smack.packet.Presence.Mode#available available},
* {@link org.jivesoftware.smack.packet.Presence.Mode#away away},
* {@link org.jivesoftware.smack.packet.Presence.Mode#xa extended away}, and
- * {@link org.jivesoftware.smack.packet.Presence.Mode#dnd do not disturb}.
- *
+ * {@link org.jivesoftware.smack.packet.Presence.Mode#dnd do not disturb}.
+ *
*
* Note that presence information is received asynchronously. So, just after logging
* in to the server, presence values for users in the roster may be unavailable
@@ -1184,7 +1184,7 @@ public final class Roster extends Manager {
*
* Note that if the roster is not loaded, then this method will always return false.
*
- * @param jid TODO javadoc me please
+ * @param jid
* @return true if the given JID is allowed to see the users presence.
* @since 4.1
*/
@@ -1871,7 +1871,7 @@ public final class Roster extends Manager {
/**
* Set the maximum size of the non-Roster presence map.
*
- * @param maximumSize TODO javadoc me please
+ * @param maximumSize
* @since 4.2
* @see #setDefaultNonRosterPresenceMapMaxSize(int)
*/
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterEntry.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterEntry.java
index 60b50cce9..6e3f2db20 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterEntry.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterEntry.java
@@ -94,10 +94,10 @@ public final class RosterEntry extends Manager {
* Sets the name associated with this entry.
*
* @param name the name.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws InterruptedException
*/
public synchronized void setName(String name) throws NotConnectedException, NoResponseException, XMPPErrorException, InterruptedException {
// Do nothing if the name hasn't changed.
@@ -213,8 +213,8 @@ public final class RosterEntry extends Manager {
/**
* Cancel the presence subscription the XMPP entity representing this roster entry has with us.
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.2
*/
public void cancelSubscription() throws NotConnectedException, InterruptedException {
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterGroup.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterGroup.java
index e67f3e6fc..f245289fe 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterGroup.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterGroup.java
@@ -71,10 +71,10 @@ public class RosterGroup extends Manager {
* be invalid and will need to be updated to the new group specified by the new name.
*
* @param name the name of the group.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws InterruptedException
*/
public void setName(String name) throws NotConnectedException, NoResponseException, XMPPErrorException, InterruptedException {
synchronized (entries) {
@@ -167,8 +167,8 @@ public class RosterGroup extends Manager {
* @param entry a roster entry.
* @throws XMPPErrorException if an error occured while trying to add the entry to the group.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void addEntry(RosterEntry entry) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Only add the entry if it isn't already in the list.
@@ -195,8 +195,8 @@ public class RosterGroup extends Manager {
* @param entry a roster entry.
* @throws XMPPErrorException if an error occurred while trying to remove the entry from the group.
* @throws NoResponseException if there was no response from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void removeEntry(RosterEntry entry) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// Only remove the entry if it's in the entry list.
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterUtil.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterUtil.java
index 843b24bad..03b1c6ad5 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterUtil.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/RosterUtil.java
@@ -92,9 +92,9 @@ public class RosterUtil {
*
* @param roster The roster which should be used for the pre-approval.
* @param jid The XMPP address which should be pre-approved.
- * @throws NotLoggedInException if the XMPP connection is not authenticated.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotLoggedInException
+ * @throws NotConnectedException
+ * @throws InterruptedException
* @since 4.2.2
*/
public static void preApproveSubscriptionIfRequiredAndPossible(Roster roster, BareJid jid)
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/packet/RosterPacket.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/packet/RosterPacket.java
index 3c079a39c..430fa3434 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/packet/RosterPacket.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/packet/RosterPacket.java
@@ -137,8 +137,8 @@ public final class RosterPacket extends IQ {
/**
* Creates a new roster item.
*
- * @param jid TODO javadoc me please
- * @param name TODO javadoc me please
+ * @param jid
+ * @param name
*/
public Item(BareJid jid, String name) {
this(jid, name, false);
@@ -149,7 +149,7 @@ public final class RosterPacket extends IQ {
*
* @param jid the jid.
* @param name the user's name.
- * @param subscriptionPending TODO javadoc me please
+ * @param subscriptionPending
*/
public Item(BareJid jid, String name, boolean subscriptionPending) {
this.jid = Objects.requireNonNull(jid);
diff --git a/smack-im/src/main/java/org/jivesoftware/smack/roster/rosterstore/DirectoryRosterStore.java b/smack-im/src/main/java/org/jivesoftware/smack/roster/rosterstore/DirectoryRosterStore.java
index dec89bc68..3dd4fde6a 100644
--- a/smack-im/src/main/java/org/jivesoftware/smack/roster/rosterstore/DirectoryRosterStore.java
+++ b/smack-im/src/main/java/org/jivesoftware/smack/roster/rosterstore/DirectoryRosterStore.java
@@ -67,7 +67,7 @@ public final class DirectoryRosterStore implements RosterStore {
};
/**
- * @param baseDir TODO javadoc me please
+ * @param baseDir
* will be the directory where all roster entries are stored. One
* file for each entry, such that file.name = entry.username.
* There is also one special file '__version__' that contains the
@@ -80,7 +80,7 @@ public final class DirectoryRosterStore implements RosterStore {
/**
* Creates a new roster store on disk.
*
- * @param baseDir TODO javadoc me please
+ * @param baseDir
* The directory to create the store in. The directory should
* be empty
* @return A {@link DirectoryRosterStore} instance if successful,
@@ -98,7 +98,7 @@ public final class DirectoryRosterStore implements RosterStore {
/**
* Opens a roster store.
- * @param baseDir TODO javadoc me please
+ * @param baseDir
* The directory containing the roster store.
* @return A {@link DirectoryRosterStore} instance if successful,
* null else.
diff --git a/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterTest.java b/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterTest.java
index 8bd98748c..1af4f574c 100644
--- a/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterTest.java
+++ b/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterTest.java
@@ -369,7 +369,7 @@ public class RosterTest extends InitSmackIm {
/**
* Tests that roster pushes with invalid from are ignored.
- * @throws XmppStringprepException if the provided string is invalid.
+ * @throws XmppStringprepException
*
* @see RFC 6121, Section 2.1.6
*/
@@ -538,8 +538,8 @@ public class RosterTest extends InitSmackIm {
* RFC3921: Retrieving One's Roster on Login.
*
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XmppStringprepException if the provided string is invalid.
+ * @throws SmackException
+ * @throws XmppStringprepException
*/
private void initRoster() throws InterruptedException, SmackException, XmppStringprepException {
roster.reload();
diff --git a/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterVersioningTest.java b/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterVersioningTest.java
index 91be648ed..f3eeb3b23 100644
--- a/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterVersioningTest.java
+++ b/smack-im/src/test/java/org/jivesoftware/smack/roster/RosterVersioningTest.java
@@ -95,8 +95,8 @@ public class RosterVersioningTest {
/**
* Tests that receiving an empty roster result causes the roster to be populated
* by all entries of the roster store.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws SmackException
+ * @throws XMPPException
*/
@Test(timeout = 300000)
public void testEqualVersionStored() throws InterruptedException, IOException, XMPPException, SmackException {
@@ -129,9 +129,9 @@ public class RosterVersioningTest {
/**
* Tests that a non-empty roster result empties the store.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws XmppStringprepException if the provided string is invalid.
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws XmppStringprepException
*/
@Test(timeout = 5000)
public void testOtherVersionStored() throws XMPPException, SmackException, XmppStringprepException {
diff --git a/smack-integration-test/src/main/java/org/igniterealtime/smack/inttest/SmackIntegrationTestFramework.java b/smack-integration-test/src/main/java/org/igniterealtime/smack/inttest/SmackIntegrationTestFramework.java
index a2c07772a..ab18e9d2a 100644
--- a/smack-integration-test/src/main/java/org/igniterealtime/smack/inttest/SmackIntegrationTestFramework.java
+++ b/smack-integration-test/src/main/java/org/igniterealtime/smack/inttest/SmackIntegrationTestFramework.java
@@ -689,7 +689,7 @@ public class SmackIntegrationTestFramework {
* Execute the test.
*
* @throws IllegalAccessException
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
* @throws InvocationTargetException if the reflective invoked test throws an exception.
* @throws XMPPException in case an XMPPException happens when preparing the test.
* @throws IOException in case an IOException happens when preparing the test.
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smack/LoginIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smack/LoginIntegrationTest.java
index 541de5163..0c44c42f4 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smack/LoginIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smack/LoginIntegrationTest.java
@@ -41,12 +41,12 @@ public class LoginIntegrationTest extends AbstractSmackLowLevelIntegrationTest {
* Check that the server is returning the correct error when trying to login using an invalid
* (i.e. non-existent) user.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws IOException if an I/O error occured.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws NoSuchAlgorithmException if no such algorithm is available.
- * @throws KeyManagementException if there was a key mangement error.
+ * @throws InterruptedException
+ * @throws XMPPException
+ * @throws IOException
+ * @throws SmackException
+ * @throws NoSuchAlgorithmException
+ * @throws KeyManagementException
*/
@SmackIntegrationTest
public void testInvalidLogin() throws SmackException, IOException, XMPPException,
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/caps/EntityCapsTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/caps/EntityCapsTest.java
index c3aa5ede0..3dcbc8161 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/caps/EntityCapsTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/caps/EntityCapsTest.java
@@ -124,10 +124,10 @@ public class EntityCapsTest extends AbstractSmackIntegrationTest {
/**
* Test if entity caps actually prevent a disco info request and reply.
*
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws XMPPException
+ * @throws InterruptedException
+ * @throws NotConnectedException
+ * @throws NoResponseException
*
*/
@SmackIntegrationTest
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTControlIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTControlIntegrationTest.java
index c6f8b275d..9d39fc30d 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTControlIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTControlIntegrationTest.java
@@ -52,8 +52,8 @@ public class IoTControlIntegrationTest extends AbstractSmackIntegrationTest {
/**
* Connection one provides a thing, which is controlled by connection two.
*
- * @throws Exception if an exception occurs.
- * @throws TimeoutException if there was a timeout.
+ * @throws Exception
+ * @throws TimeoutException
*/
@SmackIntegrationTest
// @SmackSerialIntegrationTest
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTDataIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTDataIntegrationTest.java
index 1fec14577..90543108f 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTDataIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/iot/IoTDataIntegrationTest.java
@@ -54,8 +54,8 @@ public class IoTDataIntegrationTest extends AbstractSmackIntegrationTest {
/**
* Connection one provides a thing, which momentary value is read out by connection two.
*
- * @throws Exception if an exception occurs.
- * @throws TimeoutException if there was a timeout.
+ * @throws Exception
+ * @throws TimeoutException
*/
@SmackIntegrationTest
public void dataTest() throws Exception {
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/omemo/MessageEncryptionIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/omemo/MessageEncryptionIntegrationTest.java
index 6a9ba5e20..db9a6522d 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/omemo/MessageEncryptionIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/omemo/MessageEncryptionIntegrationTest.java
@@ -53,7 +53,7 @@ public class MessageEncryptionIntegrationTest extends AbstractTwoUsersOmemoInteg
* Bob responds to Alice (normal message)
* Alice still has A1
* Bob still has B2
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
@SuppressWarnings("SynchronizeOnNonFinalField")
@SmackIntegrationTest
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox/OXSecretKeyBackupIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox/OXSecretKeyBackupIntegrationTest.java
index 5137960e4..65c26d3ba 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox/OXSecretKeyBackupIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox/OXSecretKeyBackupIntegrationTest.java
@@ -90,12 +90,12 @@ public class OXSecretKeyBackupIntegrationTest extends AbstractOpenPgpIntegration
*
* @see
* XEP-0373 §5: Synchronizing the Secret Key with a Private PEP Node
- * @param environment TODO javadoc me please
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws TestNotPossibleException if the test is not possible.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
+ * @param environment
+ * @throws XMPPException.XMPPErrorException
+ * @throws TestNotPossibleException
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
*/
public OXSecretKeyBackupIntegrationTest(SmackIntegrationTestEnvironment environment)
throws XMPPException.XMPPErrorException, TestNotPossibleException, SmackException.NotConnectedException,
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox_im/OXInstantMessagingIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox_im/OXInstantMessagingIntegrationTest.java
index 6a89976fb..aa84f8122 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox_im/OXInstantMessagingIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/ox_im/OXInstantMessagingIntegrationTest.java
@@ -81,11 +81,11 @@ public class OXInstantMessagingIntegrationTest extends AbstractOpenPgpIntegratio
*
* @param environment test environment
*
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
+ * @throws XMPPException.XMPPErrorException
+ * @throws InterruptedException
+ * @throws SmackException.NotConnectedException
* @throws TestNotPossibleException if the test is not possible due to lacking server support for PEP.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
+ * @throws SmackException.NoResponseException
*/
public OXInstantMessagingIntegrationTest(SmackIntegrationTestEnvironment environment)
throws XMPPException.XMPPErrorException, InterruptedException, SmackException.NotConnectedException,
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/pubsub/PubSubIntegrationTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/pubsub/PubSubIntegrationTest.java
index cc5811ad0..8b7e04e86 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/pubsub/PubSubIntegrationTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/pubsub/PubSubIntegrationTest.java
@@ -54,11 +54,6 @@ public class PubSubIntegrationTest extends AbstractSmackIntegrationTest {
/**
* Asserts that an event notification (publication without item) can be published to
* a node that is both 'notification-only' as well as 'transient'.
- *
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
*/
@SmackIntegrationTest
public void transientNotificationOnlyNodeWithoutItemTest() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@@ -79,10 +74,6 @@ public class PubSubIntegrationTest extends AbstractSmackIntegrationTest {
}
}
- /**
-
- */
-
/**
* Asserts that an error is returned when a publish request to a node that is both
* 'notification-only' as well as 'transient' contains an item element.
@@ -94,10 +85,6 @@ public class PubSubIntegrationTest extends AbstractSmackIntegrationTest {
* and a pubsub-specific error condition of <item-forbidden/>.
*
*
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
* @see
* 7.1.3.6 Request Does Not Match Configuration
*/
diff --git a/smack-integration-test/src/main/java/org/jivesoftware/smackx/xdata/FormTest.java b/smack-integration-test/src/main/java/org/jivesoftware/smackx/xdata/FormTest.java
index 682f3b82f..61eb04129 100644
--- a/smack-integration-test/src/main/java/org/jivesoftware/smackx/xdata/FormTest.java
+++ b/smack-integration-test/src/main/java/org/jivesoftware/smackx/xdata/FormTest.java
@@ -48,8 +48,8 @@ public class FormTest extends AbstractSmackIntegrationTest {
* 2. Retrieve the form to fill out, complete it and return it to the requestor
* 3. Retrieve the completed form and check that everything is OK
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws NotConnectedException if the XMPP connection is not connected.
+ * @throws InterruptedException
+ * @throws NotConnectedException
*/
@SuppressWarnings("deprecation")
@SmackIntegrationTest
diff --git a/smack-java7/src/main/java/org/jivesoftware/smack/java7/XmppHostnameVerifier.java b/smack-java7/src/main/java/org/jivesoftware/smack/java7/XmppHostnameVerifier.java
index 94f3f198a..f817fd058 100644
--- a/smack-java7/src/main/java/org/jivesoftware/smack/java7/XmppHostnameVerifier.java
+++ b/smack-java7/src/main/java/org/jivesoftware/smack/java7/XmppHostnameVerifier.java
@@ -203,8 +203,8 @@ public class XmppHostnameVerifier implements HostnameVerifier {
/**
* Returns true if the name matches against the template that may contain the wildcard char '*'.
*
- * @param name TODO javadoc me please
- * @param template TODO javadoc me please
+ * @param name
+ * @param template
* @return true if name matches template.
*/
private static boolean matchWildCards(String name, String template) {
@@ -243,8 +243,8 @@ public class XmppHostnameVerifier implements HostnameVerifier {
* must exactly match the IP in the URI."
*
*
- * @param expectedIP TODO javadoc me please
- * @param cert TODO javadoc me please
+ * @param expectedIP
+ * @param cert
* @throws CertificateException
*/
private static void matchIp(String expectedIP, X509Certificate cert)
diff --git a/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/JingleManagerTest.java b/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/JingleManagerTest.java
index 49c89c355..3acbd4c77 100644
--- a/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/JingleManagerTest.java
+++ b/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/JingleManagerTest.java
@@ -59,7 +59,7 @@ public class JingleManagerTest extends SmackTestCase {
/**
* Constructor for JingleManagerTest.
*
- * @param name TODO javadoc me please
+ * @param name
*/
public JingleManagerTest(final String name) {
super(name);
diff --git a/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/nat/STUNResolverTest.java b/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/nat/STUNResolverTest.java
index 2f1ee9b92..732cb7122 100644
--- a/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/nat/STUNResolverTest.java
+++ b/smack-jingle-old/src/integration-test/java/org/jivesoftware/smackx/jingle/nat/STUNResolverTest.java
@@ -77,7 +77,7 @@ public class STUNResolverTest extends SmackTestCase {
/**
* Test for getPreferredCandidate()
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
public void testGetPreferredCandidate() throws Exception {
int highestPref = 100;
@@ -105,7 +105,7 @@ public class STUNResolverTest extends SmackTestCase {
/**
* Test for getPreferredCandidate()
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
public void testGetPreferredCandidateICE() throws Exception {
int highestPref = 100;
@@ -133,7 +133,7 @@ public class STUNResolverTest extends SmackTestCase {
/**
* Test priority generated by STUN lib
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
public void testICEPriority() throws Exception {
@@ -193,7 +193,7 @@ public class STUNResolverTest extends SmackTestCase {
/**
* Test for loadSTUNServers()
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
public void testLoadSTUNServers() throws Exception {
STUNResolver stunResolver = new STUNResolver() {
@@ -218,7 +218,7 @@ public class STUNResolverTest extends SmackTestCase {
/**
* Test for resolve()
*
- * @throws Exception if an exception occurs.
+ * @throws Exception
*/
public void testResolve() throws Exception {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/ContentNegotiator.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/ContentNegotiator.java
index 2d9d663b5..797ce194c 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/ContentNegotiator.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/ContentNegotiator.java
@@ -124,7 +124,7 @@ public class ContentNegotiator extends JingleNegotiator {
/**
* Set jingle transport manager.
- * @param jingleTransportManager TODO javadoc me please
+ * @param jingleTransportManager
*/
public void setJingleTransportManager(JingleTransportManager jingleTransportManager) {
this.jingleTransportManager = jingleTransportManager;
@@ -175,7 +175,7 @@ public class ContentNegotiator extends JingleNegotiator {
/**
* Set the jmf negotiator.
*
- * @param mediaNeg TODO javadoc me please
+ * @param mediaNeg
* the description negotiator to set
*/
protected void setMediaNegotiator(MediaNegotiator mediaNeg) {
@@ -205,7 +205,7 @@ public class ContentNegotiator extends JingleNegotiator {
/**
* Set TransportNegotiator
*
- * @param transNeg TODO javadoc me please
+ * @param transNeg
* the transNeg to set
*/
protected void setTransportNegotiator(TransportNegotiator transNeg) {
@@ -225,8 +225,6 @@ public class ContentNegotiator extends JingleNegotiator {
/**
* Return true if the transport and content negotiators have finished.
- *
- * @return true if fully established.
*/
public boolean isFullyEstablished() {
boolean result = true;
@@ -277,8 +275,8 @@ public class ContentNegotiator extends JingleNegotiator {
/**
* Trigger a session established event.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private void triggerContentEstablished(PayloadType pt, TransportCandidate rc, TransportCandidate lc) throws NotConnectedException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleActionEnum.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleActionEnum.java
index fd4af3719..685d9aef5 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleActionEnum.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleActionEnum.java
@@ -53,9 +53,6 @@ public enum JingleActionEnum {
/**
* Returns the Action enum for a String action value.
- *
- * @param inActionCode the action code.
- * @return the jingle action.
*/
public static JingleActionEnum getAction(String inActionCode) {
for (JingleActionEnum jingleAction : JingleActionEnum.values()) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleManager.java
index acd9a5796..842dc11a6 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleManager.java
@@ -194,8 +194,8 @@ public class JingleManager implements JingleSessionListener {
*
* @param connection XMPP XMPPConnection to be used
* @param jingleMediaManagers an implemented JingleMediaManager to be used.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws SmackException
+ * @throws XMPPException
*/
public JingleManager(XMPPConnection connection, List jingleMediaManagers) throws XMPPException, SmackException {
this.connection = connection;
@@ -303,8 +303,8 @@ public class JingleManager implements JingleSessionListener {
* @return a boolean indicating whether the specified user handles Jingle
* messages
* @throws SmackException if there was no response from the server.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws InterruptedException
*/
public static boolean isServiceEnabled(XMPPConnection connection, Jid userID) throws XMPPException, SmackException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection).supportsFeature(userID, Jingle.NAMESPACE);
@@ -367,7 +367,7 @@ public class JingleManager implements JingleSessionListener {
* Adds a CreatedJingleSessionListener.
* This listener will be called when a session is created by the JingleManager instance.
*
- * @param createdJingleSessionListener TODO javadoc me please
+ * @param createdJingleSessionListener
*/
public void addCreationListener(CreatedJingleSessionListener createdJingleSessionListener) {
this.creationListeners.add(createdJingleSessionListener);
@@ -377,7 +377,7 @@ public class JingleManager implements JingleSessionListener {
* Removes a CreatedJingleSessionListener.
* This listener will be called when a session is created by the JingleManager instance.
*
- * @param createdJingleSessionListener TODO javadoc me please
+ * @param createdJingleSessionListener
*/
public void removeCreationListener(CreatedJingleSessionListener createdJingleSessionListener) {
this.creationListeners.remove(createdJingleSessionListener);
@@ -386,7 +386,7 @@ public class JingleManager implements JingleSessionListener {
/**
* Trigger CreatedJingleSessionListeners that a session was created.
*
- * @param jingleSession TODO javadoc me please
+ * @param jingleSession
*/
public void triggerSessionCreated(JingleSession jingleSession) {
jingleSessions.add(jingleSession);
@@ -517,7 +517,6 @@ public class JingleManager implements JingleSessionListener {
* @param responder the fully qualified jabber ID with resource of the other
* user.
* @return The session on which the negotiation can be run.
- * @throws XMPPException if an XMPP protocol error was received.
*/
public JingleSession createOutgoingJingleSession(EntityFullJid responder) throws XMPPException {
JingleSession session = new JingleSession(connection, null, connection.getUser(), responder, jingleMediaManagers);
@@ -544,7 +543,6 @@ public class JingleManager implements JingleSessionListener {
*
* @param request the remote request that is being accepted.
* @return the session which manages the rest of the negotiation.
- * @throws XMPPException if an XMPP protocol error was received.
*/
public JingleSession createIncomingJingleSession(JingleSessionRequest request) throws XMPPException {
if (request == null) {
@@ -578,7 +576,7 @@ public class JingleManager implements JingleSessionListener {
/**
* Get a session with the informed JID. If no session is found, return null.
*
- * @param jid TODO javadoc me please
+ * @param jid
* @return the JingleSession
*/
public JingleSession getSession(String jid) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleNegotiator.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleNegotiator.java
index 656faad25..475411846 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleNegotiator.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleNegotiator.java
@@ -129,7 +129,7 @@ public abstract class JingleNegotiator {
/**
* Add expected ID.
*
- * @param id TODO javadoc me please
+ * @param id
*/
public void addExpectedId(String id) {
expectedAckId = id;
@@ -138,7 +138,7 @@ public abstract class JingleNegotiator {
/**
* Check if the passed ID is the expected ID.
*
- * @param id TODO javadoc me please
+ * @param id
* @return true if is expected id
*/
public boolean isExpectedId(String id) {
@@ -152,7 +152,7 @@ public abstract class JingleNegotiator {
/**
* Remove and expected ID.
*
- * @param id TODO javadoc me please
+ * @param id
*/
public void removeExpectedId(String id) {
addExpectedId(null);
@@ -229,9 +229,8 @@ public abstract class JingleNegotiator {
* @param iq the stanza received
* @param id the ID of the response that will be sent
* @return the new stanza to send (either a Jingle or an IQ error).
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws InterruptedException
*/
public abstract List dispatchIncomingPacket(IQ iq, String id) throws XMPPException, SmackException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSession.java
index fdd529e5f..296630f26 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSession.java
@@ -100,15 +100,15 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Full featured JingleSession constructor.
*
- * @param conn TODO javadoc me please
+ * @param conn
* the XMPPConnection which is used
- * @param initiator TODO javadoc me please
+ * @param initiator
* the initiator JID
- * @param responder TODO javadoc me please
+ * @param responder
* the responder JID
- * @param sessionid TODO javadoc me please
+ * @param sessionid
* the session ID
- * @param jingleMediaManagers TODO javadoc me please
+ * @param jingleMediaManagers
* the jingleMediaManager
*/
public JingleSession(XMPPConnection conn, Jid initiator, Jid responder, String sessionid,
@@ -138,7 +138,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
*
* @param conn
* Connection
- * @param request the request.
* @param initiator
* the initiator JID
* @param responder
@@ -169,7 +168,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Set the session initiator.
*
- * @param initiator TODO javadoc me please
+ * @param initiator
* the initiator to set
*/
public void setInitiator(Jid initiator) {
@@ -188,7 +187,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Set the Media Manager of this Jingle Session.
*
- * @param jingleMediaManagers TODO javadoc me please
+ * @param jingleMediaManagers
*/
public void setMediaManagers(List jingleMediaManagers) {
this.jingleMediaManagers = jingleMediaManagers;
@@ -206,7 +205,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Set the session responder.
*
- * @param responder TODO javadoc me please
+ * @param responder
* the receptor to set
*/
public void setResponder(Jid responder) {
@@ -225,7 +224,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Set the session ID
*
- * @param sessionId TODO javadoc me please
+ * @param sessionId
* the sid to set
*/
protected void setSid(String sessionId) {
@@ -234,8 +233,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Generate a unique session ID.
- *
- * @return the generated session ID.
*/
protected static String generateSessionId() {
return String.valueOf(randomGenerator.nextInt(Integer.MAX_VALUE) + randomGenerator.nextInt(Integer.MAX_VALUE));
@@ -243,8 +240,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Validate the state changes.
- *
- * @param stateIs the jingle session state.
*/
public void setSessionState(JingleSessionState stateIs) {
@@ -260,8 +255,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Return true if all of the media managers have finished.
- *
- * @return true if fully established.
*/
public boolean isFullyEstablished() {
boolean result = true;
@@ -284,11 +277,11 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* a response. The response will be another Jingle stanza that will be sent
* to the other end point.
*
- * @param iq TODO javadoc me please
+ * @param iq
* the stanza received
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
public synchronized void receivePacketAndRespond(IQ iq) throws XMPPException, SmackException, InterruptedException {
List responses = new ArrayList<>();
@@ -353,12 +346,12 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* the stanza type and, depending on the current state, delivering the
* stanza to the right event handler and wait for a response.
*
- * @param iq TODO javadoc me please
+ * @param iq
* the stanza received
* @return the new Jingle stanza to send.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Override
public List dispatchIncomingPacket(IQ iq, String id) throws XMPPException, SmackException, InterruptedException {
@@ -402,8 +395,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Add a new content negotiator on behalf of a <content/> section received.
- *
- * @param inContentNegotiator the content negotiator.
*/
public void addContentNegotiator(ContentNegotiator inContentNegotiator) {
contentNegotiators.add(inContentNegotiator);
@@ -433,9 +424,8 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
*
* @param jout
* the Jingle stanza we want to complete and send
- * @return the Jingle stanza.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Jingle sendFormattedJingle(Jingle jout) throws NotConnectedException, InterruptedException {
return sendFormattedJingle(null, jout);
@@ -446,11 +436,12 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* reponse, using the session information we have or some info from the
* incoming packet.
*
- * @param iq The Jingle stanza we are responding to
- * @param jout the Jingle stanza we want to complete and send
- * @return the Jingle stanza.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param iq
+ * The Jingle stanza we are responding to
+ * @param jout
+ * the Jingle stanza we want to complete and send
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Jingle sendFormattedJingle(IQ iq, Jingle jout) throws NotConnectedException, InterruptedException {
if (jout != null) {
@@ -495,8 +486,8 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
}
/**
- * @param inJingle TODO javadoc me please
- * @param inAction TODO javadoc me please
+ * @param inJingle
+ * @param inAction
*/
// private void sendUnknownStateAction(Jingle inJingle, JingleActionEnum inAction) {
//
@@ -517,8 +508,8 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Acknowledge a IQ packet.
*
- * @param iq The IQ to acknowledge.
- * @return the ack IQ.
+ * @param iq
+ * The IQ to acknowledge
*/
public IQ createAck(IQ iq) {
IQ result = null;
@@ -604,7 +595,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Clean a session from the list.
*
- * @param connection TODO javadoc me please
+ * @param connection
* The connection to clean up
*/
private void unregisterInstanceFor(XMPPConnection connection) {
@@ -625,7 +616,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Returns the JingleSession related to a particular connection.
*
- * @param con TODO javadoc me please
+ * @param con
* A XMPP connection
* @return a Jingle session
*/
@@ -647,7 +638,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Configure a session, setting some action listeners...
*
- * @param connection TODO javadoc me please
+ * @param connection
* The connection to set up
*/
private void installConnectionListeners(final XMPPConnection connection) {
@@ -759,7 +750,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Add a listener for jmf negotiation events.
*
- * @param li TODO javadoc me please
+ * @param li
* The listener
*/
public void addMediaListener(JingleMediaListener li) {
@@ -774,7 +765,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Remove a listener for jmf negotiation events.
*
- * @param li TODO javadoc me please
+ * @param li
* The listener
*/
public void removeMediaListener(JingleMediaListener li) {
@@ -788,7 +779,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Add a listener for transport negotiation events.
*
- * @param li TODO javadoc me please
+ * @param li
* The listener
*/
public void addTransportListener(JingleTransportListener li) {
@@ -802,7 +793,7 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Remove a listener for transport negotiation events.
*
- * @param li TODO javadoc me please
+ * @param li
* The listener
*/
public void removeTransportListener(JingleTransportListener li) {
@@ -892,8 +883,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Trigger a session closed event.
- *
- * @param reason the reason.
*/
protected void triggerSessionClosed(String reason) {
// for (ContentNegotiator contentNegotiator : contentNegotiators) {
@@ -916,8 +905,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Trigger a session closed event due to an error.
- *
- * @param exc the exception.
*/
protected void triggerSessionClosedOnError(XMPPException exc) {
for (ContentNegotiator contentNegotiator : contentNegotiators) {
@@ -951,8 +938,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
// }
/**
* Trigger a media received event.
- *
- * @param participant the participant.
*/
protected void triggerMediaReceived(String participant) {
List listeners = getListenersList();
@@ -995,9 +980,9 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Terminates the session with default reason.
*
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void terminate() throws XMPPException, NotConnectedException, InterruptedException {
terminate("Closed Locally");
@@ -1006,10 +991,9 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* Terminates the session with a custom reason.
*
- * @param reason the reason.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void terminate(String reason) throws XMPPException, NotConnectedException, InterruptedException {
if (isClosed())
@@ -1064,7 +1048,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* The Jingle stanza we are responding to
* @param jingleError
* the IQ stanza we want to complete and send
- * @return the jingle error IQ.
*/
public IQ createJingleError(IQ iq, JingleError jingleError) {
IQ errorPacket = null;
@@ -1095,9 +1078,9 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
/**
* This is the starting point for intitiating a new session.
*
- * @throws IllegalStateException if an illegal state was encountered
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws IllegalStateException
+ * @throws SmackException
+ * @throws InterruptedException
*/
public void startOutgoing() throws IllegalStateException, SmackException, InterruptedException {
@@ -1185,9 +1168,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* The jingle session may have one or more media managers that are trying to establish media sessions.
* When the media manager succeeds in creating a media session is registers it with the session by the
* media manager's static name. This routine is where the media manager does the registering.
- *
- * @param mediaManagerName the name of the media manager.
- * @param mediaSession the jingle media session.
*/
public void addJingleMediaSession(String mediaManagerName, JingleMediaSession mediaSession) {
mediaSessionMap.put(mediaManagerName, mediaSession);
@@ -1198,9 +1178,6 @@ public final class JingleSession extends JingleNegotiator implements MediaReceiv
* When the media manager succeeds in creating a media session is registers it with the session by the
* media manager's static name. This routine is where other objects can access the registered media sessions.
* NB: If the media manager has not succeeded in establishing a media session then this could return null.
- *
- * @param mediaManagerName the name of the media manager.
- * @return the jingle media session.
*/
public JingleMediaSession getMediaSession(String mediaManagerName) {
return mediaSessionMap.get(mediaManagerName);
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionRequest.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionRequest.java
index afbc34369..d363cac5d 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionRequest.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionRequest.java
@@ -80,8 +80,6 @@ public class JingleSessionRequest {
/**
* Returns the Jingle stanza that was sent by the requester which contains
* the parameters of the session.
- *
- * @return the jingle stanza.
*/
public Jingle getJingle() {
return jingle;
@@ -111,9 +109,8 @@ public class JingleSessionRequest {
*
* @return Returns the IncomingJingleSession on which the
* negotiation can be carried out.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public synchronized JingleSession accept() throws XMPPException, SmackException, InterruptedException {
JingleSession session;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionState.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionState.java
index a1bc7263b..693a3fc2f 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionState.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionState.java
@@ -36,8 +36,6 @@ public abstract class JingleSessionState {
/**
* Called when entering the state.
- *
- * @return the jingle session state.
*/
public static JingleSessionState getInstance() {
// Since we can never instantiate this class there is nothing to return (ever).
@@ -56,14 +54,8 @@ public abstract class JingleSessionState {
/**
* Process an incoming Jingle Packet.
- * When you look at the GoF State pattern this method roughly corresponds to example on p310: ProcessOctect()
- *
- * @param session the jingle session.
- * @param jingle the jingle stanza.
- * @param action the jingle action.
- * @return the resulting IQ.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * When you look at the GoF State pattern this method roughly corresponds to example on p310: ProcessOctect().
+ * @throws InterruptedException
*/
public abstract IQ processJingle(JingleSession session, Jingle jingle, JingleActionEnum action) throws SmackException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionStateUnknown.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionStateUnknown.java
index 619458f29..24455c4b9 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionStateUnknown.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/JingleSessionStateUnknown.java
@@ -98,8 +98,8 @@ public class JingleSessionStateUnknown extends JingleSessionState {
/**
* In the UNKNOWN state we received a action.
* This method processes that action.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
private IQ receiveSessionInitiateAction(JingleSession session, Jingle inJingle) throws SmackException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleMediaListener.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleMediaListener.java
index 47a599a7c..1601282b5 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleMediaListener.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleMediaListener.java
@@ -30,8 +30,8 @@ public interface JingleMediaListener extends JingleListener {
* Notification that the jmf has been negotiated and established.
*
* @param pt The payload type agreed.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
void mediaEstablished(PayloadType pt) throws NotConnectedException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleSessionListener.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleSessionListener.java
index b51e6e9f6..95e3a1852 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleSessionListener.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleSessionListener.java
@@ -37,8 +37,8 @@ public interface JingleSessionListener extends JingleListener {
* service.
* @param localCandidate the local candidate where we must listen for connections
* @param jingleSession Session that called the method
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
void sessionEstablished(PayloadType pt, TransportCandidate remoteCandidate,
TransportCandidate localCandidate, JingleSession jingleSession) throws NotConnectedException, InterruptedException;
@@ -54,7 +54,7 @@ public interface JingleSessionListener extends JingleListener {
/**
* Notification that the session was redirected.
*
- * @param redirection TODO javadoc me please
+ * @param redirection
* @param jingleSession session that called the method
*/
void sessionRedirected(String redirection, JingleSession jingleSession);
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleTransportListener.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleTransportListener.java
index e4ca3ca67..3b1817d29 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleTransportListener.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/listeners/JingleTransportListener.java
@@ -35,8 +35,8 @@ public interface JingleTransportListener extends JingleListener {
* in the local machine
* @param remote The transport candidate that has been used for
* transmitting to the remote machine
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
void transportEstablished(TransportCandidate local,
TransportCandidate remote) throws NotConnectedException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/ContentInfo.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/ContentInfo.java
index 8db3f03b9..dbdcbd63b 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/ContentInfo.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/ContentInfo.java
@@ -56,9 +56,6 @@ public abstract class ContentInfo {
/**
* Returns the MediaInfo constant associated with the String value.
- *
- * @param value the input string.
- * @return the content info.
*/
public static ContentInfo fromString(String value) {
value = value.toLowerCase(Locale.US);
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaManager.java
index a1c7cc9a5..1ad3dc1d6 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaManager.java
@@ -45,9 +45,7 @@ public abstract class JingleMediaManager {
}
/**
- * Returns the transport manager that goes with this media manager.
- *
- * @return the transport manager.
+ * Return The transport manager that goes with this media manager.
*/
public JingleTransportManager getTransportManager() {
return transportManager;
@@ -72,10 +70,9 @@ public abstract class JingleMediaManager {
/**
* Create a Media Session Implementation.
*
- * @param payloadType TODO javadoc me please
- * @param remote TODO javadoc me please
- * @param local TODO javadoc me please
- * @param jingleSession the jingle session.
+ * @param payloadType
+ * @param remote
+ * @param local
* @return the media session
*/
public abstract JingleMediaSession createMediaSession(PayloadType payloadType, TransportCandidate remote,
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaSession.java
index 2956a265a..44effa49e 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/JingleMediaSession.java
@@ -56,7 +56,6 @@ public abstract class JingleMediaSession {
* @param remote Remote accepted Transport Candidate
* @param local Local accepted Transport Candidate
* @param mediaLocator Media Locator of the capture device
- * @param jingleSession the jingle session.
*/
public JingleMediaSession(PayloadType payloadType, TransportCandidate remote,
TransportCandidate local, String mediaLocator, JingleSession jingleSession) {
@@ -115,7 +114,7 @@ public abstract class JingleMediaSession {
/**
* Adds a Media Received Listener.
*
- * @param mediaReceivedListener TODO javadoc me please
+ * @param mediaReceivedListener
*/
public void addMediaReceivedListener(MediaReceivedListener mediaReceivedListener) {
mediaReceivedListeners.add(mediaReceivedListener);
@@ -124,7 +123,7 @@ public abstract class JingleMediaSession {
/**
* Removes a Media Received Listener.
*
- * @param mediaReceivedListener TODO javadoc me please
+ * @param mediaReceivedListener
*/
public void removeMediaReceivedListener(MediaReceivedListener mediaReceivedListener) {
mediaReceivedListeners.remove(mediaReceivedListener);
@@ -156,7 +155,7 @@ public abstract class JingleMediaSession {
* Set transmit activity. If the active is true, the instance should trasmit.
* If it is set to false, the instance should pause transmit.
*
- * @param active TODO javadoc me please
+ * @param active
*/
public abstract void setTransmit(boolean active);
@@ -172,8 +171,6 @@ public abstract class JingleMediaSession {
/**
* Called when new Media is received.
- *
- * @param participant the particpant.
*/
public void mediaReceived(String participant) {
for (MediaReceivedListener mediaReceivedListener : mediaReceivedListeners) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaNegotiator.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaNegotiator.java
index eb461208c..c2f809e93 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaNegotiator.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaNegotiator.java
@@ -69,10 +69,8 @@ public class MediaNegotiator extends JingleNegotiator {
* but it does not start the negotiation. For starting the negotiation, call
* startNegotiation.
*
- * @param session TODO javadoc me please
- * @param mediaManager the media manager.
- * @param pts the list of payload types.
- * @param parentNegotiator the parent content negotiator.
+ * @param session
+ * The jingle session.
*/
public MediaNegotiator(JingleSession session, JingleMediaManager mediaManager, List pts,
ContentNegotiator parentNegotiator) {
@@ -91,9 +89,7 @@ public class MediaNegotiator extends JingleNegotiator {
}
/**
- * Returns the media manager for this negotiator.
- *
- * @return the media manager.
+ * Return The media manager for this negotiator.
*/
public JingleMediaManager getMediaManager() {
return mediaManager;
@@ -104,12 +100,12 @@ public class MediaNegotiator extends JingleNegotiator {
* the stanza type and, depending on the current state, delivering the
* stanza to the right event handler and wait for a response.
*
- * @param iq TODO javadoc me please
+ * @param iq
* the stanza received
* @return the new Jingle stanza to send.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Override
public List dispatchIncomingPacket(IQ iq, String id) throws XMPPException, NotConnectedException, InterruptedException {
@@ -207,10 +203,10 @@ public class MediaNegotiator extends JingleNegotiator {
* This means we can walk through our list, in order, until we find one from their list that matches. This
* will be the best payload type to use.
*
- * @param jingle TODO javadoc me please
+ * @param jingle
* @return the iq
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private IQ receiveContentAcceptAction(Jingle jingle, JingleDescription description) throws XMPPException, NotConnectedException, InterruptedException {
IQ response;
@@ -237,8 +233,8 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Receive a session-initiate packet.
- * @param jingle TODO javadoc me please
- * @param description TODO javadoc me please
+ * @param jingle
+ * @param description
* @return the iq
*/
private IQ receiveSessionInitiateAction(Jingle jingle, JingleDescription description) {
@@ -268,7 +264,7 @@ public class MediaNegotiator extends JingleNegotiator {
* A content info has been received. This is done for publishing the
* list of payload types...
*
- * @param jingle TODO javadoc me please
+ * @param jingle
* The input packet
* @return a Jingle packet
* @throws JingleException
@@ -308,7 +304,7 @@ public class MediaNegotiator extends JingleNegotiator {
* A jmf description has been accepted. In this case, we must save the
* accepted payload type and notify any listener...
*
- * @param jin TODO javadoc me please
+ * @param jin
* The input packet
* @return a Jingle packet
* @throws JingleException
@@ -413,7 +409,7 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Adds a payload type to the list of remote payloads.
*
- * @param pt TODO javadoc me please
+ * @param pt
* the remote payload type
*/
public void addRemoteAudioPayloadType(PayloadType.Audio pt) {
@@ -479,10 +475,10 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Trigger a session established event.
*
- * @param bestPt TODO javadoc me please
+ * @param bestPt
* payload type that has been agreed.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
protected void triggerMediaEstablished(PayloadType bestPt) throws NotConnectedException, InterruptedException {
List listeners = getListenersList();
@@ -497,7 +493,7 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Trigger a jmf closed event.
*
- * @param currPt TODO javadoc me please
+ * @param currPt
* current payload type that is cancelled.
*/
protected void triggerMediaClosed(PayloadType currPt) {
@@ -529,8 +525,6 @@ public class MediaNegotiator extends JingleNegotiator {
/**
* Create a JingleDescription that matches this negotiator.
- *
- * @return the jingle description.
*/
public JingleDescription getJingleDescription() {
JingleDescription result = null;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaReceivedListener.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaReceivedListener.java
index d4266c3d3..2a4997dcf 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaReceivedListener.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/media/MediaReceivedListener.java
@@ -23,8 +23,6 @@ public interface MediaReceivedListener {
/**
* Called when new Media is received.
- *
- * @param participant the participant.
*/
void mediaReceived(String participant);
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioChannel.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioChannel.java
index 4d16933d0..d5bbbb285 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioChannel.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioChannel.java
@@ -100,7 +100,6 @@ public class AudioChannel {
* @param localPort local port number
* @param remotePort remote port number
* @param format audio format
- * @param jingleMediaSession the jingle media session.
*/
public AudioChannel(MediaLocator locator,
String localIpAddress,
@@ -313,10 +312,10 @@ public class AudioChannel {
/**
* Get the best stanza size for a given codec and a codec rate
*
- * @param codecFormat TODO javadoc me please
- * @param milliseconds TODO javadoc me please
+ * @param codecFormat
+ * @param milliseconds
* @return the best stanza size
- * @throws IllegalArgumentException if an illegal argument was given.
+ * @throws IllegalArgumentException
*/
private int getPacketSize(Format codecFormat, int milliseconds) throws IllegalArgumentException {
String encoding = codecFormat.getEncoding();
@@ -337,7 +336,7 @@ public class AudioChannel {
* Use the RTPManager API to create sessions for each jmf
* track of the processor.
*
- * @return description TODO javadoc me please
+ * @return description
*/
private String createTransmitter() {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioMediaSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioMediaSession.java
index 42525c68d..3e0aace1a 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioMediaSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/AudioMediaSession.java
@@ -51,7 +51,6 @@ public class AudioMediaSession extends JingleMediaSession {
* @param remote the remote information. The candidate that the jmf will be sent to.
* @param local the local information. The candidate that will receive the jmf
* @param locator media locator
- * @param jingleSession the jingle session.
*/
public AudioMediaSession(final PayloadType payloadType, final TransportCandidate remote,
final TransportCandidate local, String locator, JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/JmfMediaManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/JmfMediaManager.java
index 4ac3e5396..dc20a6844 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/JmfMediaManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jmf/JmfMediaManager.java
@@ -50,8 +50,6 @@ public class JmfMediaManager extends JingleMediaManager {
/**
* Creates a Media Manager instance.
- *
- * @param transportManager the transport manger.
*/
public JmfMediaManager(JingleTransportManager transportManager) {
super(transportManager);
@@ -62,7 +60,6 @@ public class JmfMediaManager extends JingleMediaManager {
* Creates a Media Manager instance.
*
* @param mediaLocator Media Locator
- * @param transportManager the transport manger.
*/
public JmfMediaManager(String mediaLocator, JingleTransportManager transportManager) {
super(transportManager);
@@ -76,7 +73,7 @@ public class JmfMediaManager extends JingleMediaManager {
* @param payloadType payloadType
* @param remote remote Candidate
* @param local local Candidate
- * @return JingleMediaSession TODO javadoc me please
+ * @return JingleMediaSession
*/
@Override
public JingleMediaSession createMediaSession(final PayloadType payloadType, final TransportCandidate remote, final TransportCandidate local, final JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/AudioMediaSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/AudioMediaSession.java
index 229a1521f..dcea33c02 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/AudioMediaSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/AudioMediaSession.java
@@ -67,11 +67,11 @@ public class AudioMediaSession extends JingleMediaSession implements MediaSessio
* @param quality quality
* @param secure secure
* @param micOn micOn
- * @return MediaSession TODO javadoc me please
- * @throws NoProcessorException if there is no media processor.
- * @throws UnsupportedFormatException if the format is not supported.
- * @throws IOException if an I/O error occured.
- * @throws GeneralSecurityException if there was a geneeral security exception.
+ * @return MediaSession
+ * @throws NoProcessorException
+ * @throws UnsupportedFormatException
+ * @throws IOException
+ * @throws GeneralSecurityException
*/
public static MediaSession createSession(String localhost, int localPort, String remoteHost, int remotePort, MediaSessionListener eventHandler, int quality, boolean secure, boolean micOn) throws NoProcessorException, UnsupportedFormatException, IOException, GeneralSecurityException {
@@ -102,7 +102,6 @@ public class AudioMediaSession extends JingleMediaSession implements MediaSessio
* @param remote the remote information. The candidate that the jmf will be sent to.
* @param local the local information. The candidate that will receive the jmf
* @param locator media locator
- * @param jingleSession the jingle session.
*/
public AudioMediaSession(final PayloadType payloadType, final TransportCandidate remote,
final TransportCandidate local, String locator, JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/SpeexMediaManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/SpeexMediaManager.java
index f99077345..d77d9206c 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/SpeexMediaManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/jspeex/SpeexMediaManager.java
@@ -58,7 +58,7 @@ public class SpeexMediaManager extends JingleMediaManager {
* @param payloadType payloadType
* @param remote remote Candidate
* @param local local Candidate
- * @return JingleMediaSession TODO javadoc me please
+ * @return JingleMediaSession
*/
@Override
public JingleMediaSession createMediaSession(PayloadType payloadType, final TransportCandidate remote, final TransportCandidate local, final JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/ScreenShareSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/ScreenShareSession.java
index 8a33211e0..4af4a56c3 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/ScreenShareSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/ScreenShareSession.java
@@ -64,7 +64,6 @@ public class ScreenShareSession extends JingleMediaSession {
* @param remote the remote information. The candidate that the jmf will be sent to.
* @param local the local information. The candidate that will receive the jmf
* @param locator media locator
- * @param jingleSession the jingle session.
*/
public ScreenShareSession(final PayloadType payloadType, final TransportCandidate remote, final TransportCandidate local,
final String locator, JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/ImageTransmitter.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/ImageTransmitter.java
index 6a51b339a..39db457b8 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/ImageTransmitter.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/ImageTransmitter.java
@@ -196,7 +196,7 @@ public class ImageTransmitter implements Runnable {
/**
* Get the encoder used to encode Images Tiles.
*
- * @return encoder TODO javadoc me please
+ * @return encoder
*/
public ImageEncoder getEncoder() {
return encoder;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/PixelUtils.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/PixelUtils.java
index f6001c762..bd7e326f4 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/PixelUtils.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/sshare/api/PixelUtils.java
@@ -52,9 +52,6 @@ public class PixelUtils {
/**
* Clamp a value to the range 0..255.
- *
- * @param c the input integer.
- * @return the output integer.
*/
public static int clamp(int c) {
if (c < 0)
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/test/TestMediaSession.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/test/TestMediaSession.java
index 1bb4cf746..afecb9b58 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/test/TestMediaSession.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/mediaimpl/test/TestMediaSession.java
@@ -35,7 +35,6 @@ public class TestMediaSession extends JingleMediaSession {
* @param remote the remote information. The candidate that the jmf will be sent to.
* @param local the local information. The candidate that will receive the jmf
* @param locator media locator
- * @param jingleSession the jingle session.
*/
public TestMediaSession(final PayloadType payloadType, final TransportCandidate remote, final TransportCandidate local,
final String locator, JingleSession jingleSession) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BasicResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BasicResolver.java
index fed641d7f..c77a16c01 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BasicResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BasicResolver.java
@@ -48,8 +48,8 @@ public class BasicResolver extends TransportResolver {
*
* The BasicResolver takes the IP addresses of the interfaces and uses the
* first non-loopback, non-linklocal and non-sitelocal address.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Override
public synchronized void resolve(JingleSession session) throws XMPPException, NotConnectedException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedResolver.java
index 05482014f..5efb2a610 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedResolver.java
@@ -54,20 +54,18 @@ public class BridgedResolver extends TransportResolver {
/**
* Constructor.
* A Bridged Resolver need an XMPPConnection to connect to a RTP Bridge.
- *
- * @param connection the XMPP connection.
*/
public BridgedResolver(XMPPConnection connection) {
super();
this.connection = connection;
}
- /**
+ /**1
* Resolve Bridged Candidate.
*
* The BridgedResolver takes the IP address and ports of a jmf proxy service.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Override
public synchronized void resolve(JingleSession session) throws XMPPException, NotConnectedException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedTransportManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedTransportManager.java
index faa18e8e0..eaeb70ee2 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedTransportManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/BridgedTransportManager.java
@@ -46,7 +46,7 @@ public class BridgedTransportManager extends JingleTransportManager implements J
* Return the correspondent resolver
*
* @param session correspondent Jingle Session
- * @return resolver TODO javadoc me please
+ * @return resolver
*/
@Override
protected TransportResolver createResolver(JingleSession session) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/FixedResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/FixedResolver.java
index d1ea13fad..59aba815d 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/FixedResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/FixedResolver.java
@@ -34,9 +34,6 @@ public class FixedResolver extends TransportResolver {
/**
* Constructor.
- *
- * @param ip the IP address.
- * @param port the port number.
*/
public FixedResolver(String ip, int port) {
super();
@@ -55,8 +52,8 @@ public class FixedResolver extends TransportResolver {
/**
* Resolve the IP address.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Override
public synchronized void resolve(JingleSession session) throws XMPPException, NotConnectedException, InterruptedException {
@@ -79,7 +76,7 @@ public class FixedResolver extends TransportResolver {
/**
* Initialize the resolver.
*
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws XMPPException
*/
@Override
public void initialize() throws XMPPException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/ICEResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/ICEResolver.java
index f286f5f38..d47970893 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/ICEResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/ICEResolver.java
@@ -96,8 +96,8 @@ public class ICEResolver extends TransportResolver {
/**
* Resolve the IP and obtain a valid transport method.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Override
public synchronized void resolve(JingleSession session) throws XMPPException, SmackException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/JingleTransportManager.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/JingleTransportManager.java
index bc5bf2aaa..68f032293 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/JingleTransportManager.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/JingleTransportManager.java
@@ -51,11 +51,8 @@ public abstract class JingleTransportManager {
/**
* Get a new Transport Resolver to be used in a Jingle Session.
*
- * @param session the jingle session.
* @return the TransportResolver to be used
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public TransportResolver getResolver(JingleSession session) throws XMPPException, SmackException, InterruptedException {
TransportResolver resolver = createResolver(session);
@@ -70,10 +67,8 @@ public abstract class JingleTransportManager {
/**
* Create a Transport Resolver instance according to the implementation.
*
- * @param session the jingle session.
* @return the TransportResolver
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
protected abstract TransportResolver createResolver(JingleSession session) throws SmackException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/RTPBridge.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/RTPBridge.java
index 04668e6ba..b4160d833 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/RTPBridge.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/RTPBridge.java
@@ -92,7 +92,7 @@ public class RTPBridge extends IQ {
/**
* Creates a RTPBridge Instance with defined Session ID.
*
- * @param sid TODO javadoc me please
+ * @param sid
*/
public RTPBridge(String sid) {
this();
@@ -102,7 +102,7 @@ public class RTPBridge extends IQ {
/**
* Creates a RTPBridge Instance with defined Session ID.
*
- * @param action TODO javadoc me please
+ * @param action
*/
public RTPBridge(BridgeAction action) {
this();
@@ -112,8 +112,8 @@ public class RTPBridge extends IQ {
/**
* Creates a RTPBridge Instance with defined Session ID.
*
- * @param sid TODO javadoc me please
- * @param bridgeAction TODO javadoc me please
+ * @param sid
+ * @param bridgeAction
*/
public RTPBridge(String sid, BridgeAction bridgeAction) {
this();
@@ -130,8 +130,6 @@ public class RTPBridge extends IQ {
/**
* Get the attributes string.
- *
- * @return the attributes.
*/
public String getAttributes() {
StringBuilder str = new StringBuilder();
@@ -169,7 +167,7 @@ public class RTPBridge extends IQ {
/**
* Set the Session ID of the Stanza (usually same as Jingle Session ID).
*
- * @param sid TODO javadoc me please
+ * @param sid
*/
public void setSid(String sid) {
this.sid = sid;
@@ -187,7 +185,7 @@ public class RTPBridge extends IQ {
/**
* Set the Host A IP Address.
*
- * @param hostA TODO javadoc me please
+ * @param hostA
*/
public void setHostA(String hostA) {
this.hostA = hostA;
@@ -205,7 +203,7 @@ public class RTPBridge extends IQ {
/**
* Set the Host B IP Address.
*
- * @param hostB TODO javadoc me please
+ * @param hostB
*/
public void setHostB(String hostB) {
this.hostB = hostB;
@@ -223,7 +221,7 @@ public class RTPBridge extends IQ {
/**
* Set Side A receive port.
*
- * @param portA TODO javadoc me please
+ * @param portA
*/
public void setPortA(int portA) {
this.portA = portA;
@@ -241,7 +239,7 @@ public class RTPBridge extends IQ {
/**
* Set Side B receive port.
*
- * @param portB TODO javadoc me please
+ * @param portB
*/
public void setPortB(int portB) {
this.portB = portB;
@@ -259,7 +257,7 @@ public class RTPBridge extends IQ {
/**
* Set the RTP Bridge IP.
*
- * @param ip TODO javadoc me please
+ * @param ip
*/
public void setIp(String ip) {
this.ip = ip;
@@ -277,7 +275,7 @@ public class RTPBridge extends IQ {
/**
* Set the RTP Agent Pass.
*
- * @param pass TODO javadoc me please
+ * @param pass
*/
public void setPass(String pass) {
this.pass = pass;
@@ -295,7 +293,7 @@ public class RTPBridge extends IQ {
/**
* Set the name of the Candidate.
*
- * @param name TODO javadoc me please
+ * @param name
*/
public void setName(String name) {
this.name = name;
@@ -391,11 +389,11 @@ public class RTPBridge extends IQ {
* Get a new RTPBridge Candidate from the server.
* If a error occurs or the server don't support RTPBridge Service, null is returned.
*
- * @param connection TODO javadoc me please
- * @param sessionID TODO javadoc me please
+ * @param connection
+ * @param sessionID
* @return the new RTPBridge
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@SuppressWarnings("deprecation")
public static RTPBridge getRTPBridge(XMPPConnection connection, String sessionID) throws NotConnectedException, InterruptedException {
@@ -420,12 +418,12 @@ public class RTPBridge extends IQ {
/**
* Check if the server support RTPBridge Service.
*
- * @param connection TODO javadoc me please
+ * @param connection
* @return true if the server supports the RTPBridge service
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public static boolean serviceAvailable(XMPPConnection connection) throws NoResponseException,
XMPPErrorException, NotConnectedException, InterruptedException {
@@ -460,14 +458,10 @@ public class RTPBridge extends IQ {
/**
* Check if the server support RTPBridge Service.
*
- * @param connection TODO javadoc me please
- * @param sessionID the session id.
- * @param pass the password.
- * @param proxyCandidate the proxy candidate.
- * @param localCandidate the local candidate.
+ * @param connection
* @return the RTPBridge
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@SuppressWarnings("deprecation")
public static RTPBridge relaySession(XMPPConnection connection, String sessionID, String pass, TransportCandidate proxyCandidate, TransportCandidate localCandidate) throws NotConnectedException, InterruptedException {
@@ -501,10 +495,10 @@ public class RTPBridge extends IQ {
/**
* Get Public Address from the Server.
*
- * @param xmppConnection TODO javadoc me please
+ * @param xmppConnection
* @return public IP String or null if not found
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@SuppressWarnings("deprecation")
public static String getPublicIP(XMPPConnection xmppConnection) throws NotConnectedException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUN.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUN.java
index cd32d7381..72bfd7ed2 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUN.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUN.java
@@ -101,7 +101,7 @@ public class STUN extends SimpleIQ {
/**
* Set Public Ip returned from the XMPP server
*
- * @param publicIp TODO javadoc me please
+ * @param publicIp
*/
private void setPublicIp(String publicIp) {
this.publicIp = publicIp;
@@ -172,10 +172,10 @@ public class STUN extends SimpleIQ {
* Get a new STUN Server Address and port from the server.
* If a error occurs or the server don't support STUN Service, null is returned.
*
- * @param connection TODO javadoc me please
+ * @param connection
* @return the STUN server address
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@SuppressWarnings("deprecation")
public static STUN getSTUNServer(XMPPConnection connection) throws NotConnectedException, InterruptedException {
@@ -202,9 +202,9 @@ public class STUN extends SimpleIQ {
*
* @param connection the connection
* @return true if the server support STUN
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws XMPPException
+ * @throws InterruptedException
*/
public static boolean serviceAvailable(XMPPConnection connection) throws XMPPException, SmackException, InterruptedException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUNResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUNResolver.java
index dd68939c0..0ab8fa71b 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUNResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/STUNResolver.java
@@ -263,8 +263,8 @@ public class STUNResolver extends TransportResolver {
/**
* Resolve the IP and obtain a valid transport method.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
@Override
public synchronized void resolve(JingleSession session) throws XMPPException, NotConnectedException, InterruptedException {
@@ -288,7 +288,7 @@ public class STUNResolver extends TransportResolver {
/**
* Initialize the resolver.
*
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws XMPPException
*/
@Override
public void initialize() throws XMPPException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportCandidate.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportCandidate.java
index 103286862..d1d2a63ad 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportCandidate.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportCandidate.java
@@ -117,7 +117,7 @@ public abstract class TransportCandidate {
/**
* Set local IP to bind to this candidate.
*
- * @param localIp TODO javadoc me please
+ * @param localIp
*/
public void setLocalIp(String localIp) {
this.localIp = localIp;
@@ -135,7 +135,7 @@ public abstract class TransportCandidate {
/**
* Set the symmetric candidate for this candidate.
*
- * @param symmetric TODO javadoc me please
+ * @param symmetric
*/
public void setSymmetric(TransportCandidate symmetric) {
this.symmetric = symmetric;
@@ -171,7 +171,7 @@ public abstract class TransportCandidate {
/**
* Set the XMPPConnection use to send or receive this candidate.
*
- * @param connection TODO javadoc me please
+ * @param connection
*/
public void setConnection(XMPPConnection connection) {
this.connection = connection;
@@ -189,7 +189,7 @@ public abstract class TransportCandidate {
/**
* Set the jingle's sessionId that is using this candidate.
*
- * @param sessionId TODO javadoc me please
+ * @param sessionId
*/
public void setSessionId(String sessionId) {
this.sessionId = sessionId;
@@ -349,8 +349,6 @@ public abstract class TransportCandidate {
* usable.
*
* Subclasses should provide better methods if they can...
- *
- * @param localCandidates a list of local candidates.
*/
@SuppressWarnings("UnusedVariable")
public void check(final List localCandidates) {
@@ -476,9 +474,6 @@ public abstract class TransportCandidate {
/**
* Returns the Protocol constant associated with the String value.
- *
- * @param value the input String.
- * @return the protocol.
*/
public static Protocol fromString(String value) {
if (value == null) {
@@ -568,9 +563,6 @@ public abstract class TransportCandidate {
/**
* Returns the MediaChannel constant associated with the String value.
- *
- * @param value the input String.
- * @return the channel.
*/
public static Channel fromString(String value) {
if (value == null) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportNegotiator.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportNegotiator.java
index cbba19505..8d63b4019 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportNegotiator.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportNegotiator.java
@@ -94,7 +94,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
*
* @param session The Jingle session
* @param transResolver The JingleTransportManager to use
- * @param parentNegotiator the parent ngeotiator.
*/
public TransportNegotiator(JingleSession session, TransportResolver transResolver, ContentNegotiator parentNegotiator) {
super(session);
@@ -109,7 +108,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
* Get a new instance of the right TransportNegotiator class with this
* candidate.
*
- * @param cand the transport candidate.
* @return A TransportNegotiator instance
*/
public abstract JingleTransport getJingleTransport(TransportCandidate cand);
@@ -118,8 +116,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
* Return true if the transport candidate is acceptable for the current
* negotiator.
*
- * @param tc the transport candidate.
- * @param localCandidates a list of local transport candidates.
* @return true if the transport candidate is acceptable
*/
public abstract boolean acceptableTransportCandidate(TransportCandidate tc, List localCandidates);
@@ -188,8 +184,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* Return a JingleTransport that best reflects this transport negotiator.
- *
- * @return the jingle transport.
*/
public JingleTransport getJingleTransport() {
return getJingleTransport(getBestRemoteCandidate());
@@ -537,9 +531,9 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* Send an offer for a transport candidate
*
- * @param cand TODO javadoc me please
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @param cand
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private synchronized void sendTransportCandidateOffer(TransportCandidate cand) throws NotConnectedException, InterruptedException {
if (!cand.isNull()) {
@@ -560,9 +554,9 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* Create a Jingle stanza where we announce our transport candidates.
*
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
private void sendTransportCandidatesOffer() throws XMPPException, SmackException, InterruptedException {
List notOffered = resolver.getCandidatesList();
@@ -609,9 +603,9 @@ public abstract class TransportNegotiator extends JingleNegotiator {
*
* @param iq the stanza received
* @return the new Jingle stanza to send.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
@Override
public final List dispatchIncomingPacket(IQ iq, String id) throws XMPPException, SmackException, InterruptedException {
@@ -681,9 +675,9 @@ public abstract class TransportNegotiator extends JingleNegotiator {
* offering a list of candidates.
*
* @return an IQ packet
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPException
+ * @throws SmackException
+ * @throws InterruptedException
*/
private Jingle receiveResult(IQ iq) throws XMPPException, SmackException, InterruptedException {
Jingle response = null;
@@ -695,10 +689,10 @@ public abstract class TransportNegotiator extends JingleNegotiator {
}
/**
- * @param jingle TODO javadoc me please
+ * @param jingle
* @return the iq
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
private IQ receiveSessionInitiateAction(Jingle jingle) throws XMPPException, SmackException, InterruptedException {
IQ response = null;
@@ -720,7 +714,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
}
/**
- * @param jingle TODO javadoc me please
+ * @param jingle
* @return the iq
*/
private IQ receiveTransportInfoAction(Jingle jingle) {
@@ -781,7 +775,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
}
/**
- * @param jingle TODO javadoc me please
+ * @param jingle
* @return the iq
*/
private static IQ receiveSessionAcceptAction(Jingle jingle) {
@@ -800,8 +794,8 @@ public abstract class TransportNegotiator extends JingleNegotiator {
*
* @param local TransportCandidate that has been agreed.
* @param remote TransportCandidate that has been agreed.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private void triggerTransportEstablished(TransportCandidate local, TransportCandidate remote) throws NotConnectedException, InterruptedException {
List listeners = getListenersList();
@@ -844,7 +838,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
*
* @param js The Jingle session this negotiation belongs to.
* @param res The transport resolver to use.
- * @param parentNegotiator the parent content negotiator.
*/
public RawUdp(JingleSession js, final TransportResolver res, ContentNegotiator parentNegotiator) {
super(js, res, parentNegotiator);
@@ -900,7 +893,6 @@ public abstract class TransportNegotiator extends JingleNegotiator {
*
* @param js The Jingle session this negotiation belongs to.
* @param res The transport manager to use.
- * @param parentNegotiator the parent content negotiator.
*/
public Ice(JingleSession js, final TransportResolver res, ContentNegotiator parentNegotiator) {
super(js, res, parentNegotiator);
@@ -909,7 +901,7 @@ public abstract class TransportNegotiator extends JingleNegotiator {
/**
* Get a TransportNegotiator instance.
*
- * @param candidate TODO javadoc me please
+ * @param candidate
*/
@Override
public org.jivesoftware.smackx.jingleold.packet.JingleTransport getJingleTransport(TransportCandidate candidate) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolver.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolver.java
index 75c1e2f71..9c3eccd5a 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolver.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolver.java
@@ -90,27 +90,20 @@ public abstract class TransportResolver {
/**
* Initialize the Resolver.
- *
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public abstract void initialize() throws XMPPException, SmackException, InterruptedException;
/**
* Start a the resolution.
- *
- * @param session the Jingle session.
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public abstract void resolve(JingleSession session) throws XMPPException, SmackException, InterruptedException;
/**
* Clear the list of candidates and start a new resolution process.
*
- * @throws XMPPException if an XMPP protocol error was received.
+ * @throws XMPPException
*/
public void clear() throws XMPPException {
cancel();
@@ -119,8 +112,6 @@ public abstract class TransportResolver {
/**
* Cancel any asynchronous resolution operation.
- *
- * @throws XMPPException if an XMPP protocol error was received.
*/
public abstract void cancel() throws XMPPException;
@@ -220,8 +211,8 @@ public abstract class TransportResolver {
* Trigger a new candidate added event.
*
* @param cand The candidate added to the list of candidates.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
protected void triggerCandidateAdded(TransportCandidate cand) throws NotConnectedException, InterruptedException {
Iterator iter = getListenersList().iterator();
@@ -278,8 +269,8 @@ public abstract class TransportResolver {
* Add a new transport candidate
*
* @param cand The candidate to add
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
protected void addCandidate(TransportCandidate cand) throws NotConnectedException, InterruptedException {
synchronized (candidates) {
@@ -356,7 +347,6 @@ public abstract class TransportResolver {
/**
* Get the n-th candidate.
*
- * @param i the index of the candidate.
* @return a transport candidate
*/
public TransportCandidate getCandidate(int i) {
@@ -370,10 +360,8 @@ public abstract class TransportResolver {
/**
* Initialize Transport Resolver and wait until it is completely uninitialized.
- *
- * @throws XMPPException if an XMPP protocol error was received.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public void initializeAndWait() throws XMPPException, SmackException, InterruptedException {
this.initialize();
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolverListener.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolverListener.java
index e7bbda378..4f4bb3d0e 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolverListener.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/nat/TransportResolverListener.java
@@ -35,8 +35,8 @@ public interface TransportResolverListener {
* A transport candidate has been added.
*
* @param cand The transport candidate.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
void candidateAdded(TransportCandidate cand) throws NotConnectedException, InterruptedException;
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/Jingle.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/Jingle.java
index cfb08d374..7712a3474 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/Jingle.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/Jingle.java
@@ -66,10 +66,6 @@ public class Jingle extends IQ {
/**
* A constructor where the main components can be initialized.
- *
- * @param contents the contents.
- * @param mi the jingle content info
- * @param sid the sid.
*/
public Jingle(final List contents, final JingleContentInfo mi,
final String sid) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContent.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContent.java
index 8fdafde6b..6506b9de8 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContent.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContent.java
@@ -41,10 +41,7 @@ public class JingleContent implements ExtensionElement {
private final List transports = new ArrayList<>();
/**
- * Creates a content description.
- *
- * @param creator the creator.
- * @param name the name.
+ * Creates a content description..
*/
public JingleContent(String creator, String name) {
super();
@@ -84,7 +81,7 @@ public class JingleContent implements ExtensionElement {
/**
* Sets the description for this Jingle content.
*
- * @param description TODO javadoc me please
+ * @param description
* The description
*/
public void setDescription(JingleDescription description) {
@@ -103,7 +100,7 @@ public class JingleContent implements ExtensionElement {
/**
* Adds a JingleTransport type to the packet.
*
- * @param transport TODO javadoc me please
+ * @param transport
* the JingleTransport to add.
*/
public void addJingleTransport(final JingleTransport transport) {
@@ -115,7 +112,7 @@ public class JingleContent implements ExtensionElement {
/**
* Adds a list of transports to add to the packet.
*
- * @param transports TODO javadoc me please
+ * @param transports
* the transports to add.
*/
public void addTransports(final List transports) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContentDescription.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContentDescription.java
index 3df98e574..01cbcb8ea 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContentDescription.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleContentDescription.java
@@ -181,8 +181,6 @@ public abstract class JingleContentDescription implements ExtensionElement {
/**
* Utility constructor, with a JinglePayloadType.
- *
- * @param pt the payload type.
*/
public Audio(final JinglePayloadType pt) {
super();
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleDescription.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleDescription.java
index 4e143f266..57e9450a1 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleDescription.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleDescription.java
@@ -188,8 +188,6 @@ public abstract class JingleDescription implements ExtensionElement {
/**
* Utility constructor, with a PayloadType.
- *
- * @param pt the payload type.
*/
public Audio(final PayloadType pt) {
super();
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleError.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleError.java
index 301a72596..e261588d9 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleError.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleError.java
@@ -89,9 +89,6 @@ public class JingleError implements ExtensionElement {
/**
* Returns a Action instance associated with the String value.
- *
- * @param value the input string.
- * @return the jingle error.
*/
public static JingleError fromString(String value) {
if (value != null) {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleTransport.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleTransport.java
index 40553ea27..07cafdd3b 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleTransport.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/packet/JingleTransport.java
@@ -314,8 +314,6 @@ public class JingleTransport implements ExtensionElement {
/**
* Constructor with a transport candidate.
- *
- * @param tc the transport candidate.
*/
public Candidate(final TransportCandidate tc) {
super(tc);
@@ -405,8 +403,6 @@ public class JingleTransport implements ExtensionElement {
/**
* Constructor with a transport candidate.
- *
- * @param tc the transport candidate.
*/
public Candidate(final TransportCandidate tc) {
super(tc);
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleContentDescriptionProvider.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleContentDescriptionProvider.java
index 5d2f90bc3..de8553a32 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleContentDescriptionProvider.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleContentDescriptionProvider.java
@@ -65,8 +65,8 @@ public abstract class JingleContentDescriptionProvider extends ExtensionElementP
*
* @param parser the input to parse
* @return a description element
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public JingleContentDescription parse(XmlPullParser parser,
@@ -98,8 +98,6 @@ public abstract class JingleContentDescriptionProvider extends ExtensionElementP
/**
* Return a new instance of this class. Subclasses must overwrite this
* method.
- *
- * @return the jingle content description.
*/
protected abstract JingleContentDescription getInstance();
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleDescriptionProvider.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleDescriptionProvider.java
index 124258680..70aea87f2 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleDescriptionProvider.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleDescriptionProvider.java
@@ -36,7 +36,7 @@ public abstract class JingleDescriptionProvider extends ExtensionElementProvider
/**
* Parse a iq/jingle/description/payload-type element.
*
- * @param parser TODO javadoc me please
+ * @param parser
* the input to parse
* @return a payload type element
*/
@@ -63,11 +63,11 @@ public abstract class JingleDescriptionProvider extends ExtensionElementProvider
/**
* Parse a iq/jingle/description element.
*
- * @param parser TODO javadoc me please
+ * @param parser
* the input to parse
* @return a description element
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public JingleDescription parse(XmlPullParser parser, int initialDepth, XmlEnvironment xmlEnvironment) throws XmlPullParserException, IOException {
@@ -97,8 +97,6 @@ public abstract class JingleDescriptionProvider extends ExtensionElementProvider
/**
* Return a new instance of this class. Subclasses must overwrite this
* method.
- *
- * @return the jingle description.
*/
protected abstract JingleDescription getInstance();
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleProvider.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleProvider.java
index e78457342..499dde5b6 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleProvider.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleProvider.java
@@ -45,9 +45,9 @@ public class JingleProvider extends IQProvider {
/**
* Parse a iq/jingle element.
- * @throws XmlPullParserException if an error in the XML parser occured.
- * @throws IOException if an I/O error occured.
- * @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
+ * @throws XmlPullParserException
+ * @throws IOException
+ * @throws SmackParsingException
*/
@Override
public Jingle parse(XmlPullParser parser, int intialDepth, XmlEnvironment xmlEnvironment) throws IOException, XmlPullParserException, SmackParsingException {
diff --git a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleTransportProvider.java b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleTransportProvider.java
index 87d39360b..ee3d78e48 100644
--- a/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleTransportProvider.java
+++ b/smack-jingle-old/src/main/java/org/jivesoftware/smackx/jingleold/provider/JingleTransportProvider.java
@@ -49,8 +49,8 @@ public abstract class JingleTransportProvider extends ExtensionElementProviderChatNote associated with a given chat session.
* @throws XMPPErrorException if an error occurs while retrieving the ChatNote.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ChatNotes getNote(String sessionID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
ChatNotes request = new ChatNotes();
@@ -890,8 +890,8 @@ public class AgentSession {
* @param startDate point in time from which on history should get retrieved.
* @return the chat history associated with a given jid.
* @throws XMPPException if an error occurs while retrieving the AgentChatHistory.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public AgentChatHistory getAgentHistory(EntityBareJid jid, int maxSessions, Date startDate) throws XMPPException, NotConnectedException, InterruptedException {
AgentChatHistory request;
@@ -915,10 +915,10 @@ public class AgentSession {
* Asks the workgroup for it's Search Settings.
*
* @return SearchSettings the search settings for this workgroup.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public SearchSettings getSearchSettings() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
SearchSettings request = new SearchSettings();
@@ -935,9 +935,9 @@ public class AgentSession {
* @param global true to retrieve global macros, otherwise false for personal macros.
* @return MacroGroup the root macro group.
* @throws XMPPErrorException if an error occurs while getting information from the server.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public MacroGroup getMacros(boolean global) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Macros request = new Macros();
@@ -953,10 +953,10 @@ public class AgentSession {
* Persists the Personal Macro for an agent.
*
* @param group the macro group to save.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void saveMacros(MacroGroup group) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Macros request = new Macros();
@@ -974,8 +974,8 @@ public class AgentSession {
* @param sessionID the sessionID to query for.
* @return Map a map of all metadata associated with the sessionID.
* @throws XMPPException if an error occurs while getting information from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Map> getChatMetadata(String sessionID) throws XMPPException, NotConnectedException, InterruptedException {
ChatMetadata request = new ChatMetadata();
@@ -1013,9 +1013,9 @@ public class AgentSession {
* @param reason the reason of the invitation.
* @throws XMPPErrorException if the sender of the invitation is not an agent or the service failed to process
* the request.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendRoomInvitation(RoomInvitation.Type type, Jid invitee, String sessionID, String reason) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
final RoomInvitation invitation = new RoomInvitation(type, invitee, sessionID, reason);
@@ -1050,9 +1050,9 @@ public class AgentSession {
* @param reason the reason of the invitation.
* @throws XMPPErrorException if the sender of the invitation is not an agent or the service failed to process
* the request.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendRoomTransfer(RoomTransfer.Type type, String invitee, String sessionID, String reason) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
final RoomTransfer transfer = new RoomTransfer(type, invitee, sessionID, reason);
@@ -1071,9 +1071,9 @@ public class AgentSession {
* @param query an optional query object used to tell the server what metadata to retrieve. This can be null.
* @return the settings for the workgroup.
* @throws XMPPErrorException if an error occurs while sending the request to the server.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public GenericSettings getGenericSettings(XMPPConnection con, String query) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
GenericSettings setting = new GenericSettings();
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/Offer.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/Offer.java
index ece31d9c6..0c3d26f2d 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/Offer.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/Offer.java
@@ -81,8 +81,8 @@ public class Offer {
/**
* Accepts the offer.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void accept() throws NotConnectedException, InterruptedException {
Stanza acceptPacket = new AcceptPacket(this.session.getWorkgroupJID());
@@ -93,8 +93,8 @@ public class Offer {
/**
* Rejects the offer.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void reject() throws NotConnectedException, InterruptedException {
RejectPacket rejectPacket = new RejectPacket(this.session.getWorkgroupJID());
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptManager.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptManager.java
index e9b59af28..19bcd0d66 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptManager.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptManager.java
@@ -48,10 +48,10 @@ public class TranscriptManager {
* @param sessionID the id of the session to get the full transcript.
* @param workgroupJID the JID of the workgroup that will process the request.
* @return the full conversation transcript of a given session.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Transcript getTranscript(EntityBareJid workgroupJID, String sessionID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Transcript request = new Transcript(sessionID);
@@ -67,10 +67,10 @@ public class TranscriptManager {
* @param userID the id of the user to get his conversations.
* @param workgroupJID the JID of the workgroup that will process the request.
* @return the transcripts of a given user.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Transcripts getTranscripts(EntityBareJid workgroupJID, Jid userID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Transcripts request = new Transcripts(userID);
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptSearchManager.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptSearchManager.java
index dd429c67c..df8392b4f 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptSearchManager.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/agent/TranscriptSearchManager.java
@@ -50,10 +50,10 @@ public class TranscriptSearchManager {
*
* @param serviceJID the address of the workgroup service.
* @return the Form to use for searching transcripts.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getSearchForm(DomainBareJid serviceJID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
TranscriptSearch search = new TranscriptSearch();
@@ -73,10 +73,10 @@ public class TranscriptSearchManager {
* @param serviceJID the address of the workgroup service.
* @param completedForm the filled out search form.
* @return the result of the transcript search.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public ReportedData submitSearch(DomainBareJid serviceJID, Form completedForm) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
TranscriptSearch search = new TranscriptSearch();
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/MetaDataProvider.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/MetaDataProvider.java
index 297ce40d9..924c41a0d 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/MetaDataProvider.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/MetaDataProvider.java
@@ -38,8 +38,8 @@ public class MetaDataProvider extends ExtensionElementProvider {
/**
* PacketExtensionProvider implementation.
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public MetaData parse(XmlPullParser parser, int initialDepth, XmlEnvironment xmlEnvironment) throws XmlPullParserException, IOException {
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/WorkgroupInformation.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/WorkgroupInformation.java
index 9880f5eac..4fe2fe750 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/WorkgroupInformation.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/packet/WorkgroupInformation.java
@@ -79,8 +79,8 @@ public class WorkgroupInformation implements ExtensionElement {
/**
* PacketExtensionProvider implementation.
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public WorkgroupInformation parse(XmlPullParser parser,
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/user/Workgroup.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/user/Workgroup.java
index 99907adc6..e4143370d 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/user/Workgroup.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/workgroup/user/Workgroup.java
@@ -182,10 +182,10 @@ public class Workgroup {
* available only when agents are available for this workgroup.
*
* @return true if the workgroup is available for receiving new requests.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public boolean isAvailable() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
Presence directedPresence = new Presence(Presence.Type.available);
@@ -260,8 +260,8 @@ public class Workgroup {
* @throws XMPPException if an error occurred joining the queue. An error may indicate
* that a connection failure occurred or that the server explicitly rejected the
* request to join the queue.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public void joinQueue() throws XMPPException, SmackException, InterruptedException {
joinQueue(null);
@@ -299,8 +299,8 @@ public class Workgroup {
* @throws XMPPException if an error occurred joining the queue. An error may indicate
* that a connection failure occurred or that the server explicitly rejected the
* request to join the queue.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public void joinQueue(Form answerForm) throws XMPPException, SmackException, InterruptedException {
joinQueue(answerForm, null);
@@ -338,9 +338,9 @@ public class Workgroup {
* @throws XMPPErrorException if an error occurred joining the queue. An error may indicate
* that a connection failure occurred or that the server explicitly rejected the
* request to join the queue.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void joinQueue(Form answerForm, Jid userID) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// If already in the queue ignore the join request.
@@ -387,8 +387,8 @@ public class Workgroup {
* @throws XMPPException if an error occurred joining the queue. An error may indicate
* that a connection failure occurred or that the server explicitly rejected the
* request to join the queue.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public void joinQueue(Map metadata, Jid userID) throws XMPPException, SmackException, InterruptedException {
// If already in the queue ignore the join request.
@@ -421,9 +421,9 @@ public class Workgroup {
*
* @throws XMPPErrorException if an error occurred trying to send the depart queue
* request to the server.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void departQueue() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
// If not in the queue ignore the depart request.
@@ -599,8 +599,8 @@ public class Workgroup {
* @param key the key to find.
* @return the ChatSetting if found, otherwise false.
* @throws XMPPException if an error occurs while getting information from the server.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public ChatSetting getChatSetting(String key) throws XMPPException, SmackException, InterruptedException {
ChatSettings chatSettings = getChatSettings(key, -1);
@@ -613,8 +613,8 @@ public class Workgroup {
* @param type the type of ChatSettings to return.
* @return the ChatSettings of given type, otherwise null.
* @throws XMPPException if an error occurs while getting information from the server.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public ChatSettings getChatSettings(int type) throws XMPPException, SmackException, InterruptedException {
return getChatSettings(null, type);
@@ -625,8 +625,8 @@ public class Workgroup {
*
* @return all ChatSettings of a given workgroup.
* @throws XMPPException if an error occurs while getting information from the server.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public ChatSettings getChatSettings() throws XMPPException, SmackException, InterruptedException {
return getChatSettings(null, -1);
@@ -637,10 +637,10 @@ public class Workgroup {
* Asks the workgroup for it's Chat Settings.
*
* @return key specify a key to retrieve only that settings. Otherwise for all settings, key should be null.
- * @throws NoResponseException if there was no response from the remote entity.
+ * @throws NoResponseException
* @throws XMPPErrorException if an error occurs while getting information from the server.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
private ChatSettings getChatSettings(String key, int type) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
ChatSettings request = new ChatSettings();
@@ -663,8 +663,8 @@ public class Workgroup {
* to see if the email service has been configured and is available.
*
* @return true if the email service is available, otherwise return false.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws InterruptedException
*/
public boolean isEmailAvailable() throws SmackException, InterruptedException {
ServiceDiscoveryManager discoManager = ServiceDiscoveryManager.getInstanceFor(connection);
@@ -683,10 +683,10 @@ public class Workgroup {
* Asks the workgroup for it's Offline Settings.
*
* @return offlineSettings the offline settings for this workgroup.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public OfflineSettings getOfflineSettings() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
OfflineSettings request = new OfflineSettings();
@@ -700,10 +700,10 @@ public class Workgroup {
* Asks the workgroup for it's Sound Settings.
*
* @return soundSettings the sound settings for the specified workgroup.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public SoundSettings getSoundSettings() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
SoundSettings request = new SoundSettings();
@@ -717,10 +717,10 @@ public class Workgroup {
* Asks the workgroup for it's Properties.
*
* @return the WorkgroupProperties for the specified workgroup.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public WorkgroupProperties getWorkgroupProperties() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
WorkgroupProperties request = new WorkgroupProperties();
@@ -735,10 +735,10 @@ public class Workgroup {
*
* @param jid the jid of the user who's information you would like the workgroup to retreive.
* @return the WorkgroupProperties for the specified workgroup.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public WorkgroupProperties getWorkgroupProperties(String jid) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
WorkgroupProperties request = new WorkgroupProperties();
@@ -757,10 +757,10 @@ public class Workgroup {
* for future submissions.
*
* @return the Form to use for searching transcripts.
- * @throws XMPPErrorException if there was an XMPP error returned.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws XMPPErrorException
+ * @throws NoResponseException
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public Form getWorkgroupForm() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
WorkgroupForm workgroupForm = new WorkgroupForm();
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventManager.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventManager.java
index a2ca8d17b..2dfc66a7a 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventManager.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventManager.java
@@ -209,8 +209,8 @@ public final class MessageEventManager extends Manager {
*
* @param to the recipient of the notification.
* @param packetID the id of the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendDeliveredNotification(Jid to, String packetID) throws NotConnectedException, InterruptedException {
// Create the message to send
@@ -229,8 +229,8 @@ public final class MessageEventManager extends Manager {
*
* @param to the recipient of the notification.
* @param packetID the id of the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendDisplayedNotification(Jid to, String packetID) throws NotConnectedException, InterruptedException {
// Create the message to send
@@ -249,8 +249,8 @@ public final class MessageEventManager extends Manager {
*
* @param to the recipient of the notification.
* @param packetID the id of the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendComposingNotification(Jid to, String packetID) throws NotConnectedException, InterruptedException {
// Create the message to send
@@ -269,8 +269,8 @@ public final class MessageEventManager extends Manager {
*
* @param to the recipient of the notification.
* @param packetID the id of the message to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void sendCancelledNotification(Jid to, String packetID) throws NotConnectedException, InterruptedException {
// Create the message to send
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventRequestListener.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventRequestListener.java
index 321ef280d..7bccc92f8 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventRequestListener.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/MessageEventRequestListener.java
@@ -49,8 +49,8 @@ public interface MessageEventRequestListener {
* @param from the user that sent the notification.
* @param packetID the id of the message that was sent.
* @param messageEventManager the messageEventManager that fired the listener.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
void deliveredNotificationRequested(Jid from, String packetID,
MessageEventManager messageEventManager) throws NotConnectedException, InterruptedException;
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/provider/MessageEventProvider.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/provider/MessageEventProvider.java
index da31a5f5f..a2af202a2 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/provider/MessageEventProvider.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/xevent/provider/MessageEventProvider.java
@@ -39,8 +39,8 @@ public class MessageEventProvider extends ExtensionElementProvider
*
* @param parser the XML parser, positioned at the starting element of the extension.
* @return a PacketExtension.
- * @throws IOException if an I/O error occured.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws IOException
+ * @throws XmlPullParserException
*/
@Override
public MessageEvent parse(XmlPullParser parser, int initialDepth, XmlEnvironment xmlEnvironment)
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/RosterExchangeManager.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/RosterExchangeManager.java
index 1f42c6f02..32be5be41 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/RosterExchangeManager.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/RosterExchangeManager.java
@@ -117,8 +117,8 @@ public class RosterExchangeManager {
*
* @param roster the roster to send
* @param targetUserID the user that will receive the roster entries
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void send(Roster roster, Jid targetUserID) throws NotConnectedException, InterruptedException {
// Create a new message to send the roster
@@ -137,8 +137,8 @@ public class RosterExchangeManager {
*
* @param rosterEntry the roster entry to send
* @param targetUserID the user that will receive the roster entries
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void send(RosterEntry rosterEntry, Jid targetUserID) throws NotConnectedException, InterruptedException {
// Create a new message to send the roster
@@ -159,8 +159,8 @@ public class RosterExchangeManager {
*
* @param rosterGroup the roster group to send
* @param targetUserID the user that will receive the roster entries
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
public void send(RosterGroup rosterGroup, Jid targetUserID) throws NotConnectedException, InterruptedException {
// Create a new message to send the roster
diff --git a/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/provider/RosterExchangeProvider.java b/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/provider/RosterExchangeProvider.java
index 3013b92a8..2baeb5697 100644
--- a/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/provider/RosterExchangeProvider.java
+++ b/smack-legacy/src/main/java/org/jivesoftware/smackx/xroster/provider/RosterExchangeProvider.java
@@ -44,8 +44,8 @@ public class RosterExchangeProvider extends ExtensionElementProvider getParameters() throws IOException {
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/CachingOmemoStore.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/CachingOmemoStore.java
index d2fd9966b..d83984e6c 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/CachingOmemoStore.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/CachingOmemoStore.java
@@ -37,15 +37,15 @@ import org.jxmpp.jid.BareJid;
*
* Alternatively this implementation can be used as an ephemeral keystore without a persisting backend.
*
- * @param the type of the id key pair.
- * @param the type of the id key.
- * @param the prekey type
- * @param the signed prekey type.
- * @param the session type.
- * @param the address type.
- * @param the EC pub type.
- * @param the bundle type.
- * @param the cipher type.
+ * @param
+ * @param
+ * @param
+ * @param
+ * @param
+ * @param
+ * @param
+ * @param
+ * @param
*/
public class CachingOmemoStore
extends OmemoStore {
@@ -437,7 +437,7 @@ public class CachingOmemoStore getCache(OmemoDevice device) {
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/FileBasedOmemoStore.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/FileBasedOmemoStore.java
index d8b1df42c..612e955ff 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/FileBasedOmemoStore.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/FileBasedOmemoStore.java
@@ -514,7 +514,7 @@ public abstract class FileBasedOmemoStore managers = INSTANCES.get(connection);
@@ -227,14 +227,14 @@ public final class OmemoManager extends Manager {
/**
* Initializes the OmemoManager. This method must be called before the manager can be used.
*
- * @throws CorruptedOmemoKeyException if the OMEMO key is corrupted.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws PubSubException.NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
- * @throws IOException if an I/O error occured.
+ * @throws CorruptedOmemoKeyException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
+ * @throws SmackException.NotConnectedException
+ * @throws XMPPException.XMPPErrorException
+ * @throws SmackException.NotLoggedInException
+ * @throws PubSubException.NotALeafNodeException
+ * @throws IOException
*/
public synchronized void initialize()
throws SmackException.NotLoggedInException, CorruptedOmemoKeyException, InterruptedException,
@@ -278,7 +278,7 @@ public final class OmemoManager extends Manager {
* @see #requestDeviceListUpdateFor(BareJid)
* @param contact contact we want to get a set of device of.
* @return set of known devices of that contact.
- * @throws IOException if an I/O error occured.
+ * @throws IOException
*/
public Set getDevicesOf(BareJid contact) throws IOException {
OmemoCachedDeviceList list = getOmemoService().getOmemoStoreBackend().loadCachedDeviceList(getOwnDevice(), contact);
@@ -300,11 +300,11 @@ public final class OmemoManager extends Manager {
* @return encrypted message
* @throws CryptoFailedException when something crypto related fails
* @throws UndecidedOmemoIdentityException When there are undecided devices
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException.NotConnectedException
+ * @throws SmackException.NoResponseException
+ * @throws SmackException.NotLoggedInException
+ * @throws IOException
*/
public OmemoMessage.Sent encrypt(BareJid recipient, String message)
throws CryptoFailedException, UndecidedOmemoIdentityException,
@@ -323,11 +323,11 @@ public final class OmemoManager extends Manager {
* @return encrypted message.
* @throws CryptoFailedException When something crypto related fails
* @throws UndecidedOmemoIdentityException When there are undecided devices.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws SmackException.NotConnectedException
+ * @throws SmackException.NoResponseException
+ * @throws SmackException.NotLoggedInException
+ * @throws IOException
*/
public synchronized OmemoMessage.Sent encrypt(Set recipients, String message)
throws CryptoFailedException, UndecidedOmemoIdentityException,
@@ -348,14 +348,14 @@ public final class OmemoManager extends Manager {
* @param message message to send
* @return encrypted message
* @throws UndecidedOmemoIdentityException when there are undecided devices.
- * @throws CryptoFailedException if the OMEMO cryptography failed.
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
+ * @throws CryptoFailedException
+ * @throws XMPPException.XMPPErrorException
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
* @throws NoOmemoSupportException When the muc doesn't support OMEMO.
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws IOException if an I/O error occured.
+ * @throws SmackException.NotLoggedInException
+ * @throws IOException
*/
public synchronized OmemoMessage.Sent encrypt(MultiUserChat muc, String message)
throws UndecidedOmemoIdentityException, CryptoFailedException,
@@ -387,7 +387,7 @@ public final class OmemoManager extends Manager {
* @throws CorruptedOmemoKeyException if our or their key is corrupted
* @throws NoRawSessionException if the message was not a preKeyMessage, but we had no session with the contact
* @throws CryptoFailedException if decryption fails
- * @throws IOException if an I/O error occured.
+ * @throws IOException
*/
public OmemoMessage.Received decrypt(BareJid sender, OmemoElement omemoElement)
throws SmackException.NotLoggedInException, CorruptedOmemoKeyException, NoRawSessionException,
@@ -402,7 +402,7 @@ public final class OmemoManager extends Manager {
* @param mamQuery The MAM query
* @return list of decrypted OmemoMessages
* @throws SmackException.NotLoggedInException if the Manager is not authenticated.
- * @throws IOException if an I/O error occured.
+ * @throws IOException
*/
public List decryptMamQueryResult(MamManager.MamQuery mamQuery)
throws SmackException.NotLoggedInException, IOException {
@@ -446,7 +446,7 @@ public final class OmemoManager extends Manager {
* be of length 64.
* @param device device
* @param fingerprint fingerprint
- * @return true if this is a trusted OMEMO identity.
+ * @return
*/
public boolean isTrustedOmemoIdentity(OmemoDevice device, OmemoFingerprint fingerprint) {
if (trustCallback == null) {
@@ -462,7 +462,7 @@ public final class OmemoManager extends Manager {
* be of length 64.
* @param device device
* @param fingerprint fingerprint
- * @return true if the trust is decided for the identity.
+ * @return
*/
public boolean isDecidedOmemoIdentity(OmemoDevice device, OmemoFingerprint fingerprint) {
if (trustCallback == null) {
@@ -480,12 +480,12 @@ public final class OmemoManager extends Manager {
* @throws CorruptedOmemoKeyException When the used identityKeys are corrupted
* @throws CryptoFailedException When something fails with the crypto
* @throws CannotEstablishOmemoSessionException When we can't establish a session with the recipient
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws NoSuchAlgorithmException if no such algorithm is available.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws IOException if an I/O error occured.
+ * @throws SmackException.NotLoggedInException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
+ * @throws NoSuchAlgorithmException
+ * @throws SmackException.NotConnectedException
+ * @throws IOException
*/
public synchronized void sendRatchetUpdateMessage(OmemoDevice recipient)
throws SmackException.NotLoggedInException, CorruptedOmemoKeyException, InterruptedException,
@@ -508,12 +508,12 @@ public final class OmemoManager extends Manager {
*
* @param contact contact
* @return true if contact has at least one OMEMO capable device.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws PubSubException.NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws IOException if an I/O error occured.
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
+ * @throws PubSubException.NotALeafNodeException
+ * @throws XMPPException.XMPPErrorException
+ * @throws IOException
*/
public synchronized boolean contactSupportsOmemo(BareJid contact)
throws InterruptedException, PubSubException.NotALeafNodeException, XMPPException.XMPPErrorException,
@@ -547,10 +547,10 @@ public final class OmemoManager extends Manager {
* @param connection XMPPConnection
* @param server domainBareJid of the server to test
* @return true if server supports pep
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
+ * @throws XMPPException.XMPPErrorException
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
*/
public static boolean serverSupportsOmemo(XMPPConnection connection, DomainBareJid server)
throws XMPPException.XMPPErrorException, SmackException.NotConnectedException, InterruptedException,
@@ -562,10 +562,10 @@ public final class OmemoManager extends Manager {
/**
* Return the fingerprint of our identity key.
*
- * @return fingerprint TODO javadoc me please
+ * @return fingerprint
* @throws SmackException.NotLoggedInException if we don't know our bareJid yet.
* @throws CorruptedOmemoKeyException if our identityKey is corrupted.
- * @throws IOException if an I/O error occured.
+ * @throws IOException
*/
public synchronized OmemoFingerprint getOwnFingerprint()
throws SmackException.NotLoggedInException, CorruptedOmemoKeyException, IOException {
@@ -579,14 +579,14 @@ public final class OmemoManager extends Manager {
/**
* Get the fingerprint of a contacts device.
* @param device contacts OmemoDevice
- * @return fingerprint TODO javadoc me please
+ * @return fingerprint
* @throws CannotEstablishOmemoSessionException if we have no session yet, and are unable to create one.
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
+ * @throws SmackException.NotLoggedInException
* @throws CorruptedOmemoKeyException if the copy of the fingerprint we have is corrupted.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws IOException if an I/O error occured.
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
+ * @throws IOException
*/
public synchronized OmemoFingerprint getFingerprint(OmemoDevice device)
throws CannotEstablishOmemoSessionException, SmackException.NotLoggedInException,
@@ -610,13 +610,13 @@ public final class OmemoManager extends Manager {
* @param contact contact
* @return Map of all active devices of the contact and their fingerprints.
*
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws CorruptedOmemoKeyException if the OMEMO key is corrupted.
- * @throws CannotEstablishOmemoSessionException if no OMEMO session could be established.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws IOException if an I/O error occured.
+ * @throws SmackException.NotLoggedInException
+ * @throws CorruptedOmemoKeyException
+ * @throws CannotEstablishOmemoSessionException
+ * @throws SmackException.NotConnectedException
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
+ * @throws IOException
*/
public synchronized HashMap getActiveFingerprints(BareJid contact)
throws SmackException.NotLoggedInException, CorruptedOmemoKeyException,
@@ -681,12 +681,12 @@ public final class OmemoManager extends Manager {
* Request a deviceList update from contact contact.
*
* @param contact contact we want to obtain the deviceList from.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws PubSubException.NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws IOException if an I/O error occured.
+ * @throws InterruptedException
+ * @throws PubSubException.NotALeafNodeException
+ * @throws XMPPException.XMPPErrorException
+ * @throws SmackException.NotConnectedException
+ * @throws SmackException.NoResponseException
+ * @throws IOException
*/
public synchronized void requestDeviceListUpdateFor(BareJid contact)
throws InterruptedException, PubSubException.NotALeafNodeException, XMPPException.XMPPErrorException,
@@ -697,13 +697,13 @@ public final class OmemoManager extends Manager {
/**
* Publish a new device list with just our own deviceId in it.
*
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
- * @throws IOException if an I/O error occured.
- * @throws PubSubException.NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @throws SmackException.NotLoggedInException
+ * @throws InterruptedException
+ * @throws XMPPException.XMPPErrorException
+ * @throws SmackException.NotConnectedException
+ * @throws SmackException.NoResponseException
+ * @throws IOException
+ * @throws PubSubException.NotALeafNodeException
*/
public void purgeDeviceList()
throws SmackException.NotLoggedInException, InterruptedException, XMPPException.XMPPErrorException,
@@ -721,9 +721,9 @@ public final class OmemoManager extends Manager {
* @throws XMPPException.XMPPErrorException XMPP error
* @throws SmackException.NotConnectedException XMPP error
* @throws SmackException.NoResponseException XMPP error
- * @throws SmackException.NotLoggedInException if the XMPP connection is not authenticated.
- * @throws IOException if an I/O error occured.
- * @throws PubSubException.NotALeafNodeException if a PubSub leaf node operation was attempted on a non-leaf node.
+ * @throws SmackException.NotLoggedInException
+ * @throws IOException
+ * @throws PubSubException.NotALeafNodeException
*/
public synchronized void rotateSignedPreKey()
throws CorruptedOmemoKeyException, SmackException.NotLoggedInException, XMPPException.XMPPErrorException,
@@ -761,7 +761,7 @@ public final class OmemoManager extends Manager {
/**
* Returns a pseudo random number from the interval [1, Integer.MAX_VALUE].
- * @return deviceId TODO javadoc me please
+ * @return deviceId
*/
public static int randomDeviceId() {
return new Random().nextInt(Integer.MAX_VALUE - 1) + 1;
@@ -770,7 +770,7 @@ public final class OmemoManager extends Manager {
/**
* Return the BareJid of the user.
*
- * @return bareJid TODO javadoc me please
+ * @return bareJid
*/
public BareJid getOwnJid() {
if (ownJid == null && connection().isAuthenticated()) {
@@ -783,7 +783,7 @@ public final class OmemoManager extends Manager {
/**
* Return the deviceId of this OmemoManager.
*
- * @return deviceId TODO javadoc me please
+ * @return deviceId
*/
public synchronized Integer getDeviceId() {
return deviceId;
@@ -792,7 +792,7 @@ public final class OmemoManager extends Manager {
/**
* Return the OmemoDevice of the user.
*
- * @return omemoDevice TODO javadoc me please
+ * @return omemoDevice
*/
public synchronized OmemoDevice getOwnDevice() {
BareJid jid = getOwnJid();
@@ -895,10 +895,10 @@ public final class OmemoManager extends Manager {
*
* @param contactsDevice OmemoDevice of a contact.
*
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws SmackException.NoResponseException if there was no response from the remote entity.
+ * @throws InterruptedException
+ * @throws SmackException.NoResponseException
* @throws CorruptedOmemoKeyException if our or their identityKey is corrupted.
- * @throws SmackException.NotConnectedException if the XMPP connection is not connected.
+ * @throws SmackException.NotConnectedException
* @throws CannotEstablishOmemoSessionException if no new session can be established.
* @throws SmackException.NotLoggedInException if the connection is not authenticated.
*/
@@ -924,7 +924,7 @@ public final class OmemoManager extends Manager {
/**
* Return the OMEMO service object.
*
- * @return omemoService TODO javadoc me please
+ * @return omemoService
*/
OmemoService getOmemoService() {
throwIfNoServiceSet();
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoMessage.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoMessage.java
index 0bfa1847e..56a703f82 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoMessage.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoMessage.java
@@ -48,7 +48,7 @@ public class OmemoMessage {
/**
* Return the original OmemoElement (<encrypted/>).
*
- * @return omemoElement TODO javadoc me please
+ * @return omemoElement
*/
public OmemoElement getElement() {
return element;
@@ -57,7 +57,7 @@ public class OmemoMessage {
/**
* Return the messageKey (or transported key in case of a KeyTransportMessage).
*
- * @return key TODO javadoc me please
+ * @return key
*/
public byte[] getKey() {
return messageKey.clone();
@@ -124,7 +124,7 @@ public class OmemoMessage {
* and an EME hint about OMEMO encryption.
*
* @param recipient recipient for the to-field of the message.
- * @return Message TODO javadoc me please
+ * @return Message
*/
public Message asMessage(Jid recipient) {
@@ -187,7 +187,7 @@ public class OmemoMessage {
/**
* Return the OmemoDevice which sent the message.
- * @return senderDevice TODO javadoc me please
+ * @return senderDevice
*/
public OmemoDevice getSenderDevice() {
return senderDevice;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoRatchet.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoRatchet.java
index 988c2b197..7ad0f6b6e 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoRatchet.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/OmemoRatchet.java
@@ -62,11 +62,11 @@ public abstract class OmemoRatchet contactsDevices,
@@ -441,7 +441,7 @@ public abstract class OmemoService contactsDevices,
@@ -514,12 +514,12 @@ public abstract class OmemoService contactsDevices,
@@ -546,12 +546,12 @@ public abstract class OmemoService buildMissingSessionsWithDevices(XMPPConnection connection,
OmemoDevice userDevice,
@@ -841,7 +841,7 @@ public abstract class OmemoService getUndecidedDevices(OmemoDevice userDevice, OmemoTrustCallback callback, Set devices) throws IOException {
Set undecidedDevices = new HashSet<>();
@@ -872,7 +872,7 @@ public abstract class OmemoService decryptMamQueryResult(OmemoManager.LoggedInOmemoManager managerGuard,
MamManager.MamQuery mamQuery) throws IOException {
@@ -1220,7 +1220,7 @@ public abstract class OmemoService preKeyHashMap) throws IOException {
for (Map.Entry entry : preKeyHashMap.entrySet()) {
@@ -444,7 +444,7 @@ public abstract class OmemoStore loadOmemoPreKeys(OmemoDevice userDevice) throws IOException;
@@ -453,8 +453,8 @@ public abstract class OmemoStore loadOmemoSignedPreKeys(OmemoDevice userDevice) throws IOException;
@@ -476,7 +476,7 @@ public abstract class OmemoStore loadAllRawSessionsOf(OmemoDevice userDevice, BareJid contact) throws IOException;
@@ -528,7 +528,7 @@ public abstract class OmemoStore getPreKeys() {
if (preKeys == null) {
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/element/OmemoElement.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/element/OmemoElement.java
index 877436214..d84852a72 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/element/OmemoElement.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/element/OmemoElement.java
@@ -55,7 +55,7 @@ public abstract class OmemoElement implements ExtensionElement {
/**
* Return the payload of the message.
*
- * @return payload TODO javadoc me please
+ * @return payload
*/
public byte[] getPayload() {
if (payload == null) {
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/CannotEstablishOmemoSessionException.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/CannotEstablishOmemoSessionException.java
index e20782632..d8b25bbab 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/CannotEstablishOmemoSessionException.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/CannotEstablishOmemoSessionException.java
@@ -79,7 +79,7 @@ public class CannotEstablishOmemoSessionException extends Exception {
/**
* Return true, if there is at least one recipient, which would not be able to decipher the message on any of
* their devices.
- * @return boolean TODO javadoc me please
+ * @return boolean
*/
public boolean requiresThrowing() {
for (Map.Entry> entry : failures.entrySet()) {
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/ReadOnlyDeviceException.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/ReadOnlyDeviceException.java
index ce69d1a30..6a0832f95 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/ReadOnlyDeviceException.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/ReadOnlyDeviceException.java
@@ -44,7 +44,7 @@ public class ReadOnlyDeviceException extends Exception {
/**
* Return the device in question.
- * @return device TODO javadoc me please
+ * @return device
*/
public OmemoDevice getDevice() {
return device;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/StaleDeviceException.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/StaleDeviceException.java
index c3453b99e..be2c31e89 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/StaleDeviceException.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/StaleDeviceException.java
@@ -31,8 +31,8 @@ public class StaleDeviceException extends Exception {
* This exception gets thrown if a message cannot be encrypted for a device due to the device being inactive for too long (stale).
*
* @param device OmemoDevice.
- * @param lastMessageDate TODO javadoc me please
- * @param lastDeviceIdPublicationDate TODO javadoc me please
+ * @param lastMessageDate
+ * @param lastDeviceIdPublicationDate
*/
public StaleDeviceException(OmemoDevice device, Date lastMessageDate, Date lastDeviceIdPublicationDate) {
this.device = device;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/UntrustedOmemoIdentityException.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/UntrustedOmemoIdentityException.java
index 3e8b0b458..d594fe614 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/UntrustedOmemoIdentityException.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/exceptions/UntrustedOmemoIdentityException.java
@@ -65,8 +65,7 @@ public class UntrustedOmemoIdentityException extends Exception {
/**
* Return the fingerprint of the key we expected.
* This might return null in case this exception got thrown during encryption process.
- *
- * @return the trusted fingerprint.
+ * @return
*/
public OmemoFingerprint getTrustedFingerprint() {
return trustedKey;
@@ -74,8 +73,7 @@ public class UntrustedOmemoIdentityException extends Exception {
/**
* Return the fingerprint of the unexpected untrusted key.
- *
- * @return the OMEMO fingerprint.
+ * @return
*/
public OmemoFingerprint getUntrustedFingerprint() {
return untrustedKey;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/CiphertextTuple.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/CiphertextTuple.java
index 60fac8469..c94a5bc88 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/CiphertextTuple.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/CiphertextTuple.java
@@ -41,7 +41,7 @@ public class CiphertextTuple {
/**
* Return the ciphertext.
*
- * @return ciphertext TODO javadoc me please
+ * @return ciphertext
*/
public byte[] getCiphertext() {
return ciphertext;
@@ -50,7 +50,7 @@ public class CiphertextTuple {
/**
* Return the messageType.
*
- * @return messageType TODO javadoc me please
+ * @return messageType
*/
public int getMessageType() {
return this.messageType;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/OmemoDevice.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/OmemoDevice.java
index 762494281..05a07594a 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/OmemoDevice.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/internal/OmemoDevice.java
@@ -43,7 +43,7 @@ public class OmemoDevice {
/**
* Return the BareJid of the device owner.
*
- * @return bareJid TODO javadoc me please
+ * @return bareJid
*/
public BareJid getJid() {
return this.jid;
@@ -52,7 +52,7 @@ public class OmemoDevice {
/**
* Return the OMEMO device Id of the device.
*
- * @return deviceId TODO javadoc me please
+ * @return deviceId
*/
public int getDeviceId() {
return this.deviceId;
diff --git a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/util/OmemoKeyUtil.java b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/util/OmemoKeyUtil.java
index 1954246f1..8fa56f071 100644
--- a/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/util/OmemoKeyUtil.java
+++ b/smack-omemo/src/main/java/org/jivesoftware/smackx/omemo/util/OmemoKeyUtil.java
@@ -55,7 +55,7 @@ public abstract class OmemoKeyUtilOMEMO security audit.
*
* @param message plaintext message
- * @throws NoSuchPaddingException if the requested padding mechanism is not availble.
+ * @throws NoSuchPaddingException
* @throws NoSuchProviderException
- * @throws InvalidAlgorithmParameterException if the provided arguments are invalid.
- * @throws InvalidKeyException if the key is invalid.
- * @throws BadPaddingException if the input data is not padded properly.
- * @throws IllegalBlockSizeException if the input data length is incorrect.
+ * @throws InvalidAlgorithmParameterException
+ * @throws InvalidKeyException
+ * @throws BadPaddingException
+ * @throws IllegalBlockSizeException
*/
private void setMessage(String message)
throws NoSuchPaddingException, NoSuchAlgorithmException, InvalidAlgorithmParameterException,
@@ -220,7 +220,7 @@ public class OmemoMessageBuilder
- * @param username TODO javadoc me please
- * @param password TODO javadoc me please
- * @param serviceName TODO javadoc me please
- * @throws XmppStringprepException if the provided string is invalid.
+ * @param username
+ * @param password
+ * @param serviceName
+ * @throws XmppStringprepException
*/
public XMPPTCPConnection(CharSequence username, String password, String serviceName) throws XmppStringprepException {
this(XMPPTCPConnectionConfiguration.builder().setUsernameAndPassword(username, password).setXmppDomain(
@@ -629,8 +629,8 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
*
* @throws XMPPException if establishing a connection to the server fails.
* @throws SmackException if the server fails to respond back or if there is anther error.
- * @throws IOException if an I/O error occured.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws IOException
+ * @throws InterruptedException
*/
private void initConnection() throws IOException, InterruptedException {
compressionHandler = null;
@@ -673,14 +673,14 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
* The server has indicated that TLS negotiation can start. We now need to secure the
* existing plain connection and perform a handshake. This method won't return until the
* connection has finished the handshake or an error occurred while securing the connection.
- * @throws IOException if an I/O error occured.
+ * @throws IOException
* @throws CertificateException
- * @throws NoSuchAlgorithmException if no such algorithm is available.
+ * @throws NoSuchAlgorithmException
* @throws NoSuchProviderException
* @throws KeyStoreException
* @throws UnrecoverableKeyException
- * @throws KeyManagementException if there was a key mangement error.
- * @throws SmackException if Smack detected an exceptional situation.
+ * @throws KeyManagementException
+ * @throws SmackException
* @throws Exception if an exception occurs.
*/
@SuppressWarnings("LiteralClassName")
@@ -775,10 +775,10 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
* before authentication took place.
*
*
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws NoResponseException if there was no response from the remote entity.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws SmackException
+ * @throws NoResponseException
+ * @throws InterruptedException
*/
private void maybeEnableCompression() throws SmackException, InterruptedException {
if (!config.isCompressionEnabled()) {
@@ -808,9 +808,9 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
*
*
* @throws XMPPException if an error occurs while trying to establish the connection.
- * @throws SmackException if Smack detected an exceptional situation.
- * @throws IOException if an I/O error occured.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws SmackException
+ * @throws IOException
+ * @throws InterruptedException
*/
@Override
protected void connectInternal() throws SmackException, IOException, XMPPException, InterruptedException {
@@ -832,7 +832,7 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
/**
* For unit testing purposes
*
- * @param writer TODO javadoc me please
+ * @param writer
*/
protected void setWriter(Writer writer) {
this.writer = writer;
@@ -871,8 +871,8 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
* to be sent by the server.
*
* @throws SmackException if the parser could not be reset.
- * @throws InterruptedException if the calling thread was interrupted.
- * @throws XmlPullParserException if an error in the XML parser occured.
+ * @throws InterruptedException
+ * @throws XmlPullParserException
*/
void openStream() throws SmackException, InterruptedException, XmlPullParserException {
sendStreamOpen();
@@ -1237,8 +1237,8 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
* Sends the specified element to the server.
*
* @param element the element to send.
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws NotConnectedException
+ * @throws InterruptedException
*/
protected void sendStreamElement(Element element) throws NotConnectedException, InterruptedException {
throwNotConnectedExceptionIfDoneAndResumptionNotPossible();
@@ -1259,7 +1259,7 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
/**
* Shuts down the stanza writer. Once this method has been called, no further
* packets will be written to the server.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
void shutdown(boolean instant) {
instantShutdown = instant;
@@ -1570,7 +1570,7 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
*
* @throws StreamManagementNotEnabledException if Stream Management is not enabled.
* @throws NotConnectedException if the connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public void requestSmAcknowledgement() throws StreamManagementNotEnabledException, NotConnectedException, InterruptedException {
if (!isSmEnabled()) {
@@ -1593,7 +1593,7 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
*
* @throws StreamManagementNotEnabledException if Stream Management is not enabled.
* @throws NotConnectedException if the connection is not connected.
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
*/
public void sendSmAcknowledgement() throws StreamManagementNotEnabledException, NotConnectedException, InterruptedException {
if (!isSmEnabled()) {
@@ -1870,7 +1870,7 @@ public class XMPPTCPConnection extends AbstractXMPPConnection {
/**
* Set the default bundle and defer callback used for new connections.
*
- * @param defaultBundleAndDeferCallback TODO javadoc me please
+ * @param defaultBundleAndDeferCallback
* @see BundleAndDeferCallback
* @since 4.1
*/
diff --git a/smack-tcp/src/test/java/org/jivesoftware/smack/tcp/PacketWriterTest.java b/smack-tcp/src/test/java/org/jivesoftware/smack/tcp/PacketWriterTest.java
index 940c8910f..cb84f16e8 100644
--- a/smack-tcp/src/test/java/org/jivesoftware/smack/tcp/PacketWriterTest.java
+++ b/smack-tcp/src/test/java/org/jivesoftware/smack/tcp/PacketWriterTest.java
@@ -51,14 +51,14 @@ public class PacketWriterTest {
* {@link PacketWriter#sendStanza(org.jivesoftware.smack.tcp.packet.Packet)} does unblock after the
* interrupt.
*
- * @throws InterruptedException if the calling thread was interrupted.
+ * @throws InterruptedException
* @throws BrokenBarrierException
- * @throws NotConnectedException if the XMPP connection is not connected.
- * @throws XmppStringprepException if the provided string is invalid.
- * @throws SecurityException if there was a security violation.
+ * @throws NotConnectedException
+ * @throws XmppStringprepException
+ * @throws SecurityException
* @throws NoSuchFieldException
* @throws IllegalAccessException
- * @throws IllegalArgumentException if an illegal argument was given.
+ * @throws IllegalArgumentException
*/
@Test
public void shouldBlockAndUnblockTest() throws InterruptedException, BrokenBarrierException, NotConnectedException, XmppStringprepException, NoSuchFieldException, SecurityException, IllegalArgumentException, IllegalAccessException {