applayerpluginsandutils/bookmarksupport/src/bookmarkbase.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 15 Mar 2010 12:42:40 +0200
branchRCL_3
changeset 8 fa2fd8b2d6cc
parent 0 b16258d2340f
permissions -rw-r--r--
Revision: 201009 Kit: 201010

// Copyright (c) 2005-2009 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:
//

#include <bookmark.h>
#include "bkmrk.h"
#include "bkmrkfolder.h"

/**
RBkNode constructor
@publishedPartner
@released
*/
EXPORT_C RBkNode::RBkNode() : iItem(NULL)
	{
	}

/**
Closes the RBkNode handle and decrements the reference count
@publishedPartner
@released
*/
EXPORT_C void RBkNode::Close()
	{
	if (iItem)
		{
		iItem->DecRefCount();
		}
	iItem = NULL;
	}

/**
Returns the type of the object that the RBkNode handle is connected to

@return The type of the object connected to
@publishedPartner
@released
*/
EXPORT_C Bookmark::TType RBkNode::Type() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	return iItem->Type();
	}

/**
Method for querying the bookmark item's database id.

@return The item's ID.
@publishedPartner
@released
*/
EXPORT_C Bookmark::TItemId RBkNode::Id() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	return iItem->Id();
	}

/**
Method for querying a bookmark item's parent folder. Only the root will not have
a parent. The method will leave if an attempt is made to call this on the root folder

@return The opened RBkFolder object.
@leave KErrNotFound This will leave if called on the root folder (the root folder has no parent).
@publishedPartner
@released
*/
EXPORT_C RBkFolder RBkNode::OpenParentL() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	CBookmarkFolder* parent = iItem->Parent();
	if (!parent)
		{
		User::Leave(KErrNotFound);
		}
	return parent->OpenFolder();
	}
	
/**
Opens RBkBookmark handle from this RBkNode handle. This is usually done when iterating through a folder. 
You must ensure that this RBkNode handle is of the type: Bookmark::ETypeBookmark before calling this method. 

This method does NOT close the RBkNode handle

@return The opened RBkBookmark object
@leave	Bookmark::KErrWrongType The method will leave if an attempt is made to call this with a RBkNode handle which is not of
the Bookmark::ETypeBookmark type.
@publishedPartner
@released
*/
EXPORT_C RBkBookmark RBkNode::OpenBookmarkL() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	if (Type() != Bookmark::ETypeBookmark)
		{
		// can't create a bookmark from a folder item
		User::Leave(Bookmark::KErrWrongType);
		}
		
	RBkBookmark handle;
	handle.SetItem(*iItem);
	return handle;
	}

/**
Opens RBkFolder handle from this RBkNode handle. This is usually done when iterating through a folder. 
You must ensure that this RBkNode handle is of the type: Bookmark::ETypeFolder before calling this method. 

This method does NOT close the RBkNode handle

@return The opened RBkFolder object.
@leave	Bookmark::KErrWrongType The method will leave if an attempt is made to call this with a RBkNode handle which is not of
the Bookmark::ETypeFolder type.
@publishedPartner
@released
*/
EXPORT_C RBkFolder RBkNode::OpenFolderL() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	if (Type() != Bookmark::ETypeFolder)
		{
		// can't create a bookmark from a folder item
		User::Leave(Bookmark::KErrWrongType);
		}
		
	RBkFolder handle;
	handle.SetItem(*iItem);
	return handle;
	}

/**
Moves the item to another folder

This function will leave if called on the root folder or an out of memory condition
occurs. 

@param aNewParent The new parent folder
@leave Bookmark::KErrReadOnly This function will leave if the item is read only.
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetParentL(RBkFolder& aNewParent)
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	LeaveIfRootL();
	// Push the bookmark internal item into the cleanupstack using TCleanupItem.
	// else the iItem will not get deleted in case of a leave from AppendL function.
	CleanupStack::PushL ( TCleanupItem ( RBkNode::DeleteBkmrkItem, iItem ) );
	aNewParent.Folder()->AppendL(*iItem);
	CleanupStack::Pop ();
	}

/**
Gets the items title text.

@return A reference to the bookmark's title text
@publishedPartner
@released
*/
EXPORT_C const TDesC& RBkNode::Title() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	return iItem->Title();
	}
	
/**
Sets the item's title text. Folder titles must be unique.

@param aTitle The item's new title.
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetTitleL(const TDesC& aTitle)
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));

	LeaveIfRootL();
	iItem->SetTitleL(aTitle);
	}

/**
Gets the item description text.

@return Reference to the bookmark's description text
@publishedPartner
@released
*/
EXPORT_C const TDesC& RBkNode::DescriptionL() const
	{
	CBkmrkProperties* properties = ExtendedPropertiesL();
	return properties->Description();
	}
	
/**
Sets the item's decription text.

@param aDescription The item's new description
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetDescriptionL(const TDesC& aDescription)
	{
	LeaveIfRootL();
	CBkmrkProperties* properties = ExtendedPropertiesL();
	properties->SetDescriptionL(aDescription);
	}

/**
Returns whether the item is public or private

@return ETrue if the bookmark or folder is public, otherwise EFalse
@publishedPartner
@released
*/
EXPORT_C TBool RBkNode::IsPublic() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	return iItem->IsPublic();
	}
	
/**
Sets the public or private status.

@param aPublic Whether the item is to be public or private
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetPublicL(TBool aPublic)
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	LeaveIfRootL();
	iItem->SetPublicL(aPublic);
	}

/**
Returns whether the item is read only or not

@return ETrue if the bookmark or folder can be written to, otherwise EFalse
@publishedPartner
@released
*/
EXPORT_C TBool RBkNode::IsWritable() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	return iItem->IsWritable();;
	}
	
/**
Sets item to Read Only. An item can always be made Read Only, but the bookmark database must be opened as
Bookmark::EVisibilityManager in order to set an item back to Read/Write.
This function will leave if called on the root folder.

@see Bookmark::TVisibility
@param aWritable Whether the item is to be read only or not
@leave KErrPermissionDenied This function will leave, when the bookmark database is not opened in 
Bookmark::EVisibilityManager.
@leave Bookmark::KErrOperationDenied This function will leave, if called on the root folder.
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetWritableL(TBool aWritable)
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	
	LeaveIfRootL();
	iItem->SetWritableL(aWritable);
	}

/**
Returns the ID if an icon is assigned to this bookmark item.

@return The ID of the icon or KNullBookmarkID if no item has been assigned.
@publishedPartner
@released
*/
EXPORT_C Bookmark::TAttachmentId RBkNode::IconIdL() const
	{
	CBkmrkProperties* properties = ExtendedPropertiesL();
	return properties->IconId();
	}
	
/**
Sets the icon. Call this with KNullIconID to remove the icon. Icons are stored centrally in
the database and are shared by bookmark items. If the icon oes not exist in the database this
method will leave

@param aIconId The ID of the icon.
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetIconIdL(Bookmark::TAttachmentId aIconId)
	{
	LeaveIfRootL();
	CBkmrkProperties* properties = ExtendedPropertiesL();
	properties->SetIconIdL(aIconId);
	}

/**
Gets a custom property for the given property ID. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to get
@param aValue An integer the data value
@publishedPartner
@released
*/
EXPORT_C void RBkNode::GetCustomPropertyL(TUid aPropertyId, TInt& aValue) const
	{
	User::LeaveIfError(ExtendedPropertiesL()->CustomProperties().GetCustomProperty(aPropertyId, aValue));
	}
	
/**
Gets a custom property for the given property ID. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to get
@param aValue A floating point data value
@publishedPartner
@released
*/
EXPORT_C void RBkNode::GetCustomPropertyL(TUid aPropertyId, TReal& aValue) const
	{
	User::LeaveIfError(ExtendedPropertiesL()->CustomProperties().GetCustomProperty(aPropertyId, aValue));
	}
	
/**
Gets a custom property for the given property ID. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to get
@param aValue A 16 bit descriptor
@publishedPartner
@released
*/
EXPORT_C void RBkNode::GetCustomPropertyL(TUid aPropertyId, TDes& aValue) const
	{
	User::LeaveIfError(ExtendedPropertiesL()->CustomProperties().GetCustomProperty(aPropertyId, aValue));
	}
	
/**
Gets a custom property for the given property ID. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to get
@param aValue An 8 bit descriptor
@publishedPartner
@released
*/
EXPORT_C void RBkNode::GetCustomPropertyL(TUid aPropertyId, TDes8& aValue) const
	{
	User::LeaveIfError(ExtendedPropertiesL()->CustomProperties().GetCustomProperty(aPropertyId, aValue));
	}
	
