to.etc.smtp

Class MimeWriter

java.lang.Object

to.etc.smtp.MimeWriter

public class MimeWriter
extends Object

Write MIME messages. Allows embedding MIME bodies. Please check what comes out of this before changing anything!! Use http://tools.ietf.org/tools/msglint/ for instance.

Author:

Frits Jalvingh Created on Jan 24, 2010

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MimeWriter(MimeWriter dad, OutputStream os)
protected	MimeWriter(OutputStream os)

Method Summary

Modifier and Type	Method and Description
void	close() Write the final boundary terminating the mime body.
static MimeWriter	createMimeWriter(OutputStream os, String contentType, String... subpairs) This creates the root mime writer to some stream.
MimeWriter	createSubMime(String contenttype, String... rest) Create a MIME part in THIS version that is a full MIME compound document itself.
static String	generateContentID() Return a valid content ID for a MIME part.
protected byte[]	getBoundary()
protected String	getBoundaryString()
void	partHeader(String name, String value)
void	partStart(boolean base64, String contenttype, String... subpairs)
OutputStream	partStream() Returns the content stream for the current part.
Writer	partWriter(String encoding) Get a writer which allows writing content to the data in the appropriate format and encoding.
protected void	rawHeader(String name, String value)
void	write(byte[] data)
void	write(byte[] data, int off, int len) Write the specified data TO this writer's output.
void	write(String s) Writes a string in the current encoding.
protected void	writeCRLF()
void	writeHeader(boolean includeboundary, String name, String primevalue, String... subheaders)
void	writeHeader(String name, String primevalue, String... subheaders) BAD CODE - this writes a boundary header where there should not be one.
protected void	writeOpenBoundary() Write a boundary segment for a 'next' part.

Methods inherited from class java.lang.Object

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

Constructor Detail

MimeWriter

protected MimeWriter(@Nonnull
                     OutputStream os)

MimeWriter

protected MimeWriter(@Nonnull
                     MimeWriter dad,
                     @Nonnull
                     OutputStream os)

Method Detail

getBoundary

protected byte[] getBoundary()

getBoundaryString

protected String getBoundaryString()

write

public void write(byte[] data,
                  int off,
                  int len)
           throws IOException

Write the specified data TO this writer's output.

Parameters:

data -

off -

len -

Throws:

IOException

write

public final void write(byte[] data)
                 throws IOException

Throws:

IOException

write

public void write(String s)
           throws IOException

Writes a string in the current encoding.

Parameters:

s -

Throws:

IOException

rawHeader

protected void rawHeader(String name,
                         String value)
                  throws IOException

Throws:

IOException

writeOpenBoundary

protected void writeOpenBoundary()
                          throws IOException

Write a boundary segment for a 'next' part.

Throws:

IOException

writeCRLF

protected void writeCRLF()
                  throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Write the final boundary terminating the mime body.

Throws:

IOException

writeHeader

public void writeHeader(@Nonnull
                        String name,
                        @Nonnull
                        String primevalue,
                        String... subheaders)
                 throws IOException

BAD CODE - this writes a boundary header where there should not be one.

Parameters:

contenttype -

trailer -

Throws:

IOException

writeHeader

public void writeHeader(boolean includeboundary,
                        @Nonnull
                        String name,
                        @Nonnull
                        String primevalue,
                        String... subheaders)
                 throws IOException

Throws:

IOException

generateContentID

@Nonnull
public static String generateContentID()

Return a valid content ID for a MIME part.

Returns:

createMimeWriter

@Nonnull
public static MimeWriter createMimeWriter(@Nonnull
                                                   OutputStream os,
                                                   @Nonnull
                                                   String contentType,
                                                   String... subpairs)
                                            throws IOException

This creates the root mime writer to some stream.

Parameters:

os -

contentType -

rest -

Returns:

Throws:

IOException

partStart

public void partStart(boolean base64,
                      String contenttype,
                      String... subpairs)
               throws IOException

Throws:

IOException

partHeader

public void partHeader(String name,
                       String value)
                throws IOException

Throws:

IOException

partStream

public OutputStream partStream()
                        throws IOException

Returns the content stream for the current part.

Returns:

Throws:

IOException

partWriter

public Writer partWriter(String encoding)
                  throws IOException

Get a writer which allows writing content to the data in the appropriate format and encoding.

Returns:

Throws:

IOException

createSubMime

public MimeWriter createSubMime(String contenttype,
                                String... rest)
                         throws IOException

Create a MIME part in THIS version that is a full MIME compound document itself. This creates the boundary header and the initial MIME headers.

Returns:

Throws:

IOException