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

Fix all javadoc warnings

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

13
extensions/src/main/java/org/jivesoftware/smackx/bytestreams/socks5/Socks5Proxy.java
View file

@ -35,20 +35,15 @@ import java.util.concurrent.ConcurrentHashMap;
import java.util.logging.Level;
import java.util.logging.Logger;
import org.jivesoftware.smack.SmackConfiguration;
import org.jivesoftware.smack.XMPPException;
/**
* The Socks5Proxy class represents a local SOCKS5 proxy server. It can be enabled/disabled by
* setting the <code>localSocks5ProxyEnabled</code> flag in the <code>smack-config.xml</code> or by
* invoking {@link SmackConfiguration#setLocalSocks5ProxyEnabled(boolean)}. The proxy is enabled by
* default.
* invoking {@link #setLocalSocks5ProxyEnabled(boolean)}. The proxy is enabled by default.
* <p>
* The port of the local SOCKS5 proxy can be configured by setting <code>localSocks5ProxyPort</code>
* in the <code>smack-config.xml</code> or by invoking
* {@link SmackConfiguration#setLocalSocks5ProxyPort(int)}. Default port is 7777. If you set the
* port to a negative value Smack tries to the absolute value and all following until it finds an
* open port.
* The port of the local SOCKS5 proxy can be configured by invoking
* {@link #setLocalSocks5ProxyPort(int)}. Default port is 7777. If you set the port to a negative
* value Smack tries to the absolute value and all following until it finds an open port.
* <p>
* If your application is running on a machine with multiple network interfaces or if you want to
* provide your public address in case you are behind a NAT router, invoke

25
extensions/src/main/java/org/jivesoftware/smackx/caps/EntityCapsManager.java
View file

@ -136,7 +136,7 @@ public class EntityCapsManager extends Manager {
* Get the Node version (node#ver) of a JID. Returns a String or null if
* EntiyCapsManager does not have any information.
*
* @param user
* @param jid
* the user (Full JID)
* @return the node version (node#ver) or null
*/
@ -371,7 +371,7 @@ public class EntityCapsManager extends Manager {
* "http://www.igniterealtime.org/projects/smack/#66/0NaeaBKkwk85efJTGmU47vXI=
* )
*
* @return
* @return the local NodeVer
*/
public String getLocalNodeVer() {
return ENTITY_NODE + '#' + getCapsVersion();
@ -381,7 +381,7 @@ public class EntityCapsManager extends Manager {
* Returns true if Entity Caps are supported by a given JID
*
* @param jid
* @return
* @return true if the entity supports Entity Capabilities.
*/
public boolean areEntityCapsSupported(String jid) throws XMPPException {
return sdm.supportsFeature(jid, NAMESPACE);
@ -390,7 +390,7 @@ public class EntityCapsManager extends Manager {
/**
* Returns true if Entity Caps are supported by the local service/server
*
* @return
* @return true if the user's server supports Entity Capabilities.
*/
public boolean areEntityCapsSupportedByServer() throws XMPPException {
return areEntityCapsSupported(connection().getServiceName());
@ -398,19 +398,10 @@ public class EntityCapsManager extends Manager {
/**
* Updates the local user Entity Caps information with the data provided
*
*
* If we are connected and there was already a presence send, another
* presence is send to inform others about your new Entity Caps node string.
*
* @param discoverInfo
* the local users discover info (mostly the service discovery
* features)
* @param identityType
* the local users identity type
* @param identityName
* the local users identity name
* @param extendedInfo
* the local users extended info
*
*/
public void updateLocalEntityCaps() {
XMPPConnection connection = connection();
@ -478,8 +469,8 @@ public class EntityCapsManager extends Manager {
* @see <a href="http://xmpp.org/extensions/xep-0115.html#ver-proc">XEP-0115
* 5.4 Processing Method</a>
*
* @param capsNode
* the caps node (i.e. node#ver)
* @param ver
* @param hash
* @param info
* @return true if it's valid and should be cache, false if not
*/

2
extensions/src/main/java/org/jivesoftware/smackx/caps/cache/SimpleDirectoryPersistentCache.java vendored
View file

@ -138,7 +138,7 @@ public class SimpleDirectoryPersistentCache implements EntityCapsPersistentCache
* Tries to restore an DiscoverInfo packet from a file.
*
* @param file
* @return
* @return the restored DiscoverInfo
* @throws IOException
*/
private static DiscoverInfo restoreInfoFromFile(File file) throws IOException {

23
extensions/src/main/java/org/jivesoftware/smackx/commands/RemoteCommand.java
View file

@ -14,7 +14,6 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.jivesoftware.smackx.commands;
import org.jivesoftware.smack.SmackConfiguration;
@ -156,26 +155,4 @@ public class RemoteCommand extends AdHocCommand {
public String getOwnerJID() {
return jid;
}
/**
* Returns the number of milliseconds to wait for a respone. The
* {@link SmackConfiguration#getPacketReplyTimeout default} value
* should be adjusted for commands that can take a long time to execute.
*
* @return the number of milliseconds to wait for responses.
*/
public long getPacketReplyTimeout() {
return packetReplyTimeout;
}
/**
* Returns the number of milliseconds to wait for a respone. The
* {@link SmackConfiguration#getPacketReplyTimeout default} value
* should be adjusted for commands that can take a long time to execute.
*
* @param packetReplyTimeout the number of milliseconds to wait for responses.
*/
public void setPacketReplyTimeout(long packetReplyTimeout) {
this.packetReplyTimeout = packetReplyTimeout;
}
}

21
extensions/src/main/java/org/jivesoftware/smackx/disco/ServiceDiscoveryManager.java
View file

@ -271,7 +271,7 @@ public class ServiceDiscoveryManager extends Manager {
/**
* Returns all identities of this client as unmodifiable Collection
*
* @return
* @return all identies as set
*/
public Set<DiscoverInfo.Identity> getIdentities() {
Set<Identity> res = new HashSet<Identity>(identities);
@ -454,7 +454,7 @@ public class ServiceDiscoveryManager extends Manager {
* Returns the data form that is set as extended information for this Service Discovery instance (XEP-0128)
*
* @see <a href="http://xmpp.org/extensions/xep-0128.html">XEP-128: Service Discovery Extensions</a>
* @return
* @return the data form
*/
public DataForm getExtendedInfo() {
return extendedInfo;
@ -464,7 +464,7 @@ public class ServiceDiscoveryManager extends Manager {
* Returns the data form as List of PacketExtensions, or null if no data form is set.
* This representation is needed by some classes (e.g. EntityCapsManager, NodeInformationProvider)
*
* @return
* @return the data form as List of PacketExtensions
*/
public List<PacketExtension> getExtendedInfoAsList() {
List<PacketExtension> res = null;
@ -603,7 +603,7 @@ public class ServiceDiscoveryManager extends Manager {
* be returned by the server whenever the server receives a disco request targeted to the bare
* address of the client (i.e. user@host.com).
*
* @param DiscoverInfo the discover info packet to check.
* @param info the discover info packet to check.
* @return true if the server supports publishing of items.
*/
public static boolean canPublishItems(DiscoverInfo info) {
@ -646,11 +646,11 @@ public class ServiceDiscoveryManager extends Manager {
}
/**
* Queries the remote jid for it's features and returns true if the given feature is found.
* Queries the remote entity for it's features and returns true if the given feature is found.
*
* @param jid
* @param jid the JID of the remote entity
* @param feature
* @return
* @return true if the entity supports the feature, false otherwise
* @throws XMPPException
*/
public boolean supportsFeature(String jid, String feature) throws XMPPException {
@ -663,8 +663,8 @@ public class ServiceDiscoveryManager extends Manager {
*/
/**
* Loads the ServiceDiscoveryManager with an EntityCapsManger
* that speeds up certain lookups
* Loads the ServiceDiscoveryManager with an EntityCapsManger that speeds up certain lookups.
*
* @param manager
*/
public void setEntityCapsManager(EntityCapsManager manager) {
@ -672,8 +672,7 @@ public class ServiceDiscoveryManager extends Manager {
}
/**
* Updates the Entity Capabilities Verification String
* if EntityCaps is enabled
* Updates the Entity Capabilities Verification String if EntityCaps is enabled.
*/
private void renewEntityCapsVersion() {
if (capsManager != null && capsManager.entityCapsEnabled())

11
extensions/src/main/java/org/jivesoftware/smackx/disco/packet/DiscoverInfo.java
View file

@ -424,12 +424,13 @@ public class DiscoverInfo extends IQ {
}
/**
* Compares this identity with another one. The comparison order is:
* Category, Type, Lang. If all three are identical the other Identity is considered equal.
* Name is not used for comparision, as defined by XEP-0115
* Compares this identity with another one. The comparison order is: Category, Type, Lang.
* If all three are identical the other Identity is considered equal. Name is not used for
* comparison, as defined by XEP-0115
*
* @param obj
* @return
* @param other
* @return a negative integer, zero, or a positive integer as this object is less than,
* equal to, or greater than the specified object.
*/
public int compareTo(DiscoverInfo.Identity other) {
String otherLang = other.lang == null ? "" : other.lang;

1
extensions/src/main/java/org/jivesoftware/smackx/forward/Forwarded.java
View file

@ -46,7 +46,6 @@ public class Forwarded implements PacketExtension {
/**
* Creates a new Forwarded packet extension.
*
* @param delay an optional {@link DelayInfo} timestamp of the packet.
* @param fwdPacket the packet that is forwarded (required).
*/
public Forwarded(Packet fwdPacket) {

4
extensions/src/main/java/org/jivesoftware/smackx/ping/PingManager.java
View file

@ -218,7 +218,7 @@ public class PingManager extends Manager {
* {@link #isPingSupported(String)} is false.
*
* @param notifyListeners Notify the PingFailedListener in case of error if true
* @return
* @return true if the user's server could be pinged.
*/
public boolean pingMyServer(boolean notifyListeners) {
boolean res = ping(connection().getServiceName());
@ -273,7 +273,7 @@ public class PingManager extends Manager {
* users server. If there was no successful Ping (e.g. because this
* feature is disabled) -1 will be returned.
*
* @return
* @return the timestamp of the last successful ping.
*/
public long getLastSuccessfulPing() {
return Math.max(lastSuccessfulAutomaticPing, lastSuccessfulManualPing);

2
extensions/src/main/java/org/jivesoftware/smackx/privacy/PrivacyList.java
View file

@ -42,7 +42,7 @@ public class PrivacyList {
private final boolean isDefaultList;
/** Holds the list name used to print **/
private final String listName;
/** Holds the list of {@see PrivacyItem} **/
/** Holds the list of {@link PrivacyItem} */
private final List<PrivacyItem> items;
protected PrivacyList(boolean isActiveList, boolean isDefaultList,

2
extensions/src/main/java/org/jivesoftware/smackx/pubsub/Item.java
View file

@ -37,7 +37,7 @@ import org.jivesoftware.smackx.pubsub.provider.ItemProvider;
* <li>Will require payload if the node configuration has {@link ConfigureForm#isDeliverPayloads()} set
* to true.
*
* <p>To customise the payload object being returned from the {@link #getPayload()} method, you can
* <p>To customise the payload object being returned from the {@link PayloadItem#getPayload()} method, you can
* add a custom parser as explained in {@link ItemProvider}.
*
* @author Robin Collier

3
extensions/src/main/java/org/jivesoftware/smackx/pubsub/ItemsExtension.java
View file

@ -82,7 +82,6 @@ public class ItemsExtension extends NodeExtension implements EmbeddedPacketExten
* @param itemsType Type of representation
* @param nodeId The node to which the items are being sent or deleted
* @param items The list of {@link Item} or {@link RetractItem}
* @param attributeValue The value of the <b>max_items</b>
*/
public ItemsExtension(ItemsElementType itemsType, String nodeId, List<? extends PacketExtension> items)
{
@ -104,10 +103,8 @@ public class ItemsExtension extends NodeExtension implements EmbeddedPacketExten
* <li>Items deleted event - itemsType = {@link ItemsElementType#items}, items = list of {@link RetractItem} and
* attributeValue = <code>null</code>
*
* @param itemsType Type of representation
* @param nodeId The node to which the items are being sent or deleted
* @param items The list of {@link Item} or {@link RetractItem}
* @param attributeValue The value of the <b>max_items</b>
*/
public ItemsExtension(String nodeId, List<? extends PacketExtension> items, boolean notify)
{

2
extensions/src/main/java/org/jivesoftware/smackx/pubsub/SimplePayload.java
View file

@ -19,7 +19,7 @@ package org.jivesoftware.smackx.pubsub;
import org.jivesoftware.smack.packet.PacketExtension;
/**
* The default payload representation for {@link Item#getPayload()}. It simply
* The default payload representation for {@link PayloadItem#getPayload()}. It simply
* stores the XML payload as a string.
*
* @author Robin Collier

4
extensions/src/main/java/org/jivesoftware/smackx/time/packet/Time.java
View file

@ -27,10 +27,10 @@ import java.util.logging.Logger;
/**
* A Time IQ packet, which is used by XMPP clients to exchange their respective local
* times. Clients that wish to fully support the entitity time protocol should register
* times. Clients that wish to fully support the entity time protocol should register
* a PacketListener for incoming time requests that then respond with the local time.
*
* @see http://www.xmpp.org/extensions/xep-0202.html
* @see <a href="http://www.xmpp.org/extensions/xep-0202.html">XEP-202</a>
* @author Florian Schmaus
*/
public class Time extends IQ {

2
extensions/src/main/java/org/jivesoftware/smackx/xdata/packet/DataForm.java
View file

@ -197,7 +197,7 @@ public class DataForm implements PacketExtension {
* Returns true if this DataForm has at least one FORM_TYPE field which is
* hidden. This method is used for sanity checks.
*
* @return
* @return true if there is at least one field which is hidden.
*/
public boolean hasHiddenFormTypeField() {
boolean found = false;