#include <body.hpp>

Inheritance diagram for body:

[legend]

Collaboration diagram for body:

[legend]

Public Member Functions
	body ()

	~body ()

void	appendPart (shared_ptr< bodyPart > part)

void	insertPartBefore (shared_ptr< bodyPart > beforePart, shared_ptr< bodyPart > part)

void	insertPartBefore (const size_t pos, shared_ptr< bodyPart > part)

void	insertPartAfter (shared_ptr< bodyPart > afterPart, shared_ptr< bodyPart > part)

void	insertPartAfter (const size_t pos, shared_ptr< bodyPart > part)

void	removePart (shared_ptr< bodyPart > part)

void	removePart (const size_t pos)

void	removeAllParts ()

size_t	getPartCount () const

bool	isEmpty () const

shared_ptr< bodyPart >	getPartAt (const size_t pos)

const shared_ptr< const bodyPart >	getPartAt (const size_t pos) const

const std::vector< shared_ptr< const bodyPart > >	getPartList () const

const std::vector< shared_ptr< bodyPart > >	getPartList ()

const string &	getPrologText () const

void	setPrologText (const string &prologText)

const string &	getEpilogText () const

void	setEpilogText (const string &epilogText)

const shared_ptr< const contentHandler >	getContents () const

void	setContents (shared_ptr< const contentHandler > contents)

void	setContents (shared_ptr< const contentHandler > contents, const mediaType &type)

void	setContents (shared_ptr< const contentHandler > contents, const mediaType &type, const charset &chset)

void	setContents (shared_ptr< const contentHandler > contents, const mediaType &type, const charset &chset, const encoding &enc)

void	setContentType (const mediaType &type, const charset &chset)

void	setContentType (const mediaType &type)

const mediaType	getContentType () const

void	setCharset (const charset &chset)

const charset	getCharset () const

void	setEncoding (const encoding &enc)

const encoding	getEncoding () const

shared_ptr< component >	clone () const

void	copyFrom (const component &other)

body &	operator= (const body &other)

const std::vector< shared_ptr< component > >	getChildComponents ()

size_t	getGeneratedSize (const generationContext &ctx)

Public Member Functions inherited from component
	component ()

virtual	~component ()

void	parse (const string &buffer)

void	parse (const parsingContext &ctx, const string &buffer)

void	parse (shared_ptr< utility::inputStream > inputStream, const size_t length)

void	parse (const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)

void	parse (const parsingContext &ctx, const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)

void	parse (shared_ptr< utility::inputStream > inputStream, const size_t position, const size_t end, size_t *newPosition=NULL)

void	parse (const parsingContext &ctx, shared_ptr< utility::inputStream > inputStream, const size_t position, const size_t end, size_t *newPosition=NULL)

virtual const string	generate (const size_t maxLineLength=lineLengthLimits::infinite, const size_t curLinePos=0) const

virtual void	generate (utility::outputStream &outputStream, const size_t curLinePos=0, size_t *newLinePos=NULL) const

virtual void	generate (const generationContext &ctx, utility::outputStream &outputStream, const size_t curLinePos=0, size_t *newLinePos=NULL) const

size_t	getParsedOffset () const

size_t	getParsedLength () const

Static Public Member Functions
static const string	generateRandomBoundaryString ()

static bool	isValidBoundary (const string &boundary)

Protected Member Functions
size_t	findNextBoundaryPosition (shared_ptr< utility::parserInputStreamAdapter > parser, const string &boundary, const size_t position, const size_t end, size_t boundaryStart, size_t boundaryEnd)

void	parseImpl (const parsingContext &ctx, shared_ptr< utility::parserInputStreamAdapter > parser, const size_t position, const size_t end, size_t *newPosition=NULL)

void	generateImpl (const generationContext &ctx, utility::outputStream &os, const size_t curLinePos=0, size_t *newLinePos=NULL) const

Protected Member Functions inherited from component
void	setParsedBounds (const size_t start, const size_t end)

virtual void	parseImpl (const parsingContext &ctx, const string &buffer, const size_t position, const size_t end, size_t *newPosition=NULL)

Protected Member Functions inherited from object
	object ()

	object (const object &)

object &	operator= (const object &)

virtual	~object ()

Detailed Description

Body section of a MIME part.

Constructor & Destructor Documentation

◆ body()

body ( )

◆ ~body()

~body ( )

Member Function Documentation

◆ appendPart()

