smf/smfservermodule/smfclient/common/smfplaylist.cpp
author cgandhi <chandradeep.gandhi@sasken.com>
Wed, 23 Jun 2010 19:51:49 +0530
changeset 14 a469c0e6e7fb
parent 7 be09cf1f39dd
permissions -rw-r--r--
changes for SmfPost, SmfCredentialMgr, PLuginManager, SmfServer. Adding Sample Plugins and Sample Client Applications.

/**
 * Copyright (c) 2010 Sasken Communication Technologies Ltd.
 * All rights reserved.
 * This component and the accompanying materials are made available
 * under the terms of the "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:
 * Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution
 *
 * Contributors:
 * Manasij Roy, Nalina Hariharan
 * 
 * Description:
 * The playlist class represents an instance of a playlist.
 * SmfPlaylist class is in accordance with the XML Shareable Playlist Format (XSPF)
 * as mentioned in http://xspf.org/xspf-v1.html
 *
 */

#include <smfplaylist.h>
#include <smfplaylist_p.h>

/**
 * Constructor with default argument
 */
SmfPlaylist::SmfPlaylist( )
	{
	d = new SmfPlaylistPrivate;
	}

/**
 * Copy Constructor
 * @param aOther The reference object
 */
SmfPlaylist::SmfPlaylist( const SmfPlaylist &aOther )
	: d( aOther.d )
	{
	}

/**
 * Overloaded = operator
 * @param aOther The reference object
 * @return The target reference value
 */
SmfPlaylist& SmfPlaylist::operator=( const SmfPlaylist &aOther )
	{
	d->m_version = aOther.d->m_version;
	d->m_title = aOther.d->m_title;
	d->m_author = aOther.d->m_author;
	d->m_comments = aOther.d->m_comments;
	d->m_info = aOther.d->m_info;
	d->m_location = aOther.d->m_location;
	d->m_playlistId = aOther.d->m_playlistId;
	d->m_image = aOther.d->m_image;
	d->m_creationDate = aOther.d->m_creationDate;
	d->m_license = aOther.d->m_license;
	d->m_attribution = aOther.d->m_attribution;
	d->m_metadata = aOther.d->m_metadata;
	d->m_extension = aOther.d->m_extension;
	d->m_trackList = aOther.d->m_trackList;
	return *this;
	}

/**
 * Destructor
 */
SmfPlaylist::~SmfPlaylist( )
	{
	}

/**
 * Method to get the version of the playlist
 * @return The version of the playlist
 */
QString SmfPlaylist::version( ) const
	{
	return d->m_version;
	}

/**
 * Method to get the playlist title
 * @return The title of the playlist
 */
QString SmfPlaylist::playListTitle( ) const
	{
	return d->m_title;
	}

/**
 * Method to get the author of the playlist
 * @return The author of the playlist
 */
QString SmfPlaylist::author( ) const
	{
	return d->m_author;
	}

/**
 * Method to get the comments on the playlist
 * @return The comments on the playlist
 */
QList<SmfComment> SmfPlaylist::comments( ) const
	{
	return d->m_comments;
	}

/**
 * Method to get the URI of a web page to find out more about this playlist
 * @return The info Url
 */
QUrl SmfPlaylist::info( ) const
	{
	return d->m_info;
	}
		
/**
 * Method to get the Source URI for this playlist
 * @return The Source URI for this playlist
 */
QUrl SmfPlaylist::location( ) const
	{
	return d->m_location;
	}

/**
 * Method to get the id of the playlist
 * @return The ID value 
 */
QString SmfPlaylist::id( ) const
	{
	return d->m_playlistId;
	}

/**
 * Method to get the URI of an image to display in the absence 
 * of an image for playlist's tracks
 * @return The deafult image Url
 */
QUrl SmfPlaylist::image( ) const
	{
	return d->m_image;
	}

/**
 * Method to get the creation date of the playlist
 * @return The date and time of creation of the playlist
 */
QDateTime SmfPlaylist::creationDate( ) const
	{
	return d->m_creationDate;
	}

