natfw/natfwunsaf_protocols/unsaf_codec/inc/natfwunsafunknownattributesattribute.h
/*
* Copyright (c) 2006-2007 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:
*
*/
#ifndef CNATFWUNSAFUNKNOWNATTRIBUTESATTRIBUTE_H
#define CNATFWUNSAFUNKNOWNATTRIBUTESATTRIBUTE_H
// INCLUDES
#include "natfwunsafattribute.h"
// FORWARD DECLARATIONS
// CLASS DECLARATION
/**
* Class for NATFWUNSAF UNKNOWN-ATTRIBUTES attribute.
*/
class CNATFWUNSAFUnknownAttributesAttribute : public CNATFWUNSAFAttribute
{
public: // Constructors and destructor
/**
* Creates a new instance of CNATFWUNSAFUnknownAttributesAttribute
* @return A new instance of CNATFWUNSAFUnknownAttributesAttribute
* ownership is transferred.
*/
IMPORT_C static CNATFWUNSAFUnknownAttributesAttribute* NewL();
/**
* Creates a new instance of CNATFWUNSAFUnknownAttributesAttribute and
* pushes it to the CleanupStack.
* @return A new instance of CNATFWUNSAFUnknownAttributesAttribute,
* ownership is transferred.
*/
IMPORT_C static CNATFWUNSAFUnknownAttributesAttribute* NewLC();
/**
* Decodes a UNSAF attribute from a byte stream.
* This version is for lookup table.
* @param aByteStream Byte stream, containing attribute type, length and
* value.
* @return Decoded UNSAF attribute, ownership is transferred.
*/
static CNATFWUNSAFAttribute* DecodeAttributeL(
const TDesC8& aByteStream);
/**
* Destructor, deletes the resources of
* CNATFWUNSAFUnknownAttributesAttribute.
*/
IMPORT_C virtual ~CNATFWUNSAFUnknownAttributesAttribute();
public: // From CNATFWUNSAFAttribute
CNATFWUNSAFAttribute::TType Type() const;
HBufC8* EncodeValueL() const;
public: // New functions
/**
* Adds an attribute type.
* @leave KErrNoMemory If no memory to add the new attribute type
* @leave KErrAlreadyExists If aAttributeType is already present.
*/
void AddContainedAttributeL(TUint16 aAttributeType);
/**
* Remove an attribute type.
* @return KErrNone If attribute type was successfully removed
* @return KErrNotFound If attribute type was not present.
*/
TInt RemoveContainedAttribute(TUint16 aAttributeType);
/**
* Gets an array containing all the attribute types contained in this
* attribute.
* @return Contained attribute types. Ownership of the
* array or the items inside it is not transferred.
*/
IMPORT_C const RArray<TUint32>& ContainedAttributes() const;
private:
enum TEncodedValue
{
//Size in bytes of a single entry (attribute) in the encoded value
//part of UNKNOWN-ATTRIBUTES
EElementSize = 2,
//The length of the encoded value has to be a multiple of 4
EGranularity = 4
};
private: // Constructors
CNATFWUNSAFUnknownAttributesAttribute();
private: // New functions
/**
* Check the length of attribute's value part is valid
* @param aLength Length of the attribute's value part
* @leave KErrCorrupt If the length is invalid
*/
static void CheckLengthL(TInt aLength);
void DecodeValueL(const TDesC8& aValue);
private: // Data
//Use 32bit values, since RArray stores objects in the array as 4 byte
//aligned quantities.
RArray<TUint32> iContainedAttributes;
private: // For testing purposes
__DECLARE_TEST;
};
#endif // CNATFWUNSAFUNKNOWNATTRIBUTESATTRIBUTE_H