Collapse all Symbian^3 Application Developer Library

CSenSoapMessage Class Reference

class CSenSoapMessage : public CSenSoapEnvelope

CSenSoapMessage extends basic SOAP envelope functionality by offering methods to set the security header and security token. SenUtils.lib

Since: Series60 3.0

Inherits from

CSenSoapMessage
- CSenSoapEnvelope
  - CSenBaseFragment
    - CSenFragment
      - CBase

Public Member Functions
	~CSenSoapMessage ()
IMPORT_C TInt	AddSecurityTokenL (const TDesC8 &)
IMPORT_C CSenSoapMessage *	NewL ()
IMPORT_C CSenSoapMessage *	NewL ( TSOAPVersion )
IMPORT_C CSenSoapMessage *	NewL ( TSOAPVersion , const TDesC8 &)
IMPORT_C void	SetSecurityHeaderL (const TDesC8 &)

Protected Member Functions
	CSenSoapMessage ()
IMPORT_C void	BaseConstructL ()
IMPORT_C void	BaseConstructL ( TSOAPVersion )
IMPORT_C void	BaseConstructL ( TSOAPVersion , const TDesC8 &)
IMPORT_C CSenWsSecurityHeader *	NewSecurityHeaderLC (const TDesC8 *)
IMPORT_C void	ParseHeaderL (const TDesC8 &, const TDesC8 &, const TDesC8 &, const RAttributeArray &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CSenBaseFragment::AllocContentSaverL()
	CSenBaseFragment::AsElement()
	CSenBaseFragment::AsXmlL()
	CSenBaseFragment::AsXmlUnicodeL()
	CSenBaseFragment::BaseConstructL(CSenXmlReader &)
	CSenBaseFragment::BaseConstructL(const CSenElement &)
	CSenBaseFragment::BaseConstructL(const TDesC8 &)
	CSenBaseFragment::BaseConstructL(const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::BaseConstructL(const TDesC8 &,const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::BaseConstructL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenBaseFragment::BaseConstructL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &,CSenElement &)
	CSenBaseFragment::BuildFrom(const TDesC8 &)
	CSenBaseFragment::CSenBaseFragment()
	CSenBaseFragment::CharactersL(const TDesC8 &,TInt,TInt)
	CSenBaseFragment::ConsistsOfL(MSenFragment &)
	CSenBaseFragment::Content()
	CSenBaseFragment::ContentOf(const TDesC8 &)
	CSenBaseFragment::DelegateParsingL(MSenFragment &)
	CSenBaseFragment::DelegateParsingL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenBaseFragment::DetachL()
	CSenBaseFragment::EnsureNamespace(const TDesC8 &)
	CSenBaseFragment::ExtractElement()
	CSenBaseFragment::LocalName()const
	CSenBaseFragment::Namespace(const TDesC8 &)
	CSenBaseFragment::NewL(const CSenElement &)
	CSenBaseFragment::NewL(const TDesC8 &)
	CSenBaseFragment::NewL(const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::NewL(const TDesC8 &,const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::NewL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenBaseFragment::NewL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &,CSenElement &)
	CSenBaseFragment::NsPrefix()const
	CSenBaseFragment::NsUri()const
	CSenBaseFragment::ParseWithL(CSenXmlReader &)
	CSenBaseFragment::Reader()
	CSenBaseFragment::ResetContentL()
	CSenBaseFragment::ResumeParsingFromL(const TDesC8 &,const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::SaveNamespacesL(const RAttributeArray &,TBool)
	CSenBaseFragment::SetAttributesL(const RAttributeArray &)
	CSenBaseFragment::SetContentOfL(const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::SetOwner(MSenFragment &)
	CSenBaseFragment::SetReader(CSenXmlReader &)
	CSenBaseFragment::StartEntity(TDesC8 &)
	CSenBaseFragment::WriteAsXMLToL(RWriteStream &)
	CSenBaseFragment::WriteEndElementL(const TDesC8 &,const TDesC8 &,const TDesC8 &)
	CSenBaseFragment::WriteStartElementL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenBaseFragment::~CSenBaseFragment()
	CSenSoapEnvelope::AddHeaderL(CSenElement &)
	CSenSoapEnvelope::BodyAsStringL()
	CSenSoapEnvelope::BodyL()
	CSenSoapEnvelope::CSenSoapEnvelope()
	CSenSoapEnvelope::DetachFaultL()
	CSenSoapEnvelope::EndElementL(const TDesC8 &,const TDesC8 &,const TDesC8 &)
	CSenSoapEnvelope::FaultL()
	CSenSoapEnvelope::HasBody()
	CSenSoapEnvelope::HasHeader()
	CSenSoapEnvelope::HeaderL()
	CSenSoapEnvelope::IsFault()
	CSenSoapEnvelope::ParseHeaderL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenSoapEnvelope::ParseL(const TDesC8 &)
	CSenSoapEnvelope::SetBodyL(const TDesC8 &)
	CSenSoapEnvelope::SetSoapActionL(const TDesC8 &)
	CSenSoapEnvelope::SoapAction()
	CSenSoapEnvelope::SoapAction2()
	CSenSoapEnvelope::SoapVersion()
	CSenSoapEnvelope::StartElementL(const TDesC8 &,const TDesC8 &,const TDesC8 &,const RAttributeArray &)
	CSenSoapEnvelope::~CSenSoapEnvelope()

Protected Attributes
CSenWsSecurityHeader *	ipSecurityHeader

Inherited Attributes
	CSenBaseFragment::iState
	CSenBaseFragment::iWs
	CSenBaseFragment::iXmlReader
	CSenBaseFragment::ipElement
	CSenBaseFragment::ipOwner
	CSenSoapEnvelope::ipBodyFragment
	CSenSoapEnvelope::ipHeaderFragment
	CSenSoapEnvelope::ipSoapAction

Constructor & Destructor Documentation

CSenSoapMessage()

IMPORT_C

CSenSoapMessage

(

)

[protected]

C++ default constructor.

~CSenSoapMessage()

IMPORT_C

~CSenSoapMessage

(

)

[virtual]

Destructor.

Member Functions Documentation

AddSecurityTokenL(const TDesC8 &)

IMPORT_C TInt

AddSecurityTokenL

(

const TDesC8 &

aNewToken

)

Adds new token (content) to current security header, appending to existing. The token is appended after the current content of security token. Method instantiates and adds default security header (without data), if such was not set in beforehand.

Since: Series60 3.0

Parameters

const TDesC8 & aNewToken

Token to be inserted.

BaseConstructL()

IMPORT_C void

BaseConstructL

(

)

[protected]

This method should be called from the deriving classes ConstructL() methods.

Since: Series60 3.0

BaseConstructL(TSOAPVersion)

IMPORT_C void

BaseConstructL

(

TSOAPVersion

aVersion

)

[protected]

This method should be called from the deriving classes ConstructL() methods.

Since: Series60 4.0

Parameters

TSOAPVersion aVersion

BaseConstructL(TSOAPVersion, const TDesC8 &)

IMPORT_C void	BaseConstructL	(	TSOAPVersion	aVersion,
			const TDesC8 &	aSecurityNs
		)	[protected]

This method should be called from the deriving classes ConstructL() methods.

Since: Series60 4.0

Parameters

TSOAPVersion aVersion	version of SOAP (1.1 or 1.2)
const TDesC8 & aSecurityNs	seurity namespace version . KSecuritySchemeXmlNs from 2003 , or KSecurityXmlNs from 2004

NewL()

IMPORT_C CSenSoapMessage *

NewL

(

)

[static]

Two-phase constructor.

NewL(TSOAPVersion)

IMPORT_C CSenSoapMessage *

NewL

(

TSOAPVersion

aVersion

)

[static]

Two-phase constructor.

Since: Series60 4.0

Parameters

TSOAPVersion aVersion

version of SOAP (1.1 or 1.2)

NewL(TSOAPVersion, const TDesC8 &)

IMPORT_C CSenSoapMessage *	NewL	(	TSOAPVersion	aVersion,
			const TDesC8 &	aSecurityNs
		)	[static]

Two-phase constructor.

Since: Series60 4.0

Parameters

TSOAPVersion aVersion	version of SOAP (1.1 or 1.2)
const TDesC8 & aSecurityNs	seurity namespace version . KSecuritySchemeXmlNs from 2003 , or KSecurityXmlNs from 2004

NewSecurityHeaderLC(const TDesC8 *)

IMPORT_C CSenWsSecurityHeader *

NewSecurityHeaderLC

(

const TDesC8 *

aData = NULL

)

[protected, virtual]

Helper function to make a new security header.

Since: Series60 3.0

Parameters

const TDesC8 * aData = NULL

Default=NULL. Data to be set in the security header.

ParseHeaderL(const TDesC8 &, const TDesC8 &, const TDesC8 &, const RAttributeArray &)

IMPORT_C void	ParseHeaderL	(	const TDesC8 &	aNsUri,
			const TDesC8 &	aLocalName,
			const TDesC8 &	aQName,
			const RAttributeArray &	aAttributes
		)	[protected, virtual]

Implements functionality to parse SOAP header if one is found during parsing the envelope. Extends basic functionality from SOAP envelope by recognizing and parsing <Security> element under following namespace: http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd All other headers are parsed using superclass (SOAP envelope) functionality.

Since: Series60 3.0

Parameters

const TDesC8 & aNsUri	The namespace URI of the new element
const TDesC8 & aLocalName	The local name of the new element
const TDesC8 & aQName	The qualified name of the new element
const RAttributeArray & aAttributes	The attributes of the new element

SetSecurityHeaderL(const TDesC8 &)

IMPORT_C void

SetSecurityHeaderL

(

const TDesC8 &

aData

)

Sets a new security header for the soap message. If existant, the old security header is deleted and new one with given data is added.

Since: Series60 3.0

Parameters

const TDesC8 & aData

Data to be used in the security header.

Member Data Documentation

CSenWsSecurityHeader * ipSecurityHeader

CSenWsSecurityHeader *

ipSecurityHeader

[protected]