From b1f11cc0565d7cf87d37c1a55050ec21e02f4101 Mon Sep 17 00:00:00 2001
From: eyedeekay <idk@mulder>
Date: Sun, 10 Dec 2023 18:11:00 -0500
Subject: [PATCH] Router: update javadoc API version for segmented netDb
implementaion
---
.../java/src/net/i2p/router/ClientManagerFacade.java | 4 ++--
router/java/src/net/i2p/router/RouterContext.java | 4 ++--
.../i2p/router/client/ClientConnectionRunner.java | 2 +-
.../src/net/i2p/router/client/ClientManager.java | 4 ++--
.../router/dummy/DummyNetworkDatabaseSegmentor.java | 2 +-
.../kademlia/FloodfillNetworkDatabaseFacade.java | 2 +-
.../kademlia/FloodfillNetworkDatabaseSegmentor.java | 12 ++++++------
.../kademlia/KademliaNetworkDatabaseFacade.java | 6 +++---
.../router/networkdb/kademlia/LookupThrottler.java | 2 +-
.../networkdb/kademlia/NegativeLookupCache.java | 4 ++--
.../kademlia/SegmentedNetworkDatabaseFacade.java | 10 +++++-----
11 files changed, 26 insertions(+), 26 deletions(-)
diff --git a/router/java/src/net/i2p/router/ClientManagerFacade.java b/router/java/src/net/i2p/router/ClientManagerFacade.java
index 9c92922229..82e70f3b0a 100644
--- a/router/java/src/net/i2p/router/ClientManagerFacade.java
+++ b/router/java/src/net/i2p/router/ClientManagerFacade.java
@@ -129,7 +129,7 @@ public abstract class ClientManagerFacade implements Service {
*
* @param destHash destination hash associated with the client who's subDb we're looking for
* @return non-null FloodfillNetworkDatabaseFacade
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract FloodfillNetworkDatabaseFacade getClientFloodfillNetworkDatabaseFacade(Hash destHash);
@@ -137,7 +137,7 @@ public abstract class ClientManagerFacade implements Service {
* get a set of all primary hashes
*
* @return non-null set of Hashes
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract Set<Hash> getPrimaryHashes();
}
diff --git a/router/java/src/net/i2p/router/RouterContext.java b/router/java/src/net/i2p/router/RouterContext.java
index 972862a3cc..0e804eefe2 100644
--- a/router/java/src/net/i2p/router/RouterContext.java
+++ b/router/java/src/net/i2p/router/RouterContext.java
@@ -370,7 +370,7 @@ public class RouterContext extends I2PAppContext {
/**
* Our db cache
- * @since 0.9.60
+ * @since 0.9.61
*/
public SegmentedNetworkDatabaseFacade netDbSegmentor() { return _netDb; }
@@ -381,7 +381,7 @@ public class RouterContext extends I2PAppContext {
* Will return the main netDb if
* the dbid is null or the client db is not found.
*
- * @since 0.9.60
+ * @since 0.9.61
* @param id may be null
* @return non-null
*/
diff --git a/router/java/src/net/i2p/router/client/ClientConnectionRunner.java b/router/java/src/net/i2p/router/client/ClientConnectionRunner.java
index b6cac2b9a3..8648901931 100644
--- a/router/java/src/net/i2p/router/client/ClientConnectionRunner.java
+++ b/router/java/src/net/i2p/router/client/ClientConnectionRunner.java
@@ -1163,7 +1163,7 @@ class ClientConnectionRunner {
* If a session has not been created yet, it will return null.
*
* @return the client netdb or null if no session was created yet
- * @since 0.9.60
+ * @since 0.9.61
*/
public FloodfillNetworkDatabaseFacade getFloodfillNetworkDatabaseFacade() {
return _floodfillNetworkDatabaseFacade;
diff --git a/router/java/src/net/i2p/router/client/ClientManager.java b/router/java/src/net/i2p/router/client/ClientManager.java
index fea0e6d5dc..5be5cc43c0 100644
--- a/router/java/src/net/i2p/router/client/ClientManager.java
+++ b/router/java/src/net/i2p/router/client/ClientManager.java
@@ -779,7 +779,7 @@ class ClientManager {
*
* @param destHash destination hash associated with the client who's subDb we're looking for, may be null
* @return will be null if desthash is null or client does not exist or its netDb is not initialized
- * @since 0.9.60
+ * @since 0.9.61
*/
public FloodfillNetworkDatabaseFacade getClientFloodfillNetworkDatabaseFacade(Hash destHash) {
if (destHash != null) {
@@ -802,7 +802,7 @@ class ClientManager {
* get all the primary hashes for all the clients and return them as a set
*
* @return non-null
- * @since 0.9.60
+ * @since 0.9.61
*/
public Set<Hash> getPrimaryHashes() {
Set<Hash> rv = new HashSet<Hash>();
diff --git a/router/java/src/net/i2p/router/dummy/DummyNetworkDatabaseSegmentor.java b/router/java/src/net/i2p/router/dummy/DummyNetworkDatabaseSegmentor.java
index 6d00af6059..13d64e9d50 100644
--- a/router/java/src/net/i2p/router/dummy/DummyNetworkDatabaseSegmentor.java
+++ b/router/java/src/net/i2p/router/dummy/DummyNetworkDatabaseSegmentor.java
@@ -6,7 +6,7 @@ import net.i2p.router.NetworkDatabaseFacade;
import net.i2p.router.networkdb.kademlia.SegmentedNetworkDatabaseFacade;
/**
- * @since 0.9.60
+ * @since 0.9.61
*/
public class DummyNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseFacade {
private final NetworkDatabaseFacade _fndb;
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseFacade.java b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseFacade.java
index 7b63fa8208..98c853478b 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseFacade.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseFacade.java
@@ -68,7 +68,7 @@ public class FloodfillNetworkDatabaseFacade extends KademliaNetworkDatabaseFacad
* Sub DBs
*
* @param dbid null for main DB
- * @since 0.9.60
+ * @since 0.9.61
*/
public FloodfillNetworkDatabaseFacade(RouterContext context, Hash dbid) {
super(context, dbid);
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseSegmentor.java b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseSegmentor.java
index 611c38abc0..e81d766fd5 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseSegmentor.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/FloodfillNetworkDatabaseSegmentor.java
@@ -37,7 +37,7 @@ import net.i2p.util.Log;
* netDb when it's appropriate to route the netDb entry to one of the special tables.
*
* @author idk
- * @since 0.9.60
+ * @since 0.9.61
*/
public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseFacade {
private final Log _log;
@@ -51,7 +51,7 @@ public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseF
* RouterContext, containing a default, main netDb
* and which is prepared to add client netDbs.
*
- * @since 0.9.60
+ * @since 0.9.61
*/
public FloodfillNetworkDatabaseSegmentor(RouterContext context) {
_log = context.logManager().getLog(getClass());
@@ -79,7 +79,7 @@ public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseF
/**
* If we are floodfill, turn it off and tell everybody for the _mainDbid
*
- * @since 0.9.60
+ * @since 0.9.61
*
*/
public synchronized void shutdown() {
@@ -91,7 +91,7 @@ public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseF
/**
* Start up the _mainDbid
*
- * @since 0.9.60
+ * @since 0.9.61
*
*/
public synchronized void startup() {
@@ -103,7 +103,7 @@ public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseF
/**
* get the main netDb, which is the one we will use if we are a floodfill
*
- * @since 0.9.60
+ * @since 0.9.61
* @return may be null
*/
@Override
@@ -116,7 +116,7 @@ public class FloodfillNetworkDatabaseSegmentor extends SegmentedNetworkDatabaseF
* Will return the "main" netDb if
* the dbid is null.
*
- * @since 0.9.60
+ * @since 0.9.61
* @return may be null if the client netDb does not exist
*/
@Override
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/KademliaNetworkDatabaseFacade.java b/router/java/src/net/i2p/router/networkdb/kademlia/KademliaNetworkDatabaseFacade.java
index 3532a9a03e..0e7918d6e0 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/KademliaNetworkDatabaseFacade.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/KademliaNetworkDatabaseFacade.java
@@ -249,7 +249,7 @@ public abstract class KademliaNetworkDatabaseFacade extends NetworkDatabaseFacad
* cache if we are. If not, it looks up the main Db and gets it.
*
* @return non-null
- * @since 0.9.60
+ * @since 0.9.61
*/
protected BlindCache blindCache() {
if (!isClientDb())
@@ -350,7 +350,7 @@ public abstract class KademliaNetworkDatabaseFacade extends NetworkDatabaseFacad
* Check if the database is a client DB.
*
* @return true if the database is a client DB, false otherwise
- * @since 0.9.60
+ * @since 0.9.61
*/
public boolean isClientDb() {
// This is a null check in disguise, don't use .equals() here.
@@ -1714,7 +1714,7 @@ public abstract class KademliaNetworkDatabaseFacade extends NetworkDatabaseFacad
}
/**
- * @since 0.9.60
+ * @since 0.9.61
*/
@Override
public String toString() {
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/LookupThrottler.java b/router/java/src/net/i2p/router/networkdb/kademlia/LookupThrottler.java
index f63fa96d13..89e6a0ca54 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/LookupThrottler.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/LookupThrottler.java
@@ -35,7 +35,7 @@ class LookupThrottler {
/**
* @param maxlookups when floodfill
* @param maxnonfflookups when not floodfill
- * @since 0.9.60
+ * @since 0.9.61
*/
LookupThrottler(FloodfillNetworkDatabaseFacade facade, int maxlookups, int maxnonfflookups, long cleanTime) {
_facade = facade;
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/NegativeLookupCache.java b/router/java/src/net/i2p/router/networkdb/kademlia/NegativeLookupCache.java
index fc926841af..765cff22c4 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/NegativeLookupCache.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/NegativeLookupCache.java
@@ -92,7 +92,7 @@ class NegativeLookupCache {
/**
* Stops the timer. May not be restarted.
*
- * @since 0.9.60
+ * @since 0.9.61
*/
public void stop() {
clear();
@@ -103,7 +103,7 @@ class NegativeLookupCache {
/**
* Schedules itself.
*
- * @since 0.9.60
+ * @since 0.9.61
*/
public Cleaner(SimpleTimer2 pool) {
super(pool, cleanTime);
diff --git a/router/java/src/net/i2p/router/networkdb/kademlia/SegmentedNetworkDatabaseFacade.java b/router/java/src/net/i2p/router/networkdb/kademlia/SegmentedNetworkDatabaseFacade.java
index 4ba48034ea..f0db26e1c9 100644
--- a/router/java/src/net/i2p/router/networkdb/kademlia/SegmentedNetworkDatabaseFacade.java
+++ b/router/java/src/net/i2p/router/networkdb/kademlia/SegmentedNetworkDatabaseFacade.java
@@ -37,7 +37,7 @@ import net.i2p.router.NetworkDatabaseFacade;
* See implementation: FloodfillNetworkDatabaseSegmentor
*
* @author idk
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract class SegmentedNetworkDatabaseFacade {
@@ -45,7 +45,7 @@ public abstract class SegmentedNetworkDatabaseFacade {
* Get the main netDb, the one which is used if we're a floodfill
*
* @return may be null if main netDb is not initialized
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract NetworkDatabaseFacade mainNetDB();
@@ -54,21 +54,21 @@ public abstract class SegmentedNetworkDatabaseFacade {
* return the mainNetDB.
*
* @return may be null if the client netDb does not exist
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract NetworkDatabaseFacade clientNetDB(Hash dbid);
/**
* Shut down the network databases
*
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract void shutdown();
/**
* Start up the network databases
*
- * @since 0.9.60
+ * @since 0.9.61
*/
public abstract void startup();
}
--
GitLab