mirror of
https://codeberg.org/Mercury-IM/Smack
synced 2024-11-25 15:52:06 +01:00
Enable werror for javadoc and fix javadoc issues
This commit is contained in:
Florian Schmaus
parent
4249c1a845
commit
1a3067c89b
323 changed files with 2929 additions and 2704 deletions
|
|
@ -251,15 +251,9 @@ allprojects {
|
|||
// gradle.
|
||||
options.addStringOption('Xdoclint:all', '-quiet')
|
||||
|
||||
// TODO: Add
|
||||
|
||||
// Treat warnings as errors.
|
||||
// See also https://bugs.openjdk.java.net/browse/JDK-8200363
|
||||
// options.addStringOption('Xwerror', '-quiet')
|
||||
|
||||
// after all javadoc warnings have been resolved and
|
||||
// remove Xwerror from the subprojects build.gradle files
|
||||
// (e.g. smack-android-extensions).
|
||||
options.addStringOption('Xwerror', '-quiet')
|
||||
}
|
||||
}
|
||||
tasks.withType(Javadoc) {
|
||||
|
|
|
|||
133
resources/fix-a-javadoc.sh
Executable file
133
resources/fix-a-javadoc.sh
Executable file
|
|
@ -0,0 +1,133 @@
|
|||
#!/usr/bin/env bash
|
||||
|
||||
set -e
|
||||
|
||||
# Pretty fancy method to get reliable the absolute path of a shell
|
||||
# script, *even if it is sourced*. Credits go to GreenFox on
|
||||
# stackoverflow: http://stackoverflow.com/a/12197518/194894
|
||||
pushd . > /dev/null
|
||||
SCRIPTDIR="${BASH_SOURCE[0]}";
|
||||
while([ -h "${SCRIPTDIR}" ]); do
|
||||
cd "`dirname "${SCRIPTDIR}"`"
|
||||
SCRIPTDIR="$(readlink "`basename "${SCRIPTDIR}"`")";
|
||||
done
|
||||
cd "`dirname "${SCRIPTDIR}"`" > /dev/null
|
||||
SCRIPTDIR="`pwd`";
|
||||
popd > /dev/null
|
||||
|
||||
SMACK_DIR=$(readlink "${SCRIPTDIR}"/..)
|
||||
|
||||
FIND_ALL_JAVA_SRC="find ${SMACK_DIR} \
|
||||
-type f \
|
||||
-name *.java \
|
||||
-print"
|
||||
|
||||
declare -A SMACK_EXCEPTIONS
|
||||
SMACK_EXCEPTIONS[NotConnectedException]="if the XMPP connection is not connected."
|
||||
SMACK_EXCEPTIONS[InterruptedException]="if the calling thread was interrupted."
|
||||
SMACK_EXCEPTIONS[XMPPErrorException]="if there was an XMPP error returned."
|
||||
SMACK_EXCEPTIONS[NoResponseException]="if there was no response from the remote entity."
|
||||
SMACK_EXCEPTIONS[NotLoggedInException]="if the XMPP connection is not authenticated."
|
||||
SMACK_EXCEPTIONS[BOSHException]="if an BOSH related error occured."
|
||||
SMACK_EXCEPTIONS[IOException]="if an I/O error occured."
|
||||
SMACK_EXCEPTIONS[SmackException]="if Smack detected an exceptional situation."
|
||||
SMACK_EXCEPTIONS[XMPPException]="if an XMPP protocol error was received."
|
||||
SMACK_EXCEPTIONS[SmackSaslException]="if a SASL specific error occured."
|
||||
SMACK_EXCEPTIONS[SASLErrorException]="if a SASL protocol error was returned."
|
||||
SMACK_EXCEPTIONS[NotAMucServiceException]="if the entity is not a MUC serivce."
|
||||
SMACK_EXCEPTIONS[NoSuchAlgorithmException]="if no such algorithm is available."
|
||||
SMACK_EXCEPTIONS[KeyManagementException]="if there was a key mangement error."
|
||||
SMACK_EXCEPTIONS[XmppStringprepException]="if the provided string is invalid."
|
||||
SMACK_EXCEPTIONS[XmlPullParserException]="if an error in the XML parser occured."
|
||||
SMACK_EXCEPTIONS[SmackParsingException]="if the Smack parser (provider) encountered invalid input."
|
||||
SMACK_EXCEPTIONS[MucNotJoinedException]="if not joined to the Multi-User Chat."
|
||||
SMACK_EXCEPTIONS[MucAlreadyJoinedException]="if already joined the Multi-User Chat."7y
|
||||
SMACK_EXCEPTIONS[NotALeafNodeException]="if a PubSub leaf node operation was attempted on a non-leaf node."
|
||||
SMACK_EXCEPTIONS[FeatureNotSupportedException]="if a requested feature is not supported by the remote entity."
|
||||
SMACK_EXCEPTIONS[MucConfigurationNotSupportedException]="if the requested MUC configuration is not supported by the MUC service."
|
||||
SMACK_EXCEPTIONS[CouldNotConnectToAnyProvidedSocks5Host]="if no connection to any provided stream host could be established"
|
||||
SMACK_EXCEPTIONS[NoSocks5StreamHostsProvided]="if no stream host was provided."
|
||||
SMACK_EXCEPTIONS[SmackMessageException]="if there was an error."
|
||||
SMACK_EXCEPTIONS[SecurityException]="if there was a security violation."
|
||||
SMACK_EXCEPTIONS[InvocationTargetException]="if a reflection-based method or constructor invocation threw."
|
||||
SMACK_EXCEPTIONS[IllegalArgumentException]="if an illegal argument was given."
|
||||
SMACK_EXCEPTIONS[NotAPubSubNodeException]="if a involved node is not a PubSub node."
|
||||
SMACK_EXCEPTIONS[NoAcceptableTransferMechanisms]="if no acceptable transfer mechanisms are available"
|
||||
SMACK_EXCEPTIONS[NoSuchMethodException]="if no such method is declared"
|
||||
SMACK_EXCEPTIONS[Exception]="if an exception occured."
|
||||
SMACK_EXCEPTIONS[TestNotPossibleException]="if the test is not possible."
|
||||
SMACK_EXCEPTIONS[TimeoutException]="if there was a timeout."
|
||||
SMACK_EXCEPTIONS[IllegalStateException]="if an illegal state was encountered"
|
||||
SMACK_EXCEPTIONS[NoSuchPaddingException]="if the requested padding mechanism is not availble."
|
||||
SMACK_EXCEPTIONS[BadPaddingException]="if the input data is not padded properly."
|
||||
SMACK_EXCEPTIONS[InvalidKeyException]="if the key is invalid."
|
||||
SMACK_EXCEPTIONS[IllegalBlockSizeException]="if the input data length is incorrect."
|
||||
SMACK_EXCEPTIONS[InvalidAlgorithmParameterException]="if the provided arguments are invalid."
|
||||
SMACK_EXCEPTIONS[CorruptedOmemoKeyException]="if the OMEMO key is corrupted."
|
||||
SMACK_EXCEPTIONS[CryptoFailedException]="if the OMEMO cryptography failed."
|
||||
SMACK_EXCEPTIONS[CannotEstablishOmemoSessionException]="if no OMEMO session could be established."
|
||||
SMACK_EXCEPTIONS[UntrustedOmemoIdentityException]="if the OMEMO identity is not trusted."
|
||||
|
||||
MODE=""
|
||||
|
||||
while getopts dm: OPTION "$@"; do
|
||||
case $OPTION in
|
||||
d)
|
||||
set -x
|
||||
;;
|
||||
m)
|
||||
MODE=${OPTARG}
|
||||
;;
|
||||
*)
|
||||
echo "Unknown option ${OPTION}"
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
sed_sources() {
|
||||
sedScript=${1}
|
||||
${FIND_ALL_JAVA_SRC} |\
|
||||
xargs sed \
|
||||
--in-place \
|
||||
--follow-symlinks \
|
||||
--regexp-extended \
|
||||
"${sedScript}"
|
||||
}
|
||||
|
||||
show_affected() {
|
||||
echo ${!SMACK_EXCEPTIONS{@}}
|
||||
for exception in ${!SMACK_EXCEPTIONS[@]}; do
|
||||
${FIND_ALL_JAVA_SRC} |\
|
||||
xargs grep " \* @throws $exception$" || true
|
||||
done
|
||||
for exception in ${!SMACK_EXCEPTIONS[@]}; do
|
||||
count=$(${FIND_ALL_JAVA_SRC} |\
|
||||
xargs grep " \* @throws $exception$" | wc -l)
|
||||
echo "$exception $count"
|
||||
done
|
||||
|
||||
}
|
||||
|
||||
fix_affected() {
|
||||
for exception in "${!SMACK_EXCEPTIONS[@]}"; do
|
||||
exceptionJavadoc=${SMACK_EXCEPTIONS[${exception}]}
|
||||
sed_sources "s;@throws ((\w*\.)?${exception})\$;@throws \1 ${exceptionJavadoc};"
|
||||
done
|
||||
}
|
||||
|
||||
add_todo_to_param_and_return() {
|
||||
sed_sources "s;@(param|return) (\w*)\$;@\1 \2 TODO javadoc me please;"
|
||||
}
|
||||
|
||||
case $MODE in
|
||||
show)
|
||||
show_affected
|
||||
;;
|
||||
fix)
|
||||
fix_affected
|
||||
;;
|
||||
*)
|
||||
echo "Unknown mode ${mode}"
|
||||
exit 1
|
||||
esac
|
||||
|
|
@ -7,11 +7,3 @@ dependencies {
|
|||
compile project(':smack-android')
|
||||
compile project(':smack-extensions')
|
||||
}
|
||||
|
||||
if (JavaVersion.current().isJava8Compatible()) {
|
||||
tasks.withType(Javadoc) {
|
||||
// Treat warnings as errors.
|
||||
// See also https://bugs.openjdk.java.net/browse/JDK-8200363
|
||||
options.addStringOption('Xwerror', '-quiet')
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -296,7 +296,7 @@ public class XMPPBOSHConnection extends AbstractXMPPConnection {
|
|||
* Send a HTTP request to the connection manager with the provided body element.
|
||||
*
|
||||
* @param body the body which will be sent.
|
||||
* @throws BOSHException
|
||||
* @throws BOSHException if an BOSH (Bidirectional-streams Over Synchronous HTTP, XEP-0124) related error occurs
|
||||
*/
|
||||
protected void send(ComposableBody body) throws BOSHException {
|
||||
if (!connected) {
|
||||
|
|
|
|||
|
|
@ -36,7 +36,7 @@ public class PacketReaderTest extends SmackTestCase {
|
|||
/**
|
||||
* Constructor for PacketReaderTest.
|
||||
*
|
||||
* @param arg0
|
||||
* @param arg0 TODO javadoc me please
|
||||
*/
|
||||
public PacketReaderTest(String arg0) {
|
||||
super(arg0);
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ public class RosterSmackTest extends SmackTestCase {
|
|||
|
||||
/**
|
||||
* Constructor for RosterSmackTest.
|
||||
* @param name
|
||||
* @param name TODO javadoc me please
|
||||
*/
|
||||
public RosterSmackTest(String name) {
|
||||
super(name);
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ public class MockPacket extends Packet {
|
|||
|
||||
/**
|
||||
* Returns null always.
|
||||
* @return null
|
||||
* @return null TODO javadoc me please
|
||||
*/
|
||||
public String toXML() {
|
||||
return null;
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@ public class PrivacyProviderTest extends SmackTestCase {
|
|||
|
||||
/**
|
||||
* Constructor for PrivacyTest.
|
||||
* @param arg0
|
||||
* @param arg0 TODO javadoc me please
|
||||
*/
|
||||
public PrivacyProviderTest(String arg0) {
|
||||
super(arg0);
|
||||
|
|
|
|||
|
|
@ -503,7 +503,7 @@ public abstract class SmackTestCase extends TestCase {
|
|||
/**
|
||||
* Subscribes all connections with each other: They all become friends
|
||||
*
|
||||
* @throws XMPPException
|
||||
* @throws XMPPException if an XMPP protocol error was received.
|
||||
*/
|
||||
protected void letsAllBeFriends() throws XMPPException {
|
||||
ConnectionUtils.letsAllBeFriends(connections);
|
||||
|
|
|
|||
|
|
@ -488,9 +488,9 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
*
|
||||
* @throws XMPPException if an error occurs on the XMPP protocol level.
|
||||
* @throws SmackException if an error occurs somewhere else besides XMPP protocol level.
|
||||
* @throws IOException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @return a reference to this object, to chain <code>connect()</code> with <code>login()</code>.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public synchronized AbstractXMPPConnection connect() throws SmackException, IOException, XMPPException, InterruptedException {
|
||||
// Check if not already connected
|
||||
|
|
@ -528,10 +528,10 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* way of XMPP connection establishment. Implementations are required to perform an automatic
|
||||
* login if the previous connection state was logged (authenticated).
|
||||
*
|
||||
* @throws SmackException
|
||||
* @throws IOException
|
||||
* @throws XMPPException
|
||||
* @throws InterruptedException
|
||||
* @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 InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
protected abstract void connectInternal() throws SmackException, IOException, XMPPException, InterruptedException;
|
||||
|
||||
|
|
@ -563,7 +563,7 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* @throws XMPPException if an error occurs on the XMPP protocol level.
|
||||
* @throws SmackException if an error occurs somewhere else besides XMPP protocol level.
|
||||
* @throws IOException if an I/O error occurs during login.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public synchronized void login() throws XMPPException, SmackException, IOException, InterruptedException {
|
||||
// The previously used username, password and resource take over precedence over the
|
||||
|
|
@ -578,12 +578,12 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* Same as {@link #login(CharSequence, String, Resourcepart)}, but takes the resource from the connection
|
||||
* configuration.
|
||||
*
|
||||
* @param username
|
||||
* @param password
|
||||
* @throws XMPPException
|
||||
* @throws SmackException
|
||||
* @throws IOException
|
||||
* @throws InterruptedException
|
||||
* @param username TODO javadoc me please
|
||||
* @param password TODO javadoc me please
|
||||
* @throws XMPPException if an XMPP protocol error was received.
|
||||
* @throws SmackException if Smack detected an exceptional situation.
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @see #login
|
||||
*/
|
||||
public synchronized void login(CharSequence username, String password) throws XMPPException, SmackException,
|
||||
|
|
@ -595,13 +595,13 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* Login with the given username (authorization identity). You may omit the password if a callback handler is used.
|
||||
* If resource is null, then the server will generate one.
|
||||
*
|
||||
* @param username
|
||||
* @param password
|
||||
* @param resource
|
||||
* @throws XMPPException
|
||||
* @throws SmackException
|
||||
* @throws IOException
|
||||
* @throws InterruptedException
|
||||
* @param username TODO javadoc me please
|
||||
* @param password TODO javadoc me please
|
||||
* @param resource TODO javadoc me please
|
||||
* @throws XMPPException if an XMPP protocol error was received.
|
||||
* @throws SmackException if Smack detected an exceptional situation.
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @see #login
|
||||
*/
|
||||
public synchronized void login(CharSequence username, String password, Resourcepart resource) throws XMPPException,
|
||||
|
|
@ -847,7 +847,7 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* presence stanza with whatever data is set.
|
||||
*
|
||||
* @param unavailablePresence the optional presence stanza to send during shutdown.
|
||||
* @throws NotConnectedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
*/
|
||||
public synchronized void disconnect(Presence unavailablePresence) throws NotConnectedException {
|
||||
if (unavailablePresence != null) {
|
||||
|
|
@ -1277,7 +1277,7 @@ public abstract class AbstractXMPPConnection implements XMPPConnection {
|
|||
* they are a match with the filter.
|
||||
*
|
||||
* @param stanza the stanza to process.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
protected void processStanza(final Stanza stanza) throws InterruptedException {
|
||||
assert stanza != null;
|
||||
|
|
|
|||
|
|
@ -40,8 +40,8 @@ public abstract class AbstractXmppNioConnection extends AbstractXmppStateMachine
|
|||
* Set the interest Ops of a SelectionKey. Since Java's NIO interestOps(int) can block at any time, we use a queue
|
||||
* to perform the actual operation in the reactor where we can perform this operation non-blocking.
|
||||
*
|
||||
* @param selectionKey
|
||||
* @param interestOps
|
||||
* @param selectionKey TODO javadoc me please
|
||||
* @param interestOps TODO javadoc me please
|
||||
*/
|
||||
protected void setInterestOps(SelectionKey selectionKey, int interestOps) {
|
||||
SMACK_REACTOR.setInterestOps(selectionKey, interestOps);
|
||||
|
|
|
|||
|
|
@ -544,7 +544,7 @@ public abstract class ConnectionConfiguration {
|
|||
/**
|
||||
* Check if the given SASL mechansism is enabled in this connection configuration.
|
||||
*
|
||||
* @param saslMechanism
|
||||
* @param saslMechanism TODO javadoc me please
|
||||
* @return true if the given SASL mechanism is enabled, false otherwise.
|
||||
*/
|
||||
public boolean isEnabledSaslMechanism(String saslMechanism) {
|
||||
|
|
@ -642,8 +642,8 @@ public abstract class ConnectionConfiguration {
|
|||
* Although most services will follow that pattern.
|
||||
* </p>
|
||||
*
|
||||
* @param jid
|
||||
* @param password
|
||||
* @param jid TODO javadoc me please
|
||||
* @param password TODO javadoc me please
|
||||
* @return a reference to this builder.
|
||||
* @since 4.4.0
|
||||
*/
|
||||
|
|
@ -916,7 +916,7 @@ public abstract class ConnectionConfiguration {
|
|||
/**
|
||||
* Set the enabled SSL/TLS protocols.
|
||||
*
|
||||
* @param enabledSSLProtocols
|
||||
* @param enabledSSLProtocols TODO javadoc me please
|
||||
* @return a reference to this builder.
|
||||
*/
|
||||
public B setEnabledSSLProtocols(String[] enabledSSLProtocols) {
|
||||
|
|
@ -939,7 +939,7 @@ public abstract class ConnectionConfiguration {
|
|||
* Set the HostnameVerifier used to verify the hostname of SSLSockets used by XMPP connections
|
||||
* created with this ConnectionConfiguration.
|
||||
*
|
||||
* @param verifier
|
||||
* @param verifier TODO javadoc me please
|
||||
* @return a reference to this builder.
|
||||
*/
|
||||
public B setHostnameVerifier(HostnameVerifier verifier) {
|
||||
|
|
|
|||
|
|
@ -61,7 +61,7 @@ public final class ReconnectionManager {
|
|||
/**
|
||||
* Get a instance of ReconnectionManager for the given connection.
|
||||
*
|
||||
* @param connection
|
||||
* @param connection TODO javadoc me please
|
||||
* @return a ReconnectionManager for the connection.
|
||||
*/
|
||||
public static synchronized ReconnectionManager getInstanceFor(AbstractXMPPConnection connection) {
|
||||
|
|
@ -90,7 +90,7 @@ public final class ReconnectionManager {
|
|||
* Set if the automatic reconnection mechanism will be enabled per default for new XMPP connections. The default is
|
||||
* 'false'.
|
||||
*
|
||||
* @param enabled
|
||||
* @param enabled TODO javadoc me please
|
||||
*/
|
||||
public static void setEnabledPerDefault(boolean enabled) {
|
||||
enabledPerDefault = enabled;
|
||||
|
|
@ -132,7 +132,7 @@ public final class ReconnectionManager {
|
|||
/**
|
||||
* Set the default Reconnection Policy to use.
|
||||
*
|
||||
* @param reconnectionPolicy
|
||||
* @param reconnectionPolicy TODO javadoc me please
|
||||
*/
|
||||
public static void setDefaultReconnectionPolicy(ReconnectionPolicy reconnectionPolicy) {
|
||||
defaultReconnectionPolicy = reconnectionPolicy;
|
||||
|
|
@ -173,7 +173,7 @@ public final class ReconnectionManager {
|
|||
/**
|
||||
* Set the Reconnection Policy to use.
|
||||
*
|
||||
* @param reconnectionPolicy
|
||||
* @param reconnectionPolicy TODO javadoc me please
|
||||
*/
|
||||
public void setReconnectionPolicy(ReconnectionPolicy reconnectionPolicy) {
|
||||
this.reconnectionPolicy = reconnectionPolicy;
|
||||
|
|
|
|||
|
|
@ -183,13 +183,13 @@ public final class SASLAuthentication {
|
|||
* @param authzid the authorization identifier (typically null).
|
||||
* @param sslSession the optional SSL/TLS session (if one was established)
|
||||
* @return the used SASLMechanism.
|
||||
* @throws XMPPErrorException
|
||||
* @throws SASLErrorException
|
||||
* @throws IOException
|
||||
* @throws InterruptedException
|
||||
* @throws SmackSaslException
|
||||
* @throws NotConnectedException
|
||||
* @throws NoResponseException
|
||||
* @throws XMPPErrorException if there was an XMPP error returned.
|
||||
* @throws SASLErrorException if a SASL protocol error was returned.
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @throws SmackSaslException if a SASL specific error occured.
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws NoResponseException if there was no response from the remote entity.
|
||||
*/
|
||||
public SASLMechanism authenticate(String username, String password, EntityBareJid authzid, SSLSession sslSession)
|
||||
throws XMPPErrorException, SASLErrorException, IOException,
|
||||
|
|
@ -239,8 +239,8 @@ public final class SASLAuthentication {
|
|||
* to <code>false</code>.
|
||||
*
|
||||
* @param challenge a base64 encoded string representing the challenge.
|
||||
* @throws SmackException
|
||||
* @throws InterruptedException
|
||||
* @throws SmackException if Smack detected an exceptional situation.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public void challengeReceived(String challenge) throws SmackException, InterruptedException {
|
||||
challengeReceived(challenge, false);
|
||||
|
|
@ -254,9 +254,9 @@ public final class SASLAuthentication {
|
|||
*
|
||||
* @param challenge a base64 encoded string representing the challenge.
|
||||
* @param finalChallenge true if this is the last challenge send by the server within the success stanza
|
||||
* @throws SmackSaslException
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws SmackSaslException if a SASL specific error occured.
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public void challengeReceived(String challenge, boolean finalChallenge) throws SmackSaslException, NotConnectedException, InterruptedException {
|
||||
try {
|
||||
|
|
@ -271,8 +271,8 @@ public final class SASLAuthentication {
|
|||
* Notification message saying that SASL authentication was successful. The next step
|
||||
* would be to bind the resource.
|
||||
* @param success result of the authentication.
|
||||
* @throws SmackException
|
||||
* @throws InterruptedException
|
||||
* @throws SmackException if Smack detected an exceptional situation.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public void authenticated(Success success) throws SmackException, InterruptedException {
|
||||
// RFC6120 6.3.10 "At the end of the authentication exchange, the SASL server (the XMPP
|
||||
|
|
|
|||
|
|
@ -241,7 +241,7 @@ public final class SmackConfiguration {
|
|||
/**
|
||||
* Set the default parsing exception callback for all newly created connections.
|
||||
*
|
||||
* @param callback
|
||||
* @param callback TODO javadoc me please
|
||||
* @see ParsingExceptionCallback
|
||||
*/
|
||||
public static void setDefaultParsingExceptionCallback(ParsingExceptionCallback callback) {
|
||||
|
|
@ -265,13 +265,20 @@ public final class SmackConfiguration {
|
|||
/**
|
||||
* Get compression handlers.
|
||||
*
|
||||
* @return a list of compression handlers.
|
||||
* @deprecated use {@link #getCompressionHandlers()} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
// TODO: Remove in Smack 4.4.
|
||||
public static List<XMPPInputOutputStream> getCompresionHandlers() {
|
||||
return getCompressionHandlers();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get compression handlers.
|
||||
*
|
||||
* @return a list of compression handlers.
|
||||
*/
|
||||
public static List<XMPPInputOutputStream> getCompressionHandlers() {
|
||||
List<XMPPInputOutputStream> res = new ArrayList<>(compressionHandlers.size());
|
||||
for (XMPPInputOutputStream ios : compressionHandlers) {
|
||||
|
|
@ -310,7 +317,7 @@ public final class SmackConfiguration {
|
|||
* package is disabled (but can be manually enabled).
|
||||
* </p>
|
||||
*
|
||||
* @param className
|
||||
* @param className TODO javadoc me please
|
||||
*/
|
||||
public static void addDisabledSmackClass(String className) {
|
||||
disabledSmackClasses.add(className);
|
||||
|
|
|
|||
|
|
@ -292,7 +292,7 @@ public abstract class SmackFuture<V, E extends Exception> implements Future<V>,
|
|||
* A simple version of InternalSmackFuture which implements isNonFatalException(E) as always returning
|
||||
* <code>false</code> method.
|
||||
*
|
||||
* @param <V>
|
||||
* @param <V> the return value of the future.
|
||||
*/
|
||||
public abstract static class SimpleInternalProcessStanzaSmackFuture<V, E extends Exception>
|
||||
extends InternalProcessStanzaSmackFuture<V, E> {
|
||||
|
|
|
|||
|
|
@ -148,7 +148,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
*
|
||||
* @param <P> type of the result stanza.
|
||||
* @return the next available packet.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
@SuppressWarnings("unchecked")
|
||||
// TODO: Consider removing this method as it is hardly ever useful.
|
||||
|
|
@ -173,7 +173,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
*
|
||||
* @param <P> type of the result stanza.
|
||||
* @return the next available packet.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public <P extends Stanza> P nextResult() throws InterruptedException {
|
||||
return nextResult(connection.getReplyTimeout());
|
||||
|
|
@ -189,7 +189,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
* @param <P> type of the result stanza.
|
||||
* @param timeout the timeout in milliseconds.
|
||||
* @return the next available stanza or <code>null</code> on timeout or connection error.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
@SuppressWarnings("unchecked")
|
||||
public <P extends Stanza> P nextResult(long timeout) throws InterruptedException {
|
||||
|
|
@ -219,8 +219,8 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
* @return the next available stanza.
|
||||
* @throws XMPPErrorException in case an error response was received.
|
||||
* @throws NoResponseException if there was no response from the server.
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @see #nextResultOrThrow(long)
|
||||
*/
|
||||
public <P extends Stanza> P nextResultOrThrow() throws NoResponseException, XMPPErrorException,
|
||||
|
|
@ -387,7 +387,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
* Set the stanza filter used by this collector. If <code>null</code>, then all stanzas will
|
||||
* get collected by this collector.
|
||||
*
|
||||
* @param stanzaFilter
|
||||
* @param stanzaFilter TODO javadoc me please
|
||||
* @return a reference to this configuration.
|
||||
*/
|
||||
public Configuration setStanzaFilter(StanzaFilter stanzaFilter) {
|
||||
|
|
@ -399,7 +399,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
* Set the maximum size of this collector, i.e. how many stanzas this collector will collect
|
||||
* before dropping old ones.
|
||||
*
|
||||
* @param size
|
||||
* @param size TODO javadoc me please
|
||||
* @return a reference to this configuration.
|
||||
*/
|
||||
public Configuration setSize(int size) {
|
||||
|
|
@ -411,7 +411,7 @@ public final class StanzaCollector implements AutoCloseable {
|
|||
* Set the collector which timeout for the next result is reset once this collector collects
|
||||
* a packet.
|
||||
*
|
||||
* @param collector
|
||||
* @param collector TODO javadoc me please
|
||||
* @return a reference to this configuration.
|
||||
*/
|
||||
public Configuration setCollectorToReset(StanzaCollector collector) {
|
||||
|
|
|
|||
|
|
@ -48,9 +48,9 @@ public interface StanzaListener {
|
|||
* </p>
|
||||
*
|
||||
* @param packet the stanza to process.
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws NotLoggedInException
|
||||
* @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.
|
||||
*/
|
||||
void processStanza(Stanza packet) throws NotConnectedException, InterruptedException, NotLoggedInException;
|
||||
|
||||
|
|
|
|||
|
|
@ -140,7 +140,7 @@ public class SynchronizationPoint<E extends Exception> {
|
|||
/**
|
||||
* Check if this synchronization point is successful or wait the connections reply timeout.
|
||||
* @throws NoResponseException if there was no response marking the synchronization point as success or failed.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @return <code>null</code> if synchronization point was successful, or the failure Exception.
|
||||
*/
|
||||
public Exception checkIfSuccessOrWait() throws NoResponseException, InterruptedException {
|
||||
|
|
@ -281,7 +281,7 @@ public class SynchronizationPoint<E extends Exception> {
|
|||
* {@link #reportSuccess()}, {@link #reportFailure()} and {@link #reportFailure(Exception)} will either set this
|
||||
* synchronization point to {@link State#Success} or {@link State#Failure}. If none of them is set after the
|
||||
* connections reply timeout, this method will set the state of {@link State#NoResponse}.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
private void waitForConditionOrTimeout() throws InterruptedException {
|
||||
waitStart = System.currentTimeMillis();
|
||||
|
|
@ -324,7 +324,7 @@ public class SynchronizationPoint<E extends Exception> {
|
|||
* The exception is thrown, if state is one of 'Initial', 'NoResponse' or 'RequestSent'
|
||||
* </p>
|
||||
* @return <code>true</code> if synchronization point was successful, <code>false</code> on failure.
|
||||
* @throws NoResponseException
|
||||
* @throws NoResponseException if there was no response from the remote entity.
|
||||
*/
|
||||
private Exception checkForResponse() throws NoResponseException {
|
||||
switch (state) {
|
||||
|
|
|
|||
|
|
@ -183,7 +183,7 @@ public interface XMPPConnection {
|
|||
*
|
||||
* @param stanza the stanza to send.
|
||||
* @throws NotConnectedException if the connection is not connected.
|
||||
* @throws InterruptedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* */
|
||||
void sendStanza(Stanza stanza) throws NotConnectedException, InterruptedException;
|
||||
|
||||
|
|
@ -234,8 +234,8 @@ public interface XMPPConnection {
|
|||
* </p>
|
||||
*
|
||||
* @param nonza the Nonza to send.
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
void sendNonza(Nonza nonza) throws NotConnectedException, InterruptedException;
|
||||
|
||||
|
|
@ -258,11 +258,12 @@ public interface XMPPConnection {
|
|||
* Send an IQ request and wait for the response.
|
||||
*
|
||||
* @param request the IQ request
|
||||
* @param <I> the type of the expected result IQ.
|
||||
* @return an IQ with type 'result'
|
||||
* @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.3
|
||||
*/
|
||||
<I extends IQ> I sendIqRequestAndWaitForResponse(IQ request)
|
||||
|
|
@ -276,8 +277,8 @@ public interface XMPPConnection {
|
|||
*
|
||||
* @param request the IQ request to filter responses from
|
||||
* @return a new stanza collector.
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
StanzaCollector createStanzaCollectorAndSend(IQ request) throws NotConnectedException, InterruptedException;
|
||||
|
||||
|
|
@ -290,8 +291,8 @@ public interface XMPPConnection {
|
|||
* @param stanzaFilter the stanza filter to use.
|
||||
* @param stanza the stanza to send right after the collector got created
|
||||
* @return a new stanza collector.
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
*/
|
||||
StanzaCollector createStanzaCollectorAndSend(StanzaFilter stanzaFilter, Stanza stanza)
|
||||
throws NotConnectedException, InterruptedException;
|
||||
|
|
@ -498,7 +499,7 @@ public interface XMPPConnection {
|
|||
* Set the FromMode for this connection instance. Defines how the 'from' attribute of outgoing
|
||||
* stanzas should be populated by Smack.
|
||||
*
|
||||
* @param fromMode
|
||||
* @param fromMode TODO javadoc me please
|
||||
*/
|
||||
void setFromMode(FromMode fromMode);
|
||||
|
||||
|
|
@ -514,8 +515,8 @@ public interface XMPPConnection {
|
|||
* server, or <code>null</code> if the server doesn't support that feature.
|
||||
*
|
||||
* @param <F> {@link ExtensionElement} type of the feature.
|
||||
* @param element
|
||||
* @param namespace
|
||||
* @param element TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return a stanza extensions of the feature or <code>null</code>
|
||||
*/
|
||||
<F extends FullyQualifiedElement> F getFeature(String element, String namespace);
|
||||
|
|
@ -523,8 +524,8 @@ public interface XMPPConnection {
|
|||
/**
|
||||
* Return true if the server supports the given stream feature.
|
||||
*
|
||||
* @param element
|
||||
* @param namespace
|
||||
* @param element TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return true if the server supports the stream feature.
|
||||
*/
|
||||
boolean hasFeature(String element, String namespace);
|
||||
|
|
@ -552,6 +553,7 @@ public interface XMPPConnection {
|
|||
*
|
||||
* @param stanza the stanza to send.
|
||||
* @param replyFilter the filter used for the response stanza.
|
||||
* @param <S> the type of the stanza to send.
|
||||
* @return a SmackFuture for the response.
|
||||
*/
|
||||
<S extends Stanza> SmackFuture<S, Exception> sendAsync(S stanza, StanzaFilter replyFilter);
|
||||
|
|
@ -562,6 +564,7 @@ public interface XMPPConnection {
|
|||
* @param stanza the stanza to send.
|
||||
* @param replyFilter the filter used for the response stanza.
|
||||
* @param timeout the reply timeout in milliseconds.
|
||||
* @param <S> the type of the stanza to send.
|
||||
* @return a SmackFuture for the response.
|
||||
*/
|
||||
<S extends Stanza> SmackFuture<S, Exception> sendAsync(S stanza, StanzaFilter replyFilter, long timeout);
|
||||
|
|
@ -588,7 +591,7 @@ public interface XMPPConnection {
|
|||
/**
|
||||
* Convenience method for {@link #unregisterIQRequestHandler(String, String, org.jivesoftware.smack.packet.IQ.Type)}.
|
||||
*
|
||||
* @param iqRequestHandler
|
||||
* @param iqRequestHandler TODO javadoc me please
|
||||
* @return the previously registered IQ request handler or null.
|
||||
*/
|
||||
IQRequestHandler unregisterIQRequestHandler(IQRequestHandler iqRequestHandler);
|
||||
|
|
|
|||
|
|
@ -86,17 +86,6 @@ public abstract class XMPPException extends Exception {
|
|||
*/
|
||||
private final Stanza request;
|
||||
|
||||
/**
|
||||
* Creates a new XMPPErrorException with the given builder.
|
||||
*
|
||||
* @param xmppErrorBuilder
|
||||
* @deprecated Use {@link #XMPPErrorException(Stanza, StanzaError)} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
public XMPPErrorException(StanzaError.Builder xmppErrorBuilder) {
|
||||
this(null, xmppErrorBuilder.build());
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a new XMPPErrorException with the XMPPError that was the root case of the exception.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -76,7 +76,7 @@ public class Java7ZlibInputOutputStream extends XMPPInputOutputStream {
|
|||
* byte without blocking, 0 means that the system is known to block for more input.
|
||||
*
|
||||
* @return 0 if no data is available, 1 otherwise
|
||||
* @throws IOException
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
@Override
|
||||
public int available() throws IOException {
|
||||
|
|
|
|||
|
|
@ -30,7 +30,7 @@ public abstract class XMPPInputOutputStream {
|
|||
* Only use sync flush if you fully understand the implications.
|
||||
*
|
||||
* @see <a href="https://blog.thijsalkema.de/blog/2014/08/07/https-attacks-and-xmpp-2-crime-and-breach/">Attacks against XMPP when using compression</a>
|
||||
* @param flushMethod
|
||||
* @param flushMethod TODO javadoc me please
|
||||
*/
|
||||
public static void setFlushMethod(FlushMethod flushMethod) {
|
||||
XMPPInputOutputStream.flushMethod = flushMethod;
|
||||
|
|
|
|||
|
|
@ -36,7 +36,7 @@ public abstract class AbstractFromToMatchesFilter implements StanzaFilter {
|
|||
*
|
||||
* @param address The address to filter for. If <code>null</code> is given, then
|
||||
* {@link #getAddressToCompare(Stanza)} must also return <code>null</code> to match.
|
||||
* @param ignoreResourcepart
|
||||
* @param ignoreResourcepart TODO javadoc me please
|
||||
*/
|
||||
protected AbstractFromToMatchesFilter(Jid address, boolean ignoreResourcepart) {
|
||||
if (address != null && ignoreResourcepart) {
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ public final class FromMatchesFilter extends AbstractFromToMatchesFilter {
|
|||
*
|
||||
* @param address The address to filter for. If <code>null</code> is given, the stanza must not
|
||||
* have a from address.
|
||||
* @param ignoreResourcepart
|
||||
* @param ignoreResourcepart TODO javadoc me please
|
||||
*/
|
||||
public FromMatchesFilter(Jid address, boolean ignoreResourcepart) {
|
||||
super(address, ignoreResourcepart);
|
||||
|
|
|
|||
|
|
@ -61,7 +61,7 @@ public class PacketExtensionFilter implements StanzaFilter {
|
|||
/**
|
||||
* Creates a new stanza extension filter for the given stanza extension.
|
||||
*
|
||||
* @param packetExtension
|
||||
* @param packetExtension TODO javadoc me please
|
||||
*/
|
||||
public PacketExtensionFilter(ExtensionElement packetExtension) {
|
||||
this(packetExtension.getElementName(), packetExtension.getNamespace());
|
||||
|
|
|
|||
|
|
@ -59,7 +59,7 @@ public class StanzaExtensionFilter implements StanzaFilter {
|
|||
/**
|
||||
* Creates a new stanza extension filter for the given stanza extension.
|
||||
*
|
||||
* @param packetExtension
|
||||
* @param packetExtension TODO javadoc me please
|
||||
*/
|
||||
public StanzaExtensionFilter(ExtensionElement packetExtension) {
|
||||
this(packetExtension.getElementName(), packetExtension.getNamespace());
|
||||
|
|
|
|||
|
|
@ -431,6 +431,7 @@ public abstract class AbstractXmppStateMachineConnection extends AbstractXMPPCon
|
|||
/**
|
||||
* Check if the state should be activated.
|
||||
*
|
||||
* @param walkStateGraphContext the context of the current state graph walk.
|
||||
* @return <code>null</code> if the state should be activated.
|
||||
* @throws SmackException in case a Smack exception occurs.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -252,14 +252,6 @@ public abstract class IQ extends Stanza {
|
|||
*/
|
||||
protected abstract IQChildElementXmlStringBuilder getIQChildElementBuilder(IQChildElementXmlStringBuilder xml);
|
||||
|
||||
/**
|
||||
* @deprecated use {@link #initializeAsResultFor(IQ)} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
protected final void initialzeAsResultFor(IQ request) {
|
||||
initializeAsResultFor(request);
|
||||
}
|
||||
|
||||
protected final void initializeAsResultFor(IQ request) {
|
||||
assert this != request;
|
||||
|
||||
|
|
|
|||
|
|
@ -46,7 +46,6 @@ import org.jxmpp.stringprep.XmppStringprepException;
|
|||
* </ul>
|
||||
*
|
||||
* For each message type, different message fields are typically used as follows:
|
||||
* <p>
|
||||
* <table border="1">
|
||||
* <caption>Message Types</caption>
|
||||
* <tr><td> </td><td colspan="5"><b>Message type</b></td></tr>
|
||||
|
|
@ -120,8 +119,8 @@ public final class Message extends Stanza implements TypedCloneable<Message> {
|
|||
/**
|
||||
* Creates a new message with the specified recipient and extension element.
|
||||
*
|
||||
* @param to
|
||||
* @param extensionElement
|
||||
* @param to TODO javadoc me please
|
||||
* @param extensionElement TODO javadoc me please
|
||||
* @since 4.2
|
||||
*/
|
||||
public Message(Jid to, ExtensionElement extensionElement) {
|
||||
|
|
@ -136,7 +135,7 @@ public final class Message extends Stanza implements TypedCloneable<Message> {
|
|||
* instance.
|
||||
* </p>
|
||||
*
|
||||
* @param other
|
||||
* @param other TODO javadoc me please
|
||||
*/
|
||||
public Message(Message other) {
|
||||
super(other);
|
||||
|
|
|
|||
|
|
@ -56,7 +56,7 @@ public interface Packet extends TopLevelStreamElement {
|
|||
|
||||
/**
|
||||
* Set the stanza ID.
|
||||
* @param packetID
|
||||
* @param packetID TODO javadoc me please
|
||||
* @deprecated use {@link #setStanzaId(String)} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
|
|
@ -195,8 +195,8 @@ public interface Packet extends TopLevelStreamElement {
|
|||
* The argument <code>elementName</code> may be null.
|
||||
* </p>
|
||||
*
|
||||
* @param elementName
|
||||
* @param namespace
|
||||
* @param elementName TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return true if a stanza extension exists, false otherwise.
|
||||
*/
|
||||
boolean hasExtension(String elementName, String namespace);
|
||||
|
|
@ -204,7 +204,7 @@ public interface Packet extends TopLevelStreamElement {
|
|||
/**
|
||||
* Check if a stanza extension with the given namespace exists.
|
||||
*
|
||||
* @param namespace
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return true if a stanza extension exists, false otherwise.
|
||||
*/
|
||||
boolean hasExtension(String namespace);
|
||||
|
|
@ -212,8 +212,8 @@ public interface Packet extends TopLevelStreamElement {
|
|||
/**
|
||||
* Remove the stanza extension with the given elementName and namespace.
|
||||
*
|
||||
* @param elementName
|
||||
* @param namespace
|
||||
* @param elementName TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return the removed stanza extension or null.
|
||||
*/
|
||||
ExtensionElement removeExtension(String elementName, String namespace);
|
||||
|
|
|
|||
|
|
@ -124,7 +124,7 @@ public final class Presence extends Stanza implements TypedCloneable<Presence> {
|
|||
* instance.
|
||||
* </p>
|
||||
*
|
||||
* @param other
|
||||
* @param other TODO javadoc me please
|
||||
*/
|
||||
public Presence(Presence other) {
|
||||
super(other);
|
||||
|
|
|
|||
|
|
@ -130,7 +130,7 @@ public abstract class Stanza implements TopLevelStreamElement {
|
|||
|
||||
/**
|
||||
* Set the stanza ID.
|
||||
* @param packetID
|
||||
* @param packetID TODO javadoc me please
|
||||
* @deprecated use {@link #setStanzaId(String)} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
|
|
@ -422,8 +422,8 @@ public abstract class Stanza implements TopLevelStreamElement {
|
|||
* The argument <code>elementName</code> may be null.
|
||||
* </p>
|
||||
*
|
||||
* @param elementName
|
||||
* @param namespace
|
||||
* @param elementName TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return true if a stanza extension exists, false otherwise.
|
||||
*/
|
||||
public boolean hasExtension(String elementName, String namespace) {
|
||||
|
|
@ -439,7 +439,7 @@ public abstract class Stanza implements TopLevelStreamElement {
|
|||
/**
|
||||
* Check if a stanza extension with the given namespace exists.
|
||||
*
|
||||
* @param namespace
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return true if a stanza extension exists, false otherwise.
|
||||
*/
|
||||
public boolean hasExtension(String namespace) {
|
||||
|
|
@ -456,8 +456,8 @@ public abstract class Stanza implements TopLevelStreamElement {
|
|||
/**
|
||||
* Remove the stanza extension with the given elementName and namespace.
|
||||
*
|
||||
* @param elementName
|
||||
* @param namespace
|
||||
* @param elementName TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @return the removed stanza extension or null.
|
||||
*/
|
||||
public ExtensionElement removeExtension(String elementName, String namespace) {
|
||||
|
|
@ -546,6 +546,7 @@ public abstract class Stanza implements TopLevelStreamElement {
|
|||
* Append an XMPPError is this stanza has one set.
|
||||
*
|
||||
* @param xml the XmlStringBuilder to append the error to.
|
||||
* @param enclosingXmlEnvironment the enclosing XML environment.
|
||||
*/
|
||||
protected void appendErrorIfExists(XmlStringBuilder xml, XmlEnvironment enclosingXmlEnvironment) {
|
||||
StanzaError error = getError();
|
||||
|
|
|
|||
|
|
@ -29,7 +29,7 @@ import org.jivesoftware.smack.util.XmlStringBuilder;
|
|||
/**
|
||||
* Represents an XMPP error sub-packet. Typically, a server responds to a request that has
|
||||
* problems by sending the stanza back and including an error packet. Each error has a type,
|
||||
* error condition as well as as an optional text explanation. Typical errors are:<p>
|
||||
* error condition as well as as an optional text explanation. Typical errors are:
|
||||
*
|
||||
* <table border=1>
|
||||
* <caption>XMPP Errors</caption>
|
||||
|
|
@ -116,9 +116,9 @@ public class StanzaError extends AbstractError implements ExtensionElement {
|
|||
*
|
||||
* @param type the error type.
|
||||
* @param condition the error condition.
|
||||
* @param conditionText
|
||||
* @param errorGenerator
|
||||
* @param descriptiveTexts
|
||||
* @param conditionText TODO javadoc me please
|
||||
* @param errorGenerator TODO javadoc me please
|
||||
* @param descriptiveTexts TODO javadoc me please
|
||||
* @param extensions list of stanza extensions
|
||||
* @param stanza the stanza carrying this XMPP error.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ import org.jivesoftware.smack.util.XmlStringBuilder;
|
|||
/**
|
||||
* Represents a stream error packet. Stream errors are unrecoverable errors where the server
|
||||
* will close the underlying TCP connection after the stream error was sent to the client.
|
||||
* These is the list of stream errors as defined in the XMPP spec:<p>
|
||||
* These is the list of stream errors as defined in the XMPP spec:
|
||||
*
|
||||
* <table border=1>
|
||||
* <caption>Stream Errors</caption>
|
||||
|
|
|
|||
|
|
@ -39,7 +39,7 @@ public interface ParsingExceptionCallback {
|
|||
* Called when parsing a stanza caused an exception.
|
||||
*
|
||||
* @param stanzaData the raw stanza data that caused the exception
|
||||
* @throws IOException
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
void handleUnparsableStanza(UnparseableStanza stanzaData) throws IOException;
|
||||
|
||||
|
|
|
|||
|
|
@ -140,8 +140,8 @@ public abstract class SASLMechanism implements Comparable<SASLMechanism> {
|
|||
* @param authzid the optional authorization identity.
|
||||
* @param sslSession the optional SSL/TLS session (if one was established)
|
||||
* @throws SmackSaslException if a SASL related error occurs.
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public final void authenticate(String username, String host, DomainBareJid serviceName, String password,
|
||||
EntityBareJid authzid, SSLSession sslSession)
|
||||
|
|
@ -170,8 +170,8 @@ public abstract class SASLMechanism implements Comparable<SASLMechanism> {
|
|||
* @param authzid the optional authorization identity.
|
||||
* @param sslSession the optional SSL/TLS session (if one was established)
|
||||
* @throws SmackSaslException if a SASL related error occurs.
|
||||
* @throws NotConnectedException
|
||||
* @throws InterruptedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
* @throws InterruptedException if the calling thread was interrupted.
|
||||
*/
|
||||
public void authenticate(String host, DomainBareJid serviceName, CallbackHandler cbh, EntityBareJid authzid, SSLSession sslSession)
|
||||
throws SmackSaslException, NotConnectedException, InterruptedException {
|
||||
|
|
@ -210,7 +210,7 @@ public abstract class SASLMechanism implements Comparable<SASLMechanism> {
|
|||
* empty array here.
|
||||
*
|
||||
* @return the initial response or null
|
||||
* @throws SmackSaslException
|
||||
* @throws SmackSaslException if a SASL specific error occured.
|
||||
*/
|
||||
protected abstract byte[] getAuthenticationText() throws SmackSaslException;
|
||||
|
||||
|
|
@ -222,7 +222,7 @@ public abstract class SASLMechanism implements Comparable<SASLMechanism> {
|
|||
* @param finalChallenge true if this is the last challenge send by the server within the success stanza
|
||||
* @throws SmackSaslException if a SASL related error occurs.
|
||||
* @throws InterruptedException if the connection is interrupted
|
||||
* @throws NotConnectedException
|
||||
* @throws NotConnectedException if the XMPP connection is not connected.
|
||||
*/
|
||||
public final void challengeReceived(String challengeString, boolean finalChallenge) throws SmackSaslException, InterruptedException, NotConnectedException {
|
||||
byte[] challenge = Base64.decode((challengeString != null && challengeString.equals("=")) ? "" : challengeString);
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
/**
|
||||
*
|
||||
* Copyright 2016 Florian Schmaus
|
||||
* Copyright 2016-2019 Florian Schmaus
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
|
|
@ -25,10 +25,10 @@ public interface ScramHmac {
|
|||
/**
|
||||
* RFC 5802 § 2.2 HMAC(key, str).
|
||||
*
|
||||
* @param key
|
||||
* @param str
|
||||
* @param key TODO javadoc me please
|
||||
* @param str TODO javadoc me please
|
||||
* @return the HMAC-SHA1 value of the input.
|
||||
* @throws InvalidKeyException
|
||||
* @throws InvalidKeyException in case there was an invalid key.
|
||||
*/
|
||||
byte[] hmac(byte[] key, byte[] str) throws InvalidKeyException;
|
||||
|
||||
|
|
|
|||
|
|
@ -259,7 +259,7 @@ public abstract class ScramMechanism extends SASLMechanism {
|
|||
/**
|
||||
*
|
||||
* @return the Channel Binding data.
|
||||
* @throws SmackSaslException
|
||||
* @throws SmackSaslException if a SASL specific error occured.
|
||||
*/
|
||||
protected byte[] getChannelBindingData() throws SmackSaslException {
|
||||
return null;
|
||||
|
|
@ -327,7 +327,7 @@ public abstract class ScramMechanism extends SASLMechanism {
|
|||
* "The characters ',' or '=' in usernames are sent as '=2C' and '=3D' respectively."
|
||||
* </p>
|
||||
*
|
||||
* @param string
|
||||
* @param string TODO javadoc me please
|
||||
* @return the escaped string
|
||||
*/
|
||||
private static String escape(String string) {
|
||||
|
|
@ -352,10 +352,10 @@ public abstract class ScramMechanism extends SASLMechanism {
|
|||
/**
|
||||
* RFC 5802 § 2.2 HMAC(key, str)
|
||||
*
|
||||
* @param key
|
||||
* @param str
|
||||
* @param key TODO javadoc me please
|
||||
* @param str TODO javadoc me please
|
||||
* @return the HMAC-SHA1 value of the input.
|
||||
* @throws SmackException
|
||||
* @throws SmackException if Smack detected an exceptional situation.
|
||||
*/
|
||||
private byte[] hmac(byte[] key, byte[] str) throws SmackSaslException {
|
||||
try {
|
||||
|
|
@ -374,8 +374,8 @@ public abstract class ScramMechanism extends SASLMechanism {
|
|||
* </p>
|
||||
*
|
||||
* @param normalizedPassword the normalized password.
|
||||
* @param salt
|
||||
* @param iterations
|
||||
* @param salt TODO javadoc me please
|
||||
* @param iterations TODO javadoc me please
|
||||
* @return the result of the Hi function.
|
||||
* @throws SmackSaslException if a SASL related error occurs.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@ public class Async {
|
|||
/**
|
||||
* Creates a new thread with the given Runnable, marks it daemon, starts it and returns the started thread.
|
||||
*
|
||||
* @param runnable
|
||||
* @param runnable TODO javadoc me please
|
||||
* @return the started thread.
|
||||
*/
|
||||
public static Thread go(Runnable runnable) {
|
||||
|
|
@ -37,7 +37,7 @@ public class Async {
|
|||
* Creates a new thread with the given Runnable, marks it daemon, sets the name, starts it and returns the started
|
||||
* thread.
|
||||
*
|
||||
* @param runnable
|
||||
* @param runnable TODO javadoc me please
|
||||
* @param threadName the thread name.
|
||||
* @return the started thread.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
/**
|
||||
*
|
||||
* Copyright © 2014 Florian Schmaus
|
||||
* Copyright © 2014-2019 Florian Schmaus
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
|
|
@ -21,13 +21,11 @@ public class ByteUtils {
|
|||
/**
|
||||
* Concatenate two byte arrays.
|
||||
*
|
||||
* @deprecated use {@link #concat(byte[], byte[])} instead.
|
||||
* @param arrayOne the first input array.
|
||||
* @param arrayTwo the second input array
|
||||
* @return the concatenation of the first and second input array.
|
||||
*
|
||||
*/
|
||||
@Deprecated
|
||||
public static byte[] concact(byte[] arrayOne, byte[] arrayTwo) {
|
||||
return concat(arrayOne, arrayTwo);
|
||||
}
|
||||
|
||||
public static byte[] concat(byte[] arrayOne, byte[] arrayTwo) {
|
||||
int combinedLength = arrayOne.length + arrayTwo.length;
|
||||
byte[] res = new byte[combinedLength];
|
||||
|
|
@ -35,4 +33,5 @@ public class ByteUtils {
|
|||
System.arraycopy(arrayTwo, 0, res, arrayOne.length, arrayTwo.length);
|
||||
return res;
|
||||
}
|
||||
|
||||
}
|
||||
|
|
|
|||
|
|
@ -51,7 +51,7 @@ public class DNSUtil {
|
|||
/**
|
||||
* Set the DNS resolver that should be used to perform DNS lookups.
|
||||
*
|
||||
* @param resolver
|
||||
* @param resolver TODO javadoc me please
|
||||
*/
|
||||
public static void setDNSResolver(DNSResolver resolver) {
|
||||
dnsResolver = Objects.requireNonNull(resolver);
|
||||
|
|
@ -69,7 +69,7 @@ public class DNSUtil {
|
|||
/**
|
||||
* Set the DANE provider that should be used when DANE is enabled.
|
||||
*
|
||||
* @param daneProvider
|
||||
* @param daneProvider TODO javadoc me please
|
||||
*/
|
||||
public static void setDaneProvider(SmackDaneProvider daneProvider) {
|
||||
DNSUtil.daneProvider = Objects.requireNonNull(daneProvider);
|
||||
|
|
@ -189,7 +189,7 @@ public class DNSUtil {
|
|||
* Note that we follow the RFC with one exception. In a group of the same priority, only the first entry
|
||||
* is calculated by random. The others are ore simply ordered by their priority.
|
||||
*
|
||||
* @param records
|
||||
* @param records TODO javadoc me please
|
||||
* @return the list of resolved HostAddresses
|
||||
*/
|
||||
private static List<HostAddress> sortSRVRecords(List<SRVRecord> records) {
|
||||
|
|
|
|||
|
|
@ -47,7 +47,7 @@ public class EventManger<K, R, E extends Exception> {
|
|||
* @param action the action to perform prior waiting for the event, must not be null.
|
||||
* @return the event value, may be null.
|
||||
* @throws InterruptedException if interrupted while waiting for the event.
|
||||
* @throws E
|
||||
* @throws E depending on the concrete use case.
|
||||
*/
|
||||
public R performActionAndWaitForEvent(K eventKey, long timeout, Callback<E> action) throws InterruptedException, E {
|
||||
final Reference<R> reference = new Reference<>();
|
||||
|
|
|
|||
|
|
@ -108,9 +108,9 @@ public final class FileUtils {
|
|||
/**
|
||||
* Reads the contents of a File.
|
||||
*
|
||||
* @param file
|
||||
* @param file TODO javadoc me please
|
||||
* @return the content of file or null in case of an error
|
||||
* @throws IOException
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
@SuppressWarnings("DefaultCharset")
|
||||
public static String readFileOrThrow(File file) throws IOException {
|
||||
|
|
|
|||
|
|
@ -93,7 +93,7 @@ public class MultiMap<K, V> {
|
|||
/**
|
||||
* Get the first value for the given key, or <code>null</code> if there are no entries.
|
||||
*
|
||||
* @param key
|
||||
* @param key TODO javadoc me please
|
||||
* @return the first value or null.
|
||||
*/
|
||||
public V getFirst(K key) {
|
||||
|
|
@ -111,7 +111,7 @@ public class MultiMap<K, V> {
|
|||
* Changes to the returned set will update the underlying MultiMap if the return set is not empty.
|
||||
* </p>
|
||||
*
|
||||
* @param key
|
||||
* @param key TODO javadoc me please
|
||||
* @return all values for the given key.
|
||||
*/
|
||||
public List<V> getAll(K key) {
|
||||
|
|
@ -140,7 +140,7 @@ public class MultiMap<K, V> {
|
|||
/**
|
||||
* Removes all mappings for the given key and returns the first value if there where mappings or <code>null</code> if not.
|
||||
*
|
||||
* @param key
|
||||
* @param key TODO javadoc me please
|
||||
* @return the first value of the given key or null.
|
||||
*/
|
||||
public V remove(K key) {
|
||||
|
|
@ -158,8 +158,8 @@ public class MultiMap<K, V> {
|
|||
* Returns <code>true</code> if the mapping was removed and <code>false</code> if the mapping did not exist.
|
||||
* </p>
|
||||
*
|
||||
* @param key
|
||||
* @param value
|
||||
* @param key TODO javadoc me please
|
||||
* @param value TODO javadoc me please
|
||||
* @return true if the mapping was removed, false otherwise.
|
||||
*/
|
||||
public boolean removeOne(K key, V value) {
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ public class NumberUtil {
|
|||
/**
|
||||
* Checks if the given long is within the range of an unsigned 32-bit integer, the XML type "xs:unsignedInt".
|
||||
*
|
||||
* @param value
|
||||
* @param value TODO javadoc me please
|
||||
* @deprecated use {@link #requireUInt32(long)} instead.
|
||||
*/
|
||||
@Deprecated
|
||||
|
|
@ -33,7 +33,8 @@ public class NumberUtil {
|
|||
/**
|
||||
* Checks if the given long is within the range of an unsigned 32-bit integer, the XML type "xs:unsignedInt".
|
||||
*
|
||||
* @param value
|
||||
* @param value TODO javadoc me please
|
||||
* @return the input value.
|
||||
*/
|
||||
public static long requireUInt32(long value) {
|
||||
if (value < 0) {
|
||||
|
|
@ -48,7 +49,8 @@ public class NumberUtil {
|
|||
/**
|
||||
* Checks if the given int is within the range of an unsigned 16-bit integer, the XML type "xs:unsignedShort".
|
||||
*
|
||||
* @param value
|
||||
* @param value TODO javadoc me please
|
||||
* @return the input value.
|
||||
*/
|
||||
public static int requireUShort16(int value) {
|
||||
if (value < 0) {
|
||||
|
|
|
|||
|
|
@ -54,7 +54,7 @@ public class Objects {
|
|||
* @param collection collection
|
||||
* @param message error message
|
||||
* @param <T> Collection type
|
||||
* @return collection
|
||||
* @return collection TODO javadoc me please
|
||||
*/
|
||||
public static <T extends Collection<?>> T requireNonNullNorEmpty(T collection, String message) {
|
||||
if (requireNonNull(collection).isEmpty()) {
|
||||
|
|
|
|||
|
|
@ -99,12 +99,12 @@ public class PacketParserUtils {
|
|||
*
|
||||
* connection is optional and is used to return feature-not-implemented errors for unknown IQ stanzas.
|
||||
*
|
||||
* @param parser
|
||||
* @param parser TODO javadoc me please
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return a stanza which is either a Message, IQ or Presence.
|
||||
* @throws XmlPullParserException
|
||||
* @throws SmackParsingException
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
public static Stanza parseStanza(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, SmackParsingException, IOException {
|
||||
ParserUtils.assertAtStartTag(parser);
|
||||
|
|
@ -131,9 +131,9 @@ public class PacketParserUtils {
|
|||
* @param parser the XML parser, positioned at the start of a message packet.
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return a Message packet.
|
||||
* @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.
|
||||
*/
|
||||
public static Message parseMessage(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, IOException, SmackParsingException {
|
||||
ParserUtils.assertAtStartTag(parser);
|
||||
|
|
@ -212,10 +212,10 @@ public class PacketParserUtils {
|
|||
* This method is used for the parts where the XMPP specification requires elements that contain
|
||||
* only text or are the empty element.
|
||||
*
|
||||
* @param parser
|
||||
* @param parser TODO javadoc me please
|
||||
* @return the textual content of the element as String
|
||||
* @throws XmlPullParserException
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
public static String parseElementText(XmlPullParser parser) throws XmlPullParserException, IOException {
|
||||
assert parser.getEventType() == XmlPullParser.Event.START_ELEMENT;
|
||||
|
|
@ -253,8 +253,8 @@ public class PacketParserUtils {
|
|||
*
|
||||
* @param parser the XML pull parser
|
||||
* @return the element as string
|
||||
* @throws XmlPullParserException
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
public static CharSequence parseElement(XmlPullParser parser) throws XmlPullParserException, IOException {
|
||||
return parseElement(parser, false);
|
||||
|
|
@ -288,12 +288,12 @@ public class PacketParserUtils {
|
|||
* In particular Android's XmlPullParser does not support XML_ROUNDTRIP.
|
||||
* </p>
|
||||
*
|
||||
* @param parser
|
||||
* @param depth
|
||||
* @param fullNamespaces
|
||||
* @param parser TODO javadoc me please
|
||||
* @param depth TODO javadoc me please
|
||||
* @param fullNamespaces TODO javadoc me please
|
||||
* @return the content of the current depth
|
||||
* @throws XmlPullParserException
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
public static CharSequence parseContentDepth(XmlPullParser parser, int depth, boolean fullNamespaces) throws XmlPullParserException, IOException {
|
||||
if (parser.supportsRoundtrip()) {
|
||||
|
|
@ -418,9 +418,9 @@ public class PacketParserUtils {
|
|||
* @param parser the XML parser, positioned at the start of a presence packet.
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return a Presence packet.
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException
|
||||
* @throws SmackParsingException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
|
||||
*/
|
||||
public static Presence parsePresence(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, IOException, SmackParsingException {
|
||||
ParserUtils.assertAtStartTag(parser);
|
||||
|
|
@ -511,10 +511,10 @@ public class PacketParserUtils {
|
|||
* @param parser the XML parser, positioned at the start of an IQ packet.
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return an IQ object.
|
||||
* @throws XmlPullParserException
|
||||
* @throws XmppStringprepException
|
||||
* @throws IOException
|
||||
* @throws SmackParsingException
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws XmppStringprepException if the provided string is invalid.
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
|
||||
*/
|
||||
public static IQ parseIQ(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, XmppStringprepException, IOException, SmackParsingException {
|
||||
ParserUtils.assertAtStartTag(parser);
|
||||
|
|
@ -596,8 +596,8 @@ public class PacketParserUtils {
|
|||
*
|
||||
* @param parser the XML parser, positioned at the start of the mechanisms stanza.
|
||||
* @return a collection of Stings with the mechanisms included in the mechanisms stanza.
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
*/
|
||||
public static Collection<String> parseMechanisms(XmlPullParser parser)
|
||||
throws XmlPullParserException, IOException {
|
||||
|
|
@ -626,7 +626,7 @@ public class PacketParserUtils {
|
|||
*
|
||||
* @param parser the XML parser, positioned at the start of the compression stanza.
|
||||
* @return The CompressionFeature stream element
|
||||
* @throws IOException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an exception occurs while parsing the stanza.
|
||||
*/
|
||||
public static Compress.Feature parseCompressionFeature(XmlPullParser parser)
|
||||
|
|
@ -688,8 +688,8 @@ public class PacketParserUtils {
|
|||
*
|
||||
* @param parser the XML parser.
|
||||
* @return a SASL Failure packet.
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
*/
|
||||
public static SASLFailure parseSASLFailure(XmlPullParser parser) throws XmlPullParserException, IOException {
|
||||
final int initialDepth = parser.getDepth();
|
||||
|
|
@ -731,9 +731,9 @@ public class PacketParserUtils {
|
|||
* @param parser the XML parser.
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return an stream error packet.
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException
|
||||
* @throws SmackParsingException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
|
||||
*/
|
||||
public static StreamError parseStreamError(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, IOException, SmackParsingException {
|
||||
final int initialDepth = parser.getDepth();
|
||||
|
|
@ -793,9 +793,9 @@ public class PacketParserUtils {
|
|||
* @param parser the XML parser.
|
||||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
* @return an error sub-packet.
|
||||
* @throws IOException
|
||||
* @throws XmlPullParserException
|
||||
* @throws SmackParsingException
|
||||
* @throws IOException if an I/O error occured.
|
||||
* @throws XmlPullParserException if an error in the XML parser occured.
|
||||
* @throws SmackParsingException if the Smack parser (provider) encountered invalid input.
|
||||
*/
|
||||
public static StanzaError.Builder parseError(XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, IOException, SmackParsingException {
|
||||
final int initialDepth = parser.getDepth();
|
||||
|
|
@ -856,9 +856,9 @@ public class PacketParserUtils {
|
|||
* @param outerXmlEnvironment the outer XML environment (optional).
|
||||
*
|
||||
* @return an extension element.
|
||||
* @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.
|
||||
*/
|
||||
public static ExtensionElement parseExtensionElement(String elementName, String namespace,
|
||||
XmlPullParser parser, XmlEnvironment outerXmlEnvironment) throws XmlPullParserException, IOException, SmackParsingException {
|
||||
|
|
|
|||
|
|
@ -24,10 +24,10 @@ public class PacketUtil {
|
|||
|
||||
/**
|
||||
* Get a extension element from a collection.
|
||||
* @param collection
|
||||
* @param element
|
||||
* @param namespace
|
||||
* @param <PE>
|
||||
* @param collection TODO javadoc me please
|
||||
* @param element TODO javadoc me please
|
||||
* @param namespace TODO javadoc me please
|
||||
* @param <PE> the type of the extension element.
|
||||
* @return the extension element
|
||||
* @deprecated use {@link #extensionElementFrom(Collection, String, String)} instead.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -156,8 +156,8 @@ public class ParserUtils {
|
|||
/**
|
||||
* Get the boolean value of an argument.
|
||||
*
|
||||
* @param parser
|
||||
* @param name
|
||||
* @param parser TODO javadoc me please
|
||||
* @param name TODO javadoc me please
|
||||
* @return the boolean value or null of no argument of the given name exists
|
||||
*/
|
||||
public static Boolean getBooleanAttribute(XmlPullParser parser, String name) {
|
||||
|
|
|
|||
|
|
@ -390,7 +390,7 @@ public class StringUtils {
|
|||
/**
|
||||
* Returns true if the given CharSequence is null or empty.
|
||||
*
|
||||
* @param cs
|
||||
* @param cs TODO javadoc me please
|
||||
* @return true if the given CharSequence is null or empty
|
||||
*/
|
||||
public static boolean isNullOrEmpty(CharSequence cs) {
|
||||
|
|
@ -430,7 +430,7 @@ public class StringUtils {
|
|||
/**
|
||||
* Returns true if the given CharSequence is empty.
|
||||
*
|
||||
* @param cs
|
||||
* @param cs TODO javadoc me please
|
||||
* @return true if the given CharSequence is empty
|
||||
*/
|
||||
public static boolean isEmpty(CharSequence cs) {
|
||||
|
|
@ -498,7 +498,7 @@ public class StringUtils {
|
|||
* @param cs CharSequence
|
||||
* @param message error message
|
||||
* @param <CS> CharSequence type
|
||||
* @return cs
|
||||
* @return cs TODO javadoc me please
|
||||
*/
|
||||
@Deprecated
|
||||
public static <CS extends CharSequence> CS requireNotNullOrEmpty(CS cs, String message) {
|
||||
|
|
@ -511,7 +511,7 @@ public class StringUtils {
|
|||
* @param cs CharSequence
|
||||
* @param message error message
|
||||
* @param <CS> CharSequence type
|
||||
* @return cs
|
||||
* @return cs TODO javadoc me please
|
||||
*/
|
||||
public static <CS extends CharSequence> CS requireNotNullNorEmpty(CS cs, String message) {
|
||||
if (isNullOrEmpty(cs)) {
|
||||
|
|
|
|||
|
|
@ -99,8 +99,8 @@ public class TLSUtils {
|
|||
*
|
||||
* @param builder a connection configuration builder.
|
||||
* @param <B> Type of the ConnectionConfiguration builder.
|
||||
* @throws NoSuchAlgorithmException
|
||||
* @throws KeyManagementException
|
||||
* @throws NoSuchAlgorithmException if no such algorithm is available.
|
||||
* @throws KeyManagementException if there was a key mangement error.
|
||||
* @return the given builder.
|
||||
*/
|
||||
public static <B extends ConnectionConfiguration.Builder<B, ?>> B acceptAllCertificates(B builder) throws NoSuchAlgorithmException, KeyManagementException {
|
||||
|
|
@ -184,9 +184,9 @@ public class TLSUtils {
|
|||
*
|
||||
* @param sslSession the SSL/TLS session from which the data should be retrieved.
|
||||
* @return the channel binding data.
|
||||
* @throws SSLPeerUnverifiedException
|
||||
* @throws CertificateEncodingException
|
||||
* @throws NoSuchAlgorithmException
|
||||
* @throws SSLPeerUnverifiedException if we TLS peer could not be verified.
|
||||
* @throws CertificateEncodingException if there was an encoding error with the certificate.
|
||||
* @throws NoSuchAlgorithmException if no such algorithm is available.
|
||||
* @see <a href="https://tools.ietf.org/html/rfc5929#section-4">RFC 5929 § 4.</a>
|
||||
*/
|
||||
public static byte[] getChannelBindingTlsServerEndPoint(final SSLSession sslSession)
|
||||
|
|
|
|||
|
|
@ -72,8 +72,8 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
/**
|
||||
* Add a new element to this builder.
|
||||
*
|
||||
* @param name
|
||||
* @param content
|
||||
* @param name TODO javadoc me please
|
||||
* @param content TODO javadoc me please
|
||||
* @return the XmlStringBuilder
|
||||
*/
|
||||
public XmlStringBuilder element(String name, String content) {
|
||||
|
|
@ -102,8 +102,8 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
/**
|
||||
* Add a new element to this builder.
|
||||
*
|
||||
* @param name
|
||||
* @param content
|
||||
* @param name TODO javadoc me please
|
||||
* @param content TODO javadoc me please
|
||||
* @return the XmlStringBuilder
|
||||
*/
|
||||
public XmlStringBuilder element(String name, CharSequence content) {
|
||||
|
|
@ -234,8 +234,8 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
/**
|
||||
* Does nothing if value is null.
|
||||
*
|
||||
* @param name
|
||||
* @param value
|
||||
* @param name TODO javadoc me please
|
||||
* @param value TODO javadoc me please
|
||||
* @return the XmlStringBuilder
|
||||
*/
|
||||
public XmlStringBuilder attribute(String name, String value) {
|
||||
|
|
@ -347,8 +347,8 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
/**
|
||||
* Add the given attribute if {@code value => 0}.
|
||||
*
|
||||
* @param name
|
||||
* @param value
|
||||
* @param name TODO javadoc me please
|
||||
* @param value TODO javadoc me please
|
||||
* @return a reference to this object
|
||||
*/
|
||||
public XmlStringBuilder optIntAttribute(String name, int value) {
|
||||
|
|
@ -361,8 +361,8 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
/**
|
||||
* Add the given attribute if value not null and {@code value => 0}.
|
||||
*
|
||||
* @param name
|
||||
* @param value
|
||||
* @param name TODO javadoc me please
|
||||
* @param value TODO javadoc me please
|
||||
* @return a reference to this object
|
||||
*/
|
||||
public XmlStringBuilder optLongAttribute(String name, Long value) {
|
||||
|
|
@ -586,8 +586,9 @@ public class XmlStringBuilder implements Appendable, CharSequence, Element {
|
|||
* the single parts one-by-one, avoiding allocation of a big continuous memory block holding the
|
||||
* XmlStringBuilder contents.
|
||||
*
|
||||
* @param writer
|
||||
* @throws IOException
|
||||
* @param writer TODO javadoc me please
|
||||
* @param enclosingNamespace the enclosing XML namespace.
|
||||
* @throws IOException if an I/O error occured.
|
||||
*/
|
||||
public void write(Writer writer, String enclosingNamespace) throws IOException {
|
||||
for (CharSequence csq : sb.getAsList()) {
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ public class IQResponseTest {
|
|||
|
||||
/**
|
||||
* Test creating a simple and empty IQ response.
|
||||
* @throws XmppStringprepException
|
||||
* @throws XmppStringprepException if the provided string is invalid.
|
||||
*/
|
||||
@Test
|
||||
public void testGeneratingSimpleResponse() throws XmppStringprepException {
|
||||
|
|
@ -58,7 +58,7 @@ public class IQResponseTest {
|
|||
|
||||
/**
|
||||
* Test creating a error response based on an IQ request.
|
||||
* @throws XmppStringprepException
|
||||
* @throws XmppStringprepException if the provided string is invalid.
|
||||
*/
|
||||
@Test
|
||||
public void testGeneratingValidErrorResponse() throws XmppStringprepException {
|
||||
|
|
@ -83,7 +83,7 @@ public class IQResponseTest {
|
|||
/**
|
||||
* According to <a href="http://xmpp.org/rfcs/rfc3920.html#stanzas-semantics-iq"
|
||||
* >RFC3920: IQ Semantics</a> we shouldn't respond to an IQ of type result.
|
||||
* @throws XmppStringprepException
|
||||
* @throws XmppStringprepException if the provided string is invalid.
|
||||
*/
|
||||
@Test
|
||||
public void testGeneratingResponseBasedOnResult() throws XmppStringprepException {
|
||||
|
|
@ -106,7 +106,7 @@ public class IQResponseTest {
|
|||
/**
|
||||
* According to <a href="http://xmpp.org/rfcs/rfc3920.html#stanzas-semantics-iq"
|
||||
* >RFC3920: IQ Semantics</a> we shouldn't respond to an IQ of type error.
|
||||
* @throws XmppStringprepException
|
||||
* @throws XmppStringprepException if the provided string is invalid.
|
||||
*/
|
||||
@Test
|
||||
public void testGeneratingErrorBasedOnError() throws XmppStringprepException {
|
||||
|
|
|
|||
|
|
@ -676,7 +676,7 @@ public class PacketParserUtilsTest {
|
|||
* RFC6121 5.2.3 explicitly disallows mixed content in <body/> elements. Make sure that we throw
|
||||
* an exception if we encounter such an element.
|
||||
*
|
||||
* @throws Exception
|
||||
* @throws Exception if an exception occurs.
|
||||
*/
|
||||
@Test
|
||||
public void invalidMessageBodyContainingTagTest() throws Exception {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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) {
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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) {
|
||||
|
|
|
|||
|
|
@ -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,
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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) {
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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) {
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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;
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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) {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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();
|
||||
|
|
|
|||
|
|
@ -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);
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ public class GroupChatInvitationTest extends SmackTestCase {
|
|||
|
||||
/**
|
||||
* Constructor for GroupChatInvitationTest.
|
||||
* @param arg0
|
||||
* @param arg0 TODO javadoc me please
|
||||
*/
|
||||
public GroupChatInvitationTest(String arg0) {
|
||||
super(arg0);
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ public class RosterExchangeManagerTest extends SmackTestCase {
|
|||
|
||||
/**
|
||||
* Constructor for RosterExchangeManagerTest.
|
||||
* @param name
|
||||
* @param name TODO javadoc me please
|
||||
*/
|
||||
public RosterExchangeManagerTest(String name) {
|
||||
super(name);
|
||||
|
|
|
|||
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue