com.helger.as2lib.client

Class AS2ClientRequest

java.lang.Object

com.helger.as2lib.client.AS2ClientRequest

public class AS2ClientRequest
extends Object

This class represents the content of an AS2 client request.

Author:

oleo Date: May 12, 2010 Time: 5:48:26 PM, Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CONTENT_TYPE

Constructor Summary

Constructors

Constructor and Description
AS2ClientRequest(String sSubject)

Method Summary

Modifier and Type	Method and Description
void	applyDataOntoMimeBodyPart(javax.mail.internet.MimeBodyPart aPart)
com.helger.mail.cte.EContentTransferEncoding	getContentTransferEncoding()
String	getContentType()
String	getSubject()
AS2ClientRequest	setContentDescription(String sDescription) Set the optional Content-Description header to be used.
AS2ClientRequest	setContentTransferEncoding(com.helger.mail.cte.EContentTransferEncoding eCTE) Set the optional Content-Transfer-Encoding to be used.
AS2ClientRequest	setContentType(String sContentType) Set the content type to be used.
AS2ClientRequest	setData(byte[] aData)
AS2ClientRequest	setData(DataHandler aDataHandler)
AS2ClientRequest	setData(File aFile) Deprecated.
AS2ClientRequest	setData(File aFile, Charset aCharset) Set the content of the File as a payload.
AS2ClientRequest	setData(InputStream aIS) Set the content of the InputStream as a payload.
AS2ClientRequest	setData(InputStream aIS, Charset aCharset) Set the content of the InputStream as a payload.
AS2ClientRequest	setData(String sText, Charset aCharset)
AS2ClientRequest	setFilename(String sFilename) Set the filename to be used to name the content.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CONTENT_TYPE

public static final String DEFAULT_CONTENT_TYPE

Constructor Detail

AS2ClientRequest

public AS2ClientRequest(@Nonnull @Nonempty
                        String sSubject)

Parameters:

sSubject - The subject to use. May neither be null nor empty. Has no impact on the MIME part creation. Just declarative.

Method Detail

getSubject

@Nonnull
 @Nonempty
public String getSubject()

Returns:

The subject as provided in the constructor. May neither be null nor empty.

setContentType

@Nonnull
public AS2ClientRequest setContentType(@Nonnull @Nonempty
                                                 String sContentType)

Set the content type to be used. Use this AFTER setData was called, as this may select a default MIME type.

Parameters:

sContentType - The content type. May neither be null nor empty.

Returns:

this

getContentType

@Nonnull
 @Nonempty
public String getContentType()

Returns:

The content type to be used. Defaults to DEFAULT_CONTENT_TYPE.

setData

@Nonnull
 @Deprecated
public AS2ClientRequest setData(@Nonnull
                                                        File aFile)

Deprecated.

Set the content of the File as a payload. No charset is applied and therefore no content type starting with "text/" may be used. The name of the file is used as the payload file name.
Don't use that API - use the one with the explicit charset, otherwise you may run into an exception if neither signing nor encryption nor compression is used!

Parameters:

aFile - File to read the content from. Never null.

Returns:

this

See Also:

setData(File, Charset)

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull
                                          File aFile,
                                          @Nullable
                                          Charset aCharset)

Set the content of the File as a payload. If no charset is applied ( null) no content type starting with "text/" may be used. The name of the file is used as the payload file name.

Parameters:

aFile - File to read the content from. Never null.

aCharset - Charset to use. If it is null the content is set as a byte array, if not null the content is set as a String.

Returns:

this

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull @WillClose
                                          InputStream aIS)

Set the content of the InputStream as a payload. No charset is applied and therefore no content type starting with "text/" may be used.

Parameters:

aIS - InputStream to read the content from. Never null.

Returns:

this

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull @WillClose
                                          InputStream aIS,
                                          @Nullable
                                          Charset aCharset)

Set the content of the InputStream as a payload. No charset is applied and therefore no content type starting with "text/" may be used.

Parameters:

aIS - InputStream to read the content from. Never null.

aCharset - Charset to use. If it is null the content is set as a byte array, if not null the content is set as a String.

Returns:

this

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull
                                          byte[] aData)

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull
                                          String sText,
                                          @Nullable
                                          Charset aCharset)

setData

@Nonnull
public AS2ClientRequest setData(@Nonnull
                                          DataHandler aDataHandler)

setFilename

@Nonnull
public AS2ClientRequest setFilename(@Nullable
                                              String sFilename)

Set the filename to be used to name the content. This will add a Content-Disposition: attachment; filename=... header to the MIME part

Parameters:

sFilename - Filename to use. May be null to indicate none (also the default)

Returns:

this

setContentTransferEncoding

@Nonnull
public AS2ClientRequest setContentTransferEncoding(@Nullable
                                                             com.helger.mail.cte.EContentTransferEncoding eCTE)

Set the optional Content-Transfer-Encoding to be used. By default it is determined by the data type that defines the body.

Parameters:

eCTE - CTE to be used. May be null in which case the default CTE is used.

Returns:

this for chaining

Since:

3.0.4

getContentTransferEncoding

@Nullable
public com.helger.mail.cte.EContentTransferEncoding getContentTransferEncoding()

Returns:

The Content-Transfer-Encoding provided. May be null.

Since:

4.1.1

setContentDescription

@Nonnull
public AS2ClientRequest setContentDescription(@Nullable
                                                        String sDescription)

Set the optional Content-Description header to be used. By default non is present.

Parameters:

sDescription - Content description to be used. May be null.

Returns:

this for chaining

Since:

3.0.4

applyDataOntoMimeBodyPart

public void applyDataOntoMimeBodyPart(@Nonnull
                                      javax.mail.internet.MimeBodyPart aPart)
                               throws javax.mail.MessagingException

Throws:

javax.mail.MessagingException