/**
 * Method to get the URI of a resource that describes the license 
 * under which this playlist was released
 * @return The license Url
 */
QUrl SmfPlaylist::license( ) const
	{
	return d->m_license;
	}

/**
 * Method to get the ordered list of URIs. The purpose is to satisfy 
 * licenses allowing modification but requiring attribution
 * @return The list of license Urls
 */
QList<QUrl> SmfPlaylist::attribution( ) const
	{
	return d->m_attribution;
	}

/**
 * Method to get the meta element that allows metadata fields to be added to XSPF
 * @return The meta elements as a QVarintMap
 */
QVariantMap SmfPlaylist::metadata( ) const
	{
	return d->m_metadata;
	}

/**
 * Method to get the extension element that allows non-XSPF XML 
 * to be included in XSPF documents
 * @return The extension elements as a QVarintMap
 */
QVariantMap SmfPlaylist::extension( ) const
	{
	return d->m_extension;
	}

/**
 * Method to get the list of tracks in the playlist
 * @return The list of tracks in the playlist
 */
QList<SmfTrackInfo> SmfPlaylist::trackList( ) const
	{
	return d->m_trackList;
	}

/**
 * Method to set the version of the playlist
 * @param aVersion The version of the playlist
 */
void SmfPlaylist::setVersion( const QString& aVersion )
	{
	d->m_version = aVersion;
	}

/**
 * Method to set the playlist title
 * @param aTitle The title of the playlist
 */
void SmfPlaylist::setPlayListTitle( const QString &aTitle )
	{
	d->m_title = aTitle;
	}

/**
 * Method to set the author of the playlist
 * @param aAuthor The author of the playlist
 */
void SmfPlaylist::setAuthor( const QString& aAuthor )
	{
	d->m_author = aAuthor;
	}

/**
 * Method to set the comments on the playlist
 * @param aComments The comments on the playlist
 */
void SmfPlaylist::setComments( const QList<SmfComment>& aComments )
	{
	d->m_comments = aComments;
	}

/**
 * Method to set the URI of a web page to find out more about this playlist
 * @param aInfoUrl The info Url
 */
void SmfPlaylist::setInfo( const QUrl& aInfoUrl )
	{
	d->m_info = aInfoUrl;
	}

/**
 * Method to set the Source URI for this playlist
 * @param aLocation The Source URI for this playlist
 */
void SmfPlaylist::setLocation( const QUrl& aLocation )
	{
	d->m_location = aLocation;
	}

/**
 * Method to set the id of the playlist
 * @param aId The ID value 
 */
void SmfPlaylist::setId( const QString &aId)
	{
	d->m_playlistId = aId;
	}

/**
 * Method to set the URI of an image to display in the absence 
 * of an image for playlist's tracks
 * @param aImage The default image Url
 */
void SmfPlaylist::setImage( const QUrl& aImage )
	{
	d->m_image = aImage;
	}

/**
 * Method to set the creation date of the playlist
 * @param aDate The date and time of creation of the playlist
 */
void SmfPlaylist::setCreationDate( const QDateTime& aDate )
	{
	d->m_creationDate = aDate;
	}

/**
 * Method to set the URI of a resource that describes the license 
 * under which this playlist was released
 * @param aLicense The license Url
 */
void SmfPlaylist::setLicense( const QUrl& aLicense )
	{
	d->m_license = aLicense;
	}

/**
 * Method to set the ordered list of URIs. The purpose is to satisfy 
 * licenses allowing modification but requiring attribution
 * @param aAttribution The list of license Urls
 */
void SmfPlaylist::setAttribution( const QList<QUrl>& aAttribution )
	{
	d->m_attribution = aAttribution;
	}

/**
 * Method to set the meta element that allows metadata fields to be added to XSPF
 * @param aMetaData The meta elements as a QVarintMap
 */
void SmfPlaylist::setMetadata( const QVariantMap& aMetaData )
	{
	d->m_metadata = aMetaData;
	}

