CSenBaseFragment Class Reference

API published in: S60 3rd Ed

Link against: senxml.lib

Capability Information

Required Capabilities

None

#include <senbasefragment.h>

Inherits CSenFragment, and MSenContentHandlerClient.

Inherited by CSenCredential, CSenDomFragment, CSenSoapEnvelope, and CSenWsSecurityHeader.

Detailed Description

Class implements basic functionality of an XML fragment Typically BaseFragment is used to parse certain part of some XML document.

The element is identified by localname (or qualifiedname) and namespace. All child elements between start tag and and end tag defined this fragment will become content of this BaseFragment. In other words, BaseFragment has all data inside a single element. BaseFragment will parse only namespace (xmlns) attributes from a document and rest of the attributes are to be handled by subclasses, which should overwrite SetAttributesL() method to achieve this. The CSenXmlReader class will do the actual parsing and this class will act as content handler for XML parser SAX events.


Public Member Functions
virtual IMPORT_C	~CSenBaseFragment ()
	Destructor.
virtual IMPORT_C TPtrC8	Content ()
	Getter for the content,which is returned as UTF-8 form XML.
virtual IMPORT_C CSenNamespace *	Namespace (const TDesC8 &aPrefix)
	Gets the namespace object with a given prefix.
virtual IMPORT_C void	EnsureNamespace (const TDesC8 &aPrefix)
virtual IMPORT_C void	DetachL ()
virtual IMPORT_C void	SaveNamespacesL (const RAttributeArray &aAttrs, TBool aEnsure)
virtual IMPORT_C void	ResetContentL ()
	Resets the content of the fragment, and resets the namespaces.
virtual IMPORT_C const TDesC8 &	LocalName () const
virtual IMPORT_C const TDesC8 &	NsUri () const
	Getter for Fragment's namespace URI.
virtual IMPORT_C const TDesC8 &	NsPrefix () const
	Getter for namespace prefix of this fragment.
virtual IMPORT_C CSenElement &	AsElement ()
	Getting the fragment as an XML element.
virtual IMPORT_C CSenElement *	ExtractElement ()
	Etracts the XML element from the fragment, leaving the fragment empty.
virtual IMPORT_C CSenXmlReader *	Reader ()
	Gets the XML reader which this fragment uses for parsing.
virtual IMPORT_C void	SetReader (CSenXmlReader &aReader)
	Sets the XML reader to be used for parsing for the fragment.
virtual IMPORT_C void	ParseL (const TDesC8 &aXml)
	Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.
virtual IMPORT_C TInt	BuildFrom (const TDesC8 &aXml)
	Same as ParseL() except that it doesn't leave in case of an error.
virtual IMPORT_C void	DelegateParsingL (MSenFragment &aDelegate)
	Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.
virtual IMPORT_C void	DelegateParsingL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &aAttrs)
	Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.
virtual IMPORT_C void	ParseWithL (CSenXmlReader &aReader)
	Sets the reader for this fragment and sets this to be the content handler of the following SAX events.
virtual IMPORT_C void	SetOwner (MSenFragment &aFragment)
	Sets a new parent for this fragment.
virtual IMPORT_C void	ResumeParsingFromL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName)
	Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.
virtual IMPORT_C void	SetAttributesL (const RAttributeArray &aAttrs)
	Sets the attributes for the fragment.
IMPORT_C void	WriteStartElementL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &aAttrs)
	Writes the start element tag to the content stream.
IMPORT_C void	WriteEndElementL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName)
	Writes the end element tag to the content stream.
virtual IMPORT_C HBufC *	AsXmlUnicodeL ()
	Gets the fragment data as an unicode XML.
virtual IMPORT_C HBufC8 *	AsXmlL ()
	Gets the fragment data as an UTF-8 form XML.
virtual IMPORT_C void	WriteAsXMLToL (RWriteStream &aWs)
	Invokes AsElement()->WriteAsXMLToL(aWs);.
virtual IMPORT_C TBool	ConsistsOfL (MSenFragment &aCandidate)
	Checks if fragment matches to another fragment by its content and child elements.
Static Public Member Functions
static IMPORT_C CSenBaseFragment *	NewL (const CSenElement &aElement)
	Standard 2 phase constructor.
static IMPORT_C CSenBaseFragment *	NewL (const TDesC8 &aLocalName)
	Standard 2 phase constructor.
static IMPORT_C CSenBaseFragment *	NewL (const TDesC8 &aNsUri, const TDesC8 &aLocalName)
	Standard 2 phase constructor.
static IMPORT_C CSenBaseFragment *	NewL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName)
	Standard 2 phase constructor.
static IMPORT_C CSenBaseFragment *	NewL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &apAttrs)
	Standard 2 phase constructor.
static IMPORT_C CSenBaseFragment *	NewL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &apAttrs, CSenElement &aParent)
	Standard 2 phase constructor.
Protected Member Functions
IMPORT_C	CSenBaseFragment ()
	C++ default constructor.
IMPORT_C void	BaseConstructL (const CSenElement &aElement)
	BaseConstructL, where an element is given as initializer.
IMPORT_C void	BaseConstructL (const TDesC8 &aLocalName)
	BaseConstructL setting XML localname for this fragment.
IMPORT_C void	BaseConstructL (const TDesC8 &aNsUri, const TDesC8 &aLocalName)
	BaseConstructL offering possibility to set XML namespace and localname.
IMPORT_C void	BaseConstructL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName)
	Base constructor.
IMPORT_C void	BaseConstructL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &aAttrs)
	Base constructor.
IMPORT_C void	BaseConstructL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &aAttrs, CSenElement &aParent)
	Base constructor.
IMPORT_C void	BaseConstructL (CSenXmlReader &aReader)
	BaseConstructL() setting the XML reader for this fragment.
virtual IMPORT_C void	AllocContentSaverL ()
	Makes the content internal stream for content saving available.
virtual IMPORT_C void	StartElementL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName, const RAttributeArray &aAttrs)
	Callback function implementing the XML content handler interface.
virtual IMPORT_C void	EndElementL (const TDesC8 &aNsUri, const TDesC8 &aLocalName, const TDesC8 &aQName)
	Callback function which implement the XML content handler interface.
virtual IMPORT_C void	CharactersL (const TDesC8 &aChars, TInt aStart, TInt aLength)
	Function which implement the XML content handler interface.
IMPORT_C TInt	StartEntity (TDesC8 &aName)
	Callback function which implement the XML content handler interface.
IMPORT_C MSenElement &	SetContentOfL (const TDesC8 &aLocalName, const TDesC8 &aContent)
	Sets content to a child element.
IMPORT_C TPtrC8	ContentOf (const TDesC8 &aLocalName)
	Gets the content of a given element.
Protected Attributes
TInt	iState
CSenElement *	ipElement
CSenXmlReader *	iXmlReader
MSenFragment *	ipOwner
RWriteStream	iWs

Constructor & Destructor Documentation

virtual IMPORT_C CSenBaseFragment::~CSenBaseFragment ( ) [virtual]

Destructor.

IMPORT_C CSenBaseFragment::CSenBaseFragment ( ) [protected]

C++ default constructor.

Member Function Documentation

virtual IMPORT_C void CSenBaseFragment::AllocContentSaverL ( ) [protected, virtual]

Makes the content internal stream for content saving available.

virtual IMPORT_C CSenElement& CSenBaseFragment::AsElement ( ) [virtual]

Getting the fragment as an XML element.

This method will panic if element has not been initialized for any reason.

Returns:: the current object as element. Ownership is not transferred.

Implements CSenFragment.

virtual IMPORT_C HBufC8* CSenBaseFragment::AsXmlL ( ) [virtual]

Gets the fragment data as an UTF-8 form XML.

Returns:: fragment as XML. Caller takes ownership.

Implements CSenFragment.

Reimplemented in CSenXmlServiceDescription.

virtual IMPORT_C HBufC* CSenBaseFragment::AsXmlUnicodeL ( ) [virtual]

Gets the fragment data as an unicode XML.

Returns:: fragment as XML. Caller takes ownership.

Implements CSenFragment.

Reimplemented in CSenXmlServiceDescription.

IMPORT_C void CSenBaseFragment::BaseConstructL ( CSenXmlReader & aReader ) [protected]

BaseConstructL() setting the XML reader for this fragment.

Parameters:

aReader

is the XML reader for this fragment

Reimplemented in CSenDomFragment.

IMPORT_C void CSenBaseFragment::BaseConstructL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	aAttrs,
		CSenElement &	aParent
	)	`[protected]`

Base constructor.

Parameters:

	aNsUri	XML namespace URI for this fragment
	aLocalName	XML localname for this fragment
	aQName	XML qualifiedname for this fragment
	aAttrs	XML attributes for this fragment
	aParent	parent to be set for this fragmemt

Reimplemented in CSenDomFragment.

IMPORT_C void CSenBaseFragment::BaseConstructL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	aAttrs
	)	`[protected]`

Base constructor.

Parameters:

	aNsUri	XML namespace URI for this fragment
	aLocalName	XML localname for this fragment
	aQName	XML qualifiedname for this fragment
	aAttrs	XML attributes for this fragment

Reimplemented in CSenDomFragment.

IMPORT_C void CSenBaseFragment::BaseConstructL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName
	)	`[protected]`

Base constructor.

Parameters:

	aNsUri	XML namespace URI for this fragment
	aLocalName	XML localname for this fragment
	aQName	XML qualifiedname for this fragment

Reimplemented in CSenDomFragment.

IMPORT_C void CSenBaseFragment::BaseConstructL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName
	)	`[protected]`

BaseConstructL offering possibility to set XML namespace and localname.

Parameters:

	aNsUri	XML namespace URI for this fragment
	aLocalName	XML localname for this fragment

Reimplemented in CSenDomFragment, and CSenServicePattern.

IMPORT_C void CSenBaseFragment::BaseConstructL ( const TDesC8 & aLocalName ) [protected]

BaseConstructL setting XML localname for this fragment.

Parameters:

aLocalName

XML localname for this fragment

Reimplemented in CSenDomFragment, CSenServicePattern, and CSenWsSecurityHeader.

IMPORT_C void CSenBaseFragment::BaseConstructL ( const CSenElement & aElement ) [protected]

BaseConstructL, where an element is given as initializer.

Parameters:

aElement

from which this fragment will be constructed from.

Reimplemented in CSenDomFragment.

virtual IMPORT_C TInt CSenBaseFragment::BuildFrom ( const TDesC8 & aXml ) [virtual]

Same as ParseL() except that it doesn't leave in case of an error.

Instead errors are trapped and error is returned. SetReader() must be called before this method can be used.

Parameters:

aXml,:

The data to be parsed.

Returns:: KErrNone or other system-wide Symbian error codes.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::CharactersL	(	const TDesC8 &	aChars,
		TInt	aStart,
		TInt	aLength
	)	`[protected, virtual]`

Function which implement the XML content handler interface.

Inheriting classes can override these. This one is called when content is starting.

Parameters:

	aChars	The content characters.
	aStart	The starting index
	aLength	The length of the characters.

Reimplemented in CSenDomFragment.

virtual IMPORT_C TBool CSenBaseFragment::ConsistsOfL ( MSenFragment & aCandidate ) [virtual]

Checks if fragment matches to another fragment by its content and child elements.

Fragment can contain more data than the given candidate.

Parameters:

aCandidate

The pattern to be matched. Must contain same or less data for match to come true.

Returns:: ETrue if content and possible children match exactly to given pattern. EFalse otherwise.

Implements CSenFragment.

virtual IMPORT_C TPtrC8 CSenBaseFragment::Content ( ) [virtual]

Getter for the content,which is returned as UTF-8 form XML.

Returns:: content as UTF-8 form XML.

Implements CSenFragment.

IMPORT_C TPtrC8 CSenBaseFragment::ContentOf ( const TDesC8 & aLocalName ) [protected]

Gets the content of a given element.

Parameters:

aLocalName

The local name of the element which content is asked

Returns:: the content which was asked

virtual IMPORT_C void CSenBaseFragment::DelegateParsingL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	aAttrs
	)	`[virtual]`

Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.

Creates a new fragment and lets the created MSenFragment handle the following SAX events. This fragment is made the owner of the delegate and the delegate is expected to make this MSenFragment act as receiver for SAX events (callbacks) once it has seen the end element for itself.

Parameters:

	aNsUri	The XML namespace URI for the delegate to be created
	aLocalName	The XML localname for the delegate to be created
	aQName	The XML qualifiedname for the delegate to be created
	aAttrs,:	The XML attributes for the delegate to be created

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::DelegateParsingL ( MSenFragment & aDelegate ) [virtual]

Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.

Let the delegate MSenFragment handle the following SAX events. This fragment is made the owner of the delegate and the delegate is expected to make this MSenFragment the receiver of SAX events once it has seen the end element for itself.

Parameters:

aDelegate

is the fragment to start handling the SAX events.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::DetachL ( ) [virtual]

Returns:: Detaches this fragment from its owner. All namespace references from possible parent fragments are declared in the scope of this fragment prior detaching.

virtual IMPORT_C void CSenBaseFragment::EndElementL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName
	)	`[protected, virtual]`

Callback function which implement the XML content handler interface.

Inheriting classes can override these.

Parameters:

	aNsUri	The namespace URI of the new element
	aLocalName	The local name of the new element
	aQName	The qualified name of the new element

Reimplemented in CSenSoapEnvelope, and CSenXmlServiceDescription.

virtual IMPORT_C void CSenBaseFragment::EnsureNamespace ( const TDesC8 & aPrefix ) [virtual]

Parameters:

