diff --git a/src/org/ice4j/StackProperties.java b/src/org/ice4j/StackProperties.java index 2407db8..0e88692 100644 --- a/src/org/ice4j/StackProperties.java +++ b/src/org/ice4j/StackProperties.java @@ -113,6 +113,16 @@ public class StackProperties public static final String TERMINATION_DELAY = "org.ice4j.TERMINATION_DELAY"; + /** + * The maximum number of milliseconds that we should wait for a check list + * to complete before nominating one of its valid pairs (unless there are + * none in which case we may have to wait until one appears or the whole + * list fails). Default value is -1 which causes the nominator + * to wait until the check list completes or fails. + */ + public static final String NOMINATION_TIMER + = "org.ice4j.NOMINATION_TIMER"; + /** * Returns the String value of the specified property (minus all * encompassing whitespaces)and null in case no property value was mapped diff --git a/src/org/ice4j/ice/NominationStrategy.java b/src/org/ice4j/ice/NominationStrategy.java index 8fc7789..2ad4493 100644 --- a/src/org/ice4j/ice/NominationStrategy.java +++ b/src/org/ice4j/ice/NominationStrategy.java @@ -6,6 +6,8 @@ */ package org.ice4j.ice; +import org.ice4j.*; + /** * Contains the nomination strategies currently supported by this * implementation's {@link DefaultNominator} class. Applications can either @@ -27,7 +29,10 @@ public enum NominationStrategy /** * The strategy consists in nominating the highest priority valid pair once - * all checks in a list have completed. + * all checks in a list have completed, or after the nomination timer has + * fired for that check list, whichever happens first. The value of the + * nomination timer (in ms) is defined by the {@link StackProperties# + * NOMINATION_TIMER} property. */ NOMINATE_HIGHEST_PRIO("NominateHighestPriority"),