NetDbRenderer (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- net.i2p.router.web.helpers.NetDbRenderer

```
class NetDbRenderer
extends Object
```
Renders the network database (netdb) information for the router console. Handles router and leaseset listings, search, and statistics. Optimized for performance with parallel rendering and optional reverse DNS lookups.

Field Summary

Fields
Modifier and Type	Field and Description
`int`	`localLSCount` Number of local lease sets, set during lease set rendering.
`static int`	`LOOKUP_WAIT` How long to wait for a router lookup before giving up.
`static int`	`LS_LOOKUP_WAIT` How long to wait for a remote lease set lookup.

Constructor Summary
Constructors
Constructor and Description
NetDbRenderer(RouterContext ctx)
Create a renderer bound to the given context.

Constructors
Constructor and Description
`NetDbRenderer(RouterContext ctx)` Create a renderer bound to the given context.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`getPeerProfileTier(Hash peer, boolean fullname)` Peer profile tier name or CSS class.
`boolean`	`isFloodfill()` Whether the router is a floodfill.
`Map<String,String>`	`precacheReverseDNSLookups(Collection<RouterInfo> routers)` Pre-resolves reverse DNS for the given routers, returning the cached results and queuing the rest for background staggered lookups.
`void`	`renderLeaseSet(Writer out, String hostname, boolean debug)` Renders a single leaseset by hostname or b32.
`void`	`renderLeaseSetHTML(Writer out, boolean debug, Hash client)` Renders all leasesets.
`void`	`renderLeaseSetListFragment(Writer out, boolean debug)` Renders the leaseset listing and keyspace estimate for the contentonly fragment mode of the netdb page, reusing the full lease list render.
`void`	`renderLocalLeaseSetList(Writer out)` Renders the local (per-client) leaseset listing, wrapping the lease tables in the #lsWrapper div so the netdb page refreshes them with the same contentonly fragment path as the remote listing.
`void`	`renderLocalSummary(Writer out)` Renders the local leaseset summary header (hidden until JS shows it).
`void`	`renderRouterInfoHTML(Writer out, int pageSize, int page, String routerPrefix, String version, String country, String family, String capabilities, String ipAddress, String sybil, int port, int highPort, SigType signatureType, EncType encryptionType, String mtu, String ipv6Address, String ssuCapabilities, String transport, int cost, int introducerCount)` Renders router information matching search criteria to the given writer.
`String`	`renderRouterInfosInParallel(Collection<RouterInfo> routerInfos, boolean isLocalRouter)` Renders multiple RouterInfo objects in parallel, in ordered chunks of BATCH_SIZE.
`void`	`renderRoutersToWriter(Collection<RouterInfo> routers, Writer out, boolean isLocal, int page, int pageSize)` Renders a list of RouterInfo objects to the given Writer.
`void`	`renderRoutersToWriter(Collection<RouterInfo> routers, Writer out, boolean isLocal, int page, int pageSize, boolean applyPagination)` Renders a list of RouterInfo objects to the given Writer.
`void`	`renderStatusHTML(Writer out, int pageSize, int page, int mode)` Renders the network database status page.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - localLSCount
```
public int localLSCount
```
    Number of local lease sets, set during lease set rendering.
  - LOOKUP_WAIT
```
public static final int LOOKUP_WAIT
```
    How long to wait for a router lookup before giving up.
    See Also:
    Constant Field Values
  - LS_LOOKUP_WAIT
```
public static final int LS_LOOKUP_WAIT
```
    How long to wait for a remote lease set lookup.
    See Also:
    Constant Field Values
- Constructor Detail
  - NetDbRenderer
```
public NetDbRenderer(RouterContext ctx)
```
    Create a renderer bound to the given context.
    Parameters:
    ctx - the router context
- Method Detail
  - getPeerProfileTier
```
public String getPeerProfileTier(Hash peer,
                                 boolean fullname)
```
    Peer profile tier name or CSS class.
    Parameters:
    peer - the peer
    fullname - if true, return full name; else CSS class
    Returns:
    the tier name or class
  - isFloodfill
```
public boolean isFloodfill()
```
    Whether the router is a floodfill.
    Returns:
    whether floodfill
  - precacheReverseDNSLookups
```
public Map<String,String> precacheReverseDNSLookups(Collection<RouterInfo> routers)
```
    Pre-resolves reverse DNS for the given routers, returning the cached results and queuing the rest for background staggered lookups.
    Parameters:
    routers - routers whose primary IPs to resolve
    Returns:
    map of IP to hostname for already-cached lookups
  - renderLeaseSet
```
public void renderLeaseSet(Writer out,
                           String hostname,
                           boolean debug)
                    throws IOException
```
    Renders a single leaseset by hostname or b32.
    Parameters:
    out - Writer to output HTML
    hostname - the destination b32, full hash, or hostname
    debug - if true, show debug info
    Throws:
    IOException - if an I/O error occurs
  - renderLeaseSetHTML
```
public void renderLeaseSetHTML(Writer out,
                               boolean debug,
                               Hash client)
                        throws IOException
```
    Renders all leasesets.
    Parameters:
    out - Writer to output HTML
    debug - if true, sort by distance and show debug info
    client - if non-null, render only leasesets for that client
    Throws:
    IOException - if an I/O error occurs
  - renderLeaseSetListFragment
```
public void renderLeaseSetListFragment(Writer out,
                                       boolean debug)
                                throws IOException
```
    Renders the leaseset listing and keyspace estimate for the contentonly fragment mode of the netdb page, reusing the full lease list render.
    Parameters:
    out - output
    debug - if true, show debug info
    Throws:
    IOException - if an I/O error occurs
  - renderLocalLeaseSetList
```
public void renderLocalLeaseSetList(Writer out)
                             throws IOException
```
    Renders the local (per-client) leaseset listing, wrapping the lease tables in the #lsWrapper div so the netdb page refreshes them with the same contentonly fragment path as the remote listing. The summary table is emitted before the div, mirroring the remote layout. Used by both the full local netdb page and the fragment mode.
    Parameters:
    out - output
    Throws:
    IOException - if an I/O error occurs
  - renderLocalSummary
```
public void renderLocalSummary(Writer out)
                        throws IOException
```
    Renders the local leaseset summary header (hidden until JS shows it).
    Throws:
    IOException
  - renderRouterInfoHTML
```
public void renderRouterInfoHTML(Writer out,
                                 int pageSize,
                                 int page,
                                 String routerPrefix,
                                 String version,
                                 String country,
                                 String family,
                                 String capabilities,
                                 String ipAddress,
                                 String sybil,
                                 int port,
                                 int highPort,
                                 SigType signatureType,
                                 EncType encryptionType,
                                 String mtu,
                                 String ipv6Address,
                                 String ssuCapabilities,
                                 String transport,
                                 int cost,
                                 int introducerCount)
                          throws IOException
```
    Renders router information matching search criteria to the given writer. Supports filtering by version, country, family, capabilities, IP, port, etc. Streams results to reduce memory pressure on low-memory systems. Performs reverse DNS lookups in parallel if enabled.
    Parameters:
    out - Writer to output HTML
    pageSize - number of results per page
    page - zero-based page index
    routerPrefix - optional base64 hash prefix to filter routers (null for all)
    version - optional version string to filter routers
    country - optional country code(s) (comma/space separated) to filter routers
    family - optional router family name to filter routers
    capabilities - optional capability characters (e.g. "fK") to match all
    ipAddress - optional IPv4 address or prefix to filter routers
    sybil - optional; if non-null, collects hashes for Sybil analysis
    port - optional port or start of range (used with highPort)
    highPort - optional end of port range
    signatureType - optional signature type to filter routers
    encryptionType - optional encryption type to filter routers
    mtu - optional MTU value to filter routers
    ipv6Address - optional IPv6 address or prefix to filter routers
    ssuCapabilities - optional SSU capability characters to match
    transport - optional transport style (e.g., "NTCP", "SSU")
    cost - optional cost value to filter router addresses
    introducerCount - unused
    Throws:
    IOException - if writing fails
  - renderRouterInfosInParallel
```
public String renderRouterInfosInParallel(Collection<RouterInfo> routerInfos,
                                          boolean isLocalRouter)
```
    Renders multiple RouterInfo objects in parallel, in ordered chunks of BATCH_SIZE. Falls back to synchronous rendering when the set is larger than one batch, to bound peak memory.
    Parameters:
    routerInfos - collection of routers to render
    isLocalRouter - true if rendering the local router
    Returns:
    concatenated HTML
  - renderRoutersToWriter
```
public void renderRoutersToWriter(Collection<RouterInfo> routers,
                                  Writer out,
                                  boolean isLocal,
                                  int page,
                                  int pageSize)
                           throws IOException
```
    Renders a list of RouterInfo objects to the given Writer. Uses parallel rendering for sets up to 100 routers, streams for larger sets.
    Throws:
    IOException
  - renderRoutersToWriter
```
public void renderRoutersToWriter(Collection<RouterInfo> routers,
                                  Writer out,
                                  boolean isLocal,
                                  int page,
                                  int pageSize,
                                  boolean applyPagination)
                           throws IOException
```
    Renders a list of RouterInfo objects to the given Writer. Uses parallel rendering for sets up to 100 routers, streams for larger sets.
    Parameters:
    applyPagination - whether to apply pagination internally (false if list is already paginated)
    Throws:
    IOException
  - renderStatusHTML
```
public void renderStatusHTML(Writer out,
                             int pageSize,
                             int page,
                             int mode)
                      throws IOException
```
    Renders the network database status page.
    Parameters:
    out - Writer to output HTML
    pageSize - number of routers per page
    page - zero-based page index
    mode - rendering mode: 0 = summary charts, 1 = full router infos, 2 = compact router infos, 3 = summary charts sorted by country count
    Throws:
    IOException - if an I/O error occurs

Class NetDbRenderer

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

localLSCount

LOOKUP_WAIT

LS_LOOKUP_WAIT

Constructor Detail

NetDbRenderer

Method Detail

getPeerProfileTier

isFloodfill

precacheReverseDNSLookups

renderLeaseSet

renderLeaseSetHTML

renderLeaseSetListFragment

renderLocalLeaseSetList

renderLocalSummary

renderRouterInfoHTML

renderRouterInfosInParallel

renderRoutersToWriter

renderRoutersToWriter

renderStatusHTML