/**
Assigns a new custom property value to the bookmark item. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to set
@param aValue An integer data value
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetCustomPropertyL(TUid aPropertyId, TInt aValue)
	{
	LeaveIfRootL();
	ExtendedPropertiesL()->CustomProperties().SetCustomPropertyL(aPropertyId, aValue);
	iItem->SetDirty();
	}

/**
Assigns a new custom property value to the bookmark item. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to set
@param aValue A floating point data value
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetCustomPropertyL(TUid aPropertyId, TReal aValue) __SOFTFP
	{
	LeaveIfRootL();
	ExtendedPropertiesL()->CustomProperties().SetCustomPropertyL(aPropertyId, aValue);
	iItem->SetDirty();
	}

/**
Assigns a new custom property value to the bookmark item. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to set
@param aValue A 16 bit descriptor
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetCustomPropertyL(TUid aPropertyId, const TDesC& aValue)
	{
	LeaveIfRootL();
	ExtendedPropertiesL()->CustomProperties().SetCustomPropertyL(aPropertyId, aValue);
	iItem->SetDirty();
	}

/**
Assigns a new custom property value to the bookmark item. This method will leave
if no such property has been registered on the database

@param aPropertyId The ID of the property you wish to set
@param aValue An 8 bit descriptor
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetCustomPropertyL(TUid aPropertyId, const TDesC8& aValue)
	{
	LeaveIfRootL();
	ExtendedPropertiesL()->CustomProperties().SetCustomPropertyL(aPropertyId, aValue);
	iItem->SetDirty();
	}

/**
Returns the item's owner if it is a private bookmark.  

@see Bookmark::TVisibility
@return The item's owner security ID
@leave KErrPermissionDenied This function will leave when the bookmark database 
is not opened as Bookmark::EVisibilityManager.
@publishedPartner
@released
*/
EXPORT_C TSecureId RBkNode::OwnerL() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	iItem->LeaveIfNotInManagerModeL ();
	TSecureId id;
	iItem->GetOwnerL(id);
	return id;
	}
	
/**
Sets the owner security ID of this bookmark item. All applications which have opened the bookmark database as 
Bookmark::EVisibilityManager can use this function. In other visibility modes the aOwner must be the current SID, 
otherwise function will leave with KErrPermissionDenied

@param aOwner The new owner ID.
@leave KErrPermissionDenied When the aOwner is not the current SID and the bookmark database is opened in
non-manager mode.
@leave Bookmark::KErrOperationDenied This function will leave, if called on the root folder.
@publishedPartner
@released
*/
EXPORT_C void RBkNode::SetOwnerL(TSecureId aOwner)
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	LeaveIfRootL();
	iItem->SetOwnerL(aOwner);
	}

/**
Not intended for external use.

@internalComponent
*/
CBookmarkBase* RBkNode::Item() const
	{
	return iItem;
	}

/**
Not intended for external use.

@internalComponent
*/
void RBkNode::SetItem(CBookmarkBase& aItem)
	{
	// Must not try to assign an already open item
	__ASSERT_ALWAYS(!iItem, User::Panic(Bookmark::KBookmarkErrCorrupt, Bookmark::KErrCorrupt));

	iItem = &aItem;
	iItem->IncRefCount();
	}

/**
Not intended for external use.

@internalComponent
*/
CBkmrkProperties* RBkNode::ExtendedPropertiesL() const
	{
	// The handle must be open and attached to a concrete bookmark object
	__ASSERT_ALWAYS(iItem, User::Panic(Bookmark::KBookmarkErrHandleNotOpen, Bookmark::KErrNotOpen));
	
	CBkmrkProperties* properties = &(iItem->ExtendedPropertiesL());
	return properties;
	}

void RBkNode::LeaveIfRootL() const
	{
	if (Title().Compare(Bookmark::KTxtRootTitle) == 0)
		{
		User::Leave(Bookmark::KErrOperationDenied);
		}
	}

/**
 Sets the last modified time to an arbitrary value. Only applications which have opened the bookmark 
 database as Bookmark::EVisibilityManager can use this function, otherwise it will leave with 
 KErrPermissionDenied error code.

 Note: The last modified time is automatically set to the current time during a commit. This
 function should only be used if the caller needs to set to a different time (for example when 
 synchronising bookmarks).
 
 @param aTime The time to set.
 @leave KErrPermissionDenied This function will leave, when the bookmark database is not opened in 
 Bookmark::EVisibilityManager.
 @publishedPartner
 @released
 */
EXPORT_C void RBkNode::SetLastModifiedL ( const TTime& aTime )
	{	
	iItem->LeaveIfNotInManagerModeL ();
	
	CBkmrkProperties* properties = ExtendedPropertiesL();		
	properties->SetLastModified ( aTime );
	iItem->SetDirty();
	}

/**
 Returns the last modified time. If the last modified time was never set, this will return 
 the value of midnight January 1st 1970 UTC. This can occur when using a version 1.0.0 database.
 
 @return Last modified date value.
 @publishedPartner
 @released
 */
EXPORT_C TTime RBkNode::LastModifiedL () const
	{
	CBkmrkProperties* properties = ExtendedPropertiesL();
	return properties->LastModified();
	}

void RBkNode::DeleteBkmrkItem ( TAny* aPtr )
	{
	CBookmarkBase* bkItem = ( CBookmarkBase* )aPtr;
	if ( bkItem )
		{
		bkItem->DecRefCount ();
		delete bkItem;
		bkItem = NULL;					
		}
	}