diff -r 000000000000 -r f72a12da539e idlehomescreen/inc/xndomstringpool.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/idlehomescreen/inc/xndomstringpool.h Thu Dec 17 08:40:49 2009 +0200 @@ -0,0 +1,124 @@ +/* +* Copyright (c) 2005,2006 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: Flyweigth pattern implementation for dom strings. +* +*/ + + + +#ifndef XN_DOM_STRING_POOL_H +#define XN_DOM_STRING_POOL_H + +// INCLUDES +#include +#include + +// CLASS DECLARATION + +/** +* @ingroup group_domdocument +* Class utilize flyweight pattern. Dom strings are stored once +* and referred with index. Class can be serialized. +* +* @lib xndomdocument.lib +* @since Series 60 3.1 +*/ +class CXnDomStringPool : public CBase + { + public: // Constructors and destructor + + /** + * Two-phased constructor. + */ + static CXnDomStringPool* NewL(); + /** + * Two-phased stream constructor. + */ + static CXnDomStringPool* NewL( RReadStream& aStream ); + /** + * Destructor. + */ + virtual ~CXnDomStringPool(); + + public: + /** + * Make a copy from original StringPool. + * @since Series 60 3.1 + * @return Pointer to a string pool. Ownership is transferred to a caller. + */ + CXnDomStringPool* CloneL(); + public: //Adding + + /** + * Set dom string into string pool. + * @param aString String to add to string pool + * @return Index (reference) to string pool + */ + IMPORT_C TInt AddStringL( const TDesC8& aString ); + + public: //Accessing + /** + * Get pointer to the node element name. + * @param aMap Map object which has index to name string + * @return Pointer to the name + */ + const TDesC8& String( const TInt aStringRef ); + + /** + * Get object's data size in bytes. + * @return Data size in bytes + */ + TInt Size() const; + + /** + * Externalize object + * @param aStream Output stream + */ + void ExternalizeL( RWriteStream& aStream ) const; + + /** + * Internalize object + * @param aStream Input stream + */ + void InternalizeL( RReadStream& aStream ); + + /** + * Get index offset to string array for shared resources + * @return An offset that caller must add to its indexes + */ + TUint Offset() const; + + private: + + /** + * C++ default constructor. + */ + CXnDomStringPool(); + + /** + * By default Symbian 2nd phase constructor is private. + */ + void ConstructL(); + + private: + //String pool + RPointerArray iStringPool; + + TUint iStringPoolOffsetCurrent; // Internalize uses + TUint iStringPoolOffsetNext; + }; + +#endif // XN_DOM_STRING_POOL_H + +// End of File