aPrefix

is the XML namespace prefix

virtual IMPORT_C CSenElement* CSenBaseFragment::ExtractElement ( ) [virtual]

Etracts the XML element from the fragment, leaving the fragment empty.

Note(!): the return value (CSenElement) STRONGLY suggests that subclasses INHERIT CSenFragment in order properly comply the requirement of the ExtractElement() implementation.

Returns:: the current object as element. May return NULL. Ownership IS TRANSFERRED to the caller.

Implements CSenFragment.

virtual IMPORT_C const TDesC8& CSenBaseFragment::LocalName ( ) const [virtual]

Returns:: the localname of this fragment as UTF-8 form descriptor

Implements CSenFragment.

virtual IMPORT_C CSenNamespace* CSenBaseFragment::Namespace ( const TDesC8 & aPrefix ) [virtual]

Gets the namespace object with a given prefix.

Parameters:

aPrefix,:

prefix that wanted namespace should have.

Returns:: namespace with the given prefix. If not found or given prefix is zero length, will return NULL.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	apAttrs,
		CSenElement &	aParent
	)	`[static]`

Standard 2 phase constructor.

Parameters:

	aParent	Element to be set as fragment's parent element. Leave codes: KErrSenInvalidCharacters if aLocalName or aQName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName or aQName is of zero length.
	aNsUri,:	XML namespace URI
	aLocalName,:	XML localname
	aQName,:	XML qualifiedname
	apAttrs,:	XML attributes
	aParent,:	Parent element

Reimplemented in CSenCredential, and CSenDomFragment.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	apAttrs
	)	`[static]`

Standard 2 phase constructor.

Leave codes: KErrSenInvalidCharacters if aLocalName or aQName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName or aQName is zero length.

Parameters:

	aNsUri,:	XML namespace URI
	aLocalName,:	XML localname
	aQName,:	XML qualifiedname
	apAttrs,:	XML attributes

Reimplemented in CSenCredential, and CSenDomFragment.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName
	)	`[static]`

Standard 2 phase constructor.

Leave codes: KErrSenInvalidCharacters if aLocalName or aQName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName or aQName is zero length.

Parameters:

	aNsUri,:	XML namespace URI
	aLocalName,:	XML localname
	aQName,:	XML qualifiedname

Reimplemented in CSenDomFragment, and CSenIdentityProvider.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName
	)	`[static]`

Standard 2 phase constructor.

Leave codes: KErrSenInvalidCharacters if aLocalName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName is zero length.

Parameters:

	aNsUri,:	XML namespace URI
	aLocalName,:	XML localname

Reimplemented in CSenDomFragment, CSenIdentityProvider, CSenServicePattern, and CSenXmlServiceDescription.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL ( const TDesC8 & aLocalName ) [static]

Standard 2 phase constructor.

Leave codes: KErrSenInvalidCharacters if aLocalName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName is zero length.

Parameters:

aLocalName,:

is the XML localname for this fragment

Reimplemented in CSenDomFragment, CSenIdentityProvider, CSenServicePattern, CSenWsSecurityHeader, and CSenXmlServiceDescription.

static IMPORT_C CSenBaseFragment* CSenBaseFragment::NewL ( const CSenElement & aElement ) [static]

Standard 2 phase constructor.

Parameters:

aElement

is the element where construction data will be copied from.

Reimplemented in CSenDomFragment.

virtual IMPORT_C const TDesC8& CSenBaseFragment::NsPrefix ( ) const [virtual]

Getter for namespace prefix of this fragment.

Returns:: namespace prefix or KNullDesC if not set.

Implements CSenFragment.

virtual IMPORT_C const TDesC8& CSenBaseFragment::NsUri ( ) const [virtual]

Getter for Fragment's namespace URI.

Returns:: Namespace URI or KNullDesC if not set.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::ParseL ( const TDesC8 & aXml ) [virtual]

Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.

Method to invoke parsing of a XML data. Note that SetReader() must be called before this method can be used. Note that CSenBaseFragment does not parse any other attributes, but XML namespace attributes only. This is due to allow subclasses to process only those attributes they are interested in, and not others.

Parameters:

aXml,:

The data to be parsed.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::ParseWithL ( CSenXmlReader & aReader ) [virtual]

Sets the reader for this fragment and sets this to be the content handler of the following SAX events.

Parameters:

aReader

is the XML parser to be used.

Implements CSenFragment.

Reimplemented in CSenDomFragment.

virtual IMPORT_C CSenXmlReader* CSenBaseFragment::Reader ( ) [virtual]

Gets the XML reader which this fragment uses for parsing.

