|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.i2p.addressbook.AddressBook
class AddressBook
An address book for storing human readable names mapped to base64 i2p destinations. AddressBooks can be created from local and remote files, merged together, and written out to local files.
Field Summary | |
---|---|
(package private) static long |
MAX_SUB_SIZE
|
Constructor Summary | |
---|---|
AddressBook(File file)
Construct an AddressBook from the contents of the file at file. |
|
AddressBook(Map<String,String> addresses)
Construct an AddressBook from the contents of the Map addresses. |
|
AddressBook(Subscription subscription,
String proxyHost,
int proxyPort)
Construct an AddressBook from the Subscription subscription. |
Method Summary | |
---|---|
void |
delete()
Delete the temp file or clear the map. |
protected void |
finalize()
|
String |
getLocation()
Return the location of the file this AddressBook was constructed from. |
static boolean |
isValidKey(String host)
Do basic validation of the hostname hostname was already converted to lower case by ConfigParser.parse() |
Iterator<Map.Entry<String,String>> |
iterator()
Return an iterator over the addresses in the AddressBook. |
void |
merge(AddressBook other,
boolean overwrite,
Log log)
Merge this AddressBook with AddressBook other, writing messages about new addresses or conflicts to log. |
String |
toString()
Return a string representation of the origin of the AddressBook. |
void |
write()
Write this AddressBook out to the file it was read from. |
void |
write(File file)
Write the contents of this AddressBook out to the File file. |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
static final long MAX_SUB_SIZE
Constructor Detail |
---|
public AddressBook(Map<String,String> addresses)
addresses
- A Map containing human readable addresses as keys, mapped to
base64 i2p destinations.public AddressBook(Subscription subscription, String proxyHost, int proxyPort)
subscription
- A Subscription instance pointing at a remote address book.proxyHost
- hostname of proxyproxyPort
- port number of proxypublic AddressBook(File file)
file
- A File pointing at a file with lines in the format
"key=value", where key is a human readable name, and value is
a base64 i2p destination.Method Detail |
---|
public Iterator<Map.Entry<String,String>> iterator()
public void delete()
public String getLocation()
public String toString()
toString
in class Object
public static boolean isValidKey(String host)
public void merge(AddressBook other, boolean overwrite, Log log)
other
- An AddressBook to merge with.overwrite
- True to overwritelog
- The log to write messages about new addresses or conflicts to. May be null.
IllegalStateException
- if this was created with the Subscription constructor.public void write(File file)
file
- The file to write the contents of this AddressBook too.
IllegalStateException
- if this was created with the Subscription constructor.public void write()
IllegalStateException
- if this was not created with the File constructor.protected void finalize()
finalize
in class Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |