Reformat.
authorDavid ‘Bombe’ Roden <bombe@pterodactylus.net>
Thu, 12 Sep 2013 04:35:25 +0000 (06:35 +0200)
committerDavid ‘Bombe’ Roden <bombe@pterodactylus.net>
Thu, 12 Sep 2013 04:35:25 +0000 (06:35 +0200)
src/main/java/net/pterodactylus/sone/core/WebOfTrustUpdater.java

index ac38571..dd3de58 100644 (file)
@@ -61,7 +61,7 @@ public class WebOfTrustUpdater extends AbstractService {
         * Creates a new trust updater.
         *
         * @param webOfTrustConnector
         * Creates a new trust updater.
         *
         * @param webOfTrustConnector
-        *            The web of trust connector
+        *              The web of trust connector
         */
        @Inject
        public WebOfTrustUpdater(WebOfTrustConnector webOfTrustConnector) {
         */
        @Inject
        public WebOfTrustUpdater(WebOfTrustConnector webOfTrustConnector) {
@@ -74,19 +74,18 @@ public class WebOfTrustUpdater extends AbstractService {
        //
 
        /**
        //
 
        /**
-        * Updates the trust relation between the truster and the trustee. This
-        * method will return immediately and perform a trust update in the
-        * background.
+        * Updates the trust relation between the truster and the trustee. This method
+        * will return immediately and perform a trust update in the background.
         *
         * @param truster
         *
         * @param truster
-        *            The identity giving the trust
+        *              The identity giving the trust
         * @param trustee
         * @param trustee
-        *            The identity receiving the trust
+        *              The identity receiving the trust
         * @param score
         * @param score
-        *            The new level of trust (from -100 to 100, may be {@code null}
-        *            to remove the trust completely)
+        *              The new level of trust (from -100 to 100, may be {@code null} to remove
+        *              the trust completely)
         * @param comment
         * @param comment
-        *            The comment of the trust relation
+        *              The comment of the trust relation
         */
        public void setTrust(OwnIdentity truster, Identity trustee, Integer score, String comment) {
                SetTrustJob setTrustJob = new SetTrustJob(truster, trustee, score, comment);
         */
        public void setTrust(OwnIdentity truster, Identity trustee, Integer score, String comment) {
                SetTrustJob setTrustJob = new SetTrustJob(truster, trustee, score, comment);
@@ -105,22 +104,22 @@ public class WebOfTrustUpdater extends AbstractService {
         * Adds the given context to the given own identity.
         *
         * @param ownIdentity
         * Adds the given context to the given own identity.
         *
         * @param ownIdentity
-        *            The own identity to add the context to
+        *              The own identity to add the context to
         * @param context
         * @param context
-        *            The context to add
+        *              The context to add
         */
        public void addContext(OwnIdentity ownIdentity, String context) {
                addContextWait(ownIdentity, context, false);
        }
 
        /**
         */
        public void addContext(OwnIdentity ownIdentity, String context) {
                addContextWait(ownIdentity, context, false);
        }
 
        /**
-        * Adds the given context to the given own identity, waiting for completion
-        * of the operation.
+        * Adds the given context to the given own identity, waiting for completion of
+        * the operation.
         *
         * @param ownIdentity
         *
         * @param ownIdentity
-        *            The own identity to add the context to
+        *              The own identity to add the context to
         * @param context
         * @param context
-        *            The context to add
+        *              The context to add
         * @return {@code true} if the context was added successfully, {@code false}
         *         otherwise
         */
         * @return {@code true} if the context was added successfully, {@code false}
         *         otherwise
         */
@@ -129,19 +128,19 @@ public class WebOfTrustUpdater extends AbstractService {
        }
 
        /**
        }
 
        /**
-        * Adds the given context to the given own identity, waiting for completion
-        * of the operation.
+        * Adds the given context to the given own identity, waiting for completion of
+        * the operation.
         *
         * @param ownIdentity
         *
         * @param ownIdentity
-        *            The own identity to add the context to
+        *              The own identity to add the context to
         * @param context
         * @param context
-        *            The context to add
+        *              The context to add
         * @param wait
         * @param wait
-        *            {@code true} to wait for the end of the operation,
-        *            {@code false} to return immediately
-        * @return {@code true} if the context was added successfully, {@code false}
-        *         if the context was not added successfully, or if the job should
-        *         not wait for completion
+        *              {@code true} to wait for the end of the operation, {@code false} to return
+        *              immediately
+        * @return {@code true} if the context was added successfully, {@code false} if
+        *         the context was not added successfully, or if the job should not
+        *         wait for completion
         */
        private boolean addContextWait(OwnIdentity ownIdentity, String context, boolean wait) {
                AddContextJob addContextJob = new AddContextJob(ownIdentity, context);
         */
        private boolean addContextWait(OwnIdentity ownIdentity, String context, boolean wait) {
                AddContextJob addContextJob = new AddContextJob(ownIdentity, context);
@@ -169,9 +168,9 @@ public class WebOfTrustUpdater extends AbstractService {
         * Removes the given context from the given own identity.
         *
         * @param ownIdentity
         * Removes the given context from the given own identity.
         *
         * @param ownIdentity
-        *            The own identity to remove the context from
+        *              The own identity to remove the context from
         * @param context
         * @param context
-        *            The context to remove
+        *              The context to remove
         */
        public void removeContext(OwnIdentity ownIdentity, String context) {
                RemoveContextJob removeContextJob = new RemoveContextJob(ownIdentity, context);
         */
        public void removeContext(OwnIdentity ownIdentity, String context) {
                RemoveContextJob removeContextJob = new RemoveContextJob(ownIdentity, context);
@@ -189,11 +188,11 @@ public class WebOfTrustUpdater extends AbstractService {
         * Sets a property on the given own identity.
         *
         * @param ownIdentity
         * Sets a property on the given own identity.
         *
         * @param ownIdentity
-        *            The own identity to set the property on
+        *              The own identity to set the property on
         * @param propertyName
         * @param propertyName
-        *            The name of the property to set
+        *              The name of the property to set
         * @param propertyValue
         * @param propertyValue
-        *            The value of the property to set
+        *              The value of the property to set
         */
        public void setProperty(OwnIdentity ownIdentity, String propertyName, String propertyValue) {
                SetPropertyJob setPropertyJob = new SetPropertyJob(ownIdentity, propertyName, propertyValue);
         */
        public void setProperty(OwnIdentity ownIdentity, String propertyName, String propertyValue) {
                SetPropertyJob setPropertyJob = new SetPropertyJob(ownIdentity, propertyName, propertyValue);
@@ -212,9 +211,9 @@ public class WebOfTrustUpdater extends AbstractService {
         * Removes a property from the given own identity.
         *
         * @param ownIdentity
         * Removes a property from the given own identity.
         *
         * @param ownIdentity
-        *            The own identity to remove the property from
+        *              The own identity to remove the property from
         * @param propertyName
         * @param propertyName
-        *            The name of the property to remove
+        *              The name of the property to remove
         */
        public void removeProperty(OwnIdentity ownIdentity, String propertyName) {
                setProperty(ownIdentity, propertyName, null);
         */
        public void removeProperty(OwnIdentity ownIdentity, String propertyName) {
                setProperty(ownIdentity, propertyName, null);
@@ -224,9 +223,7 @@ public class WebOfTrustUpdater extends AbstractService {
        // SERVICE METHODS
        //
 
        // SERVICE METHODS
        //
 
-       /**
-        * {@inheritDoc}
-        */
+       /** {@inheritDoc} */
        @Override
        protected void serviceRun() {
                while (!shouldStop()) {
        @Override
        protected void serviceRun() {
                while (!shouldStop()) {
@@ -246,9 +243,7 @@ public class WebOfTrustUpdater extends AbstractService {
                }
        }
 
                }
        }
 
-       /**
-        * {@inheritDoc}
-        */
+       /** {@inheritDoc} */
        @Override
        protected void serviceStop() {
                try {
        @Override
        protected void serviceStop() {
                try {
@@ -281,7 +276,7 @@ public class WebOfTrustUpdater extends AbstractService {
 
                /**
                 * Performs the actual update operation.
 
                /**
                 * Performs the actual update operation.
-                * <p>
+                * <p/>
                 * The implementation of this class does nothing.
                 */
                public void run() {
                 * The implementation of this class does nothing.
                 */
                public void run() {
@@ -289,8 +284,7 @@ public class WebOfTrustUpdater extends AbstractService {
                }
 
                /**
                }
 
                /**
-                * Waits for completion of this job or stopping of the WebOfTrust
-                * updater.
+                * Waits for completion of this job or stopping of the WebOfTrust updater.
                 *
                 * @return {@code true} if this job finished successfully, {@code false}
                 *         otherwise
                 *
                 * @return {@code true} if this job finished successfully, {@code false}
                 *         otherwise
@@ -318,8 +312,7 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Signals that this job has finished.
                 *
                 * @param success
                 * Signals that this job has finished.
                 *
                 * @param success
-                *            {@code true} if this job finished successfully,
-                *            {@code false} otherwise
+                *              {@code true} if this job finished successfully, {@code false} otherwise
                 */
                protected void finish(boolean success) {
                        synchronized (syncObject) {
                 */
                protected void finish(boolean success) {
                        synchronized (syncObject) {
@@ -354,14 +347,14 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Creates a new set trust job.
                 *
                 * @param truster
                 * Creates a new set trust job.
                 *
                 * @param truster
-                *            The identity giving the trust
+                *              The identity giving the trust
                 * @param trustee
                 * @param trustee
-                *            The identity receiving the trust
+                *              The identity receiving the trust
                 * @param score
                 * @param score
-                *            The score of the trust (from -100 to 100, may be
-                *            {@code null} to remote the trust relation completely)
+                *              The score of the trust (from -100 to 100, may be {@code null} to remote
+                *              the trust relation completely)
                 * @param comment
                 * @param comment
-                *            The comment of the trust relation
+                *              The comment of the trust relation
                 */
                public SetTrustJob(OwnIdentity truster, Identity trustee, Integer score, String comment) {
                        this.truster = truster;
                 */
                public SetTrustJob(OwnIdentity truster, Identity trustee, Integer score, String comment) {
                        this.truster = truster;
@@ -370,9 +363,7 @@ public class WebOfTrustUpdater extends AbstractService {
                        this.comment = comment;
                }
 
                        this.comment = comment;
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
@@ -440,9 +431,9 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Creates a new context update job.
                 *
                 * @param ownIdentity
                 * Creates a new context update job.
                 *
                 * @param ownIdentity
-                *            The own identity to update
+                *              The own identity to update
                 * @param context
                 * @param context
-                *            The context to update
+                *              The context to update
                 */
                @SuppressWarnings("synthetic-access")
                public WebOfTrustContextUpdateJob(OwnIdentity ownIdentity, String context) {
                 */
                @SuppressWarnings("synthetic-access")
                public WebOfTrustContextUpdateJob(OwnIdentity ownIdentity, String context) {
@@ -454,9 +445,7 @@ public class WebOfTrustUpdater extends AbstractService {
                // OBJECT METHODS
                //
 
                // OBJECT METHODS
                //
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                public boolean equals(Object object) {
                        if ((object == null) || !object.getClass().equals(getClass())) {
                @Override
                public boolean equals(Object object) {
                        if ((object == null) || !object.getClass().equals(getClass())) {
@@ -466,17 +455,13 @@ public class WebOfTrustUpdater extends AbstractService {
                        return updateJob.ownIdentity.equals(ownIdentity) && updateJob.context.equals(context);
                }
 
                        return updateJob.ownIdentity.equals(ownIdentity) && updateJob.context.equals(context);
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                public int hashCode() {
                        return getClass().hashCode() ^ ownIdentity.hashCode() ^ context.hashCode();
                }
 
                @Override
                public int hashCode() {
                        return getClass().hashCode() ^ ownIdentity.hashCode() ^ context.hashCode();
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                public String toString() {
                        return String.format("%s[ownIdentity=%s,context=%s]", getClass().getSimpleName(), ownIdentity, context);
                @Override
                public String toString() {
                        return String.format("%s[ownIdentity=%s,context=%s]", getClass().getSimpleName(), ownIdentity, context);
@@ -495,17 +480,15 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Creates a new add-context job.
                 *
                 * @param ownIdentity
                 * Creates a new add-context job.
                 *
                 * @param ownIdentity
-                *            The own identity whose contexts to manage
+                *              The own identity whose contexts to manage
                 * @param context
                 * @param context
-                *            The context to add
+                *              The context to add
                 */
                public AddContextJob(OwnIdentity ownIdentity, String context) {
                        super(ownIdentity, context);
                }
 
                 */
                public AddContextJob(OwnIdentity ownIdentity, String context) {
                        super(ownIdentity, context);
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
@@ -532,17 +515,15 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Creates a new remove-context job.
                 *
                 * @param ownIdentity
                 * Creates a new remove-context job.
                 *
                 * @param ownIdentity
-                *            The own identity whose contexts to manage
+                *              The own identity whose contexts to manage
                 * @param context
                 * @param context
-                *            The context to remove
+                *              The context to remove
                 */
                public RemoveContextJob(OwnIdentity ownIdentity, String context) {
                        super(ownIdentity, context);
                }
 
                 */
                public RemoveContextJob(OwnIdentity ownIdentity, String context) {
                        super(ownIdentity, context);
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
@@ -578,20 +559,19 @@ public class WebOfTrustUpdater extends AbstractService {
                 * Creates a new set-property job.
                 *
                 * @param ownIdentity
                 * Creates a new set-property job.
                 *
                 * @param ownIdentity
-                *            The own identity to set the property on
+                *              The own identity to set the property on
                 * @param propertyName
                 * @param propertyName
-                *            The name of the property to set
+                *              The name of the property to set
                 * @param propertyValue
                 * @param propertyValue
-                *            The value of the property to set
+                *              The value of the property to set
                 */
                public SetPropertyJob(OwnIdentity ownIdentity, String propertyName, String propertyValue) {
                 */
                public SetPropertyJob(OwnIdentity ownIdentity, String propertyName, String propertyValue) {
-                       super(ownIdentity, propertyName);
+                       this.ownIdentity = ownIdentity;
+                       this.propertyName = propertyName;
                        this.propertyValue = propertyValue;
                }
 
                        this.propertyValue = propertyValue;
                }
 
-               /**
-                * {@inheritDoc}
-                */
+               /** {@inheritDoc} */
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {
                @Override
                @SuppressWarnings("synthetic-access")
                public void run() {