org.apache.commons.net.imap
Class IMAPClient

java.lang.Object
  org.apache.commons.net.SocketClient
      org.apache.commons.net.imap.IMAP
          org.apache.commons.net.imap.IMAPClient

Direct Known Subclasses:

IMAPSClient

public class IMAPClient
extends IMAP

The IMAPClient class provides the basic functionalities found in an IMAP client.

Nested Class Summary

static class	IMAPClient.FETCH_ITEM_NAMES The message data item names for the FETCH command defined in RFC 3501.
static class	IMAPClient.SEARCH_CRITERIA The search criteria defined in RFC 3501.
static class	IMAPClient.STATUS_DATA_ITEMS The status data items defined in RFC 3501.

Nested classes/interfaces inherited from class org.apache.commons.net.imap.IMAP

IMAP.IMAPState

Field Summary

Fields inherited from class org.apache.commons.net.imap.IMAP

__DEFAULT_ENCODING, __writer, _reader, DEFAULT_PORT

Fields inherited from class org.apache.commons.net.SocketClient

_defaultPort_, _input_, _output_, _serverSocketFactory_, _socket_, _socketFactory_, _timeout_, connectTimeout, NETASCII_EOL

Constructor Summary

IMAPClient()

Method Summary

boolean	append(String mailboxName) Send an APPEND command to the server.
boolean	append(String mailboxName, String flags, String datetime) Send an APPEND command to the server.
boolean	capability() Send a CAPABILITY command to the server.
boolean	check() Send a CHECK command to the server.
boolean	close() Send a CLOSE command to the server.
boolean	copy(String sequenceSet, String mailboxName) Send a COPY command to the server.
boolean	create(String mailboxName) Send a CREATE command to the server.
boolean	delete(String mailboxName) Send a DELETE command to the server.
boolean	examine(String mailboxName) Send an EXAMINE command to the server.
boolean	expunge() Send an EXPUNGE command to the server.
boolean	fetch(String sequenceSet, String itemNames) Send a FETCH command to the server.
boolean	list(String refName, String mailboxName) Send a LIST command to the server.
boolean	login(String username, String password) Login to the IMAP server with the given username and password.
boolean	logout() Send a LOGOUT command to the server.
boolean	lsub(String refName, String mailboxName) Send an LSUB command to the server.
boolean	noop() Send a NOOP command to the server.
boolean	rename(String oldMailboxName, String newMailboxName) Send a RENAME command to the server.
boolean	search(String criteria) Send a SEARCH command to the server.
boolean	search(String charset, String criteria) Send a SEARCH command to the server.
boolean	select(String mailboxName) Send a SELECT command to the server.
boolean	status(String mailboxName, String[] itemNames) Send a STATUS command to the server.
boolean	store(String sequenceSet, String itemNames, String itemValues) Send a STORE command to the server.
boolean	subscribe(String mailboxName) Send a SUBSCRIBE command to the server.
boolean	uid(String command, String commandArgs) Send a UID command to the server.
boolean	unsubscribe(String mailboxName) Send a UNSUBSCRIBE command to the server.

Methods inherited from class org.apache.commons.net.imap.IMAP

_connectAction_, disconnect, doCommand, doCommand, generateCommandID, getReplyString, getReplyStrings, getState, sendCommand, sendCommand, sendCommand, sendCommand, sendData, setState

Methods inherited from class org.apache.commons.net.SocketClient

addProtocolCommandListener, connect, connect, connect, connect, connect, connect, createCommandSupport, fireCommandSent, fireReplyReceived, getCommandSupport, getConnectTimeout, getDefaultPort, getDefaultTimeout, getKeepAlive, getLocalAddress, getLocalPort, getProxy, getReceiveBufferSize, getRemoteAddress, getRemotePort, getSendBufferSize, getServerSocketFactory, getSoLinger, getSoTimeout, getTcpNoDelay, isAvailable, isConnected, removeProtocolCommandListener, setConnectTimeout, setDefaultPort, setDefaultTimeout, setKeepAlive, setProxy, setReceiveBufferSize, setSendBufferSize, setServerSocketFactory, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IMAPClient

public IMAPClient()

Method Detail

capability

public boolean capability()
                   throws IOException

Send a CAPABILITY command to the server.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs

noop

public boolean noop()
             throws IOException

Send a NOOP command to the server. This is useful for keeping a connection alive since most IMAP servers will timeout after 10 minutes of inactivity.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

logout

public boolean logout()
               throws IOException

