Package org.apache.commons.net.imap
Class IMAPSClient
java.lang.Object
org.apache.commons.net.SocketClient
org.apache.commons.net.imap.IMAP
org.apache.commons.net.imap.IMAPClient
org.apache.commons.net.imap.IMAPSClient
- Direct Known Subclasses:
- AuthenticatingIMAPClient
The IMAPSClient class provides SSL/TLS connection encryption to IMAPClient. Copied from
  FTPSClient and modified to suit
 IMAP. If implicit mode is selected (NOT the default), SSL/TLS negotiation starts right after the connection has been established. In explicit mode (the
 default), SSL/TLS negotiation starts when the user calls execTLS() and the server accepts the command.
 
 
 //Implicit usage:
               IMAPSClient c = new IMAPSClient(true);
               c.connect("127.0.0.1", 993);
 //Explicit usage:
               IMAPSClient c = new IMAPSClient();
               c.connect("127.0.0.1", 143);
               if (c.execTLS()) { /rest of the commands here/ }
 
 
 Warning: the hostname is not verified against the certificate by default, use setHostnameVerifier(HostnameVerifier) or
 setEndpointCheckingEnabled(boolean) (on Java 1.7+) to enable verification.- 
Nested Class SummaryNested classes/interfaces inherited from class org.apache.commons.net.imap.IMAPClientIMAPClient.FETCH_ITEM_NAMES, IMAPClient.SEARCH_CRITERIA, IMAPClient.STATUS_DATA_ITEMSNested classes/interfaces inherited from class org.apache.commons.net.imap.IMAPIMAP.IMAPChunkListener, IMAP.IMAPState
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final intThe default IMAP over SSL port.static final StringDefault secure socket protocol name.Fields inherited from class org.apache.commons.net.imap.IMAP__DEFAULT_ENCODING, __writer, _reader, DEFAULT_PORT, TRUE_CHUNK_LISTENERFields inherited from class org.apache.commons.net.SocketClient_defaultPort_, _hostname_, _input_, _output_, _serverSocketFactory_, _socket_, _socketFactory_, _timeout_, connectTimeout, NETASCII_EOL, remoteInetSocketAddress
- 
Constructor SummaryConstructorsConstructorDescriptionConstructor for IMAPSClient.IMAPSClient(boolean implicit) Constructor for IMAPSClient.IMAPSClient(boolean implicit, SSLContext ctx) Constructor for IMAPSClient.IMAPSClient(String proto) Constructor for IMAPSClient.IMAPSClient(String proto, boolean implicit) Constructor for IMAPSClient.IMAPSClient(String proto, boolean implicit, SSLContext ctx) Constructor for IMAPSClient.IMAPSClient(SSLContext context) Constructor for IMAPSClient.
- 
Method SummaryModifier and TypeMethodDescriptionprotected voidBecause there are so many connect() methods, the _connectAction_() method is provided as a means of performing some action immediately after establishing a connection, rather than reimplementing all the connect() methods.booleanexecTLS()The TLS command execution.String[]Returns the names of the cipher suites which could be enabled for use on this connection.String[]Returns the names of the protocol versions which are currently enabled for use on this connection.Gets the currently configuredHostnameVerifier.Gets the currently configuredTrustManager.booleanReturn whether or not endpoint identification using the HTTPS algorithm on Java 1.7+ is enabled.voidsetEnabledCipherSuites(String[] cipherSuites) Controls which particular cipher suites are enabled for use on this connection.voidsetEnabledProtocols(String[] protocolVersions) Controls which particular protocol versions are enabled for use on this connection.voidsetEndpointCheckingEnabled(boolean enable) Automatic endpoint identification checking using the HTTPS algorithm is supported on Java 1.7+.voidsetHostnameVerifier(HostnameVerifier newHostnameVerifier) Override the defaultHostnameVerifierto use.voidsetKeyManager(KeyManager newKeyManager) Sets aKeyManagerto use.voidsetTrustManager(TrustManager newTrustManager) Override the defaultTrustManagerto use.Methods inherited from class org.apache.commons.net.imap.IMAPClientappend, append, append, capability, check, close, copy, create, delete, examine, expunge, fetch, list, login, logout, lsub, noop, rename, search, search, select, status, store, subscribe, uid, unsubscribeMethods inherited from class org.apache.commons.net.imap.IMAPdisconnect, doCommand, doCommand, fireReplyReceived, generateCommandID, getReplyString, getReplyStrings, getState, sendCommand, sendCommand, sendCommand, sendCommand, sendData, setChunkListener, setStateMethods inherited from class org.apache.commons.net.SocketClientaddProtocolCommandListener, applySocketAttributes, checkOpenOutputStream, connect, connect, connect, connect, connect, connect, createCommandSupport, fireCommandSent, getCharset, getCharsetName, getCommandSupport, getConnectTimeout, getDefaultPort, getDefaultTimeout, getKeepAlive, getLocalAddress, getLocalPort, getProxy, getReceiveBufferSize, getRemoteAddress, getRemoteInetSocketAddress, getRemotePort, getSendBufferSize, getServerSocketFactory, getSoLinger, getSoTimeout, getTcpNoDelay, isAvailable, isConnected, removeProtocolCommandListener, setCharset, setConnectTimeout, setDefaultPort, setDefaultTimeout, setKeepAlive, setProxy, setReceiveBufferSize, setSendBufferSize, setServerSocketFactory, setSocketFactory, setSoLinger, setSoTimeout, setTcpNoDelay, verifyRemote
- 
Field Details- 
DEFAULT_IMAPS_PORTThe default IMAP over SSL port.- See Also:
 
