vanitasvitae/Smack
1
0
Fork 0
mirror of https://github.com/vanitasvitae/Smack.git synced 2025-09-09 17:19:39 +02:00
Code Issues Releases Wiki Activity

Enable werror for javadoc and fix javadoc issues

Browse source
This commit is contained in:
Florian Schmaus 2019-08-30 12:08:30 +02:00
parent 4249c1a845
commit 1a3067c89b
323 changed files with 2929 additions and 2704 deletions
Download patch file Download diff file Expand all files Collapse all files

28
smack-experimental/src/main/java/org/jivesoftware/smackx/carbons/CarbonManager.java
View file

@ -223,10 +223,10 @@ public final class CarbonManager extends Manager {
* Returns true if XMPP Carbons are supported by the server.
*
* @return true if supported
* @throws NotConnectedException
* @throws XMPPErrorException
* @throws NoResponseException
* @throws InterruptedException
* @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.
*/
public boolean isSupportedByServer() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection()).serverSupportsFeature(CarbonExtension.NAMESPACE);
@ -239,8 +239,8 @@ public final class CarbonManager extends Manager {
* You should first check for support using isSupportedByServer().
*
* @param new_state whether carbons should be enabled or disabled
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotConnectedException if the XMPP connection is not connected.
* @throws InterruptedException if the calling thread was interrupted.
* @deprecated use {@link #enableCarbonsAsync(ExceptionCallback)} or {@link #disableCarbonsAsync(ExceptionCallback)} instead.
*/
@Deprecated
@ -302,10 +302,10 @@ public final class CarbonManager extends Manager {
* You should first check for support using isSupportedByServer().
*
* @param new_state whether carbons should be enabled or disabled
* @throws XMPPErrorException
* @throws NoResponseException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*
*/
public synchronized void setCarbonsEnabled(final boolean new_state) throws NoResponseException,
@ -322,9 +322,9 @@ public final class CarbonManager extends Manager {
/**
* Helper method to enable carbons.
*
* @throws XMPPException
* @throws XMPPException if an XMPP protocol error was received.
* @throws SmackException if there was no response from the server.
* @throws InterruptedException
* @throws InterruptedException if the calling thread was interrupted.
*/
public void enableCarbons() throws XMPPException, SmackException, InterruptedException {
setCarbonsEnabled(true);
@ -333,9 +333,9 @@ public final class CarbonManager extends Manager {
/**
* Helper method to disable carbons.
*
* @throws XMPPException
* @throws XMPPException if an XMPP protocol error was received.
* @throws SmackException if there was no response from the server.
* @throws InterruptedException
* @throws InterruptedException if the calling thread was interrupted.
*/
public void disableCarbons() throws XMPPException, SmackException, InterruptedException {
setCarbonsEnabled(false);

2
smack-experimental/src/main/java/org/jivesoftware/smackx/gcm/packet/GcmPacketExtension.java
View file

@ -51,7 +51,7 @@ public class GcmPacketExtension extends AbstractJsonPacketExtension {
/**
* Retrieve the GCM stanza extension from the packet.
*
* @param packet
* @param packet TODO javadoc me please
* @return the GCM stanza extension or null.
*/
public static GcmPacketExtension from(Stanza packet) {

6
smack-experimental/src/main/java/org/jivesoftware/smackx/hashes/HashManager.java
View file

@ -109,7 +109,7 @@ public final class HashManager extends Manager {
/**
* Announce support for the given list of algorithms.
* @param algorithms
* @param algorithms TODO javadoc me please
*/
public void addAlgorithmsToFeatures(List<ALGORITHM> algorithms) {
ServiceDiscoveryManager sdm = ServiceDiscoveryManager.getInstanceFor(connection());
@ -120,7 +120,7 @@ public final class HashManager extends Manager {
/**
* Get an instance of the HashManager for the given connection.
* @param connection
* @param connection TODO javadoc me please
* @return the manager for the given connection.
*/
public static synchronized HashManager getInstanceFor(XMPPConnection connection) {
@ -189,7 +189,7 @@ public final class HashManager extends Manager {
/**
* Compensational method for static 'valueOf' function.
*
* @param s
* @param s TODO javadoc me please
* @return the algorithm for the given string.
* @throws IllegalArgumentException if no algorithm for the given string is known.
*/

8
smack-experimental/src/main/java/org/jivesoftware/smackx/hoxt/HOXTManager.java
View file

@ -56,10 +56,10 @@ public class HOXTManager {
* @param jid jid
* @param connection connection
* @return true if the given entity understands the HTTP ove XMPP transport format and exchange.
* @throws XMPPErrorException
* @throws NoResponseException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public static boolean isSupported(Jid jid, XMPPConnection connection) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
return ServiceDiscoveryManager.getInstanceFor(connection).supportsFeature(jid, NAMESPACE);

6
smack-experimental/src/main/java/org/jivesoftware/smackx/hoxt/packet/AbstractHttpOverXmpp.java
View file

@ -226,7 +226,7 @@ public abstract class AbstractHttpOverXmpp extends IQ {
/**
* Returns text of this element.
*
* @return text
* @return text TODO javadoc me please
*/
public String getText() {
return text;
@ -270,7 +270,7 @@ public abstract class AbstractHttpOverXmpp extends IQ {
/**
* Returns text of this element.
*
* @return text
* @return text TODO javadoc me please
*/
public String getText() {
return text;
@ -314,7 +314,7 @@ public abstract class AbstractHttpOverXmpp extends IQ {
/**
* Returns text of this element.
*
* @return text
* @return text TODO javadoc me please
*/
public String getText() {
return text;

10
smack-experimental/src/main/java/org/jivesoftware/smackx/hoxt/provider/AbstractHttpOverXmppProvider.java
View file

@ -55,9 +55,9 @@ public abstract class AbstractHttpOverXmppProvider<H extends AbstractHttpOverXmp
*
* @param parser parser
* @return HeadersExtension or null if no headers
* @throws XmlPullParserException
* @throws IOException
* @throws SmackParsingException
* @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.
*/
protected HeadersExtension parseHeaders(XmlPullParser parser) throws IOException, XmlPullParserException, SmackParsingException {
HeadersExtension headersExtension = null;
@ -76,8 +76,8 @@ public abstract class AbstractHttpOverXmppProvider<H extends AbstractHttpOverXmp
* @param parser parser
* @return Data or null if no data
*
* @throws XmlPullParserException
* @throws IOException
* @throws XmlPullParserException if an error in the XML parser occured.
* @throws IOException if an I/O error occured.
*/
protected AbstractHttpOverXmpp.Data parseData(XmlPullParser parser) throws XmlPullParserException, IOException {
NamedElement child = null;

44
smack-experimental/src/main/java/org/jivesoftware/smackx/httpfileupload/HttpFileUploadManager.java
View file

@ -178,10 +178,10 @@ public final class HttpFileUploadManager extends Manager {
*
* @return true if upload service was discovered
* @throws XMPPException.XMPPErrorException
* @throws SmackException.NotConnectedException
* @throws InterruptedException
* @throws SmackException.NoResponseException
* @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.
*/
public boolean discoverUploadService() throws XMPPException.XMPPErrorException, SmackException.NotConnectedException,
InterruptedException, SmackException.NoResponseException {
@ -228,9 +228,9 @@ public final class HttpFileUploadManager extends Manager {
*
* @param file file to be uploaded
* @return public URL for sharing uploaded file
* @throws InterruptedException
* @throws XMPPException.XMPPErrorException
* @throws SmackException
* @throws InterruptedException if the calling thread was interrupted.
* @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
* @throws SmackException if Smack detected an exceptional situation.
* @throws IOException in case of HTTP upload errors
*/
public URL uploadFile(File file) throws InterruptedException, XMPPException.XMPPErrorException,
@ -248,10 +248,10 @@ public final class HttpFileUploadManager extends Manager {
* @param listener upload progress listener of null
* @return public URL for sharing uploaded file
*
* @throws InterruptedException
* @throws XMPPException.XMPPErrorException
* @throws SmackException
* @throws IOException
* @throws InterruptedException if the calling thread was interrupted.
* @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
* @throws SmackException if Smack detected an exceptional situation.
* @throws IOException if an I/O error occured.
*/
public URL uploadFile(File file, UploadProgressListener listener) throws InterruptedException,
XMPPException.XMPPErrorException, SmackException, IOException {
@ -275,10 +275,10 @@ public final class HttpFileUploadManager extends Manager {
* @return file upload Slot in case of success
* @throws IllegalArgumentException if fileSize is less than or equal to zero or greater than the maximum size
* supported by the service.
* @throws InterruptedException
* @throws XMPPException.XMPPErrorException
* @throws SmackException.NotConnectedException
* @throws SmackException.NoResponseException
* @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.
*/
public Slot requestSlot(String filename, long fileSize) throws InterruptedException,
XMPPException.XMPPErrorException, SmackException {
@ -298,10 +298,10 @@ public final class HttpFileUploadManager extends Manager {
* @throws IllegalArgumentException if fileSize is less than or equal to zero or greater than the maximum size
* supported by the service.
* @throws SmackException.NotConnectedException
* @throws InterruptedException
* @throws XMPPException.XMPPErrorException
* @throws SmackException.NoResponseException
* @throws SmackException.NotConnectedException if the XMPP connection is not connected.
* @throws InterruptedException if the calling thread was interrupted.
* @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
* @throws SmackException.NoResponseException if there was no response from the remote entity.
*/
public Slot requestSlot(String filename, long fileSize, String contentType) throws SmackException,
InterruptedException, XMPPException.XMPPErrorException {
@ -321,9 +321,9 @@ public final class HttpFileUploadManager extends Manager {
* @return file upload Slot in case of success
* @throws IllegalArgumentException if fileSize is less than or equal to zero or greater than the maximum size
* supported by the service.
* @throws SmackException
* @throws InterruptedException
* @throws XMPPException.XMPPErrorException
* @throws SmackException if Smack detected an exceptional situation.
* @throws InterruptedException if the calling thread was interrupted.
* @throws XMPPException.XMPPErrorException if there was an XMPP error returned.
*/
public Slot requestSlot(String filename, long fileSize, String contentType, DomainBareJid uploadServiceAddress)
throws SmackException, InterruptedException, XMPPException.XMPPErrorException {

20
smack-experimental/src/main/java/org/jivesoftware/smackx/iot/control/IoTControlManager.java
View file

@ -101,13 +101,13 @@ public final class IoTControlManager extends IoTManager {
/**
* Control a thing by sending a collection of {@link SetData} instructions.
*
* @param jid
* @param data
* @param jid TODO javadoc me please
* @param data TODO javadoc me please
* @return a IoTSetResponse
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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 #setUsingIq(FullJid, Collection)
*/
public IoTSetResponse setUsingIq(FullJid jid, SetData data) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -120,10 +120,10 @@ public final class IoTControlManager extends IoTManager {
* @param jid the thing to control.
* @param data a collection of {@link SetData} instructions.
* @return the {@link IoTSetResponse} if successful.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public IoTSetResponse setUsingIq(FullJid jid, Collection<? extends SetData> data) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
IoTSetRequest request = new IoTSetRequest(data);

8
smack-experimental/src/main/java/org/jivesoftware/smackx/iot/data/IoTDataManager.java
View file

@ -164,10 +164,10 @@ public final class IoTDataManager extends IoTManager {
*
* @param jid the full JID of the thing to read data from.
* @return a list with the read out data.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<IoTFieldsExtension> requestMomentaryValuesReadOut(EntityFullJid jid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {

16
smack-experimental/src/main/java/org/jivesoftware/smackx/iot/discovery/IoTDiscoveryManager.java
View file

@ -211,10 +211,10 @@ public final class IoTDiscoveryManager extends Manager {
* Try to find an XMPP IoT registry.
*
* @return the JID of a Thing Registry if one could be found, <code>null</code> otherwise.
* @throws InterruptedException
* @throws NotConnectedException
* @throws XMPPErrorException
* @throws NoResponseException
* @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.
* @see <a href="http://xmpp.org/extensions/xep-0347.html#findingregistry">XEP-0347 § 3.5 Finding Thing Registry</a>
*/
public Jid findRegistry()
@ -283,10 +283,10 @@ public final class IoTDiscoveryManager extends Manager {
* @param metaTags a collection of meta tags used to identify the thing.
* @param publicThing if this is a public thing.
* @return a {@link IoTClaimed} if successful.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public IoTClaimed claimThing(Jid registry, Collection<Tag> metaTags, boolean publicThing) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
interactWithRegistry(registry);

18
smack-experimental/src/main/java/org/jivesoftware/smackx/iot/provisioning/IoTProvisioningManager.java
View file

@ -284,7 +284,7 @@ public final class IoTProvisioningManager extends Manager {
* Set the configured provisioning server. Use <code>null</code> as provisioningServer to use
* automatic discovery of the provisioning server (the default behavior).
*
* @param provisioningServer
* @param provisioningServer TODO javadoc me please
*/
public void setConfiguredProvisioningServer(Jid provisioningServer) {
this.configuredProvisioningServer = provisioningServer;
@ -302,10 +302,10 @@ public final class IoTProvisioningManager extends Manager {
* Try to find a provisioning server component.
*
* @return the XMPP address of the provisioning server component if one was found.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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 <a href="http://xmpp.org/extensions/xep-0324.html#servercomponent">XEP-0324 § 3.1.2 Provisioning Server as a server component</a>
*/
public DomainBareJid findProvisioningServerComponent() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -326,10 +326,10 @@ public final class IoTProvisioningManager extends Manager {
* @param provisioningServer the provisioning server to ask.
* @param friendInQuestion the JID to ask about.
* @return <code>true</code> if the JID is a friend, <code>false</code> otherwise.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public boolean isFriend(Jid provisioningServer, BareJid friendInQuestion) throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
LruCache<BareJid, Void> cache = negativeFriendshipRequestCache.lookup(provisioningServer);

4
smack-experimental/src/main/java/org/jivesoftware/smackx/jingle_filetransfer/element/Range.java
View file

@ -72,7 +72,7 @@ public class Range implements NamedElement {
/**
* Return the index of the offset.
* This marks the begin of the specified range.
* @return offset
* @return offset TODO javadoc me please
*/
public int getOffset() {
return offset;
@ -80,7 +80,7 @@ public class Range implements NamedElement {
/**
* Return the length of the range.
* @return length
* @return length TODO javadoc me please
*/
public int getLength() {
return length;

2
smack-experimental/src/main/java/org/jivesoftware/smackx/json/packet/JsonPacketExtension.java
View file

@ -45,7 +45,7 @@ public class JsonPacketExtension extends AbstractJsonPacketExtension {
/**
* Retrieve the JSON stanza extension from the packet.
*
* @param packet
* @param packet TODO javadoc me please
* @return the JSON stanza extension or null.
*/
public static JsonPacketExtension from(Stanza packet) {

76
smack-experimental/src/main/java/org/jivesoftware/smackx/mam/MamManager.java
View file

@ -492,11 +492,11 @@ public final class MamManager extends Manager {
* Get the form fields supported by the server.
*
* @return the list of form fields.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotLoggedInException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
*/
public List<FormField> retrieveFormFields() throws NoResponseException, XMPPErrorException, NotConnectedException,
InterruptedException, NotLoggedInException {
@ -508,11 +508,11 @@ public final class MamManager extends Manager {
*
* @param node The PubSub node name, can be null
* @return the list of form fields.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotLoggedInException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
*/
public List<FormField> retrieveFormFields(String node)
throws NoResponseException, XMPPErrorException, NotConnectedException,
@ -700,10 +700,10 @@ public final class MamManager extends Manager {
*
* @return true if MAM is supported, <code>false</code>otherwise.
*
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
* @since 4.2.1
* @see <a href="https://xmpp.org/extensions/xep-0313.html#support">XEP-0313 § 7. Determining support</a>
*/
@ -725,11 +725,11 @@ public final class MamManager extends Manager {
* empty.
*
* @return the ID of the lastest message or {@code null}.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws NotLoggedInException
* @throws InterruptedException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
* @throws InterruptedException if the calling thread was interrupted.
* @since 4.3.0
*/
public String getMessageUidOfLatestMessage() throws NoResponseException, XMPPErrorException, NotConnectedException, NotLoggedInException, InterruptedException {
@ -750,11 +750,11 @@ public final class MamManager extends Manager {
* Get the preferences stored in the server.
*
* @return the MAM preferences result
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotLoggedInException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
*/
public MamPrefsResult retrieveArchivingPreferences() throws NoResponseException, XMPPErrorException,
NotConnectedException, InterruptedException, NotLoggedInException {
@ -765,20 +765,20 @@ public final class MamManager extends Manager {
/**
* Update the preferences in the server.
*
* @param alwaysJids
* @param alwaysJids TODO javadoc me please
* is the list of JIDs that should always have messages to/from
* archived in the user's store
* @param neverJids
* @param neverJids TODO javadoc me please
* is the list of JIDs that should never have messages to/from
* archived in the user's store
* @param defaultBehavior
* @param defaultBehavior TODO javadoc me please
* can be "roster", "always", "never" (see XEP-0313)
* @return the MAM preferences result
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotLoggedInException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
* @deprecated use {@link #updateArchivingPreferences(MamPrefs)} instead.
*/
@Deprecated
@ -793,13 +793,13 @@ public final class MamManager extends Manager {
/**
* Update the preferences in the server.
*
* @param mamPrefs
* @param mamPrefs TODO javadoc me please
* @return the currently active preferences after the operation.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotLoggedInException
* @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 NotLoggedInException if the XMPP connection is not authenticated.
* @since 4.3.0
*/
public MamPrefsResult updateArchivingPreferences(MamPrefs mamPrefs) throws NoResponseException, XMPPErrorException,

10
smack-experimental/src/main/java/org/jivesoftware/smackx/mam/element/MamElements.java
View file

@ -72,9 +72,9 @@ public class MamElements {
/**
* MAM result extension constructor.
*
* @param queryId
* @param id
* @param forwarded
* @param queryId TODO javadoc me please
* @param id TODO javadoc me please
* @param forwarded TODO javadoc me please
*/
public MamResultExtension(String queryId, String id, Forwarded forwarded) {
if (StringUtils.isEmpty(id)) {
@ -160,7 +160,7 @@ public class MamElements {
/**
* Always JID list element constructor.
*
* @param alwaysJids
* @param alwaysJids TODO javadoc me please
*/
AlwaysJidListElement(List<Jid> alwaysJids) {
this.alwaysJids = alwaysJids;
@ -194,7 +194,7 @@ public class MamElements {
/**
* Never JID list element constructor.
*
* @param neverJids
* @param neverJids TODO javadoc me please
*/
public NeverJidListElement(List<Jid> neverJids) {
this.neverJids = neverJids;

8
smack-experimental/src/main/java/org/jivesoftware/smackx/mam/element/MamFinIQ.java
View file

@ -63,10 +63,10 @@ public class MamFinIQ extends IQ {
/**
* MamFinIQ constructor.
*
* @param queryId
* @param rsmSet
* @param complete
* @param stable
* @param queryId TODO javadoc me please
* @param rsmSet TODO javadoc me please
* @param complete TODO javadoc me please
* @param stable TODO javadoc me please
*/
public MamFinIQ(String queryId, RSMSet rsmSet, boolean complete, boolean stable) {
super(ELEMENT, NAMESPACE);

6
smack-experimental/src/main/java/org/jivesoftware/smackx/mam/element/MamPrefsIQ.java
View file

@ -79,9 +79,9 @@ public class MamPrefsIQ extends IQ {
/**
* MAM preferences IQ constructor.
*
* @param alwaysJids
* @param neverJids
* @param defaultBehavior
* @param alwaysJids TODO javadoc me please
* @param neverJids TODO javadoc me please
* @param defaultBehavior TODO javadoc me please
*/
public MamPrefsIQ(List<Jid> alwaysJids, List<Jid> neverJids, DefaultBehavior defaultBehavior) {
super(ELEMENT, NAMESPACE);

14
smack-experimental/src/main/java/org/jivesoftware/smackx/mam/element/MamQueryIQ.java
View file

@ -48,7 +48,7 @@ public class MamQueryIQ extends IQ {
/**
* MAM query IQ constructor.
*
* @param queryId
* @param queryId TODO javadoc me please
*/
public MamQueryIQ(String queryId) {
this(queryId, null, null);
@ -58,7 +58,7 @@ public class MamQueryIQ extends IQ {
/**
* MAM query IQ constructor.
*
* @param form
* @param form TODO javadoc me please
*/
public MamQueryIQ(DataForm form) {
this(null, null, form);
@ -67,8 +67,8 @@ public class MamQueryIQ extends IQ {
/**
* MAM query IQ constructor.
*
* @param queryId
* @param form
* @param queryId TODO javadoc me please
* @param form TODO javadoc me please
*/
public MamQueryIQ(String queryId, DataForm form) {
this(queryId, null, form);
@ -77,9 +77,9 @@ public class MamQueryIQ extends IQ {
/**
* MAM query IQ constructor.
*
* @param queryId
* @param node
* @param dataForm
* @param queryId TODO javadoc me please
* @param node TODO javadoc me please
* @param dataForm TODO javadoc me please
*/
public MamQueryIQ(String queryId, String node, DataForm dataForm) {
super(ELEMENT, NAMESPACE);

2
smack-experimental/src/main/java/org/jivesoftware/smackx/message_markup/element/ListElement.java
View file

@ -56,7 +56,7 @@ public class ListElement implements MarkupElement.MarkupChildElement {
/**
* Return a list of all list entries.
*
* @return entries
* @return entries TODO javadoc me please
*/
public List<ListEntryElement> getEntries() {
return entries;

16
smack-experimental/src/main/java/org/jivesoftware/smackx/message_markup/element/MarkupElement.java
View file

@ -51,7 +51,7 @@ public class MarkupElement implements ExtensionElement {
/**
* Return a list of all child elements.
* @return children
* @return children TODO javadoc me please
*/
public List<MarkupChildElement> getChildElements() {
return childElements;
@ -97,7 +97,7 @@ public class MarkupElement implements ExtensionElement {
*
* @param start start index
* @param end end index
* @return builder
* @return builder TODO javadoc me please
*/
public Builder setDeleted(int start, int end) {
return addSpan(start, end, Collections.singleton(SpanElement.SpanStyle.deleted));
@ -108,7 +108,7 @@ public class MarkupElement implements ExtensionElement {
*
* @param start start index
* @param end end index
* @return builder
* @return builder TODO javadoc me please
*/
public Builder setEmphasis(int start, int end) {
return addSpan(start, end, Collections.singleton(SpanElement.SpanStyle.emphasis));
@ -119,7 +119,7 @@ public class MarkupElement implements ExtensionElement {
*
* @param start start index
* @param end end index
* @return builder
* @return builder TODO javadoc me please
*/
public Builder setCode(int start, int end) {
return addSpan(start, end, Collections.singleton(SpanElement.SpanStyle.code));
@ -131,7 +131,7 @@ public class MarkupElement implements ExtensionElement {
* @param start start index
* @param end end index
* @param styles list of text styles for that span
* @return builder
* @return builder TODO javadoc me please
*/
public Builder addSpan(int start, int end, Set<SpanElement.SpanStyle> styles) {
verifyStartEnd(start, end);
@ -152,7 +152,7 @@ public class MarkupElement implements ExtensionElement {
*
* @param start start index
* @param end end index
* @return builder
* @return builder TODO javadoc me please
*/
public Builder setBlockQuote(int start, int end) {
verifyStartEnd(start, end);
@ -179,7 +179,7 @@ public class MarkupElement implements ExtensionElement {
*
* @param start start index
* @param end end index
* @return builder
* @return builder TODO javadoc me please
*/
public Builder setCodeBlock(int start, int end) {
verifyStartEnd(start, end);
@ -232,7 +232,7 @@ public class MarkupElement implements ExtensionElement {
/**
* End the list.
*
* @return builder
* @return builder TODO javadoc me please
*/
public Builder endList() {
if (entries.size() > 0) {

2
smack-experimental/src/main/java/org/jivesoftware/smackx/message_markup/element/SpanElement.java
View file

@ -54,7 +54,7 @@ public class SpanElement implements MarkupElement.MarkupChildElement {
/**
* Return all styles of this span.
*
* @return styles
* @return styles TODO javadoc me please
*/
public Set<SpanStyle> getStyles() {
return styles;

6
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/MUCLightRoomConfiguration.java
View file

@ -33,9 +33,9 @@ public class MUCLightRoomConfiguration {
/**
* MUC Light room configuration model constructor.
*
* @param roomName
* @param subject
* @param customConfigs
* @param roomName TODO javadoc me please
* @param subject TODO javadoc me please
* @param customConfigs TODO javadoc me please
*/
public MUCLightRoomConfiguration(String roomName, String subject, HashMap<String, String> customConfigs) {
this.roomName = roomName;

8
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/MUCLightRoomInfo.java
View file

@ -35,10 +35,10 @@ public class MUCLightRoomInfo {
/**
* MUC Light room info model constructor.
*
* @param version
* @param roomJid
* @param configuration
* @param occupants
* @param version TODO javadoc me please
* @param roomJid TODO javadoc me please
* @param configuration TODO javadoc me please
* @param occupants TODO javadoc me please
*/
public MUCLightRoomInfo(String version, Jid roomJid, MUCLightRoomConfiguration configuration,
HashMap<Jid, MUCLightAffiliation> occupants) {

164
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/MultiUserChatLight.java
View file

@ -120,10 +120,10 @@ public class MultiUserChatLight {
/**
* Sends a message to the chat room.
*
* @param text
* @param text TODO javadoc me please
* the text of the message to send.
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotConnectedException if the XMPP connection is not connected.
* @throws InterruptedException if the calling thread was interrupted.
*/
public void sendMessage(String text) throws NotConnectedException, InterruptedException {
Message message = createMessage();
@ -138,10 +138,10 @@ public class MultiUserChatLight {
* to the sender's room JID and delivering the message to the intended
* recipient's full JID.
*
* @param occupant
* @param occupant TODO javadoc me please
* occupant unique room JID (e.g.
* 'darkcave@macbeth.shakespeare.lit/Paul').
* @param listener
* @param listener TODO javadoc me please
* the listener is a message listener that will handle messages
* for the newly created chat.
* @return new Chat for sending private messages to a given room occupant.
@ -165,10 +165,10 @@ public class MultiUserChatLight {
/**
* Sends a Message to the chat room.
*
* @param message
* @param message TODO javadoc me please
* the message.
* @throws NotConnectedException
* @throws InterruptedException
* @throws NotConnectedException if the XMPP connection is not connected.
* @throws InterruptedException if the calling thread was interrupted.
*/
public void sendMessage(Message message) throws NotConnectedException, InterruptedException {
message.setTo(room);
@ -190,7 +190,7 @@ public class MultiUserChatLight {
* block (not return) until a message is available.
*
* @return the next message.
* @throws InterruptedException
* @throws InterruptedException if the calling thread was interrupted.
*/
public Message nextMessage() throws InterruptedException {
return messageCollector.nextResult();
@ -199,11 +199,11 @@ public class MultiUserChatLight {
/**
* Returns the next available message in the chat.
*
* @param timeout
* @param timeout TODO javadoc me please
* 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 InterruptedException
* @throws InterruptedException if the calling thread was interrupted.
*/
public Message nextMessage(long timeout) throws InterruptedException {
return messageCollector.nextResult(timeout);
@ -214,7 +214,7 @@ public class MultiUserChatLight {
* in the group chat. Only "group chat" messages addressed to this group
* chat will be delivered to the listener.
*
* @param listener
* @param listener TODO javadoc me please
* a stanza listener.
* @return true if the listener was not already added.
*/
@ -227,7 +227,7 @@ public class MultiUserChatLight {
* messages in the MUCLight. Only "group chat" messages addressed to this
* MUCLight were being delivered to the listener.
*
* @param listener
* @param listener TODO javadoc me please
* a stanza listener.
* @return true if the listener was removed, otherwise the listener was not
* added previously.
@ -256,11 +256,11 @@ public class MultiUserChatLight {
/**
* Create new MUCLight.
*
* @param roomName
* @param subject
* @param customConfigs
* @param occupants
* @throws Exception
* @param roomName TODO javadoc me please
* @param subject TODO javadoc me please
* @param customConfigs TODO javadoc me please
* @param occupants TODO javadoc me please
* @throws Exception TODO javadoc me please
*/
public void create(String roomName, String subject, HashMap<String, String> customConfigs, List<Jid> occupants)
throws Exception {
@ -279,9 +279,9 @@ public class MultiUserChatLight {
/**
* Create new MUCLight.
*
* @param roomName
* @param occupants
* @throws Exception
* @param roomName TODO javadoc me please
* @param occupants TODO javadoc me please
* @throws Exception TODO javadoc me please
*/
public void create(String roomName, List<Jid> occupants) throws Exception {
create(roomName, null, null, occupants);
@ -290,10 +290,10 @@ public class MultiUserChatLight {
/**
* Leave the MUCLight.
*
* @throws NotConnectedException
* @throws InterruptedException
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException if the XMPP connection is not connected.
* @throws InterruptedException if the calling thread was interrupted.
* @throws NoResponseException if there was no response from the remote entity.
* @throws XMPPErrorException if there was an XMPP error returned.
*/
public void leave() throws NotConnectedException, InterruptedException, NoResponseException, XMPPErrorException {
HashMap<Jid, MUCLightAffiliation> affiliations = new HashMap<>();
@ -311,12 +311,12 @@ public class MultiUserChatLight {
/**
* Get the MUC Light info.
*
* @param version
* @param version TODO javadoc me please
* @return the room info
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public MUCLightRoomInfo getFullInfo(String version)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -333,10 +333,10 @@ public class MultiUserChatLight {
* Get the MUC Light info.
*
* @return the room info
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public MUCLightRoomInfo getFullInfo()
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -346,12 +346,12 @@ public class MultiUserChatLight {
/**
* Get the MUC Light configuration.
*
* @param version
* @param version TODO javadoc me please
* @return the room configuration
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public MUCLightRoomConfiguration getConfiguration(String version)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -365,10 +365,10 @@ public class MultiUserChatLight {
* Get the MUC Light configuration.
*
* @return the room configuration
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public MUCLightRoomConfiguration getConfiguration()
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -378,12 +378,12 @@ public class MultiUserChatLight {
/**
* Get the MUC Light affiliations.
*
* @param version
* @param version TODO javadoc me please
* @return the room affiliations
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public HashMap<Jid, MUCLightAffiliation> getAffiliations(String version)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -399,10 +399,10 @@ public class MultiUserChatLight {
* Get the MUC Light affiliations.
*
* @return the room affiliations
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public HashMap<Jid, MUCLightAffiliation> getAffiliations()
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -412,11 +412,11 @@ public class MultiUserChatLight {
/**
* Change the MUC Light affiliations.
*
* @param affiliations
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param affiliations TODO javadoc me please
* @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.
*/
public void changeAffiliations(HashMap<Jid, MUCLightAffiliation> affiliations)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -427,10 +427,10 @@ public class MultiUserChatLight {
/**
* Destroy the MUC Light. Only will work if it is requested by the owner.
*
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public void destroy() throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
MUCLightDestroyIQ mucLightDestroyIQ = new MUCLightDestroyIQ(room);
@ -445,11 +445,11 @@ public class MultiUserChatLight {
/**
* Change the subject of the MUC Light.
*
* @param subject
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param subject TODO javadoc me please
* @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.
*/
public void changeSubject(String subject)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -460,11 +460,11 @@ public class MultiUserChatLight {
/**
* Change the name of the room.
*
* @param roomName
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param roomName TODO javadoc me please
* @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.
*/
public void changeRoomName(String roomName)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -475,11 +475,11 @@ public class MultiUserChatLight {
/**
* Set the room configurations.
*
* @param customConfigs
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param customConfigs TODO javadoc me please
* @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.
*/
public void setRoomConfigs(HashMap<String, String> customConfigs)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -489,12 +489,12 @@ public class MultiUserChatLight {
/**
* Set the room configurations.
*
* @param roomName
* @param customConfigs
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param roomName TODO javadoc me please
* @param customConfigs TODO javadoc me please
* @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.
*/
public void setRoomConfigs(String roomName, HashMap<String, String> customConfigs)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {

158
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/MultiUserChatLightManager.java
View file

@ -54,7 +54,7 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Get a instance of a MUC Light manager for the given connection.
*
* @param connection
* @param connection TODO javadoc me please
* @return a MUCLight manager.
*/
public static synchronized MultiUserChatLightManager getInstanceFor(XMPPConnection connection) {
@ -79,7 +79,7 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Obtain the MUC Light.
*
* @param jid
* @param jid TODO javadoc me please
* @return the MUCLight.
*/
public synchronized MultiUserChatLight getMultiUserChatLight(EntityBareJid jid) {
@ -103,12 +103,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Returns true if Multi-User Chat Light feature is supported by the server.
*
* @param mucLightService
* @param mucLightService TODO javadoc me please
* @return true if Multi-User Chat Light feature is supported by the server.
* @throws NotConnectedException
* @throws XMPPErrorException
* @throws NoResponseException
* @throws InterruptedException
* @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.
*/
public boolean isFeatureSupported(DomainBareJid mucLightService)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -119,12 +119,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Returns a List of the rooms the user occupies.
*
* @param mucLightService
* @param mucLightService TODO javadoc me please
* @return a List of the rooms the user occupies.
* @throws XMPPErrorException
* @throws NoResponseException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<Jid> getOccupiedRooms(DomainBareJid mucLightService)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -144,10 +144,10 @@ public final class MultiUserChatLightManager extends Manager {
* Returns a collection with the XMPP addresses of the MUC Light services.
*
* @return a collection with the XMPP addresses of the MUC Light services.
* @throws XMPPErrorException
* @throws NoResponseException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<DomainBareJid> getLocalServices()
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -158,12 +158,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Get users and rooms blocked.
*
* @param mucLightService
* @param mucLightService TODO javadoc me please
* @return the list of users and rooms blocked
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<Jid> getUsersAndRoomsBlocked(DomainBareJid mucLightService)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -184,12 +184,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Get rooms blocked.
*
* @param mucLightService
* @param mucLightService TODO javadoc me please
* @return the list of rooms blocked
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<Jid> getRoomsBlocked(DomainBareJid mucLightService)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -206,12 +206,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Get users blocked.
*
* @param mucLightService
* @param mucLightService TODO javadoc me please
* @return the list of users blocked
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public List<Jid> getUsersBlocked(DomainBareJid mucLightService)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -242,12 +242,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Block a room.
*
* @param mucLightService
* @param roomJid
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param roomJid TODO javadoc me please
* @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.
*/
public void blockRoom(DomainBareJid mucLightService, Jid roomJid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -259,12 +259,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Block rooms.
*
* @param mucLightService
* @param roomsJids
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param roomsJids TODO javadoc me please
* @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.
*/
public void blockRooms(DomainBareJid mucLightService, List<Jid> roomsJids)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -286,12 +286,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Block a user.
*
* @param mucLightService
* @param userJid
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param userJid TODO javadoc me please
* @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.
*/
public void blockUser(DomainBareJid mucLightService, Jid userJid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -303,12 +303,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Block users.
*
* @param mucLightService
* @param usersJids
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param usersJids TODO javadoc me please
* @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.
*/
public void blockUsers(DomainBareJid mucLightService, List<Jid> usersJids)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -330,12 +330,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Unblock a room.
*
* @param mucLightService
* @param roomJid
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param roomJid TODO javadoc me please
* @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.
*/
public void unblockRoom(DomainBareJid mucLightService, Jid roomJid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -347,12 +347,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Unblock rooms.
*
* @param mucLightService
* @param roomsJids
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param roomsJids TODO javadoc me please
* @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.
*/
public void unblockRooms(DomainBareJid mucLightService, List<Jid> roomsJids)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -374,12 +374,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Unblock a user.
*
* @param mucLightService
* @param userJid
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param userJid TODO javadoc me please
* @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.
*/
public void unblockUser(DomainBareJid mucLightService, Jid userJid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -391,12 +391,12 @@ public final class MultiUserChatLightManager extends Manager {
/**
* Unblock users.
*
* @param mucLightService
* @param usersJids
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @param mucLightService TODO javadoc me please
* @param usersJids TODO javadoc me please
* @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.
*/
public void unblockUsers(DomainBareJid mucLightService, List<Jid> usersJids)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {

4
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightAffiliationsIQ.java
View file

@ -45,8 +45,8 @@ public class MUCLightAffiliationsIQ extends IQ {
/**
* MUC Light affiliations response IQ constructor.
*
* @param version
* @param affiliations
* @param version TODO javadoc me please
* @param affiliations TODO javadoc me please
*/
public MUCLightAffiliationsIQ(String version, HashMap<Jid, MUCLightAffiliation> affiliations) {
super(ELEMENT, NAMESPACE);

4
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightBlockingIQ.java
View file

@ -44,8 +44,8 @@ public class MUCLightBlockingIQ extends IQ {
/**
* MUC Light blocking IQ constructor.
*
* @param rooms
* @param users
* @param rooms TODO javadoc me please
* @param users TODO javadoc me please
*/
public MUCLightBlockingIQ(HashMap<Jid, Boolean> rooms, HashMap<Jid, Boolean> users) {
super(ELEMENT, NAMESPACE);

4
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightChangeAffiliationsIQ.java
View file

@ -44,8 +44,8 @@ public class MUCLightChangeAffiliationsIQ extends IQ {
/**
* MUCLight change affiliations IQ constructor.
*
* @param room
* @param affiliations
* @param room TODO javadoc me please
* @param affiliations TODO javadoc me please
*/
public MUCLightChangeAffiliationsIQ(Jid room, HashMap<Jid, MUCLightAffiliation> affiliations) {
super(ELEMENT, NAMESPACE);

4
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightConfigurationIQ.java
View file

@ -39,8 +39,8 @@ public class MUCLightConfigurationIQ extends IQ {
/**
* MUC Light configuration response IQ constructor.
*
* @param version
* @param configuration
* @param version TODO javadoc me please
* @param configuration TODO javadoc me please
*/
public MUCLightConfigurationIQ(String version, MUCLightRoomConfiguration configuration) {
super(ELEMENT, NAMESPACE);

16
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightCreateIQ.java
View file

@ -47,11 +47,11 @@ public class MUCLightCreateIQ extends IQ {
/**
* MUCLight create IQ constructor.
*
* @param room
* @param roomName
* @param subject
* @param customConfigs
* @param occupants
* @param room TODO javadoc me please
* @param roomName TODO javadoc me please
* @param subject TODO javadoc me please
* @param customConfigs TODO javadoc me please
* @param occupants TODO javadoc me please
*/
public MUCLightCreateIQ(EntityJid room, String roomName, String subject, HashMap<String, String> customConfigs,
List<Jid> occupants) {
@ -70,9 +70,9 @@ public class MUCLightCreateIQ extends IQ {
/**
* MUCLight create IQ constructor.
*
* @param room
* @param roomName
* @param occupants
* @param room TODO javadoc me please
* @param roomName TODO javadoc me please
* @param occupants TODO javadoc me please
*/
public MUCLightCreateIQ(EntityJid room, String roomName, List<Jid> occupants) {
this(room, roomName, null, null, occupants);

2
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightDestroyIQ.java
View file

@ -36,7 +36,7 @@ public class MUCLightDestroyIQ extends IQ {
/**
* MUC Light destroy IQ constructor.
*
* @param roomJid
* @param roomJid TODO javadoc me please
*/
public MUCLightDestroyIQ(Jid roomJid) {
super(ELEMENT, NAMESPACE);

24
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightElements.java
View file

@ -137,11 +137,11 @@ public abstract class MUCLightElements {
/**
* Configurations change extension constructor.
*
* @param prevVersion
* @param version
* @param roomName
* @param subject
* @param customConfigs
* @param prevVersion TODO javadoc me please
* @param version TODO javadoc me please
* @param roomName TODO javadoc me please
* @param subject TODO javadoc me please
* @param customConfigs TODO javadoc me please
*/
public ConfigurationsChangeExtension(String prevVersion, String version, String roomName, String subject,
HashMap<String, String> customConfigs) {
@ -248,7 +248,7 @@ public abstract class MUCLightElements {
/**
* Configuration element constructor.
*
* @param configuration
* @param configuration TODO javadoc me please
*/
public ConfigurationElement(MUCLightRoomConfiguration configuration) {
this.configuration = configuration;
@ -289,7 +289,7 @@ public abstract class MUCLightElements {
/**
* Occupants element constructor.
*
* @param occupants
* @param occupants TODO javadoc me please
*/
public OccupantsElement(HashMap<Jid, MUCLightAffiliation> occupants) {
this.occupants = occupants;
@ -326,8 +326,8 @@ public abstract class MUCLightElements {
/**
* User with affiliations element constructor.
*
* @param user
* @param affiliation
* @param user TODO javadoc me please
* @param affiliation TODO javadoc me please
*/
public UserWithAffiliationElement(Jid user, MUCLightAffiliation affiliation) {
this.user = user;
@ -362,9 +362,9 @@ public abstract class MUCLightElements {
/**
* Blocking element constructor.
*
* @param jid
* @param allow
* @param isRoom
* @param jid TODO javadoc me please
* @param allow TODO javadoc me please
* @param isRoom TODO javadoc me please
*/
public BlockingElement(Jid jid, Boolean allow, Boolean isRoom) {
this.jid = jid;

6
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightGetAffiliationsIQ.java
View file

@ -38,8 +38,8 @@ public class MUCLightGetAffiliationsIQ extends IQ {
/**
* MUC Light get affiliations IQ constructor.
*
* @param roomJid
* @param version
* @param roomJid TODO javadoc me please
* @param version TODO javadoc me please
*/
public MUCLightGetAffiliationsIQ(Jid roomJid, String version) {
super(ELEMENT, NAMESPACE);
@ -51,7 +51,7 @@ public class MUCLightGetAffiliationsIQ extends IQ {
/**
* MUC Light get affiliations IQ constructor.
*
* @param roomJid
* @param roomJid TODO javadoc me please
*/
public MUCLightGetAffiliationsIQ(Jid roomJid) {
this(roomJid, null);

6
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightGetConfigsIQ.java
View file

@ -38,8 +38,8 @@ public class MUCLightGetConfigsIQ extends IQ {
/**
* MUC Light get configurations IQ constructor.
*
* @param roomJid
* @param version
* @param roomJid TODO javadoc me please
* @param version TODO javadoc me please
*/
public MUCLightGetConfigsIQ(Jid roomJid, String version) {
super(ELEMENT, NAMESPACE);
@ -51,7 +51,7 @@ public class MUCLightGetConfigsIQ extends IQ {
/**
* MUC Light get configurations IQ constructor.
*
* @param roomJid
* @param roomJid TODO javadoc me please
*/
public MUCLightGetConfigsIQ(Jid roomJid) {
this(roomJid, null);

6
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightGetInfoIQ.java
View file

@ -38,8 +38,8 @@ public class MUCLightGetInfoIQ extends IQ {
/**
* MUC Light get info IQ constructor.
*
* @param roomJid
* @param version
* @param roomJid TODO javadoc me please
* @param version TODO javadoc me please
*/
public MUCLightGetInfoIQ(Jid roomJid, String version) {
super(ELEMENT, NAMESPACE);
@ -51,7 +51,7 @@ public class MUCLightGetInfoIQ extends IQ {
/**
* MUC Light get info IQ constructor.
*
* @param roomJid
* @param roomJid TODO javadoc me please
*/
public MUCLightGetInfoIQ(Jid roomJid) {
this(roomJid, null);

6
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightInfoIQ.java
View file

@ -46,9 +46,9 @@ public class MUCLightInfoIQ extends IQ {
/**
* MUCLight info response IQ constructor.
*
* @param version
* @param configuration
* @param occupants
* @param version TODO javadoc me please
* @param configuration TODO javadoc me please
* @param occupants TODO javadoc me please
*/
public MUCLightInfoIQ(String version, MUCLightRoomConfiguration configuration,
HashMap<Jid, MUCLightAffiliation> occupants) {

14
smack-experimental/src/main/java/org/jivesoftware/smackx/muclight/element/MUCLightSetConfigsIQ.java
View file

@ -44,10 +44,10 @@ public class MUCLightSetConfigsIQ extends IQ {
/**
* MUC Light set configuration IQ constructor.
*
* @param roomJid
* @param roomName
* @param subject
* @param customConfigs
* @param roomJid TODO javadoc me please
* @param roomName TODO javadoc me please
* @param subject TODO javadoc me please
* @param customConfigs TODO javadoc me please
*/
public MUCLightSetConfigsIQ(Jid roomJid, String roomName, String subject, HashMap<String, String> customConfigs) {
super(ELEMENT, NAMESPACE);
@ -61,9 +61,9 @@ public class MUCLightSetConfigsIQ extends IQ {
/**
* MUC Light set configuration IQ constructor.
*
* @param roomJid
* @param roomName
* @param customConfigs
* @param roomJid TODO javadoc me please
* @param roomName TODO javadoc me please
* @param customConfigs TODO javadoc me please
*/
public MUCLightSetConfigsIQ(Jid roomJid, String roomName, HashMap<String, String> customConfigs) {
this(roomJid, roomName, null, customConfigs);

58
smack-experimental/src/main/java/org/jivesoftware/smackx/push_notifications/PushNotificationsManager.java
View file

@ -61,7 +61,7 @@ public final class PushNotificationsManager extends Manager {
/**
* Get the singleton instance of PushNotificationsManager.
*
* @param connection
* @param connection TODO javadoc me please
* @return the instance of PushNotificationsManager
*/
public static synchronized PushNotificationsManager getInstanceFor(XMPPConnection connection) {
@ -83,10 +83,10 @@ public final class PushNotificationsManager extends Manager {
* Returns true if Push Notifications are supported by this account.
*
* @return true if Push Notifications are supported by this account.
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
* @since 4.2.2
*/
public boolean isSupported()
@ -98,13 +98,13 @@ public final class PushNotificationsManager extends Manager {
/**
* Enable push notifications.
*
* @param pushJid
* @param node
* @param pushJid TODO javadoc me please
* @param node TODO javadoc me please
* @return true if it was successfully enabled, false if not
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public boolean enable(Jid pushJid, String node)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -114,14 +114,14 @@ public final class PushNotificationsManager extends Manager {
/**
* Enable push notifications.
*
* @param pushJid
* @param node
* @param publishOptions
* @param pushJid TODO javadoc me please
* @param node TODO javadoc me please
* @param publishOptions TODO javadoc me please
* @return true if it was successfully enabled, false if not
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public boolean enable(Jid pushJid, String node, HashMap<String, String> publishOptions)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -133,12 +133,12 @@ public final class PushNotificationsManager extends Manager {
/**
* Disable all push notifications.
*
* @param pushJid
* @param pushJid TODO javadoc me please
* @return true if it was successfully disabled, false if not
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public boolean disableAll(Jid pushJid)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {
@ -148,13 +148,13 @@ public final class PushNotificationsManager extends Manager {
/**
* Disable push notifications of an specific node.
*
* @param pushJid
* @param node
* @param pushJid TODO javadoc me please
* @param node TODO javadoc me please
* @return true if it was successfully disabled, false if not
* @throws NoResponseException
* @throws XMPPErrorException
* @throws NotConnectedException
* @throws InterruptedException
* @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.
*/
public boolean disable(Jid pushJid, String node)
throws NoResponseException, XMPPErrorException, NotConnectedException, InterruptedException {

22
smack-experimental/src/main/java/org/jivesoftware/smackx/reference/element/ReferenceElement.java
View file

@ -56,12 +56,12 @@ public class ReferenceElement implements ExtensionElement {
/**
* XEP-incompliant (v0.2) constructor. This is needed for SIMS.
*
* @param begin
* @param end
* @param type
* @param anchor
* @param uri
* @param child
* @param begin TODO javadoc me please
* @param end TODO javadoc me please
* @param type TODO javadoc me please
* @param anchor TODO javadoc me please
* @param uri TODO javadoc me please
* @param child TODO javadoc me please
*/
public ReferenceElement(Integer begin, Integer end, Type type, String anchor, URI uri, ExtensionElement child) {
if (begin != null && begin < 0) {
@ -89,11 +89,11 @@ public class ReferenceElement implements ExtensionElement {
/**
* XEP-Compliant constructor.
*
* @param begin
* @param end
* @param type
* @param anchor
* @param uri
* @param begin TODO javadoc me please
* @param end TODO javadoc me please
* @param type TODO javadoc me please
* @param anchor TODO javadoc me please
* @param uri TODO javadoc me please
*/
public ReferenceElement(Integer begin, Integer end, Type type, String anchor, URI uri) {
this(begin, end, type, anchor, uri, null);

2
smack-experimental/src/main/java/org/jivesoftware/smackx/sid/StableUniqueStanzaIdManager.java
View file

@ -66,7 +66,7 @@ public final class StableUniqueStanzaIdManager extends Manager {
/**
* Private constructor.
* @param connection
* @param connection TODO javadoc me please
*/
private StableUniqueStanzaIdManager(XMPPConnection connection) {
super(connection);

1
smack-experimental/src/main/java/org/jivesoftware/smackx/sid/element/OriginIdElement.java
View file

@ -37,6 +37,7 @@ public class OriginIdElement extends StableAndUniqueIdElement {
* Add an origin-id element to a message and set the stanzas id to the same id as in the origin-id element.
*
* @param message message.
* @return the added origin-id element.
*/
public static OriginIdElement addOriginId(Message message) {
OriginIdElement originId = new OriginIdElement();

2
smack-experimental/src/main/java/org/jivesoftware/smackx/spoiler/SpoilerManager.java
View file

@ -60,7 +60,7 @@ public final class SpoilerManager extends Manager {
* Return the connections instance of the SpoilerManager.
*
* @param connection xmpp connection
* @return SpoilerManager
* @return SpoilerManager TODO javadoc me please
*/
public static synchronized SpoilerManager getInstanceFor(XMPPConnection connection) {
SpoilerManager manager = INSTANCES.get(connection);

2
smack-experimental/src/test/java/org/jivesoftware/smackx/reference/ReferenceTest.java
View file

@ -57,7 +57,7 @@ public class ReferenceTest extends SmackTestSuite {
/**
* TODO: The uri might not be following the XMPP schema.
* That shouldn't matter though.
* @throws Exception
* @throws Exception if an exception occurs.
*/
@Test
public void providerDataTest() throws Exception {