void appendPart ( shared_ptr< bodyPart > part )

Add a part at the end of the list.

Parameters

part	part to append

References vmime::dynamicCast().

◆ clone()

shared_ptr< component > clone ( ) const

virtual

Clone this component.

Returns: a copy of this component

Implements component.

References vmime::dynamicCast().

◆ copyFrom()

void copyFrom ( const component & other )

virtual

Replace data in this component by data in other component.

Both components must be of the same type.

Exceptions

std::bad_cast_exception if the components are not of the same (dynamic) type

Parameters

other other component to copy data from

Implements component.

References bodyPart::createChildPart(), vmime::dynamicCast(), and body::removeAllParts().

Referenced by body::operator=().

◆ findNextBoundaryPosition()

size_t findNextBoundaryPosition	(	shared_ptr< utility::parserInputStreamAdapter >	parser,
		const string &	boundary,
		const size_t	position,
		const size_t	end,
		size_t *	boundaryStart,
		size_t *	boundaryEnd
	)

protected

Finds the next boundary position in the parsing buffer.

Parameters

parser	parser object
boundary	boundary string (without "--" nor CR/LF)
position	start position
end	end position
boundaryStart	will hold the start position of the boundary (including any CR/LF and "--" before the boundary)
boundaryEnd	will hold the end position of the boundary (position just before the CRLF or "--" which follows)

Returns: the position of the boundary string, or npos if not found

References vmime::dynamicCast(), vmime::end(), and vmime::npos.

Referenced by body::parseImpl().

◆ generateImpl()

void generateImpl	(	const generationContext &	ctx,
		utility::outputStream &	os,
		const size_t	curLinePos = `0`,
		size_t *	newLinePos = `NULL`
	)		const

protectedvirtual

Implements component.

References vmime::fields::CONTENT_TYPE, vmime::CRLF, vmime::dynamicCast(), text::FORCE_NO_ENCODING, body::generateRandomBoundaryString(), contentTypeField::getBoundary(), body::getContentType(), body::getEncoding(), bodyPart::getHeader(), body::getPartAt(), body::getPartCount(), and text::NO_NEW_LINE_SEQUENCE.

◆ generateRandomBoundaryString()

const string generateRandomBoundaryString ( )

static

Generate a new random boundary string.

Returns: randomly generated boundary string

References vmime::dynamicCast(), random::getNext(), and random::getTime().

Referenced by body::generateImpl().

◆ getCharset()

const charset getCharset ( ) const

Return the charset of the data contained in the body contents.

This is a shortcut for getHeader()->ContentType()->getCharset() on the parent part.

Returns: charset of body contents

References vmime::fields::CONTENT_TYPE, vmime::dynamicCast(), bodyPart::getHeader(), and vmime::charsets::US_ASCII.

◆ getChildComponents()

const std::vector< shared_ptr< component > > getChildComponents ( )

virtual

Return the list of children of this component.

Returns: list of child components

Implements component.

References vmime::copy_vector().

◆ getContents()

const shared_ptr< const contentHandler > getContents ( ) const

Return a read-only reference to body contents.

Returns: read-only body contents

◆ getContentType()

const mediaType getContentType ( ) const

Return the media type of the data contained in the body contents.

This is a shortcut for getHeader()->ContentType()->getValue() on the parent part.

Returns: media type of body contents

References vmime::fields::CONTENT_TYPE, vmime::dynamicCast(), bodyPart::getHeader(), headerField::getValue(), vmime::mediaTypes::TEXT, and vmime::mediaTypes::TEXT_PLAIN.

Referenced by body::generateImpl().

◆ getEncoding()

const encoding getEncoding ( ) const

Return the encoding used to encode the body contents.

This is a shortcut for getHeader()->ContentTransferEncoding()->getValue() on the parent part.

Returns: encoding of body contents

References vmime::fields::CONTENT_TRANSFER_ENCODING, vmime::dynamicCast(), bodyPart::getHeader(), and vmime::encodingTypes::SEVEN_BIT.

Referenced by body::generateImpl(), and body::getGeneratedSize().

◆ getEpilogText()

const string & getEpilogText ( ) const

Return the epilog text.

Returns: epilog text

◆ getGeneratedSize()

size_t getGeneratedSize ( const generationContext & ctx )

virtual

Get the number of bytes that will be used by this component when it is generated.

This may be a heuristically-derived estimate, but such an estimated size should always be larger than the actual generated size.