Send a LOGOUT command to the server. To fully disconnect from the server you must call disconnect(). A logout attempt is valid in any state. If the client is in the not authenticated or authenticated state, it enters the logout on a successful logout.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

login

public boolean login(String username,
                     String password)
              throws IOException

Login to the IMAP server with the given username and password. You must first connect to the server with connect before attempting to login. A login attempt is only valid if the client is in the NOT_AUTH_STATE. After logging in, the client enters the AUTH_STATE.

Parameters:

username - The account name being logged in to.

password - The plain text password of the account.

Returns:

True if the login attempt was successful, false if not.

Throws:

IOException - If a network I/O error occurs in the process of logging in.

select

public boolean select(String mailboxName)
               throws IOException

Send a SELECT command to the server.

Parameters:

mailboxName - The mailbox name to select.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

examine

public boolean examine(String mailboxName)
                throws IOException

Send an EXAMINE command to the server.

Parameters:

mailboxName - The mailbox name to examine.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

create

public boolean create(String mailboxName)
               throws IOException

Send a CREATE command to the server.

Parameters:

mailboxName - The mailbox name to create.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

delete

public boolean delete(String mailboxName)
               throws IOException

Send a DELETE command to the server.

Parameters:

mailboxName - The mailbox name to delete.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

rename

public boolean rename(String oldMailboxName,
                      String newMailboxName)
               throws IOException

Send a RENAME command to the server.

Parameters:

oldMailboxName - The existing mailbox name to rename.

newMailboxName - The new mailbox name.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

subscribe

public boolean subscribe(String mailboxName)
                  throws IOException

Send a SUBSCRIBE command to the server.

Parameters:

mailboxName - The mailbox name to subscribe to.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

unsubscribe

public boolean unsubscribe(String mailboxName)
                    throws IOException

Send a UNSUBSCRIBE command to the server.

Parameters:

mailboxName - The mailbox name to unsubscribe from.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

list

public boolean list(String refName,
                    String mailboxName)
             throws IOException

Send a LIST command to the server.

Parameters:

refName - The reference name.

mailboxName - The mailbox name.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

lsub

public boolean lsub(String refName,
                    String mailboxName)
             throws IOException

Send an LSUB command to the server.

Parameters:

refName - The reference name.

mailboxName - The mailbox name.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

status

public boolean status(String mailboxName,
                      String[] itemNames)
               throws IOException

Send a STATUS command to the server.

Parameters:

mailboxName - The reference name.

itemNames - The status data item names.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

append

public boolean append(String mailboxName,
                      String flags,
                      String datetime)
               throws IOException

Send an APPEND command to the server.

Parameters:

mailboxName - The mailbox name.

flags - The flag parenthesized list (optional).

datetime - The date/time string (optional).

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

append

public boolean append(String mailboxName)
               throws IOException

Send an APPEND command to the server.

Parameters:

mailboxName - The mailbox name.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

check

public boolean check()
              throws IOException

Send a CHECK command to the server.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

close

public boolean close()
              throws IOException

Send a CLOSE command to the server.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

expunge

public boolean expunge()
                throws IOException

Send an EXPUNGE command to the server.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

search

public boolean search(String charset,
                      String criteria)
               throws IOException

Send a SEARCH command to the server.

Parameters:

charset - The charset (optional).

criteria - The search criteria.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

search

public boolean search(String criteria)
               throws IOException

Send a SEARCH command to the server.

Parameters:

criteria - The search criteria.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

fetch

public boolean fetch(String sequenceSet,
                     String itemNames)
              throws IOException

Send a FETCH command to the server.

Parameters:

sequenceSet - The sequence set to fetch.

itemNames - The item names for the FETCH command.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

store

public boolean store(String sequenceSet,
                     String itemNames,
                     String itemValues)
              throws IOException

Send a STORE command to the server.

Parameters:

sequenceSet - The sequence set to store.

itemNames - The item names for the STORE command.

itemValues - The item values for the STORE command.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

copy

public boolean copy(String sequenceSet,
                    String mailboxName)
             throws IOException

Send a COPY command to the server.

Parameters:

sequenceSet - The sequence set to fetch.

mailboxName - The mailbox name.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.

uid

public boolean uid(String command,
                   String commandArgs)
            throws IOException

Send a UID command to the server.

Parameters:

command - The command for UID.

commandArgs - The arguments for the command.

Returns:

true if the command was successful,false if not.

Throws:

IOException - If a network I/O error occurs.