Author: toad
Date: 2008-01-12 20:27:36 +0000 (Sat, 12 Jan 2008)
New Revision: 17030
Modified:
trunk/freenet/src/freenet/io/comm/DMT.java
Log:
Javadoc the priorities - explain the reasoning behind setting them a bit
Modified: trunk/freenet/src/freenet/io/comm/DMT.java
===================================================================
--- trunk/freenet/src/freenet/io/comm/DMT.java 2008-01-12 14:31:37 UTC (rev
17029)
+++ trunk/freenet/src/freenet/io/comm/DMT.java 2008-01-12 20:27:36 UTC (rev
17030)
@@ -126,11 +126,20 @@
public static final String REJECT_CODE = "rejectCode";
public static final String ROUTING_ENABLED = "routingEnabled";
+ /** Very urgent */
public static final short PRIORITY_NOW=-2;
- public static final short PRIORITY_HIGH=-1;
+ /** Short timeout, or urgent for other reasons - Accepted, RejectedLoop
etc. */
+ public static final short PRIORITY_HIGH=-1; //
+ /** Unspecified e.g. test-only messages. */
public static final short PRIORITY_UNSPECIFIED=0;
- public static final short PRIORITY_LOW=1;
- public static final short PRIORITY_BULK_DATA=2;
+ /** Long timeout (e.g. DataFound), or moderately urgent. */
+ public static final short PRIORITY_LOW=1; // long timeout, or
moderately urgent
+ /**
+ * Bulk data transfer, bottom of the heap, high level limiting must
ensure there is time to send it by
+ * not accepting an infeasible number of requests; starvation will
cause bwlimitDelayTime to go high and
+ * requests to be rejected. That's the ultimate limiter if even output
bandwidth liability fails.
+ */
+ public static final short PRIORITY_BULK_DATA=2;
// Assimilation
