MultiPartOutput (Base Interlok)

java.lang.Object
- com.adaptris.util.text.mime.MultiPartOutput

All Implemented Interfaces:: MimeConstants

public class MultiPartOutput
extends java.lang.Object
implements MimeConstants

Handle creation of multipart mime output.

When a getBytes() is performed, then the output is something similar to

  
  Message-ID: db03b6ef-ffff-ffc0-019b-04e2b47a4d8e
  Mime-Version: 1.0
  Content-Type: multipart/mixed;
    boundary="----=_Part_1_33189144.1047351507632"
  Content-Length: 383
 
  ------=_Part_1_33189144.1047351507632
  Content-Id: AdaptrisMessage/payload
 
  This is the message 03/11/2003 01:57 PM
 
  ------=_Part_1_33189144.1047351507632
  Content-Id: AdaptrisMessage/metadata
 
  workflowId=loopback
  previousGuid=db03b6ef-ffff-ffc0-019b-04e2b47a4d8e
  emailmessageid=<200303110257.h2B2v9sC030299@localhost.localdomain>
 
  ------=_Part_1_33189144.1047351507632--

With each additional call to addPart()>/code> an additional mime bodypart is created. Repeated calls to getBytes() will return the latest version of the MimeMultiPart as written out. There is no guarantee that this is the same as the last call to getBytes() as the part id's may change.


 
 If non-unique content-id's are used for each bodypart, then an invocation of removePart(String) will remove
 all matching body parts.










Field Summary




Fields inherited from interface com.adaptris.util.text.mime.MimeConstants
CONTENT_TYPE_OCTET_STREAM, CONTENT_TYPE_TEXT_PLAIN, CONTENT_TYPE_WWW_FORM_URLENCODE, ENCODING_7BIT, ENCODING_8BIT, ENCODING_BASE64, ENCODING_BINARY, ENCODING_QUOTED, ENCODING_UUENCODE, HEADER_CONTENT_DESC, HEADER_CONTENT_ENCODING, HEADER_CONTENT_ID, HEADER_CONTENT_LENGTH, HEADER_CONTENT_TYPE, HEADER_MESSAGE_ID, HEADER_MIME_VERSION








Constructor Summary

Constructors 

Constructor and Description


MultiPartOutput(java.lang.String mimeId)
Constructor.



MultiPartOutput(java.lang.String mimeId,
               java.lang.String subtype)
Constructor.










Method Summary

All Methods Instance Methods Concrete Methods 

Modifier and Type
Method and Description


void
addPart(byte[] payload,
       java.lang.String contentId)
Add a new part to the mime multipart.



void
addPart(byte[] payload,
       java.lang.String encoding,
       java.lang.String contentId)
Add a new part to the mime multipart.



void
addPart(javax.mail.internet.MimeBodyPart part,
       java.lang.String contentId)
Add a new part to the mime multipart.



void
addPart(java.lang.String payload,
       java.lang.String contentId)
Add a new part to the mime multipart.



void
addPart(java.lang.String payload,
       java.lang.String encoding,
       java.lang.String contentId)
Add a new part to the mime multipart.



byte[]
getBytes()
Get bytes created by this multi-part.



javax.mail.internet.InternetHeaders
getMimeHeader()
Return the underlying mime header that will be used to write the headers.



void
removePart(java.lang.String contentId)
Remove a part from this multipart output.



void
setHeader(java.lang.String key,
         java.lang.String value)
Set an arbitary header to the headers prefixed to the start of the multipart.



void
writeTo(java.io.OutputStream out)
Write the multipart to the given output stream.



void
writeTo(java.io.OutputStream out,
       java.io.File tempFile)
Write the multipart to the given outputstream.







Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait














Constructor Detail





MultiPartOutput
public MultiPartOutput(java.lang.String mimeId)
                throws javax.mail.MessagingException
Constructor.
 
 This implicitly sets the multipart sub-type to be mixed.
 

Parameters:
mimeId - the Message-ID header to assign to this multi-part
Throws:
javax.mail.MessagingException - if the bytes did not contain a valid MimeMultiPart








MultiPartOutput
public MultiPartOutput(java.lang.String mimeId,
                       java.lang.String subtype)
                throws javax.mail.MessagingException
Constructor.

Parameters:
mimeId - the Message-ID header to assign to this multi-part
subtype - the multi-part subtype.
Throws:
javax.mail.MessagingException - if there was a failure to create the underlying Mime Multipart










Method Detail





addPart
public void addPart(java.lang.String payload,
                    java.lang.String encoding,
                    java.lang.String contentId)
             throws javax.mail.MessagingException,
                    java.io.IOException
Add a new part to the mime multipart.

Parameters:
payload - the data.
encoding - the encoding to apply
contentId - the id to set the content with.
Throws:
javax.mail.MessagingException - if there was a failure adding the part. MimeMultiPart
java.io.IOException - if there was an IOException








addPart
public void addPart(java.lang.String payload,
                    java.lang.String contentId)
             throws javax.mail.MessagingException,
                    java.io.IOException
