pref.cpp

著名的 helix realplayer 基于手机 symbian 系统的 播放器全套源代码

/* ***** BEGIN LICENSE BLOCK ***** 
 * Version: RCSL 1.0/RPSL 1.0 
 *  
 * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
 *      
 * The contents of this file, and the files included with this file, are 
 * subject to the current version of the RealNetworks Public Source License 
 * Version 1.0 (the "RPSL") available at 
 * http://www.helixcommunity.org/content/rpsl unless you have licensed 
 * the file under the RealNetworks Community Source License Version 1.0 
 * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
 * in which case the RCSL will apply. You may also obtain the license terms 
 * directly from RealNetworks.  You may not use this file except in 
 * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
 * applicable to this file, the RCSL.  Please see the applicable RPSL or 
 * RCSL for the rights, obligations and limitations governing use of the 
 * contents of the file.  
 *  
 * This file is part of the Helix DNA Technology. RealNetworks is the 
 * developer of the Original Code and owns the copyrights in the portions 
 * it created. 
 *  
 * This file, and the files included with this file, is distributed and made 
 * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
 * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
 * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
 * 
 * Technology Compatibility Kit Test Suite(s) Location: 
 *    http://www.helixcommunity.org/content/tck 
 * 
 * Contributor(s): 
 *  
 * ***** END LICENSE BLOCK ***** */ 
   
#include "hxtypes.h"
#include "hxwintyp.h"
#include "hxresult.h"
#include "hxcom.h"
#include "hxprefs.h"
#include "pref.h"
#include "hxassert.h"
#include "hxbuffer.h"
#include "hxstring.h"
#include "hxstrutl.h"
//#include "hlxclib/stdio.h"
#include "hlxclib/stdlib.h"

#if defined(_MACINTOSH) || defined(_MAC_UNIX)
#if defined(_CARBON) || defined(_MAC_UNIX)
#include "platform/mac/mac_pref_cf.h"
#else
#include "mac_pref.h"
#endif

#elif defined(_UNIX) && !defined(_MAC_UNIX)
#include "unix_pref.h"

#elif defined(_WIN32) || defined(_WINDOWS)
#include "win_pref.h"

#elif defined(_SYMBIAN)
#include "symbian_pref.h"
#elif defined(_OPENWAVE)
#include "openwave_pref.h"
#else
#error Undefined platform!
#endif

#include "hxheap.h"
#ifdef _DEBUG
#undef HX_THIS_FILE		
static const char HX_THIS_FILE[] = __FILE__;
#endif


// 	call open_pref() to automatically create the correct platform specific preference 
//  object.	If open_pref() returns NULL, an error occurred and the CPref object was 
//  not created. Call last_error to get the error 

CPref * CPref::open_pref(const char* pCompanyName, const char* pProductName, int nProdMajorVer, int nProdMinorVer, BOOL bCommon)
{
    CPref * pPref = NULL;

#if   defined (_CARBON) || defined(_MAC_UNIX)
	pPref = CMacPref::open_pref(pCompanyName, pProductName, nProdMajorVer, nProdMinorVer, bCommon);

#elif   defined (_MACINTOSH)
	pPref = CMacPref::open_pref(pCompanyName, pProductName, nProdMajorVer, nProdMinorVer);

#elif defined( _UNIX)
	pPref = ( CPref *) CUnixPref::open_pref(pCompanyName, pProductName, nProdMajorVer, nProdMinorVer);
        
#elif defined(_SYMBIAN)
	pPref = ( CPref *) CSymbianPref::open_pref( pCompanyName,
                                                    pProductName,
                                                    nProdMajorVer,
                                                    nProdMinorVer);

#elif defined(_OPENWAVE)
	pPref = ( CPref *) COpenwavePref::open_pref( pCompanyName,
                                                     pProductName,
                                                     nProdMajorVer,
                                                     nProdMinorVer);

#elif defined( _WIN32 ) || defined( _WINDOWS )
	pPref = CWinPref::open_pref(pCompanyName, pProductName, nProdMajorVer, nProdMinorVer, bCommon);
#endif
	if (pPref)
	{
		pPref->m_bIsCommonPref = bCommon;
	}

	return pPref;
}

CPref* CPref::open_shared_pref(const char* pCompanyName)
{
    // Major and Minor version numbers are not used for a shared preference since it is shared among all products
    return CPref::open_pref(pCompanyName,HX_PRODUCTNAME_SHARED,0,0);
}