- 
DEFAULT_PROTOCOLDefault secure socket protocol name.- See Also:
 
 
- 
- 
Constructor Details- 
IMAPSClientpublic IMAPSClient()Constructor for IMAPSClient. Sets security mode to explicit (isImplicit = false).
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- implicit- The security mode (Implicit/Explicit).
 
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- implicit- The security mode(Implicit/Explicit).
- ctx- A pre-configured SSL Context.
 
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- context- A pre-configured SSL Context.
 
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- proto- the protocol.
 
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- proto- the protocol.
- implicit- The security mode(Implicit/Explicit).
 
- 
IMAPSClientConstructor for IMAPSClient.- Parameters:
- proto- the protocol.
- implicit- The security mode(Implicit/Explicit).
- ctx- the SSL context
 
 
- 
- 
Method Details- 
_connectAction_Because there are so many connect() methods, the _connectAction_() method is provided as a means of performing some action immediately after establishing a connection, rather than reimplementing all the connect() methods.- Overrides:
- _connectAction_in class- IMAP
- Throws:
- IOException- If it is thrown by _connectAction_().
- See Also:
 
- 
execTLSThe TLS command execution.- Returns:
- TRUE if the command and negotiation succeeded.
- Throws:
- SSLException- If the server reply code is not positive.
- IOException- If an I/O error occurs while sending the command or performing the negotiation.
 
- 
getEnabledCipherSuitesReturns the names of the cipher suites which could be enabled for use on this connection. When the underlyingSocketis not anSSLSocketinstance, returns null.- Returns:
- An array of cipher suite names, or null.
 
- 
getEnabledProtocolsReturns the names of the protocol versions which are currently enabled for use on this connection. When the underlyingSocketis not anSSLSocketinstance, returns null.- Returns:
- An array of protocols, or null.
 
- 
getHostnameVerifierGets the currently configuredHostnameVerifier.- Returns:
- A HostnameVerifier instance.
- Since:
- 3.4
 
- 
getTrustManagerGets the currently configuredTrustManager.- Returns:
- A TrustManager instance.
 
- 
isEndpointCheckingEnabledReturn whether or not endpoint identification using the HTTPS algorithm on Java 1.7+ is enabled. The default behavior is for this to be disabled.- Returns:
- True if enabled, false if not.
- Since:
- 3.4
 
- 
setEnabledCipherSuitesControls which particular cipher suites are enabled for use on this connection. Called before server negotiation.- Parameters:
- cipherSuites- The cipher suites.
 
- 
setEnabledProtocolsControls which particular protocol versions are enabled for use on this connection. I perform setting before a server negotiation.- Parameters:
- protocolVersions- The protocol versions.
 
- 
setEndpointCheckingEnabledAutomatic endpoint identification checking using the HTTPS algorithm is supported on Java 1.7+. The default behavior is for this to be disabled.- Parameters:
- enable- Enable automatic endpoint identification checking using the HTTPS algorithm on Java 1.7+.
- Since:
- 3.4
 
- 
setHostnameVerifierOverride the defaultHostnameVerifierto use.- Parameters:
- newHostnameVerifier- The HostnameVerifier implementation to set or- nullto disable.
- Since:
- 3.4
 
- 
setKeyManagerSets aKeyManagerto use.- Parameters:
- newKeyManager- The KeyManager implementation to set.
- See Also:
 
- 
setTrustManagerOverride the defaultTrustManagerto use.- Parameters:
- newTrustManager- The TrustManager implementation to set.
- See Also:
 
 
-