projects
/
jFCPlib.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Update license to GPLv3, fix header comments
[jFCPlib.git]
/
src
/
main
/
java
/
net
/
pterodactylus
/
fcp
/
highlevel
/
Request.java
diff --git
a/src/main/java/net/pterodactylus/fcp/highlevel/Request.java
b/src/main/java/net/pterodactylus/fcp/highlevel/Request.java
index
0b0f46e
..
565c8d7
100644
(file)
--- a/
src/main/java/net/pterodactylus/fcp/highlevel/Request.java
+++ b/
src/main/java/net/pterodactylus/fcp/highlevel/Request.java
@@
-1,9
+1,9
@@
/*
/*
- * jFCPlib - Request.java - Copyright © 2009 David Roden
+ * jFCPlib - Request.java - Copyright © 2009
–2016
David Roden
*
*
- * This program is free software
;
you can redistribute it and/or modify
+ * This program is free software
:
you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* it under the terms of the GNU General Public License as published by
- * the Free Software Foundation
; either version 2
of the License, or
+ * the Free Software Foundation
, either version 3
of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
@@
-12,8
+12,7
@@
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
package net.pterodactylus.fcp.highlevel;
*/
package net.pterodactylus.fcp.highlevel;
@@
-132,7
+131,8
@@
public abstract class Request {
* Sets whether this request is complete.
*
* @param complete
* Sets whether this request is complete.
*
* @param complete
- * <code>true</code> if this request is complete, false otherwise
+ * <code>true</code> if this request is complete, false
+ * otherwise
*/
void setComplete(boolean complete) {
this.complete = complete;
*/
void setComplete(boolean complete) {
this.complete = complete;
@@
-219,8
+219,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 <code>true</code> if this request can not be made succeed by
* repeating, <code>false</code> otherwise
*
* @return <code>true</code> if this request can not be made succeed by
* repeating, <code>false</code> otherwise
@@
-255,90
+255,107
@@
public abstract class Request {
* @param totalBlocks
* This request’s total number of blocks
*/
* @param totalBlocks
* This request’s total number of blocks
*/
-
public
void setTotalBlocks(int totalBlocks) {
+ void setTotalBlocks(int totalBlocks) {
this.totalBlocks = 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 requiredB
locks
+ * @return
The number of required b
locks
*/
public int getRequiredBlocks() {
return requiredBlocks;
}
/**
*/
public int getRequiredBlocks() {
return requiredBlocks;
}
/**
- *
TODO
+ *
Sets the number of required blocks.
*
* @param requiredBlocks
*
* @param requiredBlocks
- *
the requiredBlocks to set
+ *
The number of required blocks
*/
*/
-
public
void setRequiredBlocks(int requiredBlocks) {
+ void setRequiredBlocks(int requiredBlocks) {
this.requiredBlocks = requiredBlocks;
}
/**
this.requiredBlocks = requiredBlocks;
}
/**
- *
TODO
+ *
Returns the number of succeeded blocks.
*
*
- * @return
the succeededB
locks
+ * @return
The number of succeeded b
locks
*/
public int getSucceededBlocks() {
return succeededBlocks;
}
/**
*/
public int getSucceededBlocks() {
return succeededBlocks;
}
/**
- *
TODO
+ *
Sets the number of succeeded blocks.
*
* @param succeededBlocks
*
* @param succeededBlocks
- *
the succeededBlocks to set
+ *
The number of succeeded blocks
*/
*/
-
public
void setSucceededBlocks(int succeededBlocks) {
+ void setSucceededBlocks(int succeededBlocks) {
this.succeededBlocks = 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 failedB
locks
+ * @return
The number of failed b
locks
*/
public int getFailedBlocks() {
return failedBlocks;
}
/**
*/
public int getFailedBlocks() {
return failedBlocks;
}
/**
- *
TODO
+ *
Sets the number of failed blocks.
*
* @param failedBlocks
*
* @param failedBlocks
- *
the failedBlocks to set
+ *
The number of failed blocks
*/
*/
-
public
void setFailedBlocks(int failedBlocks) {
+ void setFailedBlocks(int failedBlocks) {
this.failedBlocks = failedBlocks;
}
/**
this.failedBlocks = failedBlocks;
}
/**
- *
TODO
+ *
Returns the number of fatally failed blocks.
*
*
- * @return
the fatallyFailedB
locks
+ * @return
The number of fatally failed b
locks
*/
public int getFatallyFailedBlocks() {
return fatallyFailedBlocks;
}
/**
*/
public int getFatallyFailedBlocks() {
return fatallyFailedBlocks;
}
/**
- *
TODO
+ *
Sets the number of fatally failed blocks.
*
* @param fatallyFailedBlocks
*
* @param fatallyFailedBlocks
- *
the fatallyFailedBlocks to set
+ *
The number of fatally failed blocks
*/
*/
-
public
void setFatallyFailedBlocks(int fatallyFailedBlocks) {
+ void setFatallyFailedBlocks(int fatallyFailedBlocks) {
this.fatallyFailedBlocks = 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;
}
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;
}
void setFinalizedTotal(boolean finalizedTotal) {
this.finalizedTotal = finalizedTotal;
}