CPref* CPref::open_shared_user_pref(const char* pCompanyName)
{
    // Major and Minor version numbers are not used for a shared preference since it is shared among all products
    return CPref::open_pref(pCompanyName,HX_PRODUCTNAME_SHARED,0,0,false);
}

// 	Constructor NOTE: use open_pref() to create an instance of this class 
CPref::CPref() :
    m_pPrefTable(NULL), m_bIsCommonPref(FALSE)
{						
	mLastError = HXR_OK;
}   	

//      class destructor 
CPref::~CPref(void)
{
    HX_DELETE(m_pPrefTable);
}

void CPref::SetupPrefTable(PrefTableEntry* pPrefTable,INT32 nTableEntries)
{ 
    // Cleanup existing pref table
    HX_DELETE(m_pPrefTable);

    // Create new pref table
    m_pPrefTable = new CPrefTable(pPrefTable,nTableEntries,this);
    HX_ASSERT(m_pPrefTable);
}

CPrefTable::CPrefTable(PrefTableEntry* pPrefTable,INT32 nTableEntries,CPref* pPrefs) :
    m_pPrefTable(pPrefTable),
    m_nTableEntries(nTableEntries),
    m_pCPref(pPrefs),
    m_pIHXPrefs(NULL)
{
}

CPrefTable::CPrefTable(PrefTableEntry* pPrefTable,INT32 nTableEntries,IHXPreferences* pPrefs) :
    m_pPrefTable(pPrefTable),
    m_nTableEntries(nTableEntries),
    m_pCPref(NULL),
    m_pIHXPrefs(pPrefs)
{
    if (m_pIHXPrefs)
	m_pIHXPrefs->AddRef();
}

CPrefTable::~CPrefTable()
{
    HX_RELEASE(m_pIHXPrefs);
}

HX_RESULT CPrefTable::RemoveIndexedPref(INT32 nPrefKey)
{
    // Index is out of table range if this is false
    HX_ASSERT(nPrefKey >= 0 && nPrefKey < m_nTableEntries);

    // Need to call SetupPrefTable() if this is false
    HX_ASSERT(m_pPrefTable);

    // Index is out of table range
    if (nPrefKey < 0 || nPrefKey >= m_nTableEntries)
	return HXR_INVALID_PARAMETER;

    // Need to call SetupPrefTable()
    if (!m_pPrefTable || !m_pCPref)
	return HXR_UNEXPECTED;

    return m_pCPref->remove_indexed_pref(m_pPrefTable[nPrefKey].szPrefName);

}

HX_RESULT CPrefTable::RemovePref(INT32 nPrefKey)
{
    // Index is out of table range if this is false
    HX_ASSERT(nPrefKey >= 0 && nPrefKey < m_nTableEntries);

    // Need to call SetupPrefTable() if this is false
    HX_ASSERT(m_pPrefTable);

    // Index is out of table range
    if (nPrefKey < 0 || nPrefKey >= m_nTableEntries)
	return HXR_INVALID_PARAMETER;

    // Need to call SetupPrefTable()
    if (!m_pPrefTable || !m_pCPref)
	return HXR_UNEXPECTED;

    return m_pCPref->remove_pref(m_pPrefTable[nPrefKey].szPrefName);

}

BOOL CPrefTable::ReadPoints(const char* pBuffer,HXxPoint* pt,int nNumPoints)
{
    // If this is false something is really messed up
    HX_ASSERT(pBuffer);
    HX_ASSERT(pt);

    const char* szSeperators = ",";
    char	szBufferCopy[MAX_PREF_SIZE]; /* Flawfinder: ignore */
    char*	pToken= NULL;
    
    SafeStrCpy(szBufferCopy, pBuffer, MAX_PREF_SIZE);

   // Establish string and get the first token: 
   pToken = strtok( szBufferCopy, szSeperators );
   int i = 0;
   while( pToken != NULL )
   {
	// Store x value
	pt[i].x = atol(pToken);

	// Get next token and store y value
	pToken = strtok( NULL, szSeperators );
	pt[i].y = atol(pToken);

	// Get next token and continue
	i++;
	pToken = strtok( NULL, szSeperators );
   }

   return (i == nNumPoints) ? TRUE : FALSE;
}

HX_RESULT CPrefTable::ReadPrefColor(INT32 nPrefKey,HXxColor& color,INT32 nIndex)
{
    HX_RESULT theErr = HXR_OK;
    INT32 lValue = 0;

    theErr = ReadPrefInt(nPrefKey,lValue,nIndex);
    color = (HXxColor) lValue;

    return theErr;
}

HX_RESULT CPrefTable::ReadPref(INT32 nPrefKey,INT32 nIndex,IHXBuffer*& pBuffer)
{
    // Index is out of table range if this is false
    HX_ASSERT(nPrefKey >= 0 && nPrefKey < m_nTableEntries);

    // Need to call SetupPrefTable() if this is false
    HX_ASSERT(m_pPrefTable);

    // Index is out of table range
    if (nPrefKey < 0 || nPrefKey >= m_nTableEntries)
	return HXR_INVALID_PARAMETER;

    // Need to call SetupPrefTable()
    if (!m_pPrefTable || (!m_pCPref && !m_pIHXPrefs))
	return HXR_UNEXPECTED;

    // If we have an indexed pref append index number to pref
    if (nIndex > 0)
    {
        char szIndexedPref[MAX_PREF_NAME]; /* Flawfinder: ignore */
	SafeSprintf(szIndexedPref,MAX_PREF_NAME,"%s%ld",m_pPrefTable[nPrefKey].szPrefName,nIndex);
	return (m_pCPref ? m_pCPref->read_pref(szIndexedPref,pBuffer) : m_pIHXPrefs->ReadPref(szIndexedPref,pBuffer));
    }
    // otherwise just read in this pref
    else
	return (m_pCPref ? m_pCPref->read_pref(m_pPrefTable[nPrefKey].szPrefName,pBuffer) : m_pIHXPrefs->ReadPref(m_pPrefTable[nPrefKey].szPrefName,pBuffer));
}

BOOL CPrefTable::IsPrefSet(INT32 nPrefKey,INT32 nIndex)
{
    CHXBuffer* pBuffer = NULL;
    HX_RESULT result;

    // Try to read the pref
    result = ReadPref(nPrefKey,nIndex,(IHXBuffer*&)pBuffer);

    // Don't need buffer anymore
    HX_RELEASE(pBuffer);

    return SUCCEEDED(result) ? TRUE : FALSE;
}

HX_RESULT CPrefTable::ReadPrefInt(INT32 nPrefKey,INT32& nValue,INT32 nIndex)
{
    CHXBuffer* pBuffer = NULL;
    HX_RESULT result;

    // Default return value
    nValue = 0;

    // Try to read the pref
    result = ReadPref(nPrefKey,nIndex,(IHXBuffer*&)pBuffer);

    // Convert the preference to an integer 
    if (result == HXR_OK)
	nValue = atol((const char*)pBuffer->GetBuffer());
    // Pref doesn't exist convert default value to integer
    // Added the invalid parameter check to insure the index in valid range RBP 8/20/01 
    else if (HXR_INVALID_PARAMETER != result && HXR_UNEXPECTED != result)
    {
	if(NULL != m_pPrefTable[nPrefKey].pDefaultValue)
	{
	    nValue = atol(m_pPrefTable[nPrefKey].pDefaultValue);
	}
	else
	{
	    return result;
	}
    }
    else
	return HXR_FAIL;

    // Don't need buffer anymore
    if (pBuffer)
	pBuffer->Release();

    return HXR_OK;
}

HX_RESULT CPrefTable::ReadPrefRect(INT32 nPrefKey,HXxRect& rect,INT32 nIndex)
{
    CHXBuffer* pBuffer = NULL;
    HX_RESULT result;

    // Try to read the pref
    result = ReadPref(nPrefKey,nIndex,(IHXBuffer*&)pBuffer);

    // Convert the preference to a rect
    HXxPoint ptArray[2];
    if (result == HXR_OK)
    {
	if (ReadPoints((const char*)pBuffer->GetBuffer(),ptArray,2))
	{
	    rect.left = ptArray[0].x;
	    rect.top = ptArray[0].y;
	    rect.right = ptArray[1].x;
	    rect.bottom = ptArray[1].y;

	    // Don't need buffer anymore
	    if (pBuffer)
		pBuffer->Release();
	    return HXR_OK;
	}
    }

    if (m_pPrefTable[nPrefKey].pDefaultValue)
    {
	ReadPoints(m_pPrefTable[nPrefKey].pDefaultValue,ptArray,2);
	rect.left = ptArray[0].x;
	rect.top = ptArray[0].y;
	rect.right = ptArray[1].x;
	rect.bottom = ptArray[1].y;
    }
    else
	return HXR_FAIL;