diff -r 000000000000 -r 094583676ce7 PECengine/AttributeFramework2/Inc/MPEngPresenceAdvancedAttrModel2.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/PECengine/AttributeFramework2/Inc/MPEngPresenceAdvancedAttrModel2.h Thu Dec 17 08:41:52 2009 +0200 @@ -0,0 +1,155 @@ +/* +* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Advanced Presence Attribute interface. +* +*/ + +#ifndef __MPENGPRESENCEADVANCEDATTRMODEL2_H +#define __MPENGPRESENCEADVANCEDATTRMODEL2_H + +// INCLUDES +#include "MPEngPresenceAttrModel2.h" +#include + + +//FORWARD DECLARATIONS +class MPEngXMLParser; +class MPEngXMLSerializer; +class RWriteStream; +class RReadStream; +class CPEngPresenceAttrModelStorageProxy; + + + + + +// CLASS DECLARATION + +/** +* Advanced attribute model interface for Presence Engine +* internal use. +* +* This class defines the internal advanced interface +* for concrete Presence Attribute Models. This interface is +* used inside of the Presence Engine and this allows variety +* of extended operations to be performed for attribute models. +* +* @since 3.0 +*/ +class MPEngPresenceAdvancedAttrModel2 : public MPEngPresenceAttrModel2 + { + public: //XML handling + + /** + * Encodes attribute value to XML. + * + * @since 3.0 + * @param aSerializer The serializer where to write the XML. + */ + virtual void EncodeToXmlL( MPEngXMLSerializer& aSerializer ) const = 0; + + + /** + * Decodes attribute value from XML. + * + * @since 3.0 + * @param aParser The parser to use in parsing. + * @param aDataBlock The XML block containing attribute data. + */ + virtual void DecodeFromXmlL( MPEngXMLParser& aParser, + const TDesC8& aDataBlock ) = 0; + + + public: //Storage support + + /** + * Access to attribute model storage proxy. + * @since 3.0 + * @return Attribute model storage proxy. + */ + virtual const CPEngPresenceAttrModelStorageProxy& Storage() const = 0; + virtual CPEngPresenceAttrModelStorageProxy& Storage() = 0; + + + + + public: //Serialization + + /** + * Gets the byte size needed to to externalize attribute model. + * @since 3.0 + * @return Byte size needed to externalize the attribute model. + */ + virtual TInt ExternalizeSize() const = 0; + + + /** + * Externalizes attribute model data. + * + * @since 3.0 + * @param aStream The stream to write. + */ + virtual void ExternalizeL( RWriteStream& aStream ) const = 0; + + + + /** + * Internalizes attribute model data. + * + * @since 3.0 + * @param aStream The stream read from. + */ + virtual void InternalizeL( RReadStream& aStream ) = 0; + + + + + public: //Network commits and session state handling + + + /** + * Sets attribute data source as network. + * @since 3.0 + */ + virtual void HandleAttributeUpdatedToNetwork() = 0; + + + /** + * Handles network session status change. + * @since 3.0 + * @param aSessionOpen If ETrue, network presence session + * was opened. If EFalse, network presence session was closed. + */ + virtual void HandleNetworkSessionStateChangeL( TBool aSessionOpen ) = 0; + + + + + public: //destructor + + /** + * Inline virtual destructor. + * Concrete objects can be deleted through + * this interface. + */ + virtual ~MPEngPresenceAdvancedAttrModel2() {}; + + }; + +#endif //__MPENGPRESENCEADVANCEDATTRMODEL2_H + + +// End of File + +