/**
 * Method to set the extension element that allows non-XSPF XML 
 * to be included in XSPF documents
 * @param aExtension The extension elements as a QVarintMap
 */
void SmfPlaylist::setExtension( const QVariantMap& aExtension )
	{
	d->m_extension = aExtension;
	}

/**
 * Method to set the list of tracks in the playlist
 * @param aList The new list of tracks in the playlist
 */
void SmfPlaylist::setTrackList( const QList<SmfTrackInfo> &aList )
	{
	d->m_trackList = aList;
	}

/**
 * Method for Externalization. Writes the SmfPlaylist object to 
 * the stream and returns a reference to the stream.
 * @param aDataStream Stream to be written
 * @param aPlaylist The SmfPlaylist object to be externalized
 * @return reference to the written stream
 */
 QDataStream &operator<<( QDataStream &aDataStream, 
		const SmfPlaylist &aPlaylist )
	{
	// Serialize d->m_version
	aDataStream<<aPlaylist.d->m_version;
	
	// Serialize d->m_title
	aDataStream<<aPlaylist.d->m_title;
	
	// Serialize d->m_author
	aDataStream<<aPlaylist.d->m_author;
	
	// Serialize d->m_comments
	aDataStream<<aPlaylist.d->m_comments;
	
	// Serialize d->m_info
	aDataStream<<aPlaylist.d->m_info;
	
	// Serialize d->m_location
	aDataStream<<aPlaylist.d->m_location;
	
	// Serialize d->m_playlistId
	aDataStream<<aPlaylist.d->m_playlistId;
	
	// Serialize d->m_image
	aDataStream<<aPlaylist.d->m_image;
	
	// Serialize d->m_creationDate
	aDataStream<<aPlaylist.d->m_creationDate;
	
	// Serialize d->m_license
	aDataStream<<aPlaylist.d->m_license;
	
	// Serialize d->m_attribution
	aDataStream<<aPlaylist.d->m_attribution;
	
	// Serialize d->m_metadata
	aDataStream<<aPlaylist.d->m_metadata;
	
	// Serialize d->m_extension
	aDataStream<<aPlaylist.d->m_extension;
	
	// Serialize d->m_trackList
	aDataStream<<aPlaylist.d->m_trackList;
	
	return aDataStream;
	}

/**
 * Method for Internalization. Reads a SmfPlaylist object from 
 * the stream and returns a reference to the stream.
 * @param aDataStream Stream to be read
 * @param aPlaylist The SmfPlaylist object to be internalized
 * @return reference to the stream
 */
QDataStream &operator>>( QDataStream &aDataStream, 
		SmfPlaylist &aPlaylist)
	{
	// Deserialize d->m_version
	aDataStream>>aPlaylist.d->m_version;
	
	// Deserialize d->m_title
	aDataStream>>aPlaylist.d->m_title;
	
	// Deserialize d->m_author
	aDataStream>>aPlaylist.d->m_author;
	
	// Deserialize d->m_comments
	aDataStream>>aPlaylist.d->m_comments;
	
	// Deserialize d->m_info
	aDataStream>>aPlaylist.d->m_info;
	
	// Deserialize d->m_location
	aDataStream>>aPlaylist.d->m_location;
	
	// Deserialize d->m_playlistId
	aDataStream>>aPlaylist.d->m_playlistId;
	
	// Deserialize d->m_image
	aDataStream>>aPlaylist.d->m_image;
	
	// Deserialize d->m_creationDate
	aDataStream>>aPlaylist.d->m_creationDate;
	
	// Deserialize d->m_license
	aDataStream>>aPlaylist.d->m_license;
	
	// Deserialize d->m_attribution
	aDataStream>>aPlaylist.d->m_attribution;
	
	// Deserialize d->m_metadata
	aDataStream>>aPlaylist.d->m_metadata;
	
	// Deserialize d->m_extension
	aDataStream>>aPlaylist.d->m_extension;
	
	// Deserialize d->m_trackList
	aDataStream>>aPlaylist.d->m_trackList;
	
	return aDataStream;
	}