com.sun.mail.iap

Class Argument

java.lang.Object

com.sun.mail.iap.Argument

public class Argument
extends java.lang.Object

Author:

John Mani, Bill Shannon

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List	items

Constructor Summary

Constructors

Constructor and Description
Argument() Constructor

Method Summary

Methods

Modifier and Type	Method and Description
Argument	append(Argument arg) Append the given Argument to this Argument.
void	write(Protocol protocol)
Argument	writeArgument(Argument c) Write out as parenthesised list.
Argument	writeAtom(java.lang.String s) Write out given string as an Atom.
Argument	writeBytes(byte[] b) Write out given byte[] as a Literal.
Argument	writeBytes(java.io.ByteArrayOutputStream b) Write out given ByteArrayOutputStream as a Literal.
Argument	writeBytes(Literal b) Write out given data as a literal.
Argument	writeNString(java.lang.String s) Write out given string as an NSTRING, depending on the type of the characters inside the string.
Argument	writeNString(java.lang.String s, java.lang.String charset) Convert the given string into bytes in the specified charset, and write the bytes out as an NSTRING
Argument	writeNumber(int i) Write out number.
Argument	writeNumber(long i) Write out number.
Argument	writeString(java.lang.String s) Write out given string as an ASTRING, depending on the type of the characters inside the string.
Argument	writeString(java.lang.String s, java.lang.String charset) Convert the given string into bytes in the specified charset, and write the bytes out as an ASTRING

Methods inherited from class java.lang.Object

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

Field Detail

items

protected java.util.List items

Constructor Detail

Argument

public Argument()

Constructor

Method Detail

append

public Argument append(Argument arg)

Append the given Argument to this Argument. All items from the source argument are copied into this destination argument.

writeString

public Argument writeString(java.lang.String s)

Write out given string as an ASTRING, depending on the type of the characters inside the string. The string should contain only ASCII characters.

XXX: Hmm .. this should really be called writeASCII()

Parameters:

s - String to write out

writeString

public Argument writeString(java.lang.String s,
                   java.lang.String charset)
                     throws java.io.UnsupportedEncodingException

Convert the given string into bytes in the specified charset, and write the bytes out as an ASTRING

Throws:

java.io.UnsupportedEncodingException

writeNString

public Argument writeNString(java.lang.String s)

Write out given string as an NSTRING, depending on the type of the characters inside the string. The string should contain only ASCII characters.

Parameters:

s - String to write out

Since:

JavaMail 1.5.1

writeNString

public Argument writeNString(java.lang.String s,
                    java.lang.String charset)
                      throws java.io.UnsupportedEncodingException

Convert the given string into bytes in the specified charset, and write the bytes out as an NSTRING

Throws:

java.io.UnsupportedEncodingException

Since:

JavaMail 1.5.1

writeBytes

public Argument writeBytes(byte[] b)

Write out given byte[] as a Literal.

Parameters:

b - byte[] to write out

writeBytes

public Argument writeBytes(java.io.ByteArrayOutputStream b)

Write out given ByteArrayOutputStream as a Literal.

Parameters:

b - ByteArrayOutputStream to be written out.

writeBytes

public Argument writeBytes(Literal b)

Write out given data as a literal.

Parameters:

b - Literal representing data to be written out.

writeAtom

public Argument writeAtom(java.lang.String s)

Write out given string as an Atom. Note that an Atom can contain only certain US-ASCII characters. No validation is done on the characters in the string.

Parameters:

s - String

writeNumber

public Argument writeNumber(int i)

Write out number.

Parameters:

i - number

writeNumber

public Argument writeNumber(long i)

Write out number.

Parameters:

i - number

writeArgument

public Argument writeArgument(Argument c)

Write out as parenthesised list.

write

public void write(Protocol protocol)
           throws java.io.IOException,
                  ProtocolException

Throws:

java.io.IOException

ProtocolException