net.i2p.data
public class RouterInfo extends DatabaseEntry
Modifier and Type | Field and Description |
---|---|
static String |
BW_CAPABILITY_CHARS |
static char |
CAPABILITY_HIDDEN |
static String |
PROP_CAPABILITIES |
static String |
PROP_NETWORK_ID |
_currentRoutingKey, _routingKeyGenMod, _signature, KEY_TYPE_LEASESET, KEY_TYPE_ROUTERINFO
Constructor and Description |
---|
RouterInfo() |
RouterInfo(RouterInfo old) |
Modifier and Type | Method and Description |
---|---|
void |
addCapability(char cap) |
void |
delCapability(char cap) |
boolean |
equals(Object object) |
Set<RouterAddress> |
getAddresses()
Retrieve the set of RouterAddress structures at which this
router can be contacted.
|
String |
getBandwidthTier()
Return a string representation of this node's bandwidth tier,
or "Unknown"
|
protected byte[] |
getBytes()
Write out the raw payload of the routerInfo, excluding the signature.
|
String |
getCapabilities()
what special capabilities this router offers
|
long |
getDate()
A common interface to the timestamp of the two subclasses.
|
RouterIdentity |
getIdentity()
Retrieve the identity of the router represented
|
protected KeysAndCert |
getKeysAndCert()
Get the keys and the cert
Identical to getDestination() in LeaseSet,
and getIdentity() in RouterInfo.
|
int |
getNetworkId()
which network is this routerInfo a part of.
|
String |
getOption(String opt) |
Properties |
getOptions()
Retrieve a set of options or statistics that the router can expose
|
Set<Hash> |
getPeers()
Deprecated.
Implemented here but unused elsewhere
|
long |
getPublished()
Retrieve the approximate date on which the info was published
(essentially a version number for the routerInfo structure, except that
it also contains freshness information - whether or not the router is
currently publishing its information).
|
RouterAddress |
getTargetAddress(String transportStyle)
Pull the first workable target address for the given transport
|
List<RouterAddress> |
getTargetAddresses(String transportStyle)
For future multiple addresses per-transport (IPV6), currently unused
|
int |
getType()
Get the type of the data structure.
|
int |
hashCode() |
boolean |
isCurrent(long maxAgeMs)
Determine whether the router was published recently (within the given age milliseconds).
|
boolean |
isHidden()
Is this a hidden node?
|
boolean |
isValid()
Determine whether this router info is authorized with a valid signature
|
static void |
main(String[] args)
Print out routerinfos from files specified on the command line
|
void |
readBytes(InputStream in)
This does NOT validate the signature
|
void |
setAddresses(Set<RouterAddress> addresses)
Specify a set of RouterAddress structures at which this router
can be contacted.
|
void |
setIdentity(RouterIdentity ident)
Configure the identity of the router represented
|
void |
setOptions(Properties options)
Configure a set of options or statistics that the router can expose
|
void |
setPeers(Set<Hash> peers)
Deprecated.
Implemented here but unused elsewhere
|
void |
setPublished(long published)
Date on which it was published, in milliseconds since Midnight GMT on Jan 01, 1970
|
String |
toString() |
void |
writeBytes(OutputStream out)
This does NOT validate the signature
|
getHash, getRoutingKey, getSignature, getSigningPublicKey, setRoutingKey, setSignature, sign, validateRoutingKey, verifySignature
calculateHash, fromBase64, fromByteArray, read, toBase64, toByteArray
public static final String PROP_NETWORK_ID
public static final String PROP_CAPABILITIES
public static final char CAPABILITY_HIDDEN
public static final String BW_CAPABILITY_CHARS
public RouterInfo()
public RouterInfo(RouterInfo old)
public long getDate()
DatabaseEntry
getDate
in class DatabaseEntry
protected KeysAndCert getKeysAndCert()
DatabaseEntry
getKeysAndCert
in class DatabaseEntry
public int getType()
DatabaseEntry
getType
in class DatabaseEntry
public RouterIdentity getIdentity()
public void setIdentity(RouterIdentity ident)
public long getPublished()
public void setPublished(long published)
public Set<RouterAddress> getAddresses()
public void setAddresses(Set<RouterAddress> addresses)
public Set<Hash> getPeers()
public void setPeers(Set<Hash> peers)
public Properties getOptions()
public void setOptions(Properties options)
options
- if null, clears current optionsprotected byte[] getBytes() throws DataFormatException
getBytes
in class DatabaseEntry
DataFormatException
- if the data is somehow b0rked (missing props, etc)public boolean isValid()
public int getNetworkId()
public String getCapabilities()
public boolean isHidden()
public String getBandwidthTier()
public void addCapability(char cap)
public void delCapability(char cap)
public boolean isCurrent(long maxAgeMs)
maxAgeMs
- milliseconds between the current time and publish date to checkpublic RouterAddress getTargetAddress(String transportStyle)
public List<RouterAddress> getTargetAddresses(String transportStyle)
public void readBytes(InputStream in) throws DataFormatException, IOException
in
- stream to read fromDataFormatException
- if the data is improperly formattedIOException
- if there was a problem reading the streampublic void writeBytes(OutputStream out) throws DataFormatException, IOException
out
- stream to write toDataFormatException
- if the data was incomplete or not yet ready to be writtenIOException
- if there was a problem writing to the streampublic static void main(String[] args)