Parameters

ctx	generation context

Returns: component size when generated

Reimplemented from component.

References vmime::dynamicCast(), text::FORCE_NO_ENCODING, encoding::getEncoder(), body::getEncoding(), body::getPartAt(), body::getPartCount(), and text::NO_NEW_LINE_SEQUENCE.

◆ getPartAt() [1/2]

shared_ptr< bodyPart > getPartAt ( const size_t pos )

Return the part at the specified position.

Parameters

pos position

Returns: part at position 'pos'

References vmime::dynamicCast().

Referenced by body::generateImpl(), and body::getGeneratedSize().

◆ getPartAt() [2/2]

const shared_ptr< const bodyPart > getPartAt ( const size_t pos ) const

Return the part at the specified position.

Parameters

pos position

Returns: part at position 'pos'

References vmime::dynamicCast().

◆ getPartCount()

size_t getPartCount ( ) const

Return the number of parts in the list.

Returns: number of parts

Referenced by body::generateImpl(), and body::getGeneratedSize().

◆ getPartList() [1/2]

const std::vector< shared_ptr< bodyPart > > getPartList ( )

Return the part list.

Returns: list of parts

◆ getPartList() [2/2]

const std::vector< shared_ptr< const bodyPart > > getPartList ( ) const

Return the part list.

Returns: list of parts

References vmime::dynamicCast().

◆ getPrologText()

const string & getPrologText ( ) const

Return the prolog text.

Returns: prolog text

◆ insertPartAfter() [1/2]

void insertPartAfter	(	const size_t	pos,
		shared_ptr< bodyPart >	part
	)

Insert a new part after the specified position.

Parameters

pos	position of the part before the new part
part	part to insert

References vmime::dynamicCast().

◆ insertPartAfter() [2/2]

void insertPartAfter	(	shared_ptr< bodyPart >	afterPart,
		shared_ptr< bodyPart >	part
	)

Insert a new part after the specified part.

Parameters

afterPart	part after which the new part will be inserted
part	part to insert

Exceptions

exceptions::no_such_part if the part is not in the list

References vmime::dynamicCast().

◆ insertPartBefore() [1/2]

void insertPartBefore	(	const size_t	pos,
		shared_ptr< bodyPart >	part
	)

Insert a new part before the specified position.

Parameters

pos	position at which to insert the new part (0 to insert at the beginning of the list)
part	part to insert

References vmime::dynamicCast().

◆ insertPartBefore() [2/2]

void insertPartBefore	(	shared_ptr< bodyPart >	beforePart,
		shared_ptr< bodyPart >	part
	)

Insert a new part before the specified part.

Parameters

beforePart	part before which the new part will be inserted
part	part to insert

Exceptions

exceptions::no_such_part if the part is not in the list

References vmime::dynamicCast().

◆ isEmpty()

bool isEmpty ( ) const

Tests whether the list of parts is empty.

Returns: true if there is no part, false otherwise

◆ isValidBoundary()

bool isValidBoundary ( const string & boundary )

static