Add a new part to the mime multipart.

Parameters:
payload - the data.
contentId - the id to set the content with.
Throws:
javax.mail.MessagingException - if there was a failure adding the part. MimeMultiPart
java.io.IOException - if there was an IOException








addPart
public void addPart(byte[] payload,
                    java.lang.String contentId)
             throws javax.mail.MessagingException,
                    java.io.IOException
Add a new part to the mime multipart.

Parameters:
payload - the data.
contentId - the id to set the content with.
Throws:
javax.mail.MessagingException - if there was a failure adding the part. MimeMultiPart
java.io.IOException - if there was an IOException








addPart
public void addPart(byte[] payload,
                    java.lang.String encoding,
                    java.lang.String contentId)
             throws javax.mail.MessagingException,
                    java.io.IOException
Add a new part to the mime multipart.

Parameters:
payload - the data.
encoding - the encoding to apply
contentId - the id to set the content with.
Throws:
javax.mail.MessagingException - on error manipulating the bodypart
java.io.IOException - on general IO error.








addPart
public void addPart(javax.mail.internet.MimeBodyPart part,
                    java.lang.String contentId)
             throws javax.mail.MessagingException,
                    java.io.IOException
Add a new part to the mime multipart.

Parameters:
part - an already existing mimebody part
contentId - the id to set the content with.
Throws:
javax.mail.MessagingException - on error manipulating the bodypart
java.io.IOException - on general IO error.








removePart
public void removePart(java.lang.String contentId)
                throws javax.mail.MessagingException,
                       java.io.IOException
Remove a part from this multipart output.
 
 If non-unique content-id's are used for each bodypart, then an invocation of removePart(String) will remove
 all matching body parts.
 

Parameters:
contentId - the content-id associated with a previously added part.
Throws:
javax.mail.MessagingException - if there was a failure removing the part.
java.io.IOException - if there was an IOException








getBytes
public byte[] getBytes()
                throws javax.mail.MessagingException,
                       java.io.IOException
Get bytes created by this multi-part.

Returns:
the bytes represented by this MimeMultipartOutput
Throws:
javax.mail.MessagingException - if there was a failure retrieving the bytes.
java.io.IOException - if there was an IOException








writeTo
public void writeTo(java.io.OutputStream out)
             throws javax.mail.MessagingException,
                    java.io.IOException
Write the multipart to the given output stream.

Parameters:
out - the output stream.
Throws:
javax.mail.MessagingException - if there was a failure retrieving the bytes.
java.io.IOException - if there was an IOException








writeTo
public void writeTo(java.io.OutputStream out,
                    java.io.File tempFile)
             throws javax.mail.MessagingException,
                    java.io.IOException
Write the multipart to the given outputstream.

Parameters:
out - the output stream.
tempFile - if not null, then use the specified file to stream the parts to first.
Throws:
javax.mail.MessagingException
java.io.IOException








setHeader
public void setHeader(java.lang.String key,
                      java.lang.String value)
Set an arbitary header to the headers prefixed to the start of the multipart.
 
 The Content-Type and Content-Length will always be overridden with the content-type and length of the mime multipart
 

Parameters:
key - the key
value - the value.
See Also:
InternetHeaders








getMimeHeader
public javax.mail.internet.InternetHeaders getMimeHeader()
Return the underlying mime header that will be used to write the headers.

Returns:
the internet header.

Modifier and Type	Method and Description
`void`	`addPart(byte[] payload, java.lang.String contentId)` Add a new part to the mime multipart.
`void`	`addPart(byte[] payload, java.lang.String encoding, java.lang.String contentId)` Add a new part to the mime multipart.
`void`	`addPart(javax.mail.internet.MimeBodyPart part, java.lang.String contentId)` Add a new part to the mime multipart.
`void`	`addPart(java.lang.String payload, java.lang.String contentId)` Add a new part to the mime multipart.
`void`	`addPart(java.lang.String payload, java.lang.String encoding, java.lang.String contentId)` Add a new part to the mime multipart.
`byte[]`	`getBytes()` Get bytes created by this multi-part.
`javax.mail.internet.InternetHeaders`	`getMimeHeader()` Return the underlying mime header that will be used to write the headers.
`void`	`removePart(java.lang.String contentId)` Remove a part from this multipart output.
`void`	`setHeader(java.lang.String key, java.lang.String value)` Set an arbitary header to the headers prefixed to the start of the multipart.
`void`	`writeTo(java.io.OutputStream out)` Write the multipart to the given output stream.
`void`	`writeTo(java.io.OutputStream out, java.io.File tempFile)` Write the multipart to the given outputstream.

Class MultiPartOutput

Field Summary

Fields inherited from interface com.adaptris.util.text.mime.MimeConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

MultiPartOutput

MultiPartOutput

Method Detail

addPart

addPart

addPart

addPart

addPart

removePart

getBytes

writeTo

writeTo

setHeader

getMimeHeader