Returns:: the XML reader. Ownerships is not transferred, due even this class does not own the XML reader instance.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::ResetContentL ( ) [virtual]

Resets the content of the fragment, and resets the namespaces.

virtual IMPORT_C void CSenBaseFragment::ResumeParsingFromL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName
	)	`[virtual]`

Leave codes: KErrSenXmlReaderNotSet if XML reader has not been set.

Resumes parsing to be handled by this fragment. Usually called by some delegate fragment which was set to be content handler because this fragment called DelegateParsingL().

Parameters:

	aNsUri	The namespace URI of the current element
	aLocalName	The local name of the current element
	aQName	The qualified name of the current element

Implements CSenFragment.

Reimplemented in CSenDomFragment, and CSenXmlServiceDescription.

virtual IMPORT_C void CSenBaseFragment::SaveNamespacesL	(	const RAttributeArray &	aAttrs,
		TBool	aEnsure
	)	`[virtual]`

Parameters:

	aAttrs	are the attributes from which the namespaces are searched from.
	aEnsure	if set to TRUE, the namespaces are copied into this fragment. If FALSE, then the namespaces are only referenced, but not copied and owned by this class.

virtual IMPORT_C void CSenBaseFragment::SetAttributesL ( const RAttributeArray & aAttrs ) [virtual]

Sets the attributes for the fragment.

BaseFragment parses only namespace (xmlns) attributes from the document. Subclasses should override this method if they are intrested of handling any other XML attributes and their corresponding values.

Parameters:

aAttrs,:

the array of attributes.

Implements CSenFragment.

Reimplemented in CSenDomFragment, and CSenXmlServiceDescription.

IMPORT_C MSenElement& CSenBaseFragment::SetContentOfL	(	const TDesC8 &	aLocalName,
		const TDesC8 &	aContent
	)	`[protected]`

Sets content to a child element.

If no element with given local name is not found, new one is added and content is set to that one.

Parameters:

	aLocalName	The local name of element which content is about to be set
	aContent	Content to be set.

Returns:: the element where content was set. Leave codes: KErrSenInvalidCharacters if aLocalName contains illegal characters. KErrSenZeroLengthDescriptor if aLocalName is zero length.

virtual IMPORT_C void CSenBaseFragment::SetOwner ( MSenFragment & aFragment ) [virtual]

Sets a new parent for this fragment.

Parameters:

aFragment,:

the new parent.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::SetReader ( CSenXmlReader & aReader ) [virtual]

Sets the XML reader to be used for parsing for the fragment.

Parameters:

aReader,:

the reader to be used. Ownership is NOT transferred.

Implements CSenFragment.

virtual IMPORT_C void CSenBaseFragment::StartElementL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	aAttrs
	)	`[protected, virtual]`

Callback function implementing the XML content handler interface.

Inheriting classes can override these.

Parameters:

	aNsUri	The namespace URI of the new element
	aLocalName	The local name of the new element
	aQName	The qualified name of the new element
	aAttrs	The attributes of the new element

Reimplemented in CSenCredential, CSenDomFragment, CSenServicePattern, CSenSoapEnvelope, and CSenXmlServiceDescription.

IMPORT_C TInt CSenBaseFragment::StartEntity ( TDesC8 & aName ) [protected]

Callback function which implement the XML content handler interface.

Inheriting classes can override these.

Parameters:

aName

The entity name

virtual IMPORT_C void CSenBaseFragment::WriteAsXMLToL ( RWriteStream & aWs ) [virtual]

Invokes AsElement()->WriteAsXMLToL(aWs);.

Parameters:

aWs

is the stream into which the UTF-8 form XML will be written.

Implements CSenFragment.

Reimplemented in CSenXmlServiceDescription.

IMPORT_C void CSenBaseFragment::WriteEndElementL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName
	)	`[virtual]`

Writes the end element tag to the content stream.

Derivants can override the basic usage used in BaseFragment.

Parameters:

	aNsUri	The namespace URI of the current element
	aLocalName	The local name of the current element
	aQName	The qualified name of the current element

Implements CSenFragment.

Reimplemented in CSenDomFragment.

IMPORT_C void CSenBaseFragment::WriteStartElementL	(	const TDesC8 &	aNsUri,
		const TDesC8 &	aLocalName,
		const TDesC8 &	aQName,
		const RAttributeArray &	aAttrs
	)	`[virtual]`

Writes the start element tag to the content stream.

Derivants can override the basic usage used in BaseFragment.

Parameters:

	aNsUri	The namespace URI of the current element
	aLocalName	The local name of the current element
	aQName	The qualified name of the current element
	aAttrs	is the array of attributes.