Test a boundary string for validity (as defined in RFC #1521, page 19).

Parameters

boundary boundary string to test

Returns: true if the boundary string is valid, false otherwise

References vmime::dynamicCast(), and vmime::end().

◆ operator=()

body & operator= ( const body & other )

References body::copyFrom().

◆ parseImpl()

void parseImpl	(	const parsingContext &	ctx,
		shared_ptr< utility::parserInputStreamAdapter >	parser,
		const size_t	position,
		const size_t	end,
		size_t *	newPosition = `NULL`
	)

protectedvirtual

Reimplemented from component.

References vmime::fields::CONTENT_TRANSFER_ENCODING, vmime::fields::CONTENT_TYPE, bodyPart::createChildPart(), vmime::dynamicCast(), vmime::end(), body::findNextBoundaryPosition(), bodyPart::getHeader(), mediaType::getType(), text::getWholeBuffer(), parserHelpers::isSpace(), parserHelpers::isSpaceOrTab(), vmime::mediaTypes::MULTIPART, vmime::npos, component::parse(), body::removeAllParts(), component::setParsedBounds(), and vmime::encodingTypes::SEVEN_BIT.

◆ removeAllParts()

void removeAllParts ( )

Remove all parts from the list.

Referenced by body::copyFrom(), and body::parseImpl().

◆ removePart() [1/2]

void removePart ( const size_t pos )

Remove the part at the specified position.

Parameters

pos	position of the part to remove

References vmime::dynamicCast().

◆ removePart() [2/2]

void removePart ( shared_ptr< bodyPart > part )

Remove the specified part from the list.

Parameters

part	part to remove

Exceptions

exceptions::no_such_part if the part is not in the list

References vmime::dynamicCast().

◆ setCharset()

void setCharset ( const charset & chset )

Set the charset of contents.

If the type is not set, it will be set to default "text/plain" type.

Parameters

chset charset of contents

References vmime::fields::CONTENT_TYPE, vmime::dynamicCast(), bodyPart::getHeader(), contentTypeField::setCharset(), body::setContentType(), vmime::mediaTypes::TEXT, and vmime::mediaTypes::TEXT_PLAIN.

◆ setContents() [1/4]

void setContents ( shared_ptr< const contentHandler > contents )

Set the body contents.

Parameters

contents new body contents

References vmime::dynamicCast().

◆ setContents() [2/4]

void setContents	(	shared_ptr< const contentHandler >	contents,
		const mediaType &	type
	)

Set the body contents and type.

Parameters

contents	new body contents
type	type of contents

References vmime::dynamicCast(), and body::setContentType().

◆ setContents() [3/4]

void setContents	(	shared_ptr< const contentHandler >	contents,
		const mediaType &	type,
		const charset &	chset
	)

Set the body contents, type and charset.

Parameters

contents	new body contents
type	type of contents
chset	charset of contents

References vmime::dynamicCast(), and body::setContentType().

◆ setContents() [4/4]

void setContents	(	shared_ptr< const contentHandler >	contents,
		const mediaType &	type,
		const charset &	chset,
		const encoding &	enc
	)

Set the body contents, type, charset and encoding.

Parameters

contents	new body contents
type	type of contents
chset	charset of contents
enc	contents encoding

References vmime::dynamicCast(), body::setContentType(), and body::setEncoding().

◆ setContentType() [1/2]

void setContentType ( const mediaType & type )

Set the MIME type of contents.

Parameters

type	MIME media type of contents

References bodyPart::getHeader().

◆ setContentType() [2/2]

void setContentType	(	const mediaType &	type,
		const charset &	chset
	)

Set the MIME type and charset of contents.

If a charset is defined, it will not be modified.

Parameters

type	MIME media type of contents
chset	charset of contents

References vmime::dynamicCast(), and bodyPart::getHeader().

Referenced by body::setCharset(), body::setContents(), body::setContents(), and body::setContents().

◆ setEncoding()

void setEncoding ( const encoding & enc )

Set the output encoding of contents.

Contents will be encoded (or re-encoded) when this node is being generated.

Parameters

enc	encoding of contents

References vmime::dynamicCast(), and bodyPart::getHeader().

Referenced by body::setContents().

◆ setEpilogText()

void setEpilogText ( const string & epilogText )

Set the epilog text.

Parameters

epilogText new epilog text

References vmime::dynamicCast().

◆ setPrologText()

void setPrologText ( const string & prologText )

Set the prolog text.

Parameters

prologText new prolog text

References vmime::dynamicCast().

The documentation for this class was generated from the following files:

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ body()

◆ ~body()

Member Function Documentation

◆ appendPart()

◆ clone()

◆ copyFrom()

◆ findNextBoundaryPosition()

◆ generateImpl()

◆ generateRandomBoundaryString()

◆ getCharset()

◆ getChildComponents()

◆ getContents()

◆ getContentType()

◆ getEncoding()

◆ getEpilogText()

◆ getGeneratedSize()

◆ getPartAt() [1/2]

◆ getPartAt() [2/2]

◆ getPartCount()

◆ getPartList() [1/2]

◆ getPartList() [2/2]

◆ getPrologText()

◆ insertPartAfter() [1/2]

◆ insertPartAfter() [2/2]

◆ insertPartBefore() [1/2]

◆ insertPartBefore() [2/2]

◆ isEmpty()

◆ isValidBoundary()

◆ operator=()

◆ parseImpl()

◆ removeAllParts()

◆ removePart() [1/2]

◆ removePart() [2/2]

◆ setCharset()

◆ setContents() [1/4]

◆ setContents() [2/4]

◆ setContents() [3/4]

◆ setContents() [4/4]

◆ setContentType() [1/2]

◆ setContentType() [2/2]

◆ setEncoding()

◆ setEpilogText()

◆ setPrologText()