javadoc fixes part 6 (ticket #1894)

This commit is contained in:
zzz
2017-01-26 21:45:47 +00:00
parent eefb36cb99
commit d196047382
9 changed files with 13 additions and 16 deletions

View File

@@ -62,7 +62,6 @@ public interface I2NPMessage extends DataStructure {
* starting at ID if type is >= 0 (15 byte header)
* @return size of the message read (including headers)
* @throws I2NPMessageException if there is no valid message
* @throws IOException if there is a problem reading from the stream
*/
public int readBytes(byte data[], int type, int offset) throws I2NPMessageException;
@@ -79,7 +78,6 @@ public interface I2NPMessage extends DataStructure {
* This includes the type byte only if type < 0
* @return size of the message read (including headers)
* @throws I2NPMessageException if there is no valid message
* @throws IOException if there is a problem reading from the stream
* @since 0.8.12
*/
public int readBytes(byte data[], int type, int offset, int maxLen) throws I2NPMessageException;
@@ -95,7 +93,6 @@ public interface I2NPMessage extends DataStructure {
* @param type I2NP message type
* @throws I2NPMessageException if the stream doesn't contain a valid message
* that this class can read.
* @throws IOException if there is a problem reading from the stream
*/
public void readMessage(byte data[], int offset, int dataSize, int type) throws I2NPMessageException;
public void readMessage(byte data[], int offset, int dataSize, int type, I2NPMessageHandler handler) throws I2NPMessageException;

View File

@@ -92,7 +92,7 @@ public class InNetMessagePool implements Service {
/**
* @return previous builder for this message type, or null
* @throws AIOOBE if i2npMessageType is greater than MAX_I2NP_MESSAGE_TYPE
* @throws ArrayIndexOutOfBoundsException if i2npMessageType is greater than MAX_I2NP_MESSAGE_TYPE
*/
public synchronized HandlerJobBuilder registerHandlerJobBuilder(int i2npMessageType, HandlerJobBuilder builder) {
HandlerJobBuilder old = _handlerJobBuilders[i2npMessageType];
@@ -102,7 +102,7 @@ public class InNetMessagePool implements Service {
/**
* @return previous builder for this message type, or null
* @throws AIOOBE if i2npMessageType is greater than MAX_I2NP_MESSAGE_TYPE
* @throws ArrayIndexOutOfBoundsException if i2npMessageType is greater than MAX_I2NP_MESSAGE_TYPE
* @deprecated unused
*/
@Deprecated

View File

@@ -34,7 +34,7 @@ class CloveSet {
public int getCloveCount() { return _cloves.length; }
/** @throws AIOOBE */
/** @throws ArrayIndexOutOfBoundsException */
public GarlicClove getClove(int index) { return _cloves[index]; }
public Certificate getCertificate() { return _cert; }

View File

@@ -183,7 +183,7 @@ public class LoadClientAppsJob extends JobImpl {
*
* @param clientName can be null
* @param args can be null
* @throws just about anything, caller would be wise to catch Throwable
* @throws Exception just about anything, caller would be wise to catch Throwable
* @since 0.7.13
*/
public static void runClientInline(String className, String clientName, String args[], Log log) throws Exception {

View File

@@ -47,7 +47,7 @@ class OutboundMessageState implements CDPQEntry {
* "injected" message from the establisher.
*
* Called from UDPTransport.
* @throws IAE if too big or if msg or peer is null
* @throws IllegalArgumentException if too big or if msg or peer is null
*/
public OutboundMessageState(I2PAppContext context, I2NPMessage msg, PeerState peer) {
this(context, null, msg, peer);
@@ -57,7 +57,7 @@ class OutboundMessageState implements CDPQEntry {
* Normal constructor.
*
* Called from OutboundMessageFragments.
* @throws IAE if too big or if msg or peer is null
* @throws IllegalArgumentException if too big or if msg or peer is null
*/
public OutboundMessageState(I2PAppContext context, OutNetMessage m, PeerState peer) {
this(context, m, m.getMessage(), peer);
@@ -66,7 +66,7 @@ class OutboundMessageState implements CDPQEntry {
/**
* Internal.
* @param m null if msg is "injected"
* @throws IAE if too big or if msg or peer is null
* @throws IllegalArgumentException if too big or if msg or peer is null
*/
private OutboundMessageState(I2PAppContext context, OutNetMessage m, I2NPMessage msg, PeerState peer) {
if (msg == null || peer == null)