Constructor Detail

• MailCache

  MailCache​(I2PAppContext ctx,
            POP3MailBox mailbox,
            String host,
            int port,
            String user,
            String pass)
     throws IOException

  Does NOT load the mails in. Caller MUST call loadFromDisk().

  Parameters:

  mailbox - non-null

  Throws:

  IOException

Method Detail

• loadFromDisk

  public boolean loadFromDisk​(NewMailListener nml)

  Threaded. Returns immediately. This will not access the mailbox. Mailbox need not be ready.

  Returns:

  success false if in progress already and nml will NOT be called back, true if nml will be called back

  Since:

  0.9.13

• getUIDLs

  public String[] getUIDLs()

  The ones known locally, which will include any known on the server, if connected. Will not include any marked for deletion. This will not access the mailbox. Mailbox need not be ready. loadFromDisk() must have been called first.

  Returns:

  non-null

  Since:

  0.9.13

• getMail

  public Mail getMail​(String uidl,
                      MailCache.FetchMode mode)

  Fetch any needed data from pop3 server, unless mode is CACHE_ONLY. Blocking unless mode is CACHE_ONLY.

  Parameters:

  uidl - message id to get

  mode - CACHE_ONLY to not pull from pop server

  Returns:

  An e-mail or null

• getMail

  public boolean getMail​(MailCache.FetchMode mode)

  Fetch any needed data from pop3 server. Mail objects are inserted into the requests. After this, call getUIDLs() to get all known mail UIDLs. MUST already be connected, otherwise returns false. Blocking.

  Parameters:

  mode - HEADER or ALL only

  Returns:

  true if any were fetched

  Since:

  0.9.13

• delete

  public void delete​(String uidl)

  Mark mail for deletion locally. Send delete requests to POP3 then quit and reconnect. No success/failure indication is returned.

  Since:

  0.9.13

• delete

  public void delete​(Collection<String> uidls)

  Mark mail for deletion locally. Send delete requests to POP3 then quit and reconnect. No success/failure indication is returned.

  Since:

  0.9.13