DummyNamingService

java.lang.Object

net.i2p.client.naming.NamingService

net.i2p.client.naming.DummyNamingService

Direct Known Subclasses:: BlockfileNamingService, EepGetNamingService, MetaNamingService

public class DummyNamingServiceextends NamingService

A Dummy naming service that can only handle base64 and b32 destinations.

Field Summary
Modifier and Type
Field
Description
private static final Map<String, Destination>
_cache
The LRU cache, with no expiration time.
protected static final int
BASE32_HASH_LENGTH
Length of a base32 hash string.
protected static final int
CACHE_MAX_SIZE
Maximum cache size.
static final int
DEST_SIZE
Standard base64 destination length (no certificate).
static final String
PROP_B32
Property to enable b32 lookup.
Fields inherited from class NamingService
_context, _listeners, _log, _updaters, PROP_IMPL
Modifier and Type
Field
Description
protected final I2PAppContext
_context
The app context.
protected final Set<NamingServiceListener>
_listeners
The listeners.
protected final Log
_log
The logger.
protected final Set<NamingServiceUpdater>
_updaters
The updaters.
static final String
PROP_IMPL
What classname should be used as the naming service impl?
Constructor Summary
Constructors
Modifier
Constructor
Description
protected
DummyNamingService(I2PAppContext context)
The naming service should only be constructed and accessed through the application context.
Method Summary
Modifier and Type
Method
Description
protected static void
clearCache()
Clear all cached destinations.
protected static Destination
getCache(String s)
Look up a cached destination.
Destination
lookup(String hostname, Properties lookupOptions, Properties storedOptions)
Throws, this service knows no destinations.
protected static void
putCache(String s, Destination d)
Provide basic static caching for all services.
protected static void
removeCache(String s)
Remove a cached destination.
Methods inherited from class NamingService
addDestination, addDestination, addNamingService, addNamingService, createInstance, export, export, getBase64Entries, getConfiguration, getEntries, getEntries, getName, getNames, getNames, getNamingServices, getParent, isB32Host, isBlindedHost, isI2PHost, lookup, lookup, lookupAll, lookupAll, lookupBase32, lookupBase64, put, put, putAll, putIfAbsent, putIfAbsent, registerListener, registerUpdater, remove, remove, remove, remove, removeNamingService, requestUpdate, reverseLookup, reverseLookup, reverseLookup, reverseLookupAll, reverseLookupAll, reverseLookupAll, setConfiguration, shutdown, size, size, start, toString, unregisterListener, unregisterUpdater, update
Modifier and Type
Method
Description
boolean
addDestination(String hostname, Destination d)
Add a Destination to an existing hostname's entry in the addressbook.
boolean
addDestination(String hostname, Destination d, Properties options)
Add a Destination to an existing hostname's entry in the addressbook.
boolean
addNamingService(NamingService ns)
Only for chaining-capable NamingServices.
boolean
addNamingService(NamingService ns, boolean head)
Only for chaining-capable NamingServices.
static final NamingService
createInstance(I2PAppContext context)
WARNING - for use by I2PAppContext only - others must use I2PAppContext.namingService().
void
export(Writer out)
Export in a hosts.txt format.
void
export(Writer out, Properties options)
Export in a hosts.txt format.
Map<String,String>
getBase64Entries(Properties options)
This may be more or less efficient than NamingService.getEntries(), depending on the implementation.
Properties
getConfiguration()
Warning - unimplemented in any subclass.
Map<String, Destination>
getEntries()
Warning - This obviously brings the whole database into memory, so use is discouraged.
Map<String, Destination>
getEntries(Properties options)
Warning - This will bring the whole database into memory if options is null, empty, or unsupported, use with caution.
String
getName()
The name of this naming service.
Set<String>
getNames()
All known hostnames.
Set<String>
getNames(Properties options)
All known hostnames matching the specified options.
List<NamingService>
getNamingServices()
For daisy chaining (MetaNamingService).
NamingService
getParent()
This implementation returns null.
static boolean
isB32Host(String hostname)
Is this a b32 hostname? Does NOT validate the base32 part except for length.
static boolean
isBlindedHost(String hostname)
Is this a blinded ("b33") hostname? Does NOT validate the base32 part except for length.
static boolean
isI2PHost(String hostname)
Is this an i2p hostname?
Destination
lookup(String hostname)
Look up a hostname.
Destination
lookup(Hash hash, int timeout)
Same as NamingService.lookupBase32(String, int) but with the SHA256 Hash precalculated This implementation returns null.
List<Destination>
lookupAll(String hostname)
For NamingServices that support multiple Destinations for a single hostname, return all of them.
List<Destination>
lookupAll(String hostname, Properties lookupOptions, List<Properties> storedOptions)
For NamingServices that support multiple Destinations and Properties for a single hostname, return all of them.
Destination
lookupBase32(String hostname, int timeout)
Lookup a Base 32 address.
protected Destination
lookupBase64(String hostname)
If the hostname is a valid Base64 encoded destination, return the decoded Destination.
boolean
put(String hostname, Destination d)
Add a hostname and Destination to the addressbook.
boolean
put(String hostname, Destination d, Properties options)
Add a hostname and Destination to the addressbook.
boolean
putAll(Map<String, Destination> entries, Properties options)
Put all the entries, each with the given options.
boolean
putIfAbsent(String hostname, Destination d)
Add a hostname and Destination to the addressbook.
boolean
putIfAbsent(String hostname, Destination d, Properties options)
Add a hostname and Destination to the addressbook.
void
registerListener(NamingServiceListener nsl)
Register a listener for naming service changes.
void
registerUpdater(NamingServiceUpdater nsu)
Register an updater for the naming service.
boolean
remove(String hostname)
Delete the entry.
boolean
remove(String hostname, Properties options)
Delete the entry.
boolean
remove(String hostname, Destination d)
Remove a hostname's entry only if it contains the Destination d.
boolean
remove(String hostname, Destination d, Properties options)
Remove a hostname's entry only if it contains the Destination d.
boolean
removeNamingService(NamingService ns)
Only for chaining-capable NamingServices.
void
requestUpdate(Properties options)
Ask any registered updaters to update now.
String
reverseLookup(Destination dest)
Reverse lookup a destination.
String
reverseLookup(Destination d, Properties options)
Same as reverseLookup(dest) but with options This implementation returns null.
String
reverseLookup(Hash h)
Reverse lookup a hash.
List<String>
reverseLookupAll(Destination dest)
Reverse lookup a destination This implementation returns reverseLookupAll(dest, null).
List<String>
reverseLookupAll(Destination d, Properties options)
Same as reverseLookupAll(dest) but with options This implementation returns the result from reverseLookup, or null.
List<String>
reverseLookupAll(Hash h)
Reverse lookup a hash.
boolean
setConfiguration(Properties p)
Warning - unimplemented in any subclass.
void
shutdown()
Parent will call when removed.
int
size()
The number of entries in this naming service.
int
size(Properties options)
This implementation returns -1.
void
start()
Parent will call when added.
String
toString()
Returns a string representation of this naming service.
void
unregisterListener(NamingServiceListener nsl)
Unregister a listener for naming service changes.
void
unregisterUpdater(NamingServiceUpdater nsu)
Unregister an updater for the naming service.
boolean
update(String hostname, Destination d, Properties options)
Fails if entry did not previously exist.
Methods inherited from class Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details
- BASE32_HASH_LENGTH
  protected static final int BASE32_HASH_LENGTH
  Length of a base32 hash string.
  See Also:
  Constant Field Values
