X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Ffcp%2Fhighlevel%2FRequest.java;h=4b73398e7b4ea123d70483e50d538b42f7365f14;hb=b171126719c983b590c51f22eb60a3e0afdf1fb9;hp=0b0f46e704a300c22f116db3a8bb909709eabba1;hpb=508624458578f01a393f8b44f32b98b40054fdc8;p=jFCPlib.git
diff --git a/src/main/java/net/pterodactylus/fcp/highlevel/Request.java b/src/main/java/net/pterodactylus/fcp/highlevel/Request.java
index 0b0f46e..4b73398 100644
--- a/src/main/java/net/pterodactylus/fcp/highlevel/Request.java
+++ b/src/main/java/net/pterodactylus/fcp/highlevel/Request.java
@@ -132,7 +132,8 @@ public abstract class Request {
* Sets whether this request is complete.
*
* @param complete
- * true
if this request is complete, false otherwise
+ * true
if this request is complete, false
+ * otherwise
*/
void setComplete(boolean complete) {
this.complete = complete;
@@ -219,8 +220,8 @@ public abstract class Request {
}
/**
- * Returns whether this request has fatally failed, i.e. repitition will not
- * cause the request to succeed.
+ * Returns whether this request has fatally failed, i.e. repitition will
+ * not cause the request to succeed.
*
* @return true
if this request can not be made succeed by
* repeating, false
otherwise
@@ -255,90 +256,107 @@ public abstract class Request {
* @param totalBlocks
* This requestâs total number of blocks
*/
- public void setTotalBlocks(int totalBlocks) {
+ void setTotalBlocks(int totalBlocks) {
this.totalBlocks = totalBlocks;
}
/**
- * TODO
+ * Returns the number of required blocks. Any progress percentages should
+ * be calculated against this value as 100%. Also, as long as
+ * {@link #isFinalizedTotal()} returns {@code false} this value might
+ * change.
*
- * @return the requiredBlocks
+ * @return The number of required blocks
*/
public int getRequiredBlocks() {
return requiredBlocks;
}
/**
- * TODO
+ * Sets the number of required blocks.
*
* @param requiredBlocks
- * the requiredBlocks to set
+ * The number of required blocks
*/
- public void setRequiredBlocks(int requiredBlocks) {
+ void setRequiredBlocks(int requiredBlocks) {
this.requiredBlocks = requiredBlocks;
}
/**
- * TODO
+ * Returns the number of succeeded blocks.
*
- * @return the succeededBlocks
+ * @return The number of succeeded blocks
*/
public int getSucceededBlocks() {
return succeededBlocks;
}
/**
- * TODO
+ * Sets the number of succeeded blocks.
*
* @param succeededBlocks
- * the succeededBlocks to set
+ * The number of succeeded blocks
*/
- public void setSucceededBlocks(int succeededBlocks) {
+ void setSucceededBlocks(int succeededBlocks) {
this.succeededBlocks = succeededBlocks;
}
/**
- * TODO
+ * Returns the number of failed blocks. These blocks may be retried untill
+ * the maximum number of retries has been reached.
*
- * @return the failedBlocks
+ * @return The number of failed blocks
*/
public int getFailedBlocks() {
return failedBlocks;
}
/**
- * TODO
+ * Sets the number of failed blocks.
*
* @param failedBlocks
- * the failedBlocks to set
+ * The number of failed blocks
*/
- public void setFailedBlocks(int failedBlocks) {
+ void setFailedBlocks(int failedBlocks) {
this.failedBlocks = failedBlocks;
}
/**
- * TODO
+ * Returns the number of fatally failed blocks.
*
- * @return the fatallyFailedBlocks
+ * @return The number of fatally failed blocks
*/
public int getFatallyFailedBlocks() {
return fatallyFailedBlocks;
}
/**
- * TODO
+ * Sets the number of fatally failed blocks.
*
* @param fatallyFailedBlocks
- * the fatallyFailedBlocks to set
+ * The number of fatally failed blocks
*/
- public void setFatallyFailedBlocks(int fatallyFailedBlocks) {
+ void setFatallyFailedBlocks(int fatallyFailedBlocks) {
this.fatallyFailedBlocks = fatallyFailedBlocks;
}
+ /**
+ * Returns whether the number of blocks has been finalized.
+ *
+ * @return {@code true} if the number of blocks is finalized, {@code false}
+ * otherwise
+ */
public boolean isFinalizedTotal() {
return finalizedTotal;
}
+ /**
+ * Sets whether the number of blocks has been finalized.
+ *
+ * @param finalizedTotal
+ * {@code true} if the number of blocks has been finalized,
+ * {@code false} otherwise
+ */
void setFinalizedTotal(boolean finalizedTotal) {
this.finalizedTotal = finalizedTotal;
}