office-gobmx/store/source/stortree.hxx
Jens-Heiner Rechtien 9399c662f3 initial import
2000-09-18 14:18:43 +00:00

451 lines
11 KiB
C++

/*************************************************************************
*
* $RCSfile: stortree.hxx,v $
*
* $Revision: 1.1.1.1 $
*
* last change: $Author: hr $ $Date: 2000-09-18 15:18:32 $
*
* The Contents of this file are made available subject to the terms of
* either of the following licenses
*
* - GNU Lesser General Public License Version 2.1
* - Sun Industry Standards Source License Version 1.1
*
* Sun Microsystems Inc., October, 2000
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2000 by Sun Microsystems, Inc.
* 901 San Antonio Road, Palo Alto, CA 94303, USA
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License version 2.1, as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA 02111-1307 USA
*
*
* Sun Industry Standards Source License Version 1.1
* =================================================
* The contents of this file are subject to the Sun Industry Standards
* Source License Version 1.1 (the "License"); You may not use this file
* except in compliance with the License. You may obtain a copy of the
* License at http://www.openoffice.org/license.html.
*
* Software provided under this License is provided on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
* WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
* MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
* See the License for the specific provisions governing your rights and
* obligations concerning the Software.
*
* The Initial Developer of the Original Code is: Sun Microsystems, Inc.
*
* Copyright: 2000 by Sun Microsystems, Inc.
*
* All Rights Reserved.
*
* Contributor(s): _______________________________________
*
*
************************************************************************/
#ifndef _STORE_STORTREE_HXX
#define _STORE_STORTREE_HXX "$Revision: 1.1.1.1 $"
#ifndef _SAL_TYPES_H_
#include <sal/types.h>
#endif
#ifndef _RTL_MEMORY_H_
#include <rtl/memory.h>
#endif
#ifndef _VOS_MACROS_HXX_
#include <vos/macros.hxx>
#endif
#ifndef _VOS_MUTEX_HXX_
#include <vos/mutex.hxx>
#endif
#ifndef _STORE_TYPES_H_
#include <store/types.h>
#endif
#ifndef _STORE_MACROS_HXX_
#include <store/macros.hxx>
#endif
#ifndef _STORE_STORBASE_HXX
#include <storbase.hxx>
#endif
#ifdef _USE_NAMESPACE
namespace store {
#endif
/*========================================================================
*
* OStoreBTreeEntry.
*
*======================================================================*/
struct OStoreBTreeEntry
{
typedef OStorePageKey K;
typedef OStorePageLink L;
/** Representation.
*/
K m_aKey;
L m_aLink;
sal_uInt32 m_nAttrib;
/** Construction.
*/
OStoreBTreeEntry (void)
: m_nAttrib (0)
{}
OStoreBTreeEntry (const OStoreBTreeEntry& rOther)
: m_aKey (rOther.m_aKey),
m_aLink (rOther.m_aLink),
m_nAttrib (rOther.m_nAttrib)
{}
OStoreBTreeEntry& operator= (const OStoreBTreeEntry& rOther)
{
m_aKey = rOther.m_aKey;
m_aLink = rOther.m_aLink;
m_nAttrib = rOther.m_nAttrib;
return *this;
}
/** Comparison.
*/
enum CompareResult
{
COMPARE_LESS = -1,
COMPARE_EQUAL = 0,
COMPARE_GREATER = 1
};
CompareResult compare (const OStoreBTreeEntry& rOther) const
{
if (m_aKey < rOther.m_aKey)
return COMPARE_LESS;
else if (m_aKey == rOther.m_aKey)
return COMPARE_EQUAL;
else
return COMPARE_GREATER;
}
/** swap (internal and external representation).
*/
void swap (void)
{
#ifdef OSL_BIGENDIAN
m_aKey.swap();
m_aLink.swap();
m_nAttrib = VOS_SWAPDWORD(m_nAttrib);
#endif /* OSL_BIGENDIAN */
}
};
/*========================================================================
*
* OStoreBTreeNodeData.
*
*======================================================================*/
#define STORE_MAGIC_BTREENODE 0x58190322UL
struct OStoreBTreeNodeData : public NAMESPACE_STORE(OStorePageData)
{
typedef OStorePageData base;
typedef OStoreBTreeNodeData self;
typedef OStorePageGuard G;
typedef OStoreBTreeEntry T;
/** Representation.
*/
G m_aGuard;
T m_pData[1];
/** size.
*/
static sal_uInt16 size (void)
{
return (sizeof(G));
}
/** capacity.
*/
static sal_uInt16 capacity (const D& rDescr)
{
return (rDescr.m_nSize - (base::size() + self::size()));
}
sal_uInt16 capacity (void) const
{
return self::capacity (base::m_aDescr);
}
/** capacityCount (must be even).
*/
sal_uInt16 capacityCount (void) const
{
return (capacity() / sizeof(T));
}
/** usage.
*/
static sal_uInt16 usage (const D& rDescr)
{
return (rDescr.m_nUsed - (base::size() + self::size()));
}
sal_uInt16 usage (void) const
{
return self::usage (base::m_aDescr);
}
/** usageCount.
*/
sal_uInt16 usageCount (void) const
{
return (usage() / sizeof(T));
}
void usageCount (sal_uInt16 nCount)
{
base::m_aDescr.m_nUsed = base::size() + self::size();
base::m_aDescr.m_nUsed += nCount * sizeof(T);
}
/** Construction.
*/
OStoreBTreeNodeData (sal_uInt16 nPageSize);
void initialize (void);
self& operator= (const self& rOther)
{
if (this != &rOther)
{
base::operator= (rOther);
m_aGuard = rOther.m_aGuard;
rtl_copyMemory (m_pData, rOther.m_pData, capacity());
}
return *this;
}
/** Comparison.
*/
sal_Bool operator== (const self& rOther) const
{
return (base::operator==(rOther) && (m_aGuard == rOther.m_aGuard));
}
/** swap (external and internal representation).
*/
void swap (const D& rDescr);
/** guard (external representation).
*/
void guard (const D& rDescr)
{
sal_uInt32 nCRC32 = 0;
nCRC32 = G::crc32 (nCRC32, &m_aGuard.m_nMagic, sizeof(sal_uInt32));
nCRC32 = G::crc32 (nCRC32, m_pData, capacity(rDescr));
#ifdef OSL_BIGENDIAN
nCRC32 = VOS_SWAPDWORD(nCRC32);
#endif /* OSL_BIGENDIAN */
m_aGuard.m_nCRC32 = nCRC32;
}
/** verify (external representation).
*/
storeError verify (const D& rDescr)
{
sal_uInt32 nCRC32 = 0;
nCRC32 = G::crc32 (nCRC32, &m_aGuard.m_nMagic, sizeof(sal_uInt32));
nCRC32 = G::crc32 (nCRC32, m_pData, capacity(rDescr));
#ifdef OSL_BIGENDIAN
nCRC32 = VOS_SWAPDWORD(nCRC32);
#endif /* OSL_BIGENDIAN */
if (m_aGuard.m_nCRC32 != nCRC32)
return store_E_InvalidChecksum;
else
return store_E_None;
}
/** depth.
*/
sal_uInt32 depth (void) const
{
return self::m_aGuard.m_nMagic;
}
void depth (sal_uInt32 nDepth)
{
self::m_aGuard.m_nMagic = nDepth;
}
/** queryMerge.
*/
sal_Bool queryMerge (const self &rPageR) const
{
return ((usageCount() + rPageR.usageCount()) <= capacityCount());
}
/** querySplit.
*/
sal_Bool querySplit (void) const
{
return (!(usageCount() < capacityCount()));
}
/** Operation.
*/
sal_uInt16 find (const T& t) const;
void insert (sal_uInt16 i, const T& t);
void remove (sal_uInt16 i);
/** merge (with right page).
*/
void merge (const self& rPageR);
/** split (left half copied from right half of left page).
*/
void split (const self& rPageL);
/** truncate (to n elements).
*/
void truncate (sal_uInt16 n);
};
/*========================================================================
*
* OStoreBTreeNodeObject.
*
*======================================================================*/
class OStoreBTreeNodeObject :
public NAMESPACE_STORE(OStorePageObject)
{
typedef OStorePageObject base;
typedef OStoreBTreeNodeObject self;
typedef OStoreBTreeNodeData page;
typedef OStorePageDescriptor D;
typedef OStoreBTreeEntry T;
public:
/** Construction.
*/
inline OStoreBTreeNodeObject (page& rPage);
/** External representation.
*/
virtual void swap (const D& rDescr);
virtual void guard (const D& rDescr);
virtual storeError verify (const D& rDescr);
/** Query split.
*/
inline sal_Bool querySplit (void) const;
/** split.
*/
virtual storeError split (
sal_uInt16 nIndexL,
OStoreBTreeNodeData &rPageL,
OStoreBTreeNodeData &rPageR,
OStorePageBIOS &rBIOS,
NAMESPACE_VOS(IMutex) *pMutex = NULL);
/** remove (down to leaf node, recursive).
*/
storeError remove (
sal_uInt16 nIndexL,
OStoreBTreeEntry &rEntryL,
OStoreBTreeNodeData &rPageL,
#if 0 /* NYI */
OStoreBTreeNodeData &rPageR,
#endif /* NYI */
OStorePageBIOS &rBIOS,
NAMESPACE_VOS(IMutex) *pMutex = NULL);
private:
/** Representation.
*/
page& m_rPage;
};
inline OStoreBTreeNodeObject::OStoreBTreeNodeObject (page& rPage)
: OStorePageObject (rPage), m_rPage (rPage)
{
}
inline sal_Bool OStoreBTreeNodeObject::querySplit (void) const
{
return m_rPage.querySplit();
}
/*========================================================================
*
* OStoreBTreeRootObject.
*
*======================================================================*/
class OStoreBTreeRootObject :
public NAMESPACE_STORE(OStoreBTreeNodeObject)
{
typedef OStoreBTreeNodeObject base;
typedef OStoreBTreeNodeData page;
public:
/** Construction.
*/
inline OStoreBTreeRootObject (page& rPage);
/** split.
*/
virtual storeError split (
sal_uInt16 nIndexL,
OStoreBTreeNodeData &rPageL,
OStoreBTreeNodeData &rPageR,
OStorePageBIOS &rBIOS,
NAMESPACE_VOS(IMutex) *pMutex = NULL);
private:
/** Representation.
*/
page& m_rPage;
/** change (Root).
*/
storeError change (
OStoreBTreeNodeData &rPageL,
OStorePageBIOS &rBIOS,
NAMESPACE_VOS(IMutex) *pMutex = NULL);
};
inline OStoreBTreeRootObject::OStoreBTreeRootObject (page& rPage)
: OStoreBTreeNodeObject (rPage), m_rPage (rPage)
{
}
/*========================================================================
*
* The End.
*
*======================================================================*/
#ifdef _USE_NAMESPACE
}
#endif
#endif /* !_STORE_STORTREE_HXX */