diff options
| author | Sebastien Vincent <seb@jitsi.org> | 2010-10-04 09:33:50 +0000 |
|---|---|---|
| committer | Sebastien Vincent <seb@jitsi.org> | 2010-10-04 09:33:50 +0000 |
| commit | 303c3dfbd6a2ef57a2ea7ffacc49dcf7aea62c90 (patch) | |
| tree | 6442696d17ffa6a496b014185aa68cf0904cdc99 /src/net/java/sip/communicator/service | |
| parent | f7078b197ba877dc981592b927886f8d9a7fd143 (diff) | |
| download | jitsi-303c3dfbd6a2ef57a2ea7ffacc49dcf7aea62c90.zip jitsi-303c3dfbd6a2ef57a2ea7ffacc49dcf7aea62c90.tar.gz jitsi-303c3dfbd6a2ef57a2ea7ffacc49dcf7aea62c90.tar.bz2 | |
Fixes warnings and javadocs.
Diffstat (limited to 'src/net/java/sip/communicator/service')
111 files changed, 801 insertions, 244 deletions
diff --git a/src/net/java/sip/communicator/service/argdelegation/UriHandler.java b/src/net/java/sip/communicator/service/argdelegation/UriHandler.java index d533dc1..65d6f7d 100644 --- a/src/net/java/sip/communicator/service/argdelegation/UriHandler.java +++ b/src/net/java/sip/communicator/service/argdelegation/UriHandler.java @@ -23,6 +23,8 @@ public interface UriHandler /** * Returns the protocol that this handler is responsible for. + * + * @return protocol that this handler is responsible for */ public String getProtocol(); diff --git a/src/net/java/sip/communicator/service/audionotifier/AudioNotifierService.java b/src/net/java/sip/communicator/service/audionotifier/AudioNotifierService.java index fbe69ec..75e0f63 100644 --- a/src/net/java/sip/communicator/service/audionotifier/AudioNotifierService.java +++ b/src/net/java/sip/communicator/service/audionotifier/AudioNotifierService.java @@ -26,11 +26,15 @@ public interface AudioNotifierService /** * Destroys the given audio. + * + * @param audio <tt>SCAudioClip</tt> to destroy */ public void destroyAudio(SCAudioClip audio); /** * Stops/Restores all currently playing sounds. + * + * @param isMute mute or not currently playing sounds */ public void setMute(boolean isMute); diff --git a/src/net/java/sip/communicator/service/audionotifier/SCAudioClip.java b/src/net/java/sip/communicator/service/audionotifier/SCAudioClip.java index c5b51b5..4e5a6c0 100644 --- a/src/net/java/sip/communicator/service/audionotifier/SCAudioClip.java +++ b/src/net/java/sip/communicator/service/audionotifier/SCAudioClip.java @@ -9,22 +9,23 @@ package net.java.sip.communicator.service.audionotifier; /** * SCAudioClip represents an audio clip created using the AudioNotifierService. * Like any audio it could be played, stopped or played in loop. - * + * * @author Yana Stamcheva */ public interface SCAudioClip -{ +{ /** * Plays this audio. */ public void play(); - + /** * Plays this audio in loop. * + * @param silenceInterval interval between loops */ public void playInLoop(int silenceInterval); - + /** * Stops this audio. */ diff --git a/src/net/java/sip/communicator/service/callhistory/event/CallHistoryQueryStatusEvent.java b/src/net/java/sip/communicator/service/callhistory/event/CallHistoryQueryStatusEvent.java index 9dc9601..ebcf216 100644 --- a/src/net/java/sip/communicator/service/callhistory/event/CallHistoryQueryStatusEvent.java +++ b/src/net/java/sip/communicator/service/callhistory/event/CallHistoryQueryStatusEvent.java @@ -21,6 +21,11 @@ public class CallHistoryQueryStatusEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates the type of this event. */ private final int eventType; diff --git a/src/net/java/sip/communicator/service/callhistory/event/CallRecordEvent.java b/src/net/java/sip/communicator/service/callhistory/event/CallRecordEvent.java index 476cc8f..75adeb8 100644 --- a/src/net/java/sip/communicator/service/callhistory/event/CallRecordEvent.java +++ b/src/net/java/sip/communicator/service/callhistory/event/CallRecordEvent.java @@ -20,6 +20,11 @@ public class CallRecordEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The <tt>CallRecord</tt> this event is about. */ private final CallRecord callRecord; diff --git a/src/net/java/sip/communicator/service/callhistory/event/ProgressEvent.java b/src/net/java/sip/communicator/service/callhistory/event/ProgressEvent.java index ed8e58f..a36c6ce 100644 --- a/src/net/java/sip/communicator/service/callhistory/event/ProgressEvent.java +++ b/src/net/java/sip/communicator/service/callhistory/event/ProgressEvent.java @@ -18,6 +18,11 @@ import java.util.*; public class ProgressEvent extends java.util.EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private net.java.sip.communicator.service.history.event.ProgressEvent evt; /** diff --git a/src/net/java/sip/communicator/service/configuration/ConfigPropertyVetoException.java b/src/net/java/sip/communicator/service/configuration/ConfigPropertyVetoException.java index 0652400..abd17bc 100644 --- a/src/net/java/sip/communicator/service/configuration/ConfigPropertyVetoException.java +++ b/src/net/java/sip/communicator/service/configuration/ConfigPropertyVetoException.java @@ -18,8 +18,12 @@ public class ConfigPropertyVetoException extends RuntimeException { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * A PropertyChangeEvent describing the vetoed change. - * @serial */ private final PropertyChangeEvent evt; diff --git a/src/net/java/sip/communicator/service/configuration/ConfigVetoableChangeListener.java b/src/net/java/sip/communicator/service/configuration/ConfigVetoableChangeListener.java index 17a0f96..397b9ee 100644 --- a/src/net/java/sip/communicator/service/configuration/ConfigVetoableChangeListener.java +++ b/src/net/java/sip/communicator/service/configuration/ConfigVetoableChangeListener.java @@ -10,7 +10,7 @@ package net.java.sip.communicator.service.configuration; import java.beans.*; import java.util.EventListener; -/* +/** * This interface uses SC's own ProperteyVetoException. */ public interface ConfigVetoableChangeListener extends EventListener @@ -22,4 +22,4 @@ public interface ConfigVetoableChangeListener extends EventListener * @throws ConfigPropertyVetoException if the change is vetoed by the listener */ void vetoableChange(PropertyChangeEvent e) throws ConfigPropertyVetoException; -} +} diff --git a/src/net/java/sip/communicator/service/contactlist/MetaContactListException.java b/src/net/java/sip/communicator/service/contactlist/MetaContactListException.java index 2572d2a..eb126ae 100644 --- a/src/net/java/sip/communicator/service/contactlist/MetaContactListException.java +++ b/src/net/java/sip/communicator/service/contactlist/MetaContactListException.java @@ -18,6 +18,11 @@ public class MetaContactListException extends RuntimeException { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that an error has occurred while performing a local IO * operation (e.g. while writing in a file). */ @@ -52,13 +57,13 @@ public class MetaContactListException * An error code indicating the nature of this exception. */ private int errCode = CODE_UNKNOWN_ERROR; - + /** * Indicates that the exception was caused by the fact that we tried to * remove a group that cannot be removed or an error occur during remove. */ public static final int CODE_REMOVE_GROUP_ERROR = 6; - + /** * Indicates that the exception was caused by the fact that we tried to * move a contact that cannot be moved or an error occur during move. diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactAvatarUpdateEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactAvatarUpdateEvent.java index 173d436..5151c56 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactAvatarUpdateEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactAvatarUpdateEvent.java @@ -17,6 +17,11 @@ public class MetaContactAvatarUpdateEvent extends MetaContactPropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Creates an instance of this event using the specified arguments. * * @param source the <tt>MetaContact</tt> that this event is about. diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactCapabilitiesEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactCapabilitiesEvent.java index 9ae391c..37e99e5 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactCapabilitiesEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactCapabilitiesEvent.java @@ -13,13 +13,18 @@ import net.java.sip.communicator.service.contactlist.*; /** * Represents an event/<tt>EventObject</tt> fired by * <tt>OperationSetClientCapabilities</tt> in order to notify about changes in - * the list of the <tt>OperationSet</tt> capabilities of a <tt>Contact</tt>. + * the list of the <tt>OperationSet</tt> capabilities of a <tt>Contact</tt>. * * @author Yana Stamcheva */ public class MetaContactCapabilitiesEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + /**ContactList.java * The ID of the <tt>MetaContactCapabilitiesEvent</tt> which notifies about * changes in the list of the <tt>OperationSet</tt> capabilities of a diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactEvent.java index 36fbc08..29c04c7 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactEvent.java @@ -19,6 +19,14 @@ import net.java.sip.communicator.service.contactlist.*; public class MetaContactEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** + * ID of the event. + */ private int eventID = -1; /** @@ -39,6 +47,9 @@ public class MetaContactEvent */ public static final int META_CONTACT_MOVED = 3; + /** + * The parent group of the contact. + */ private MetaContactGroup parentGroup = null; /** diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactGroupEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactGroupEvent.java index db2bf26..88d5bfb 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactGroupEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactGroupEvent.java @@ -18,6 +18,14 @@ import net.java.sip.communicator.service.protocol.*; public class MetaContactGroupEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** + * ID of the event. + */ private int eventID = -1; /** @@ -68,8 +76,15 @@ public class MetaContactGroupEvent */ public static final int META_CONTACT_GROUP_RENAMED = 7; + /** + * the ProtocolProviderService instance where this event + * occurred. + */ private ProtocolProviderService sourceProvider = null; + /** + * The proto group associated with this event. + */ private ContactGroup sourceProtoGroup = null; /** diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactModifiedEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactModifiedEvent.java index aa338e2..1aa525c 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactModifiedEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactModifiedEvent.java @@ -16,6 +16,11 @@ public class MetaContactModifiedEvent extends MetaContactPropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Name of the modification. */ private String modificationName; diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactMovedEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactMovedEvent.java index 8785775..94251aa 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactMovedEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactMovedEvent.java @@ -18,6 +18,10 @@ import net.java.sip.communicator.service.contactlist.*; public class MetaContactMovedEvent extends MetaContactPropertyChangeEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * Createas an instance of this <tt>MetaContactMovedEvent</tt> using the diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactPropertyChangeEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactPropertyChangeEvent.java index 602aba1..1b21694 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactPropertyChangeEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactPropertyChangeEvent.java @@ -20,6 +20,11 @@ public abstract class MetaContactPropertyChangeEvent extends PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that the source meta contact has moved from one location to * another. The old and new values contain the previous and the new * parent group of this meta contact. diff --git a/src/net/java/sip/communicator/service/contactlist/event/MetaContactRenamedEvent.java b/src/net/java/sip/communicator/service/contactlist/event/MetaContactRenamedEvent.java index 7fb1b57..84b27a1 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/MetaContactRenamedEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/MetaContactRenamedEvent.java @@ -16,6 +16,11 @@ public class MetaContactRenamedEvent extends MetaContactPropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Creates an instance of this event using the specified arguments. * @param source the <tt>MetaContact</tt> that this event is about. * @param oldDisplayName the new display name of this meta contact. diff --git a/src/net/java/sip/communicator/service/contactlist/event/ProtoContactEvent.java b/src/net/java/sip/communicator/service/contactlist/event/ProtoContactEvent.java index 5eaf790..5d26723 100644 --- a/src/net/java/sip/communicator/service/contactlist/event/ProtoContactEvent.java +++ b/src/net/java/sip/communicator/service/contactlist/event/ProtoContactEvent.java @@ -21,6 +21,11 @@ public class ProtoContactEvent extends PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that the MetaContactEvent instance was triggered by the * removal of a protocol specific contact from an existing MetaContact. */ diff --git a/src/net/java/sip/communicator/service/credentialsstorage/CryptoException.java b/src/net/java/sip/communicator/service/credentialsstorage/CryptoException.java index f670f5f..019a2f6 100644 --- a/src/net/java/sip/communicator/service/credentialsstorage/CryptoException.java +++ b/src/net/java/sip/communicator/service/credentialsstorage/CryptoException.java @@ -14,6 +14,9 @@ package net.java.sip.communicator.service.credentialsstorage; public class CryptoException extends Exception { + /** + * Serial version UID. + */ private static final long serialVersionUID = -5424208764356198091L; /** @@ -27,7 +30,7 @@ public class CryptoException public static final int DECRYPTION_ERROR = 2; /** - * Set when a decryption fail is caused by the wrong key. + * Set when a decryption fail is caused by the wrong key. */ public static final int WRONG_KEY = 3; @@ -38,7 +41,7 @@ public class CryptoException /** * Constructs the crypto exception. - * + * * @param code the error code * @param cause the original exception that this instance wraps */ diff --git a/src/net/java/sip/communicator/service/fileaccess/FileAccessService.java b/src/net/java/sip/communicator/service/fileaccess/FileAccessService.java index 814f0a8..a00256a 100644 --- a/src/net/java/sip/communicator/service/fileaccess/FileAccessService.java +++ b/src/net/java/sip/communicator/service/fileaccess/FileAccessService.java @@ -110,17 +110,18 @@ public interface FileAccessService { /** * Returns the default download directory depending on the operating system. - * + * * @return the default download directory depending on the operating system + * @throws IOException if it I/O error occurred */ File getDefaultDownloadDirectory() throws IOException; /** * Creates a failsafe transaction which can be used to safely store * informations into a file. - * + * * @param file The file concerned by the transaction, null if file is null. - * + * * @return A new failsafe transaction related to the given file. */ FailSafeTransaction createFailSafeTransaction(File file); diff --git a/src/net/java/sip/communicator/service/gui/event/ChatFocusEvent.java b/src/net/java/sip/communicator/service/gui/event/ChatFocusEvent.java index da476a9..b88e86b 100644 --- a/src/net/java/sip/communicator/service/gui/event/ChatFocusEvent.java +++ b/src/net/java/sip/communicator/service/gui/event/ChatFocusEvent.java @@ -13,12 +13,20 @@ import net.java.sip.communicator.service.gui.*; /** * The <tt>ChatFocusEvent</tt> indicates that a <tt>Chat</tt> has gained or lost * the current focus. - * + * * @author Yana Stamcheva */ public class ChatFocusEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** + * ID of the event. + */ private int eventID = -1; /** @@ -45,19 +53,19 @@ public class ChatFocusEvent super(source); this.eventID = eventID; } - + /** - * Returns an event id specifying what is the type of this event + * Returns an event id specifying what is the type of this event * (FOCUS_GAINED or FOCUS_LOST) * @return one of the REGISTRATION_XXX int fields of this class. */ public int getEventID(){ return eventID; } - + /** * Returns the <tt>Chat</tt> object that corresponds to this event. - * + * * @return the <tt>Chat</tt> object that corresponds to this event */ public Chat getChat() diff --git a/src/net/java/sip/communicator/service/gui/event/ContainerEvent.java b/src/net/java/sip/communicator/service/gui/event/ContainerEvent.java index 5dea232..cf71415 100644 --- a/src/net/java/sip/communicator/service/gui/event/ContainerEvent.java +++ b/src/net/java/sip/communicator/service/gui/event/ContainerEvent.java @@ -9,8 +9,16 @@ package net.java.sip.communicator.service.gui.event; import java.util.*; public class ContainerEvent - extends EventObject{ + extends EventObject +{ + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + /** + * ID of the event. + */ private int eventID = -1; /** diff --git a/src/net/java/sip/communicator/service/gui/internal/GuiServiceActivator.java b/src/net/java/sip/communicator/service/gui/internal/GuiServiceActivator.java index e9d9fe0..008d523 100644 --- a/src/net/java/sip/communicator/service/gui/internal/GuiServiceActivator.java +++ b/src/net/java/sip/communicator/service/gui/internal/GuiServiceActivator.java @@ -13,18 +13,36 @@ import org.osgi.framework.*; public class GuiServiceActivator
implements BundleActivator
{
+ /**
+ * The <tt>BundleContext</tt> of the service.
+ */
private static BundleContext bundleContext;
+ /**
+ * Returns the <tt>BundleContext</tt>.
+ *
+ * @return bundle context
+ */
public static BundleContext getBundleContext()
{
return bundleContext;
}
+ /**
+ * Initialize and start GUI service
+ *
+ * @param bundleContext the <tt>BundleContext</tt>
+ */
public void start(BundleContext bundleContext)
{
GuiServiceActivator.bundleContext = bundleContext;
}
+ /**
+ * Stops this bundle.
+ *
+ * @param bundleContext the <tt>BundleContext</tt>
+ */
public void stop(BundleContext bundleContext)
{
if (GuiServiceActivator.bundleContext == bundleContext)
diff --git a/src/net/java/sip/communicator/service/history/BidirectionalIterator.java b/src/net/java/sip/communicator/service/history/BidirectionalIterator.java index 0394755..1e5a04f 100644 --- a/src/net/java/sip/communicator/service/history/BidirectionalIterator.java +++ b/src/net/java/sip/communicator/service/history/BidirectionalIterator.java @@ -13,24 +13,25 @@ import java.util.*; * the contents of a collection in one way only. This interface defines a * bi-directional iterator, permiting the user to go forwards and backwards in a * collection. - * + * * @author Alexander Pelov */ -public interface BidirectionalIterator<T> extends Iterator<T> { +public interface BidirectionalIterator<T> extends Iterator<T> +{ /** * Returns true if the iteration has elements preceeding the current one. * (In other words, returns true if <tt>prev</tt> would return an element * rather than throwing an exception.) - * + * * @return true if the iterator has preceeding elements. */ boolean hasPrev(); /** * Returns the previous element in the iteration. - * + * * @return the previous element in the iteration. - * + * * @throws NoSuchElementException * iteration has no more elements. */ diff --git a/src/net/java/sip/communicator/service/history/event/HistoryQueryStatusEvent.java b/src/net/java/sip/communicator/service/history/event/HistoryQueryStatusEvent.java index 786db5f..5103532 100644 --- a/src/net/java/sip/communicator/service/history/event/HistoryQueryStatusEvent.java +++ b/src/net/java/sip/communicator/service/history/event/HistoryQueryStatusEvent.java @@ -21,6 +21,11 @@ public class HistoryQueryStatusEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that a query has been completed. */ public static final int QUERY_COMPLETED = 0; diff --git a/src/net/java/sip/communicator/service/history/event/HistoryRecordEvent.java b/src/net/java/sip/communicator/service/history/event/HistoryRecordEvent.java index c32a377..7419916 100644 --- a/src/net/java/sip/communicator/service/history/event/HistoryRecordEvent.java +++ b/src/net/java/sip/communicator/service/history/event/HistoryRecordEvent.java @@ -21,6 +21,11 @@ public class HistoryRecordEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The <tt>HistoryRecord</tt> this event is about. */ private final HistoryRecord historyRecord; diff --git a/src/net/java/sip/communicator/service/history/event/ProgressEvent.java b/src/net/java/sip/communicator/service/history/event/ProgressEvent.java index 037658f..1fb9ef5 100644 --- a/src/net/java/sip/communicator/service/history/event/ProgressEvent.java +++ b/src/net/java/sip/communicator/service/history/event/ProgressEvent.java @@ -24,6 +24,11 @@ public class ProgressEvent extends java.util.EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The start date in the search condition. */ private Date startDate = null; diff --git a/src/net/java/sip/communicator/service/msghistory/event/ProgressEvent.java b/src/net/java/sip/communicator/service/msghistory/event/ProgressEvent.java index 16685d6..eb3e324 100644 --- a/src/net/java/sip/communicator/service/msghistory/event/ProgressEvent.java +++ b/src/net/java/sip/communicator/service/msghistory/event/ProgressEvent.java @@ -18,6 +18,11 @@ import java.util.*; public class ProgressEvent extends java.util.EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private net.java.sip.communicator.service.history.event.ProgressEvent evt; /** diff --git a/src/net/java/sip/communicator/service/neomedia/MediaException.java b/src/net/java/sip/communicator/service/neomedia/MediaException.java index f49e3ed..393a418 100644 --- a/src/net/java/sip/communicator/service/neomedia/MediaException.java +++ b/src/net/java/sip/communicator/service/neomedia/MediaException.java @@ -18,6 +18,11 @@ public class MediaException extends Exception { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The error code value which specifies that the <tt>MediaException</tt> * carrying it does not give more information about its specifics. */ diff --git a/src/net/java/sip/communicator/service/neomedia/MediaService.java b/src/net/java/sip/communicator/service/neomedia/MediaService.java index 8173a88..baa96b2 100644 --- a/src/net/java/sip/communicator/service/neomedia/MediaService.java +++ b/src/net/java/sip/communicator/service/neomedia/MediaService.java @@ -155,10 +155,10 @@ public interface MediaService /** * Creates a new <tt>Recorder</tt> instance that can be used to record a * call which captures and plays back media using a specific - * <tt>MediaDevice</tt>. + * <tt>MediaDevice</tt>. * * @param device the <tt>MediaDevice</tt> which is used for media capture - * and playback by the call to be recorded + * and playback by the call to be recorded * @return a new <tt>Recorder</tt> instance that can be used to record a * call which captures and plays back media using the specified * <tt>MediaDevice</tt> diff --git a/src/net/java/sip/communicator/service/neomedia/MediaUseCase.java b/src/net/java/sip/communicator/service/neomedia/MediaUseCase.java index afcc140..4c9a71a 100644 --- a/src/net/java/sip/communicator/service/neomedia/MediaUseCase.java +++ b/src/net/java/sip/communicator/service/neomedia/MediaUseCase.java @@ -32,7 +32,6 @@ public enum MediaUseCase /** * Name of this <tt>MediaUseCase</tt>. - * */ private final String mediaUseCase; diff --git a/src/net/java/sip/communicator/service/neomedia/device/ScreenDevice.java b/src/net/java/sip/communicator/service/neomedia/device/ScreenDevice.java index f4edef4..6540648 100644 --- a/src/net/java/sip/communicator/service/neomedia/device/ScreenDevice.java +++ b/src/net/java/sip/communicator/service/neomedia/device/ScreenDevice.java @@ -10,14 +10,14 @@ import java.awt.*; /** * The <tt>ScreenDevice</tt> interface represent physical screen display. - * + * * @author Sebastien Vincent */ -public interface ScreenDevice +public interface ScreenDevice { /** * Get current resolution of <tt>ScreenDevice</tt> device. - * + * * @return current resolution of the screen */ public Dimension getSize(); diff --git a/src/net/java/sip/communicator/service/neomedia/event/DTMFToneEvent.java b/src/net/java/sip/communicator/service/neomedia/event/DTMFToneEvent.java index b99d92c..252f16c 100644 --- a/src/net/java/sip/communicator/service/neomedia/event/DTMFToneEvent.java +++ b/src/net/java/sip/communicator/service/neomedia/event/DTMFToneEvent.java @@ -20,6 +20,11 @@ public class DTMFToneEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The tone that this event is pertaining to. */ private final DTMFTone dtmfTone; diff --git a/src/net/java/sip/communicator/service/neomedia/event/RTCPFeedbackEvent.java b/src/net/java/sip/communicator/service/neomedia/event/RTCPFeedbackEvent.java index f2fe199..8e2e6eb 100644 --- a/src/net/java/sip/communicator/service/neomedia/event/RTCPFeedbackEvent.java +++ b/src/net/java/sip/communicator/service/neomedia/event/RTCPFeedbackEvent.java @@ -18,6 +18,11 @@ public class RTCPFeedbackEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Transport layer type (payload type). */ public static final int PT_TL = 205; diff --git a/src/net/java/sip/communicator/service/neomedia/event/SizeChangeVideoEvent.java b/src/net/java/sip/communicator/service/neomedia/event/SizeChangeVideoEvent.java index 0130d6f..9ffe5bf 100644 --- a/src/net/java/sip/communicator/service/neomedia/event/SizeChangeVideoEvent.java +++ b/src/net/java/sip/communicator/service/neomedia/event/SizeChangeVideoEvent.java @@ -18,6 +18,11 @@ public class SizeChangeVideoEvent extends VideoEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The type of a <tt>VideoEvent</tt> which notifies about an update to the * size of a specific visual <tt>Component</tt> depicting video. */ diff --git a/src/net/java/sip/communicator/service/neomedia/event/VideoEvent.java b/src/net/java/sip/communicator/service/neomedia/event/VideoEvent.java index e3690e3..7b75d7e 100644 --- a/src/net/java/sip/communicator/service/neomedia/event/VideoEvent.java +++ b/src/net/java/sip/communicator/service/neomedia/event/VideoEvent.java @@ -19,6 +19,10 @@ import java.util.*; public class VideoEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * The video origin of a <tt>VideoEvent</tt> which is local to the executing diff --git a/src/net/java/sip/communicator/service/netaddr/event/ChangeEvent.java b/src/net/java/sip/communicator/service/netaddr/event/ChangeEvent.java index a31d9fc..0b9675d 100644 --- a/src/net/java/sip/communicator/service/netaddr/event/ChangeEvent.java +++ b/src/net/java/sip/communicator/service/netaddr/event/ChangeEvent.java @@ -15,6 +15,11 @@ public class ChangeEvent extends java.util.EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Event type for interface going up. */ public static final int IFACE_DOWN = 0; @@ -22,7 +27,7 @@ public class ChangeEvent /** * Event type for interface going down. */ - public static final int IFACE_UP = 1; + public static final int IFACE_UP = 1; /** * The type of the current event. diff --git a/src/net/java/sip/communicator/service/notification/event/NotificationActionTypeEvent.java b/src/net/java/sip/communicator/service/notification/event/NotificationActionTypeEvent.java index e6ca109..5f82ead 100644 --- a/src/net/java/sip/communicator/service/notification/event/NotificationActionTypeEvent.java +++ b/src/net/java/sip/communicator/service/notification/event/NotificationActionTypeEvent.java @@ -19,21 +19,26 @@ public class NotificationActionTypeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that a new action is added to an event type. */ public static final String ACTION_ADDED = "ActionAdded"; - + /** * Indicates that an action was removed for a given event type. */ public static final String ACTION_REMOVED = "ActionRemoved"; - + /** * Indicates that an action for a given event type has changed. For example * the action descriptor is changed. */ public static final String ACTION_CHANGED = "ActionChanged"; - + /** * The type of the notification action that is being added. */ @@ -55,15 +60,15 @@ public class NotificationActionTypeEvent * The type of this event. One of the static field constants declared in * this class. */ - private String eventType = null; - + private String eventType = null; + /** * Creates an instance of this event according to the specified type. - * + * * @param source the <tt>NotificationService</tt> that dispatched this event * @param eventType the type of this event. One of the static fields * declared in this class - * @param sourceEventType the event type for which this event occured + * @param sourceEventType the event type for which this event occured * @param sourceActionType the action type corresponding to this event * @param actionHandler the <tt>NotificationActionHandler</tt> that handles * the given action @@ -75,7 +80,7 @@ public class NotificationActionTypeEvent NotificationActionHandler actionHandler) { super(source); - + this.eventType = eventType; this.sourceEventType = sourceEventType; this.sourceActionType = sourceActionType; @@ -84,7 +89,7 @@ public class NotificationActionTypeEvent /** * Returns the action type, for which this event is about. - * + * * @return the action type, for which this event is about. */ public String getSourceActionType() @@ -94,7 +99,7 @@ public class NotificationActionTypeEvent /** * Returns the event type, to which the given action belongs. - * + * * @return the event type, to which the given action belongs */ public String getSourceEventType() @@ -105,7 +110,7 @@ public class NotificationActionTypeEvent /** * Returns the <tt>NotificationActionHandler</tt> that handles the action, * for which this event is about. - * + * * @return the <tt>NotificationActionHandler</tt> that handles the action, * for which this event is about. */ @@ -117,7 +122,7 @@ public class NotificationActionTypeEvent /** * The type of this event. One of ACTION_XXX constants declared in this * class. - * + * * @return the type of this event */ public String getEventType() diff --git a/src/net/java/sip/communicator/service/notification/event/NotificationEventTypeEvent.java b/src/net/java/sip/communicator/service/notification/event/NotificationEventTypeEvent.java index 218961e..c908410 100644 --- a/src/net/java/sip/communicator/service/notification/event/NotificationEventTypeEvent.java +++ b/src/net/java/sip/communicator/service/notification/event/NotificationEventTypeEvent.java @@ -17,17 +17,22 @@ import net.java.sip.communicator.service.notification.*; */ public class NotificationEventTypeEvent extends EventObject -{ +{ + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + /** * Indicates that a new event type is added. */ public static final String EVENT_TYPE_ADDED = "EventTypeAdded"; - + /** * Indicates that an event type was removed. */ public static final String EVENT_TYPE_REMOVED = "EventTypeRemoved"; - + /** * The type of the event that a new action is being added for. */ @@ -37,11 +42,11 @@ public class NotificationEventTypeEvent * The type of this event. One of the static field constants declared in * this class. */ - private String eventType = null; - + private String eventType = null; + /** * Creates an instance of this event according to the specified type. - * + * * @param source the <tt>NotificationService</tt> that dispatched this event * @param eventType the type of this event. One of the static fields * declared in this class @@ -52,14 +57,14 @@ public class NotificationEventTypeEvent String sourceEventType) { super(source); - + this.eventType = eventType; - this.sourceEventType = sourceEventType; + this.sourceEventType = sourceEventType; } /** * Returns the <tt>eventType</tt>, for which this event is about. - * + * * @return the <tt>eventType</tt>, for which this event is about. */ public String getSourceEventType() @@ -70,7 +75,7 @@ public class NotificationEventTypeEvent /** * The type of this event. One of EVENT_TYPE_XXX constants declared in this * class. - * + * * @return the type of this event */ public String getEventType() diff --git a/src/net/java/sip/communicator/service/protocol/AuthorizationRequest.java b/src/net/java/sip/communicator/service/protocol/AuthorizationRequest.java index 43b8a66..f89f85b 100644 --- a/src/net/java/sip/communicator/service/protocol/AuthorizationRequest.java +++ b/src/net/java/sip/communicator/service/protocol/AuthorizationRequest.java @@ -26,6 +26,10 @@ package net.java.sip.communicator.service.protocol; */ public class AuthorizationRequest { + /** + * The reason phrase that should be sent to the user we're demanding for + * authorization. + */ private String reason = ""; /** diff --git a/src/net/java/sip/communicator/service/protocol/OperationFailedException.java b/src/net/java/sip/communicator/service/protocol/OperationFailedException.java index 26ad9b5..6afabf2 100644 --- a/src/net/java/sip/communicator/service/protocol/OperationFailedException.java +++ b/src/net/java/sip/communicator/service/protocol/OperationFailedException.java @@ -22,6 +22,11 @@ public class OperationFailedException extends Exception { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Set when no other error code can describe the exception that occurred. */ public static final int GENERAL_ERROR = 1; diff --git a/src/net/java/sip/communicator/service/protocol/OperationNotSupportedException.java b/src/net/java/sip/communicator/service/protocol/OperationNotSupportedException.java index 827bc9d..6159a59 100644 --- a/src/net/java/sip/communicator/service/protocol/OperationNotSupportedException.java +++ b/src/net/java/sip/communicator/service/protocol/OperationNotSupportedException.java @@ -9,13 +9,16 @@ package net.java.sip.communicator.service.protocol; /** * The OperationNotSupportedException is used by telephony providers as an * indication that a requested operation is not supported or implemented. - * + * * @author Emil Ivov * @author Lubomir Marinov */ public class OperationNotSupportedException extends Exception { + /** + * Serial version UID. + */ private static final long serialVersionUID = 0L; /** @@ -31,7 +34,7 @@ public class OperationNotSupportedException /** * Creates an OperationNotSupportedException instance with the specified * reason phrase. - * + * * @param message * a detailed message explaining any particular details as to why * is not the specified operation supported or null if no diff --git a/src/net/java/sip/communicator/service/protocol/OperationSetInstantMessageFiltering.java b/src/net/java/sip/communicator/service/protocol/OperationSetInstantMessageFiltering.java index b76d15e..202d431 100644 --- a/src/net/java/sip/communicator/service/protocol/OperationSetInstantMessageFiltering.java +++ b/src/net/java/sip/communicator/service/protocol/OperationSetInstantMessageFiltering.java @@ -6,22 +6,21 @@ */ package net.java.sip.communicator.service.protocol; +import net.java.sip.communicator.service.protocol.event.*; + /** - * An operation set that allows plugins to register filters which could - * intercept instant messages and determine whether or not they should be + * An operation set that allows plugins to register filters which could + * intercept instant messages and determine whether or not they should be * dispatched to regular listeners. <tt>EventFilter</tt>-s allow implementating - * features that use standard instant messaging channels to exchange - * + * features that use standard instant messaging channels to exchange + * * @author Keio Kraaner */ - -import net.java.sip.communicator.service.protocol.event.*; - public interface OperationSetInstantMessageFiltering extends OperationSet { /** - * Registeres an <tt>EventFilter</tt> with this operation set so that + * Registeres an <tt>EventFilter</tt> with this operation set so that * events, that do not need processing, are filtered out. * * @param filter the <tt>EventFilter</tt> to register. @@ -29,7 +28,7 @@ public interface OperationSetInstantMessageFiltering public void addEventFilter(EventFilter filter); /** - * Unregisteres an <tt>EventFilter</tt> so that it won't check any more + * Unregisteres an <tt>EventFilter</tt> so that it won't check any more * if an event should be filtered out. * * @param filter the <tt>EventFilter</tt> to unregister. diff --git a/src/net/java/sip/communicator/service/protocol/OperationSetWhiteboarding.java b/src/net/java/sip/communicator/service/protocol/OperationSetWhiteboarding.java index 3eeb103..9fdfb02 100644 --- a/src/net/java/sip/communicator/service/protocol/OperationSetWhiteboarding.java +++ b/src/net/java/sip/communicator/service/protocol/OperationSetWhiteboarding.java @@ -66,7 +66,7 @@ public interface OperationSetWhiteboarding */ public WhiteboardSession createWhiteboardSession( String sessionName, - Hashtable sessionProperties) + Hashtable<Object, Object> sessionProperties) throws OperationFailedException, OperationNotSupportedException; /** diff --git a/src/net/java/sip/communicator/service/protocol/ProtocolProviderFactory.java b/src/net/java/sip/communicator/service/protocol/ProtocolProviderFactory.java index 420a4bb..caa0667 100644 --- a/src/net/java/sip/communicator/service/protocol/ProtocolProviderFactory.java +++ b/src/net/java/sip/communicator/service/protocol/ProtocolProviderFactory.java @@ -327,6 +327,12 @@ public abstract class ProtocolProviderFactory protected final Hashtable<AccountID, ServiceRegistration> registeredAccounts = new Hashtable<AccountID, ServiceRegistration>(); + /** + * Creates a new <tt>ProtocolProviderFactory</tt>. + * + * @param bundleContext the bundle context reference of the service + * @param protocolName the name of the protocol + */ protected ProtocolProviderFactory(BundleContext bundleContext, String protocolName) { @@ -947,6 +953,11 @@ public abstract class ProtocolProviderFactory protocolProviderService.shutdown(); } + /** + * Get the <tt>AccountManager</tt> of the protocol. + * + * @return <tt>AccountManager</tt> of the protocol + */ private AccountManager getAccountManager() { BundleContext bundleContext = getBundleContext(); diff --git a/src/net/java/sip/communicator/service/protocol/UserCredentials.java b/src/net/java/sip/communicator/service/protocol/UserCredentials.java index a74b0db..ed3b2cb 100644 --- a/src/net/java/sip/communicator/service/protocol/UserCredentials.java +++ b/src/net/java/sip/communicator/service/protocol/UserCredentials.java @@ -16,8 +16,19 @@ package net.java.sip.communicator.service.protocol; public class UserCredentials { + /** + * The user name. + */ private String userName = null; + + /** + * The user password. + */ private char[] password = null; + + /** + * If we will store the password persistently. + */ private boolean storePassword = false; /** @@ -73,7 +84,7 @@ public class UserCredentials /** * Specifies whether or not the password associated with this credentials - * object is to be sored persistently (insecure!) or not. + * object is to be stored persistently (insecure!) or not. * <p> * @param storePassword indicates whether passwords contained by this * credentials object are to be stored persistently. @@ -85,10 +96,10 @@ public class UserCredentials /** * Determines whether or not the password associated with this credentials - * object is to be sored persistently (insecure!) or not. + * object is to be stored persistently (insecure!) or not. * <p> * @return true if the underlying protocol provider is to persistently - * (and possiblu insecurely) store the password and false otherwise. + * (and possibly insecurely) store the password and false otherwise. */ public boolean isPasswordPersistent() { diff --git a/src/net/java/sip/communicator/service/protocol/event/AccountManagerEvent.java b/src/net/java/sip/communicator/service/protocol/event/AccountManagerEvent.java index 30c2f9e..16817f4 100644 --- a/src/net/java/sip/communicator/service/protocol/event/AccountManagerEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/AccountManagerEvent.java @@ -12,12 +12,16 @@ import net.java.sip.communicator.service.protocol.*; /**
* Represents a notifying event fired by a specific {@link AccountManager}.
- *
+ *
* @author Lubomir Marinov
*/
public class AccountManagerEvent
extends EventObject
{
+ /**
+ * Serial version UID.
+ */
+ private static final long serialVersionUID = 0L;
/**
* The type of event notifying that the loading of the stored accounts of a
@@ -42,7 +46,7 @@ public class AccountManagerEvent * specific <code>AccountManager</code> in order to notify of an event of a
* specific type occurring while working on a specific
* <code>ProtocolProviderFactory</code>.
- *
+ *
* @param accountManager the <code>AccountManager</code> issuing the
* notification i.e. the source of the event
* @param type the type of the event which is one of
@@ -62,7 +66,7 @@ public class AccountManagerEvent /**
* Gets the <code>ProtocolProviderFactory</code> being worked on at the time
* this event has been fired.
- *
+ *
* @return the <code>ProtocolProviderFactory</code> being worked on at the
* time this event has been fired
*/
@@ -74,7 +78,7 @@ public class AccountManagerEvent /**
* Gets the (detail) type of this event which is one of
* <code>STORED_ACCOUNTS_LOADED</code>.
- *
+ *
* @return the (detail) type of this event which is one of
* <code>STORED_ACCOUNTS_LOADED</code>
*/
diff --git a/src/net/java/sip/communicator/service/protocol/event/AdHocChatRoomParticipantPresenceChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/AdHocChatRoomParticipantPresenceChangeEvent.java index eb3795d..759fbc4 100644 --- a/src/net/java/sip/communicator/service/protocol/event/AdHocChatRoomParticipantPresenceChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/AdHocChatRoomParticipantPresenceChangeEvent.java @@ -11,7 +11,7 @@ import net.java.sip.communicator.service.protocol.*; /** * Dispatched to notify interested parties that a change in the presence of an - * ad-hoc chat room participant has occurred. Changes may include the + * ad-hoc chat room participant has occurred. Changes may include the * participant being join, left... * * @author Valentin Martinet @@ -65,10 +65,10 @@ public class AdHocChatRoomParticipantPresenceChangeEvent * Creates an <tt>AdHocChatRoomParticipantPresenceChangeEvent</tt> * representing that a change in the presence of an <tt>Contact</tt> * has occurred. Changes may include the participant being join, left, etc. - * - * @param sourceAdHocRoom the <tt>AdHocChatRoom</tt> that produced this + * + * @param sourceAdHocRoom the <tt>AdHocChatRoom</tt> that produced this * event - * @param sourceParticipant the <tt>Contact</tt> that this event is about + * @param sourceParticipant the <tt>Contact</tt> that this event is about * @param eventType the event type; one of the CONTACT_XXX constants * @param reason the reason explaining why this event might have occurred */ @@ -96,7 +96,7 @@ public class AdHocChatRoomParticipantPresenceChangeEvent /** * Returns the participant that this event is about. - * + * * @return the <tt>Contact</tt> that this event is about. */ public Contact getParticipant() @@ -118,7 +118,7 @@ public class AdHocChatRoomParticipantPresenceChangeEvent /** * Gets the indicator which determines whether this event has occurred with * the well-known reason of listing all users in a <code>ChatRoom</code>. - * + * * @return <tt>true</tt> if this event has occurred with the well-known * reason of listing all users in a <code>ChatRoom</code> i.e. * {@link #getReason()} returns a value of {@link #REASON_USER_LIST}; @@ -143,6 +143,8 @@ public class AdHocChatRoomParticipantPresenceChangeEvent /** * Returns a String representation of this event. + * + * @return string representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/AvatarEvent.java b/src/net/java/sip/communicator/service/protocol/event/AvatarEvent.java index 90c8677..0428e37 100644 --- a/src/net/java/sip/communicator/service/protocol/event/AvatarEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/AvatarEvent.java @@ -12,13 +12,18 @@ import net.java.sip.communicator.service.protocol.*; /** * Instances of this class represent a change avatar of a protocol - * + * * @author Damien Roth */ public class AvatarEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The new avatar */ private byte[] newAvatar; @@ -31,7 +36,7 @@ public class AvatarEvent /** * Creates an event instance indicating that the specified protocol * has changed its avatar to <tt>newAvatar</tt>. - * + * * @param sourceOp the operation set that generated this event * @param sourceProvider the protocol provider that the contact belongs to * @param newAvatar the new avatar @@ -77,7 +82,7 @@ public class AvatarEvent /** * Returns a String representation of this AvatarEvent - * + * * @return a <tt>String</tt> representation of this <tt>AvatarEvent</tt>. */ public String toString() diff --git a/src/net/java/sip/communicator/service/protocol/event/CallChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallChangeEvent.java index d43e17c..374afaa 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallChangeEvent.java @@ -19,6 +19,9 @@ import net.java.sip.communicator.service.protocol.*; public class CallChangeEvent extends java.beans.PropertyChangeEvent { + /** + * Serial version UID. + */ private static final long serialVersionUID = 0L; /** diff --git a/src/net/java/sip/communicator/service/protocol/event/CallEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallEvent.java index b6ee61b..83ca589 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallEvent.java @@ -20,6 +20,11 @@ public class CallEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event id value indicating that this event has been triggered as a * result of an outgoing call. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerChangeEvent.java index 29f7c0d..c684107 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerChangeEvent.java @@ -33,6 +33,11 @@ public class CallPeerChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the corresponding event is caused by a * change of the CallPeer's status. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerConferenceEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerConferenceEvent.java index 8c58c7e..ede9bd2 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerConferenceEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerConferenceEvent.java @@ -21,6 +21,10 @@ import net.java.sip.communicator.service.protocol.*; public class CallPeerConferenceEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * The ID of <code>CallPeerConferenceEvent</code> which notifies diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerControlEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerControlEvent.java index 824c6e3..45ab215 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerControlEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerControlEvent.java @@ -26,6 +26,11 @@ import net.java.sip.communicator.service.protocol.*; public class CallPeerControlEvent extends java.util.EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private final String targetURI; /** diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerEvent.java index 68cbeb6..ed3923d 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerEvent.java @@ -18,6 +18,11 @@ public class CallPeerEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The call that the source call peer is associated with. */ private final Call sourceCall; diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityMessageEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityMessageEvent.java index 1afc111..dbd14c8 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityMessageEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityMessageEvent.java @@ -21,6 +21,11 @@ public class CallPeerSecurityMessageEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * This is a information message. Security will be established. */ public static final int INFORMATION = 0; diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOffEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOffEvent.java index b9684af..330389a 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOffEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOffEvent.java @@ -17,6 +17,10 @@ import net.java.sip.communicator.service.protocol.*; public class CallPeerSecurityOffEvent extends CallPeerSecurityStatusEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * The event constructor. diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOnEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOnEvent.java index da22635..c02b24c 100755 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOnEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityOnEvent.java @@ -18,6 +18,11 @@ import net.java.sip.communicator.service.protocol.*; public class CallPeerSecurityOnEvent extends CallPeerSecurityStatusEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private final String securityString; private final boolean isVerified; diff --git a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityStatusEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityStatusEvent.java index 76e07e7..d36297b 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityStatusEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallPeerSecurityStatusEvent.java @@ -17,6 +17,11 @@ public abstract class CallPeerSecurityStatusEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Constant value defining that security is enabled. */ public static final int AUDIO_SESSION = 1; diff --git a/src/net/java/sip/communicator/service/protocol/event/CallReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/CallReceivedEvent.java index 91ba5d7..5317a98 100644 --- a/src/net/java/sip/communicator/service/protocol/event/CallReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/CallReceivedEvent.java @@ -18,6 +18,9 @@ import net.java.sip.communicator.service.protocol.*; public class CallReceivedEvent extends EventObject { + /** + * Serial version UID. + */ private static final long serialVersionUID = 0L; public CallReceivedEvent(Call call) diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationReceivedEvent.java index fae17d1..38ad202 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationReceivedEvent.java @@ -12,7 +12,7 @@ import net.java.sip.communicator.service.protocol.*; /** * <tt>ChatRoomInvitationReceivedEvent</tt>s indicate reception of an * invitation to join a chat room. - * + * * @author Emil Ivov * @author Stephane Remy * @author Yana Stamcheva @@ -21,10 +21,15 @@ public class ChatRoomInvitationReceivedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The invitation corresponding to this event. */ private final ChatRoomInvitation invitation; - + /** * A timestamp indicating the exact date when the event occurred. */ @@ -50,17 +55,17 @@ public class ChatRoomInvitationReceivedEvent this.invitation = invitation; this.timestamp = timestamp; } - + /** * Returns the multi user chat operation set that dispatches this event. - * + * * @return the multi user chat operation set that dispatches this event. */ public OperationSetMultiUserChat getSourceOperationSet() { return (OperationSetMultiUserChat) getSource(); } - + /** * Returns the <tt>ChatRoomInvitation</tt> that this event is for. * @@ -70,7 +75,7 @@ public class ChatRoomInvitationReceivedEvent { return invitation; } - + /** * A timestamp indicating the exact date when the event ocurred. * diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationRejectedEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationRejectedEvent.java index ed953d7..6559e1c 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationRejectedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomInvitationRejectedEvent.java @@ -21,26 +21,31 @@ public class ChatRoomInvitationRejectedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The <tt>ChatRoom</tt> for which the initial invitation was. */ private ChatRoom chatRoom; - + /** * The invitee that rejected the invitation. */ private String invitee; - + /** * The reason why this invitation is rejected or null if there is no reason * specified. */ private String reason; - + /** * The exact date at which this event occured. */ private Date timestamp; - + /** * Creates a <tt>ChatRoomInvitationRejectedEvent</tt> representing the * rejection of an invitation, rejected by the given <tt>invitee</tt>. @@ -60,33 +65,33 @@ public class ChatRoomInvitationRejectedEvent Date timestamp) { super(source); - + this.chatRoom = chatRoom; this.invitee = invitee; this.reason = reason; this.timestamp = timestamp; } - + /** * Returns the multi user chat operation set that dispatches this event. - * + * * @return the multi user chat operation set that dispatches this event */ public OperationSetMultiUserChat getSourceOperationSet() { return (OperationSetMultiUserChat)getSource(); } - + /** * Returns the <tt>ChatRoom</tt> for which the initial invitation was. - * + * * @return the <tt>ChatRoom</tt> for which the initial invitation was */ public ChatRoom getChatRoom() { return chatRoom; } - + /** * Returns the name of the invitee that rejected the invitation. * @@ -96,7 +101,7 @@ public class ChatRoomInvitationRejectedEvent { return invitee; } - + /** * Returns the reason for which the <tt>ChatRoomInvitation</tt> is rejected. * @@ -106,7 +111,7 @@ public class ChatRoomInvitationRejectedEvent { return reason; } - + /** * A timestamp indicating the exact date when the event ocurred. * @return a Date indicating when the event ocurred. diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomLocalUserRoleChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomLocalUserRoleChangeEvent.java index 8acac38..f7ba6c8 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomLocalUserRoleChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomLocalUserRoleChangeEvent.java @@ -13,7 +13,7 @@ import net.java.sip.communicator.service.protocol.*; * Dispatched to notify interested parties that a change in our role in the * source chat room has occurred. Changes may include us being granted admin * permissions, or other permissions. - * + * * @see ChatRoomMemberRole * * @author Emil Ivov @@ -21,35 +21,40 @@ import net.java.sip.communicator.service.protocol.*; */ public class ChatRoomLocalUserRoleChangeEvent extends EventObject -{ +{ + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + /** * The previous role that local participant had. */ private ChatRoomMemberRole previousRole = null; - + /** * The new role that local participant get. */ private ChatRoomMemberRole newRole = null; - + /** * Creates a <tt>ChatRoomLocalUserRoleChangeEvent</tt> representing that * a change in local participant role in the source chat room has * occured. - * + * * @param sourceRoom the <tt>ChatRoom</tt> that produced the event * @param previousRole the previous role that local participant had * @param newRole the new role that local participant get */ public ChatRoomLocalUserRoleChangeEvent(ChatRoom sourceRoom, ChatRoomMemberRole previousRole, - ChatRoomMemberRole newRole) + ChatRoomMemberRole newRole) { super(sourceRoom); this.previousRole = previousRole; this.newRole = newRole; } - + /** * Returns the new role the local participant get. * @@ -59,7 +64,7 @@ public class ChatRoomLocalUserRoleChangeEvent { return newRole; } - + /** * Returns the previous role that local participant had. * @@ -69,7 +74,7 @@ public class ChatRoomLocalUserRoleChangeEvent { return previousRole; } - + /** * Returns the <tt>ChatRoom</tt>, where this event occured. * diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPresenceChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPresenceChangeEvent.java index a4ac041..220b7d0 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPresenceChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPresenceChangeEvent.java @@ -21,6 +21,11 @@ public class ChatRoomMemberPresenceChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that this event was triggered as a result of the participant * joining the source chat room. */ @@ -78,9 +83,9 @@ public class ChatRoomMemberPresenceChangeEvent * Creates a <tt>ChatRoomMemberPresenceChangeEvent</tt> representing that * a change in the presence of a <tt>ChatRoomMember</tt> has occurred. * Changes may include the participant being kicked, join, left, etc. - * + * * @param sourceRoom the <tt>ChatRoom</tt> that produced this event - * @param sourceMember the <tt>ChatRoomMember</tt> that this event is about + * @param sourceMember the <tt>ChatRoomMember</tt> that this event is about * @param eventType the event type; one of the MEMBER_XXX constants * @param reason the reason explaining why this event might have occurred */ @@ -96,11 +101,11 @@ public class ChatRoomMemberPresenceChangeEvent * Creates a <tt>ChatRoomMemberPresenceChangeEvent</tt> representing that * a change in the presence of a <tt>ChatRoomMember</tt> has occurred. * Changes may include the participant being kicked, join, left, etc. - * + * * @param sourceRoom the <tt>ChatRoom</tt> that produced this event * @param sourceMember the <tt>ChatRoomMember</tt> that this event is about * @param actorMember the <tt>ChatRoomMember</tt> that participated as an - * actor in this event + * actor in this event * @param eventType the event type; one of the MEMBER_XXX constants * @param reason the reason explaining why this event might have occurred */ @@ -129,7 +134,7 @@ public class ChatRoomMemberPresenceChangeEvent /** * Returns the chat room member that this event is about. - * + * * @return the <tt>ChatRoomMember</tt> that this event is about. */ public ChatRoomMember getChatRoomMember() @@ -151,7 +156,7 @@ public class ChatRoomMemberPresenceChangeEvent /** * Gets the indicator which determines whether this event has occurred with * the well-known reason of listing all users in a <code>ChatRoom</code>. - * + * * @return <tt>true</tt> if this event has occurred with the well-known * reason of listing all users in a <code>ChatRoom</code> i.e. * {@link #getReason()} returns a value of {@link #REASON_USER_LIST}; @@ -176,6 +181,8 @@ public class ChatRoomMemberPresenceChangeEvent /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPropertyChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPropertyChangeEvent.java index 83f621d..458edb1 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPropertyChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberPropertyChangeEvent.java @@ -10,8 +10,8 @@ import net.java.sip.communicator.service.protocol.*; /** * A <tt>ChatRoomMemberPropertyChangeEvent</tt> is issued whenever a chat room - * member property has changed (such as the nickname for example). Event codes - * defined in this class describe properties whose changes are being announced + * member property has changed (such as the nickname for example). Event codes + * defined in this class describe properties whose changes are being announced * through this event. * * @author Emil Ivov @@ -21,6 +21,11 @@ public class ChatRoomMemberPropertyChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The nick name of the <tt>ChatRoomMember</tt> property. */ public static final String MEMBER_NICKNAME = "MemberNickname"; @@ -31,12 +36,13 @@ public class ChatRoomMemberPropertyChangeEvent private ChatRoom memberChatRoom; /** - * Creates a <tt>ChatRoomMemberPropertyChangeEvent</tt> indicating that a + * Creates a <tt>ChatRoomMemberPropertyChangeEvent</tt> indicating that a * change has occurred for property <tt>propertyName</tt> in the - * <tt>source</tt> chat room member and that its value has changed from + * <tt>source</tt> chat room member and that its value has changed from * <tt>oldValue</tt> to <tt>newValue</tt>. * <p> * @param source the <tt>ChatRoomMember</tt> whose property has changed. + * @param memberChatRoom the <tt>ChatRoom</tt> of the member * @param propertyName the name of the property that has changed. * @param oldValue the value of the property before the change occurred. * @param newValue the value of the property after the change. @@ -77,6 +83,8 @@ public class ChatRoomMemberPropertyChangeEvent /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberRoleChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberRoleChangeEvent.java index fd93f8f..398d641 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberRoleChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMemberRoleChangeEvent.java @@ -14,7 +14,7 @@ import net.java.sip.communicator.service.protocol.*; * Dispatched to notify interested parties that a change in a member role in the * source room has occurred. Changes may include member being granted admin * permissions, or other permissions. - * + * * @see ChatRoomMemberRole * * @author Emil Ivov @@ -24,24 +24,29 @@ public class ChatRoomMemberRoleChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The member that the event relates to. */ private ChatRoomMember sourceMember = null; - + /** * The previous role that this member had. */ private ChatRoomMemberRole previousRole = null; - + /** * The new role that this member get. */ private ChatRoomMemberRole newRole = null; - + /** * Creates a <tt>ChatRoomMemberRoleChangeEvent</tt> representing that * a change in member role in the source chat room has occured. - * + * * @param sourceRoom the <tt>ChatRoom</tt> that produced this event * @param sourceMember the <tt>ChatRoomMember</tt> that this event is about * @param previousRole the previous role that member had @@ -50,14 +55,14 @@ public class ChatRoomMemberRoleChangeEvent public ChatRoomMemberRoleChangeEvent(ChatRoom sourceRoom, ChatRoomMember sourceMember, ChatRoomMemberRole previousRole, - ChatRoomMemberRole newRole) + ChatRoomMemberRole newRole) { super(sourceRoom); this.sourceMember = sourceMember; this.previousRole = previousRole; this.newRole = newRole; } - + /** * Returns the new role given to the member that this event is about. * @@ -67,7 +72,7 @@ public class ChatRoomMemberRoleChangeEvent { return newRole; } - + /** * Returns the previous role the member that this event is about had. * @@ -77,7 +82,7 @@ public class ChatRoomMemberRoleChangeEvent { return previousRole; } - + /** * Returns the chat room that produced this event. * @@ -87,7 +92,7 @@ public class ChatRoomMemberRoleChangeEvent { return (ChatRoom)getSource(); } - + /** * Returns the member that this event is about. * @return the <tt>ChatRoomMember</tt> that this event is about diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveredEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveredEvent.java index 981ae34..a8d1512 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveredEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveredEvent.java @@ -21,6 +21,11 @@ public class ChatRoomMessageDeliveredEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the message being received is a standard * conversation message sent by another member of the chat room to all * current participants. diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveryFailedEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveryFailedEvent.java index f3243fe..2a3163c 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveryFailedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageDeliveryFailedEvent.java @@ -21,6 +21,11 @@ public class ChatRoomMessageDeliveryFailedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The chat room member that this message has been sent to. */ private ChatRoomMember to = null; @@ -114,7 +119,7 @@ public class ChatRoomMessageDeliveryFailedEvent { return to; } - + /** * Returns the received message. * @return the <tt>Message</tt> that triggered this event. diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageReceivedEvent.java index 0fdd67f..1fcc5d0 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomMessageReceivedEvent.java @@ -20,6 +20,11 @@ public class ChatRoomMessageReceivedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the message being received is a standard * conversation message sent by another member of the chatroom to all * current participants. diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeEvent.java index 043c1d6..cf3f052 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeEvent.java @@ -20,15 +20,20 @@ public class ChatRoomPropertyChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The name of the <tt>ChatRoom</tt> subject property. */ public static final String CHAT_ROOM_SUBJECT = "ChatRoomSubject"; - + /** * The name of the <tt>ChatRoom</tt> subject property. */ public static final String CHAT_ROOM_USER_NICKNAME = "ChatRoomUserNickname"; - + /** * Creates a <tt>ChatRoomPropertyChangeEvent</tt> indicating that a change * has occurred for property <tt>propertyName</tt> in the <tt>source</tt> @@ -58,9 +63,11 @@ public class ChatRoomPropertyChangeEvent { return (ChatRoom)getSource(); } - + /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeFailedEvent.java b/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeFailedEvent.java index 37265c6..35ce982 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeFailedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ChatRoomPropertyChangeFailedEvent.java @@ -14,28 +14,33 @@ import net.java.sip.communicator.service.protocol.*; * Dispatched to indicate that a change of a chat room property has failed. * The modification of a property could fail, because the implementation * doesn't support such a property. - * + * * @author Yana Stamcheva */ public class ChatRoomPropertyChangeFailedEvent extends PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that the current implementation doesn't support the given * property. */ public static final int PROPERTY_NOT_SUPPORTED = 0; - + /** * The reason of the failure. */ private final String reason; - + /** * Indicates why the failure occurred. */ private final int reasonCode; - + /** * Creates a <tt>ChatRoomPropertyChangeEvent</tt> indicating that a change * has occurred for property <tt>propertyName</tt> in the <tt>source</tt> @@ -49,7 +54,7 @@ public class ChatRoomPropertyChangeFailedEvent * @param reasonCode the code indicating the reason for the failure * @param reason more detailed explanation of the failure */ - public ChatRoomPropertyChangeFailedEvent( ChatRoom source, + public ChatRoomPropertyChangeFailedEvent( ChatRoom source, String propertyName, Object propertyValue, Object expectedValue, @@ -57,7 +62,7 @@ public class ChatRoomPropertyChangeFailedEvent String reason) { super(source, propertyName, propertyValue, expectedValue); - + this.reasonCode = reasonCode; this.reason = reason; } @@ -72,27 +77,27 @@ public class ChatRoomPropertyChangeFailedEvent { return (ChatRoom)getSource(); } - + /** * Returns the value of the property. - * + * * @return the value of the property. */ public Object getPropertyValue() { - return getOldValue(); + return getOldValue(); } - + /** * Return the expected after the change value of the property. - * + * * @return the expected after the change value of the property */ public Object getExpectedValue() { return getNewValue(); } - + /** * Returns the code of the failure. One of the static constants declared in * this class. @@ -103,7 +108,7 @@ public class ChatRoomPropertyChangeFailedEvent { return reasonCode; } - + /** * Returns the reason of the failure. * @return the reason of the failure @@ -112,9 +117,11 @@ public class ChatRoomPropertyChangeFailedEvent { return reason; } - + /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/ConferenceMembersSoundLevelEvent.java b/src/net/java/sip/communicator/service/protocol/event/ConferenceMembersSoundLevelEvent.java index 2436107..c716299 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ConferenceMembersSoundLevelEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ConferenceMembersSoundLevelEvent.java @@ -22,6 +22,11 @@ public class ConferenceMembersSoundLevelEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The maximum level that can be reported for a participant in a conference. * Level values should be distributed among MAX_LEVEL and MIN_LEVEL in a * way that would appear uniform to users. diff --git a/src/net/java/sip/communicator/service/protocol/event/ContactCapabilitiesEvent.java b/src/net/java/sip/communicator/service/protocol/event/ContactCapabilitiesEvent.java index ee32d90..da12de3 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ContactCapabilitiesEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ContactCapabilitiesEvent.java @@ -13,7 +13,7 @@ import net.java.sip.communicator.service.protocol.*; /** * Represents an event/<tt>EventObject</tt> fired by * <tt>OperationSetClientCapabilities</tt> in order to notify about changes in - * the list of the <tt>OperationSet</tt> capabilities of a <tt>Contact</tt>. + * the list of the <tt>OperationSet</tt> capabilities of a <tt>Contact</tt>. * * @author Lubomir Marinov */ @@ -21,6 +21,11 @@ public class ContactCapabilitiesEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The ID of the <tt>ContactCapabilitiesEvent</tt> which notifies about * changes in the list of the <tt>OperationSet</tt> capabilities of a * <tt>Contact</tt>. diff --git a/src/net/java/sip/communicator/service/protocol/event/ContactPresenceStatusChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ContactPresenceStatusChangeEvent.java index a09ee93..4ce2d1f 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ContactPresenceStatusChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ContactPresenceStatusChangeEvent.java @@ -17,9 +17,20 @@ import net.java.sip.communicator.service.protocol.*; */ public class ContactPresenceStatusChangeEvent extends PropertyChangeEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** + * The contact's <tt>ProtocolProviderService</tt>. + */ private ProtocolProviderService sourceProvider = null; - private ContactGroup parentGroup = null; + /** + * The parent group of the contact. + */ + private ContactGroup parentGroup = null; /** * Creates an event instance indicating that the specified source contact diff --git a/src/net/java/sip/communicator/service/protocol/event/ContactPropertyChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ContactPropertyChangeEvent.java index cd6ee66..6f324bc 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ContactPropertyChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ContactPropertyChangeEvent.java @@ -13,6 +13,11 @@ public class ContactPropertyChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that a change has occurred in the display name of the source * contact. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/FileTransferCreatedEvent.java b/src/net/java/sip/communicator/service/protocol/event/FileTransferCreatedEvent.java index 8656f8b..feaeff0 100644 --- a/src/net/java/sip/communicator/service/protocol/event/FileTransferCreatedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/FileTransferCreatedEvent.java @@ -13,13 +13,18 @@ import net.java.sip.communicator.service.protocol.*; /** * The <tt>FileTransferCreatedEvent</tt> indicates the creation of a file * transfer. - * + * * @author Yana Stamcheva */ public class FileTransferCreatedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The timestamp indicating the exact date when the event occurred. */ private final Date timestamp; @@ -43,7 +48,7 @@ public class FileTransferCreatedEvent /** * Returns the file transfer that triggered this event. - * + * * @return the <tt>FileTransfer</tt> that triggered this * event. */ @@ -54,7 +59,7 @@ public class FileTransferCreatedEvent /** * A timestamp indicating the exact date when the event occurred. - * + * * @return a Date indicating when the event occurred. */ public Date getTimestamp() diff --git a/src/net/java/sip/communicator/service/protocol/event/FileTransferProgressEvent.java b/src/net/java/sip/communicator/service/protocol/event/FileTransferProgressEvent.java index b8c57ef..0a8157c 100644 --- a/src/net/java/sip/communicator/service/protocol/event/FileTransferProgressEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/FileTransferProgressEvent.java @@ -13,13 +13,18 @@ import net.java.sip.communicator.service.protocol.*; /** * The <tt>FileTransferProgressEvent</tt> indicates the progress of a file * transfer. - * + * * @author Yana Stamcheva */ public class FileTransferProgressEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates the progress of a file transfer in bytes. */ private long progress; @@ -33,7 +38,7 @@ public class FileTransferProgressEvent * Creates a <tt>FileTransferProgressEvent</tt> by specifying the source * file transfer object, that triggered the event and the new progress * value. - * + * * @param fileTransfer the source file transfer object, that triggered the * event * @param timestamp when this event occured @@ -51,7 +56,7 @@ public class FileTransferProgressEvent /** * Returns the source <tt>FileTransfer</tt> that triggered this event. - * + * * @return the source <tt>FileTransfer</tt> that triggered this event */ public FileTransfer getFileTransfer() @@ -61,7 +66,7 @@ public class FileTransferProgressEvent /** * Returns the progress of the file transfer in transferred bytes. - * + * * @return the progress of the file transfer */ public long getProgress() @@ -71,7 +76,7 @@ public class FileTransferProgressEvent /** * Returns the timestamp when this event initially occured. - * + * * @return the timestamp when this event initially occured */ public long getTimestamp() diff --git a/src/net/java/sip/communicator/service/protocol/event/FileTransferRequestEvent.java b/src/net/java/sip/communicator/service/protocol/event/FileTransferRequestEvent.java index 551ac96..9c04de8 100644 --- a/src/net/java/sip/communicator/service/protocol/event/FileTransferRequestEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/FileTransferRequestEvent.java @@ -13,7 +13,7 @@ import net.java.sip.communicator.service.protocol.*; /** * The <tt>FileTransferRequestEvent</tt> indicates the reception of a file * transfer request. - * + * * @author Nicolas Riegel * @author Yana Stamcheva */ @@ -21,6 +21,11 @@ public class FileTransferRequestEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The request that triggered this event. */ private final IncomingFileTransferRequest request; @@ -53,7 +58,7 @@ public class FileTransferRequestEvent /** * Returns the <tt>OperationSetFileTransfer</tt>, where this event initially * occurred. - * + * * @return the <tt>OperationSetFileTransfer</tt>, where this event initially * occurred */ @@ -64,7 +69,7 @@ public class FileTransferRequestEvent /** * Returns the incoming file transfer request that triggered this event. - * + * * @return the <tt>IncomingFileTransferRequest</tt> that triggered this * event. */ @@ -75,7 +80,7 @@ public class FileTransferRequestEvent /** * A timestamp indicating the exact date when the event occurred. - * + * * @return a Date indicating when the event occurred. */ public Date getTimestamp() diff --git a/src/net/java/sip/communicator/service/protocol/event/FileTransferStatusChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/FileTransferStatusChangeEvent.java index ee5daf3..d886773 100644 --- a/src/net/java/sip/communicator/service/protocol/event/FileTransferStatusChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/FileTransferStatusChangeEvent.java @@ -13,13 +13,18 @@ import net.java.sip.communicator.service.protocol.*; /** * The <tt>FileTransferStatusChangeEvent</tt> is the event indicating of a * change in the state of a file transfer. - * + * * @author Yana Stamcheva */ public class FileTransferStatusChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that the file transfer has been completed. */ public static final int COMPLETED = 0; @@ -73,7 +78,7 @@ public class FileTransferStatusChangeEvent /** * Creates a <tt>FileTransferStatusChangeEvent</tt> by specifying the * source <tt>fileTransfer</tt>, the old transfer status and the new status. - * + * * @param fileTransfer the source file transfer, for which this status * change occured * @param oldStatus the old status @@ -94,7 +99,7 @@ public class FileTransferStatusChangeEvent /** * Returns the source <tt>FileTransfer</tt> that triggered this event. - * + * * @return the source <tt>FileTransfer</tt> that triggered this event */ public FileTransfer getFileTransfer() @@ -104,7 +109,7 @@ public class FileTransferStatusChangeEvent /** * Returns the state of the file transfer before this event occured. - * + * * @return the old state */ public int getOldStatus() @@ -114,7 +119,7 @@ public class FileTransferStatusChangeEvent /** * The new state of the file transfer. - * + * * @return the new state */ public int getNewStatus() diff --git a/src/net/java/sip/communicator/service/protocol/event/GeolocationEvent.java b/src/net/java/sip/communicator/service/protocol/event/GeolocationEvent.java index 2db6329..819796a 100644 --- a/src/net/java/sip/communicator/service/protocol/event/GeolocationEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/GeolocationEvent.java @@ -18,6 +18,10 @@ import net.java.sip.communicator.service.protocol.*; public class GeolocationEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * The provider that has generated the event. diff --git a/src/net/java/sip/communicator/service/protocol/event/LocalUserChatRoomPresenceChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/LocalUserChatRoomPresenceChangeEvent.java index 3a11278..ccba82d 100644 --- a/src/net/java/sip/communicator/service/protocol/event/LocalUserChatRoomPresenceChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/LocalUserChatRoomPresenceChangeEvent.java @@ -21,6 +21,11 @@ public class LocalUserChatRoomPresenceChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that this event was triggered as a result of the local * participant joining a chat room. */ @@ -43,7 +48,7 @@ public class LocalUserChatRoomPresenceChangeEvent * participant being kicked from a chat room. */ public static final String LOCAL_USER_KICKED = "LocalUserKicked"; - + /** * Indicates that this event was triggered as a result of the local * participant beeing disconnected from the server brutally, or ping timeout. @@ -54,7 +59,7 @@ public class LocalUserChatRoomPresenceChangeEvent * The <tt>ChatRoom</tt> to which the change is related. */ private ChatRoom chatRoom = null; - + /** * The type of this event. */ @@ -70,7 +75,7 @@ public class LocalUserChatRoomPresenceChangeEvent * Creates a <tt>ChatRoomLocalUserPresenceChangeEvent</tt> representing that * a change in local participant presence in the source chat room has * occured. - * + * * @param source the <tt>OperationSetMultiUserChat</tt>, which produced this * event * @param chatRoom the <tt>ChatRoom</tt> that this event is about @@ -83,7 +88,7 @@ public class LocalUserChatRoomPresenceChangeEvent String reason) { super(source); - + this.chatRoom = chatRoom; this.eventType = eventType; this.reason = reason; @@ -100,7 +105,7 @@ public class LocalUserChatRoomPresenceChangeEvent { return (OperationSetMultiUserChat) getSource(); } - + /** * Returns the <tt>ChatRoom</tt>, that this event is about. * @@ -135,6 +140,8 @@ public class LocalUserChatRoomPresenceChangeEvent /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/event/MessageDeliveredEvent.java b/src/net/java/sip/communicator/service/protocol/event/MessageDeliveredEvent.java index b1812a4..3a75227 100644 --- a/src/net/java/sip/communicator/service/protocol/event/MessageDeliveredEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/MessageDeliveredEvent.java @@ -20,6 +20,11 @@ public class MessageDeliveredEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that has sent this message. */ private Contact to = null; diff --git a/src/net/java/sip/communicator/service/protocol/event/MessageDeliveryFailedEvent.java b/src/net/java/sip/communicator/service/protocol/event/MessageDeliveryFailedEvent.java index 1146ef3..15ca49e 100644 --- a/src/net/java/sip/communicator/service/protocol/event/MessageDeliveryFailedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/MessageDeliveryFailedEvent.java @@ -20,6 +20,11 @@ public class MessageDeliveryFailedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that this message has been sent to. */ private Contact to = null; @@ -142,7 +147,7 @@ public class MessageDeliveryFailedEvent { return (Message) getSource(); } - + /** * Returns an error code descibing the reason for the failure of the * message delivery. @@ -158,7 +163,7 @@ public class MessageDeliveryFailedEvent * A timestamp indicating the exact date when the event ocurred (in this * case it is the moment when it was determined that message delivery has * failed). - * + * * @return a long indicating when the event ocurred in the form of * date timestamp. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/MessageEvent.java b/src/net/java/sip/communicator/service/protocol/event/MessageEvent.java index 2b9a7d7..3b76914 100644 --- a/src/net/java/sip/communicator/service/protocol/event/MessageEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/MessageEvent.java @@ -9,6 +9,16 @@ import java.util.*; public class MessageEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** + * Construcs a new <tt>MessageEvent</tt> instance. + * + * @param source Object on which the Event initially occurred + */ public MessageEvent(Object source) { super(source); diff --git a/src/net/java/sip/communicator/service/protocol/event/MessageReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/MessageReceivedEvent.java index be62256..c7e3246 100644 --- a/src/net/java/sip/communicator/service/protocol/event/MessageReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/MessageReceivedEvent.java @@ -19,6 +19,11 @@ public class MessageReceivedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the message being received is a standard * conversation message sent by another contact. */ @@ -62,19 +67,19 @@ public class MessageReceivedEvent */ public MessageReceivedEvent(Message source, Contact from, long timestamp) { - this(source, from, timestamp, CONVERSATION_MESSAGE_RECEIVED); + this(source, from, timestamp, CONVERSATION_MESSAGE_RECEIVED); } - + /** * Creates a <tt>MessageReceivedEvent</tt> representing reception of the * <tt>source</tt> message received from the specified <tt>from</tt> * contact. - * + * * @param source the <tt>Message</tt> whose reception this event represents. * @param from the <tt>Contact</tt> that has sent this message. * @param timestamp the exact date when the event occurred. * @param eventType the type of message event that this instance represents - * (one of the XXX_MESSAGE_RECEIVED static fields). + * (one of the XXX_MESSAGE_RECEIVED static fields). */ public MessageReceivedEvent(Message source, Contact from, long timestamp, int eventType) @@ -85,7 +90,7 @@ public class MessageReceivedEvent this.timestamp = timestamp; this.eventType = eventType; } - + /** * Returns a reference to the <tt>Contact</tt> that has send the * <tt>Message</tt> whose reception this event represents. @@ -100,7 +105,7 @@ public class MessageReceivedEvent /** * Returns the message that triggered this event - * + * * @return the <tt>Message</tt> that triggered this event. */ public Message getSourceMessage() @@ -110,19 +115,19 @@ public class MessageReceivedEvent /** * A timestamp indicating the exact date when the event occurred. - * + * * @return a Date indicating when the event occurred. */ public long getTimestamp() { return timestamp; } - + /** * Returns the type of message event represented by this event instance. * Message event type is one of the XXX_MESSAGE_RECEIVED fields of this * class. - * + * * @return one of the XXX_MESSAGE_RECEIVED fields of this class indicating * the type of this event. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/ProviderPresenceStatusChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ProviderPresenceStatusChangeEvent.java index ceac4f9..5d448a7 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ProviderPresenceStatusChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ProviderPresenceStatusChangeEvent.java @@ -17,6 +17,10 @@ import net.java.sip.communicator.service.protocol.*; */ public class ProviderPresenceStatusChangeEvent extends PropertyChangeEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * Creates an event instance indicating a change of the property diff --git a/src/net/java/sip/communicator/service/protocol/event/ProviderStatusChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/ProviderStatusChangeEvent.java index e52521f..304cf24 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ProviderStatusChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ProviderStatusChangeEvent.java @@ -17,6 +17,10 @@ import net.java.sip.communicator.service.protocol.*; */ public class ProviderStatusChangeEvent extends PropertyChangeEvent { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; /** * Creates an event instance indicating a change of the property diff --git a/src/net/java/sip/communicator/service/protocol/event/RegistrationStateChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/RegistrationStateChangeEvent.java index 4469363..e2e93ec 100644 --- a/src/net/java/sip/communicator/service/protocol/event/RegistrationStateChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/RegistrationStateChangeEvent.java @@ -30,6 +30,11 @@ import net.java.sip.communicator.service.protocol.*; public class RegistrationStateChangeEvent extends PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that no reason is specified for this event transition. */ public static final int REASON_NOT_SPECIFIED = -1; diff --git a/src/net/java/sip/communicator/service/protocol/event/ServerStoredGroupEvent.java b/src/net/java/sip/communicator/service/protocol/event/ServerStoredGroupEvent.java index daf823a..c3e25a0 100644 --- a/src/net/java/sip/communicator/service/protocol/event/ServerStoredGroupEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/ServerStoredGroupEvent.java @@ -20,6 +20,11 @@ public class ServerStoredGroupEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that a contact group has been successfully created. */ public static final int GROUP_CREATED_EVENT = 1; diff --git a/src/net/java/sip/communicator/service/protocol/event/SizeChangeVideoEvent.java b/src/net/java/sip/communicator/service/protocol/event/SizeChangeVideoEvent.java index f868303..8ecea31 100644 --- a/src/net/java/sip/communicator/service/protocol/event/SizeChangeVideoEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/SizeChangeVideoEvent.java @@ -18,6 +18,11 @@ public class SizeChangeVideoEvent extends VideoEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The type of a <tt>VideoEvent</tt> which notifies about an update to the * size of a specific visual <tt>Component</tt> depicting video. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/SoundLevelChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/SoundLevelChangeEvent.java index f6aa124..c27956f 100644 --- a/src/net/java/sip/communicator/service/protocol/event/SoundLevelChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/SoundLevelChangeEvent.java @@ -28,6 +28,11 @@ public class SoundLevelChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The maximum level that can be reported for a participant. * Level values should be distributed among MAX_LEVEL and MIN_LEVEL in a * way that would appear uniform to users. diff --git a/src/net/java/sip/communicator/service/protocol/event/SubscriptionEvent.java b/src/net/java/sip/communicator/service/protocol/event/SubscriptionEvent.java index 3d480a1..3469db4 100644 --- a/src/net/java/sip/communicator/service/protocol/event/SubscriptionEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/SubscriptionEvent.java @@ -22,6 +22,11 @@ import net.java.sip.communicator.service.protocol.*; public class SubscriptionEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private int eventID = -1; /** diff --git a/src/net/java/sip/communicator/service/protocol/event/SubscriptionMovedEvent.java b/src/net/java/sip/communicator/service/protocol/event/SubscriptionMovedEvent.java index 85c9c2c..a4bfc88 100644 --- a/src/net/java/sip/communicator/service/protocol/event/SubscriptionMovedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/SubscriptionMovedEvent.java @@ -22,6 +22,11 @@ import net.java.sip.communicator.service.protocol.*; public class SubscriptionMovedEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private ContactGroup oldParent = null; private ContactGroup newParent = null; private ProtocolProviderService sourceProvider = null; diff --git a/src/net/java/sip/communicator/service/protocol/event/TypingNotificationEvent.java b/src/net/java/sip/communicator/service/protocol/event/TypingNotificationEvent.java index 9b2a8f2..f5e3917 100644 --- a/src/net/java/sip/communicator/service/protocol/event/TypingNotificationEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/TypingNotificationEvent.java @@ -21,6 +21,11 @@ import net.java.sip.communicator.service.protocol.*; public class TypingNotificationEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + private int typingState = OperationSetTypingNotifications.STATE_UNKNOWN; /** diff --git a/src/net/java/sip/communicator/service/protocol/event/VideoEvent.java b/src/net/java/sip/communicator/service/protocol/event/VideoEvent.java index 19ca41c..28c97f7 100644 --- a/src/net/java/sip/communicator/service/protocol/event/VideoEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/VideoEvent.java @@ -19,6 +19,10 @@ import java.util.*; public class VideoEvent
extends EventObject
{
+ /**
+ * Serial version UID.
+ */
+ private static final long serialVersionUID = 0L;
/**
* The video origin of a <code>VideoEvent</code> which is local to the
diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardChangeEvent.java index 3eebaa1..c4c8bd0 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardChangeEvent.java @@ -21,6 +21,11 @@ public class WhiteboardChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the corresponding event is caused by a * change of the Whiteboard state. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationReceivedEvent.java index 127ed68..28cb530 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationReceivedEvent.java @@ -12,17 +12,22 @@ import net.java.sip.communicator.service.protocol.*; /** * <tt>WhiteboardInvitationReceivedEvent</tt>s indicate reception of an * invitation to join a whiteboard. - * + * * @author Yana Stamcheva */ public class WhiteboardInvitationReceivedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The invitation corresponding to this event. */ private WhiteboardInvitation invitation; - + /** * A timestamp indicating the exact date when the event occurred. */ @@ -49,17 +54,17 @@ public class WhiteboardInvitationReceivedEvent this.invitation = invitation; this.timestamp = timestamp; } - + /** * Returns the whiteboarding operation set that dispatches this event. - * + * * @return the whiteboarding operation set that dispatches this event. */ public OperationSetWhiteboarding getSourceOperationSet() { return (OperationSetWhiteboarding) getSource(); } - + /** * Returns the <tt>WhiteboardInvitation</tt> that this event is for. * @@ -69,7 +74,7 @@ public class WhiteboardInvitationReceivedEvent { return invitation; } - + /** * A timestamp indicating the exact date when the event ocurred. * diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationRejectedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationRejectedEvent.java index d5ee190..b313c62 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationRejectedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardInvitationRejectedEvent.java @@ -19,26 +19,31 @@ public class WhiteboardInvitationRejectedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The <tt>WhiteboardSession</tt> for which the initial invitation was. */ private WhiteboardSession whiteboardSession; - + /** * The invitee that rejected the invitation. */ private String invitee; - + /** * The reason why this invitation is rejected or null if there is no reason * specified. */ private String reason; - + /** * The exact date at which this event occured. */ private Date timestamp; - + /** * Creates a <tt>WhiteboardInvitationRejectedEvent</tt> representing the * rejection of an invitation, rejected by the given <tt>invitee</tt>. @@ -65,21 +70,21 @@ public class WhiteboardInvitationRejectedEvent this.reason = reason; this.timestamp = timestamp; } - + /** * Returns the whiteboarding operation set that dispatches this event. - * + * * @return the whiteboarding operation set that dispatches this event */ public OperationSetWhiteboarding getSourceOperationSet() { return (OperationSetWhiteboarding) getSource(); } - + /** * Returns the <tt>WhiteboardSession</tt> for which the initial invitation * was. - * + * * @return the <tt>WhiteboardSession</tt> for which the initial invitation * was */ @@ -87,7 +92,7 @@ public class WhiteboardInvitationRejectedEvent { return whiteboardSession; } - + /** * Returns the name of the invitee that rejected the invitation. * @@ -97,7 +102,7 @@ public class WhiteboardInvitationRejectedEvent { return invitee; } - + /** * Returns the reason for which the <tt>ChatRoomInvitation</tt> is rejected. * @@ -107,7 +112,7 @@ public class WhiteboardInvitationRejectedEvent { return reason; } - + /** * A timestamp indicating the exact date when the event ocurred. * @return a Date indicating when the event ocurred. diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeletedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeletedEvent.java index 838d67f..bd44706 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeletedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeletedEvent.java @@ -21,20 +21,25 @@ public class WhiteboardObjectDeletedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that has sent this wbObject. */ private Contact from = null; - + /** * A timestamp indicating the exact date when the event occurred. */ private Date timestamp = null; - + /** * A String that uniquely identifies this WhiteboardObject. */ private String id; - + /** * Creates a <tt>WhiteboardObjectReceivedEvent</tt> * representing reception of the <tt>source</tt> WhiteboardObject @@ -60,7 +65,7 @@ public class WhiteboardObjectDeletedEvent /** * Returns the source white-board session, to which the received object * belongs. - * + * * @return the source white-board session, to which the received object * belongs */ @@ -80,7 +85,7 @@ public class WhiteboardObjectDeletedEvent { return from; } - + /** * Returns the identification of the deleted WhiteboardObject * that triggered this event @@ -91,7 +96,7 @@ public class WhiteboardObjectDeletedEvent { return id; } - + /** * A timestamp indicating the exact date when the event ocurred. * @return a Date indicating when the event ocurred. diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveredEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveredEvent.java index 4f6e4fa..359c8ad 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveredEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveredEvent.java @@ -22,6 +22,11 @@ public class WhiteboardObjectDeliveredEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that has sent this wbObject. */ private Contact to = null; diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveryFailedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveryFailedEvent.java index d6de770..7a05f44 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveryFailedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectDeliveryFailedEvent.java @@ -22,6 +22,11 @@ public class WhiteboardObjectDeliveryFailedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that this whiteboard object has been sent to. */ private Contact to = null; diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectModifiedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectModifiedEvent.java index bb69030..3308fdd 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectModifiedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectModifiedEvent.java @@ -22,6 +22,11 @@ public class WhiteboardObjectModifiedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that has sent this wbObject. */ private Contact from = null; @@ -59,7 +64,7 @@ public class WhiteboardObjectModifiedEvent /** * Returns the source white-board session, to which the received object * belongs. - * + * * @return the source white-board session, to which the received object * belongs */ diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectReceivedEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectReceivedEvent.java index e118a5f..398eead 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectReceivedEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardObjectReceivedEvent.java @@ -22,6 +22,11 @@ public class WhiteboardObjectReceivedEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * The contact that has sent this wbObject. */ private Contact from = null; @@ -60,7 +65,7 @@ public class WhiteboardObjectReceivedEvent /** * Returns the source white-board session, to which the received object * belongs. - * + * * @return the source white-board session, to which the received object * belongs */ diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantChangeEvent.java index a4267fb..80c67cb 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantChangeEvent.java @@ -29,6 +29,11 @@ public class WhiteboardParticipantChangeEvent extends java.beans.PropertyChangeEvent { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event type indicating that the corresponding event is caused by a * change of the WhiteboardParticipant's status. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantEvent.java index dfebb50..ee97955 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardParticipantEvent.java @@ -21,6 +21,11 @@ public class WhiteboardParticipantEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * An event id value indicating that this event is about the fact that * the source whiteboard participant has joined the source whiteboard. */ diff --git a/src/net/java/sip/communicator/service/protocol/event/WhiteboardSessionPresenceChangeEvent.java b/src/net/java/sip/communicator/service/protocol/event/WhiteboardSessionPresenceChangeEvent.java index 4b445e7..f75d083 100644 --- a/src/net/java/sip/communicator/service/protocol/event/WhiteboardSessionPresenceChangeEvent.java +++ b/src/net/java/sip/communicator/service/protocol/event/WhiteboardSessionPresenceChangeEvent.java @@ -20,6 +20,11 @@ public class WhiteboardSessionPresenceChangeEvent extends EventObject { /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + + /** * Indicates that this event was triggered as a result of the local * participant joining a whiteboard. */ @@ -42,7 +47,7 @@ public class WhiteboardSessionPresenceChangeEvent * participant being kicked from a whiteboard. */ public static final String LOCAL_USER_KICKED = "LocalUserKicked"; - + /** * Indicates that this event was triggered as a result of the local * participant beeing disconnected from the server brutally, or ping timeout. @@ -53,7 +58,7 @@ public class WhiteboardSessionPresenceChangeEvent * The <tt>WhiteboardSession</tt> to which the change is related. */ private WhiteboardSession whiteboardSession = null; - + /** * The type of this event. */ @@ -69,7 +74,7 @@ public class WhiteboardSessionPresenceChangeEvent * Creates a <tt>WhiteboardSessionPresenceChangeEvent</tt> representing that * a change in local participant presence in the source white-board has * occured. - * + * * @param source the <tt>OperationSetWhiteboarding</tt>, which produced this * event * @param session the <tt>WhiteboardSession</tt> that this event is about @@ -82,7 +87,7 @@ public class WhiteboardSessionPresenceChangeEvent String reason) { super(source); - + this.whiteboardSession = session; this.eventType = eventType; this.reason = reason; @@ -99,7 +104,7 @@ public class WhiteboardSessionPresenceChangeEvent { return (OperationSetWhiteboarding) getSource(); } - + /** * Returns the <tt>WhiteboardSession</tt>, that this event is about. * @@ -134,6 +139,8 @@ public class WhiteboardSessionPresenceChangeEvent /** * Returns a String representation of this event. + * + * @return String representation of this event */ public String toString() { diff --git a/src/net/java/sip/communicator/service/protocol/icqconstants/IcqStatusEnum.java b/src/net/java/sip/communicator/service/protocol/icqconstants/IcqStatusEnum.java index be6a0cf..78d8ce9 100644 --- a/src/net/java/sip/communicator/service/protocol/icqconstants/IcqStatusEnum.java +++ b/src/net/java/sip/communicator/service/protocol/icqconstants/IcqStatusEnum.java @@ -26,7 +26,10 @@ import net.java.sip.communicator.util.*; public class IcqStatusEnum extends PresenceStatus { - + /** + * The <tt>Logger</tt> used by the <tt>IcqStatusEnum</tt> class and its + * instances for logging output. + */ private static Logger logger = Logger.getLogger(IcqStatusEnum.class); /** @@ -100,7 +103,7 @@ public class IcqStatusEnum /** * The minimal set of states that any ICQ implementation must support. */ - public static final ArrayList<IcqStatusEnum> icqStatusSet + public static final ArrayList<IcqStatusEnum> icqStatusSet = new ArrayList<IcqStatusEnum>(); static{ icqStatusSet.add(FREE_FOR_CHAT); diff --git a/src/net/java/sip/communicator/service/protocol/jabberconstants/JabberStatusEnum.java b/src/net/java/sip/communicator/service/protocol/jabberconstants/JabberStatusEnum.java index 87c3030..bcdd995 100644 --- a/src/net/java/sip/communicator/service/protocol/jabberconstants/JabberStatusEnum.java +++ b/src/net/java/sip/communicator/service/protocol/jabberconstants/JabberStatusEnum.java @@ -1,6 +1,6 @@ /* * SIP Communicator, the OpenSource Java VoIP and Instant Messaging client. - * + * * Distributable under LGPL license. See terms of license at gnu.org. */ package net.java.sip.communicator.service.protocol.jabberconstants; @@ -16,7 +16,7 @@ import net.java.sip.communicator.util.*; * The <tt>JabberStatusEnum</tt> gives access to presence states for the Sip * protocol. All status icons corresponding to presence states are located with * the help of the <tt>imagePath</tt> parameter - * + * * @author Emil Ivov * @author Yana Stamcheva * @author Lubomir Marinov @@ -53,7 +53,7 @@ public class JabberStatusEnum * communicate. */ public static final String FREE_FOR_CHAT = "Free For Chat"; - + /** * The Free For Chat status. Indicates that the user is eager to * communicate. @@ -99,7 +99,7 @@ public class JabberStatusEnum * Indicates an Offline status or status with 0 connectivity. */ private final JabberPresenceStatus offlineStatus; - + /** * Indicates an Extended Away status or status. */ @@ -117,38 +117,38 @@ public class JabberStatusEnum * not. */ private final JabberPresenceStatus unknownStatus; - + private static final Map<String, JabberStatusEnum> existingEnums = new Hashtable<String, JabberStatusEnum>(); /** - * Returns an instance of JabberStatusEnum for the specified + * Returns an instance of JabberStatusEnum for the specified * <tt>iconPath</tt> or creates a new one if it doesn't already exist. - * - * @param iconPath the location containing the status icons that should + * + * @param iconPath the location containing the status icons that should * be used by this enumeration. - * + * * @return the newly created JabberStatusEnum instance. */ public static JabberStatusEnum getJabberStatusEnum(String iconPath) { JabberStatusEnum statusEnum = existingEnums.get(iconPath); - + if(statusEnum != null) return statusEnum; - + statusEnum = new JabberStatusEnum(iconPath); - + existingEnums.put(iconPath, statusEnum); - + return statusEnum; } - + /** * Creates a new instance of JabberStatusEnum using <tt>iconPath</tt> as the * root path where it should be reading status icons from. - * - * @param iconPath the location containing the status icons that should + * + * @param iconPath the location containing the status icons that should * be used by this enumeration. */ private JabberStatusEnum(String iconPath) @@ -160,7 +160,7 @@ public class JabberStatusEnum this.doNotDisturbStatus = new JabberPresenceStatus(30, DO_NOT_DISTURB, loadIcon(iconPath + "/status16x16-dnd.png")); - + this.extendedAwayStatus = new JabberPresenceStatus(35, EXTENDED_AWAY, loadIcon(iconPath + "/status16x16-xa.png")); @@ -192,7 +192,7 @@ public class JabberStatusEnum /** * Returns the offline Jabber status. - * + * * @param statusName the name of the status. * @return the offline Jabber status. */ @@ -217,7 +217,7 @@ public class JabberStatusEnum /** * Returns an iterator over all status instances supported by the sip * provider. - * + * * @return an <tt>Iterator</tt> over all status instances supported by the * sip provider. */ @@ -226,6 +226,11 @@ public class JabberStatusEnum return supportedStatusSet.iterator(); } + /** + * Get all status name as array. + * + * @return array of <tt>String</tt> representing the different status name + */ public static String[] getStatusNames() { return new String[] @@ -234,7 +239,7 @@ public class JabberStatusEnum /** * Loads an image from a given image path. - * + * * @param imagePath The path to the image resource. * @return The image extracted from the resource at the specified path. */ @@ -306,7 +311,7 @@ public class JabberStatusEnum /** * Creates an instance of <tt>JabberPresenceStatus</tt> with the * specified parameters. - * + * * @param status the connectivity level of the new presence status * instance * @param statusName the name of the presence status. diff --git a/src/net/java/sip/communicator/service/protocol/msnconstants/MsnStatusEnum.java b/src/net/java/sip/communicator/service/protocol/msnconstants/MsnStatusEnum.java index 45d535e..9f7b3ad 100644 --- a/src/net/java/sip/communicator/service/protocol/msnconstants/MsnStatusEnum.java +++ b/src/net/java/sip/communicator/service/protocol/msnconstants/MsnStatusEnum.java @@ -26,6 +26,10 @@ import net.java.sip.communicator.util.*; public class MsnStatusEnum extends PresenceStatus { + /** + * The <tt>Logger</tt> used by the <tt>MsnStatusEnum</tt> class and its + * instances for logging output. + */ private static Logger logger = Logger.getLogger(MsnStatusEnum.class); /** diff --git a/src/net/java/sip/communicator/service/protocol/yahooconstants/YahooStatusEnum.java b/src/net/java/sip/communicator/service/protocol/yahooconstants/YahooStatusEnum.java index eda1d04..c105729 100644 --- a/src/net/java/sip/communicator/service/protocol/yahooconstants/YahooStatusEnum.java +++ b/src/net/java/sip/communicator/service/protocol/yahooconstants/YahooStatusEnum.java @@ -26,8 +26,12 @@ import net.java.sip.communicator.util.*; public class YahooStatusEnum extends PresenceStatus { + /** + * The <tt>Logger</tt> used by the <tt>YahooStatusEnum</tt> class and its + * instances for logging output. + */ private static Logger logger = Logger.getLogger(YahooStatusEnum.class); - + /** * The Online status. Indicate that the user is able and willing to * communicate. @@ -73,7 +77,7 @@ public class YahooStatusEnum public static final YahooStatusEnum NOT_AT_HOME = new YahooStatusEnum(38, "Not at home", loadIcon("resources/images/protocol/yahoo/yahoo16x16-na.png")); - + /** * The On the phone status. Indicates that the user is talking to the phone. */ @@ -82,13 +86,13 @@ public class YahooStatusEnum loadIcon("resources/images/protocol/yahoo/yahoo16x16-phone.png")); /** - * The Not at desk status. Indicates that the user is not at his desk, but + * The Not at desk status. Indicates that the user is not at his desk, but * somewhere in the office. */ public static final YahooStatusEnum NOT_AT_DESK = new YahooStatusEnum(36, "Not at desk", loadIcon("resources/images/protocol/yahoo/yahoo16x16-na.png")); - + /** * The Not Available status. Indicates that the user has connectivity * but might not be able to immediately act (i.e. even less immediately than @@ -105,15 +109,15 @@ public class YahooStatusEnum public static final YahooStatusEnum NOT_IN_OFFICE = new YahooStatusEnum(34, "Not in office", loadIcon("resources/images/protocol/yahoo/yahoo16x16-na.png")); - + /** - * The On vacation status. Indicates that the user is somewhere on the + * The On vacation status. Indicates that the user is somewhere on the * beach or skiing. */ public static final YahooStatusEnum ON_VACATION = new YahooStatusEnum(33, "On vacation", loadIcon("resources/images/protocol/yahoo/yahoo16x16-vacation.png")); - + /** * The DND status. Indicates that the user has connectivity but prefers * not to be contacted. diff --git a/src/net/java/sip/communicator/service/systray/event/SystrayPopupMessageEvent.java b/src/net/java/sip/communicator/service/systray/event/SystrayPopupMessageEvent.java index 716f54a..220f577 100644 --- a/src/net/java/sip/communicator/service/systray/event/SystrayPopupMessageEvent.java +++ b/src/net/java/sip/communicator/service/systray/event/SystrayPopupMessageEvent.java @@ -11,15 +11,25 @@ import java.util.*; /** * The <tt>SystrayPopupMessageEvent</tt>s are posted when user clicks on the * system tray popup message. - * + * * @author Yana Stamcheva */ public class SystrayPopupMessageEvent extends EventObject { + /** + * Serial version UID. + */ + private static final long serialVersionUID = 0L; + /** an object to distinguish this <tt>SystrayPopupMessageEvent</tt> */ private Object tag; + /** + * Constructs a new <tt>SystrayPopupMessageEvent</tt> object. + * + * @param source object on which the Event initially occurred + */ public SystrayPopupMessageEvent(Object source) { super(source); |