フィールドの詳細

• MAX_SUB_SIZE

  static final long MAX_SUB_SIZE

  関連項目:

  定数フィールド値

コンストラクタの詳細

• AddressBook

  public AddressBook​(java.util.Map<java.lang.String,HostTxtEntry> addresses)

  Construct an AddressBook from the contents of the Map addresses.

  パラメータ:

  addresses - A Map containing human readable addresses as keys, mapped to base64 i2p destinations.

• AddressBook

  public AddressBook​(Subscription subscription,
                     java.lang.String proxyHost,
                     int proxyPort)

  Construct an AddressBook from the Subscription subscription. If the address book at subscription has not changed since the last time it was read or cannot be read, return an empty AddressBook. Set a maximum size of the remote book to make it a little harder for a malicious book-sender. Yes, the EepGet fetch() is done in this constructor. This stores the subscription in a temporary file and does not read the whole thing into memory. An AddressBook created with this constructor may not be modified or written using write(). It may be a merge source (an parameter for another AddressBook's merge()) but may not be a merge target (this.merge() will throw an exception).

  パラメータ:

  subscription - A Subscription instance pointing at a remote address book.

  proxyHost - hostname of proxy

  proxyPort - port number of proxy

• AddressBook

  public AddressBook​(java.io.File file)

  Construct an AddressBook from the contents of the file at file. If the file cannot be read, construct an empty AddressBook. This reads the entire file into memory. The resulting map is modifiable and may be a merge target.

  パラメータ:

  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.

• AddressBook

  public AddressBook​(java.lang.String testsubfile)

  Test only.

  パラメータ:

  testsubfile - path to a file containing the simulated fetch of a subscription

  導入されたバージョン:

  0.9.26

メソッドの詳細

• iterator

  public java.util.Iterator<java.util.Map.Entry<java.lang.String,HostTxtEntry>> iterator​()

  Return an iterator over the addresses in the AddressBook.

  定義:

  iterator インタフェース内 java.lang.Iterable<java.util.Map.Entry<java.lang.String,HostTxtEntry>>

  導入されたバージョン:

  0.8.7

• delete

  public void delete​()

  Delete the temp file or clear the map.

  導入されたバージョン:

  0.8.7

• getLocation

  public java.lang.String getLocation​()

  Return the location of the file this AddressBook was constructed from.

  戻り値:

  A String representing either an abstract path, or a url, depending on how the instance was constructed. Will be null if created with the Map constructor.

• toString

  public java.lang.String toString​()

  Return a string representation of the origin of the AddressBook.

  オーバーライド:

  toString クラス内 java.lang.Object

  戻り値:

  A String representing the origin of the AddressBook.

• isValidKey

  public static boolean isValidKey​(java.lang.String host)

  Do basic validation of the hostname hostname was already converted to lower case by HostTxtParser.parse()

• merge

  public void merge​(AddressBook other,
                    boolean overwrite,
                    Log log)

  Merge this AddressBook with AddressBook other, writing messages about new addresses or conflicts to log. Addresses in AddressBook other that are not in this AddressBook are added to this AddressBook. In case of a conflict, addresses in this AddressBook take precedence

  パラメータ:

  other - An AddressBook to merge with.

  overwrite - True to overwrite

  log - The log to write messages about new addresses or conflicts to. May be null.

  例外:

  java.lang.IllegalStateException - if this was created with the Subscription constructor.

• write

  public void write​(java.io.File file)

  Write the contents of this AddressBook out to the File file. If the file cannot be writen to, this method will silently fail.

  パラメータ:

  file - The file to write the contents of this AddressBook too.

  例外:

  java.lang.IllegalStateException - if this was created with the Subscription constructor.

• write

  public void write​()

  Write this AddressBook out to the file it was read from. Requires that AddressBook was constructed from a file on the local filesystem. If the file cannot be writen to, this method will silently fail.

  例外:

  java.lang.IllegalStateException - if this was not created with the File constructor.