Changeset 24 for protocol/src/main/java/geniusweb/protocol/session/amop/AMOP.java

Timestamp:

10/06/20 13:12:20 (4 years ago)

Author:

bart

Message:

Fixes an issue with processing maxPower of a vote. Javadoc maven plugin now uses latest version.

File:

• protocol/src/main/java/geniusweb/protocol/session/amop/AMOP.java (modified) (4 diffs)

protocol/src/main/java/geniusweb/protocol/session/amop/AMOP.java

@@ -28 +28 @@
 import geniusweb.protocol.CurrentNegoState;
 import geniusweb.protocol.ProtocolException;
-import geniusweb.protocol.WillBeCalled;
 import geniusweb.protocol.partyconnection.ProtocolToPartyConn;
 import geniusweb.protocol.partyconnection.ProtocolToPartyConnFactory;
@@ -51 +50 @@
  * <h1>parameter</h1> AMOP parties can receive a parameter: minVotes containing
  * a Double. If set, the AMOP protocol checks that all {@link Votes} from that
- * party have {@link Vote#getMinPower()} > minVotes.
- * <h1>Protocol steps</h1> The protocol tries to start all parties. If not all
- * parties start, the parties are freed up and another attempt is done to start
- * all parties some time later.
+ * party have {@link Vote#getMinPower()} &gt; minVotes.
+ * <h1>Protocol steps</h1>
+ * <ol>
+ * <li>The protocol tries to start all parties. If not all parties start, the
+ * parties are freed up and another attempt is done to start all parties some
+ * time later.
  * <li>the variable remainingparties = {all parties}
  * <li>The session deadline clock now starts ticking.
  * <li>All parties are sent their settings.
- * <li>Loop until {@link Deadline} is reached or |remainingparties|<2:
+ * <li>Loop until {@link Deadline} is reached or |remainingparties|&lt;2:
  * <ol>
  * <li>protocol sends {@link YourTurn} to all remainingparties. Each party now
  * must submit an {@link Offer} within {@link #PHASE_TIME} seconds. If a party
  * fails to submit it is send Finished and removed from from remainingparties.
- * <li>protocol sends a {@link Voting} containing a List<Bid> containing all
- * received {@link Bid}s. Each party must place his {@link Votes} within
- * {@link #PHASE_TIME} seconds. If a party does not submit, it is send a
+ * <li>protocol sends a {@link Voting} containing a List of {@link Bid}
+ * containing all received {@link Bid}s. Each party must place his {@link Votes}
+ * within {@link #PHASE_TIME} seconds. If a party does not submit, it is send a
  * {@link Finished} and removed from remainingparties. Previous votes for the
  * same bid do not count. But see {@link Agreements}.
- * <li>The protocol determines a maximum sized subset of size N>=2 of the votes
- * for bid B for which the vote conditions hold. If there is such a subset, the
- * parties that placed these votes reached an agreement. They are added to the
- * agreement set, sent the {@link Finished} info and terminated. They are
- * removed from the remainingparties.
+ * <li>The protocol determines a maximum sized subset of size N&ge;2 of the
+ * votes for bid B for which the vote conditions hold. If there is such a
+ * subset, the parties that placed these votes reached an agreement. They are
+ * added to the agreement set, sent the {@link Finished} info and terminated.
+ * They are removed from the remainingparties.
  * </ol>
  * <li>Any remaining parties are sent a {@link Finished} object without
@@ -109 +110 @@
         /**
          * 
-         * @param state normally the initial state coming from SAOPSettings
+         * @param state  normally the initial state coming from SAOPSettings
+         * @param logger the {@link Reporter} to use
          */
         public AMOP(AMOPState state, Reporter logger) {
@@ -218 +220 @@
          * overridable factory method, used for testing.
          * 
-         * @param r
-         * @param delayMs
+         * @param r       the {@link Runnable} that will be called
+         * @param delayMs the time after which r will be called
          * @return new WillBeCalled(r,delayms)
          */