Utility classes for use with the JavaMail API. These utility classes are not part of the JavaMail specification. While this package contains many classes used by the JavaMail implementation and not intended for direct use by applications, the classes documented here may be of use to applications.
Classes in this package log debugging information using
java.util.logging as described in the following table:
|Logger Name||Logging Level||Purpose|
|com.sun.mail.util.socket||FINER||Debugging output related to creating sockets|
WARNING: The APIs in this package should be considered EXPERIMENTAL. They may be changed in the future in ways that are incompatible with applications using the current APIs.
Interface Summary Interface Description ReadableMimeA Message or message Part whose data can be read as a MIME format stream.
Class Summary Class Description ASCIIUtility BASE64DecoderStreamThis class implements a BASE64 Decoder. BASE64EncoderStreamThis class implements a BASE64 encoder. BEncoderStreamThis class implements a 'B' Encoder as defined by RFC2047 for encoding MIME headers. CRLFOutputStreamConvert lines into the canonical format, that is, terminate lines with the CRLF sequence. LineInputStreamThis class is to support reading CRLF terminated lines that contain only US-ASCII characters from an input stream. LineOutputStreamThis class is to support writing out Strings as a sequence of bytes terminated by a CRLF sequence. LogOutputStreamCapture output lines and send them to the mail logger. MailLoggerA simplified logger used by JavaMail to handle logging to a PrintStream and logging through a java.util.logging.Logger. MailSSLSocketFactoryAn SSL socket factory that makes it easier to specify trust. MimeUtilGeneral MIME-related utility methods. PropUtilUtilities to make it easier to get property values. QDecoderStreamThis class implements a Q Decoder as defined in RFC 2047 for decoding MIME headers. QEncoderStreamThis class implements a Q Encoder as defined by RFC 2047 for encoding MIME headers. QPDecoderStreamThis class implements a QP Decoder. QPEncoderStreamThis class implements a Quoted Printable Encoder. SharedByteArrayOutputStreamA ByteArrayOutputStream that allows us to share the byte array rather than copy it. SocketFetcherThis class is used to get Sockets. TraceInputStreamThis class is a FilterInputStream that writes the bytes being read from the given input stream into the given output stream. TraceOutputStreamThis class is a subclass of DataOutputStream that copies the data being written into the DataOutputStream into another output stream. UUDecoderStreamThis class implements a UUDecoder. UUEncoderStreamThis class implements a UUEncoder. WriteTimeoutSocketA special Socket that uses a ScheduledExecutorService to implement timeouts for writes.
Exception Summary Exception Description DecodingExceptionA special IOException that indicates a failure to decode data due to an error in the formatting of the data. FolderClosedIOExceptionA variant of FolderClosedException that can be thrown from methods that only throw IOException. MailConnectExceptionA MessagingException that indicates a socket connection attempt failed. MessageRemovedIOExceptionA variant of MessageRemovedException that can be thrown from methods that only throw IOException. SocketConnectExceptionAn IOException that indicates a socket connection attempt failed.