- PROP_B32
  public static final String PROP_B32
  Property to enable b32 lookup.
  See Also:
  Constant Field Values
- CACHE_MAX_SIZE
  protected static final int CACHE_MAX_SIZE
  Maximum cache size.
- DEST_SIZE
  public static final int DEST_SIZE
  Standard base64 destination length (no certificate).
  See Also:
  Constant Field Values
- _cache
  private static final Map<String, Destination> _cache
  The LRU cache, with no expiration time. Classes should take care to call removeCache(String) for any entries that are invalidated.
Constructor Details
- DummyNamingService
  protected DummyNamingService(I2PAppContext context)
  The naming service should only be constructed and accessed through the application context. This constructor should only be used by the appropriate application context itself.
  Parameters:
  context - the application context
Method Details
- lookup
  public Destination lookup(String hostname, Properties lookupOptions, Properties storedOptions)
  Throws, this service knows no destinations.
  Specified by:
  lookup in class NamingService
  Parameters:
  hostname - mixed case as it could be a key
  lookupOptions - input parameter, NamingService-specific, can be null
  storedOptions - output parameter, NamingService-specific, any stored properties will be added if non-null
  Returns:
  dest or null
- putCache
  protected static void putCache(String s, Destination d)
  Provide basic static caching for all services.
  Parameters:
  s - case-sensitive, could be a hostname or a full b64 string
  d - the destination to cache
- getCache
  protected static Destination getCache(String s)
  Look up a cached destination.
  Parameters:
  s - case-sensitive, could be a hostname or a full b64 string
  Returns:
  cached dest or null
- removeCache
  protected static void removeCache(String s)
  Remove a cached destination.
  Parameters:
  s - case-sensitive, could be a hostname or a full b64 string
- clearCache
  protected static void clearCache()
  Clear all cached destinations. @since 0.8.1.

Field Summary

Fields inherited from class NamingService

Constructor Summary

Method Summary

Methods inherited from class NamingService

Methods inherited from class Object

Field Details

BASE32_HASH_LENGTH

PROP_B32

CACHE_MAX_SIZE

DEST_SIZE

_cache

Constructor Details

Method Details

lookup

putCache

getCache

removeCache

clearCache