record.h

Trolltech公司发布的图形界面操作系统。可在qt-embedded-2.3.10平台上编译为嵌入式图形界面操作系统。

/**********************************************************************
** Copyright (C) 2000-2005 Trolltech AS.  All rights reserved.
**
** This file is part of the Qtopia Environment.
** 
** This program is free software; you can redistribute it and/or modify it
** under the terms of the GNU General Public License as published by the
** Free Software Foundation; either version 2 of the License, or (at your
** option) any later version.
** 
** A copy of the GNU GPL license version 2 is included in this package as 
** LICENSE.GPL.
**
** This program 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 General Public License for more details.
**
** In addition, as a special exception Trolltech gives permission to link
** the code of this program with Qtopia applications copyrighted, developed
** and distributed by Trolltech under the terms of the Qtopia Personal Use
** License Agreement. You must comply with the GNU General Public License
** in all respects for all of the code used other than the applications
** licensed under the Qtopia Personal Use License Agreement. If you modify
** this file, you may extend this exception to your version of the file,
** but you are not obligated to do so. If you do not wish to do so, delete
** this exception statement from your version.
** 
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact [e-mail] if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/

#ifndef RECORD_H
#define RECORD_H

#include <qtopia/qpeglobal.h>
#include <qtopia/quuid.h>

#include <qarray.h>
#include <qstring.h>
#include <qdatetime.h>

#include <sys/types.h>
#ifndef Q_OS_WIN32
#include <netinet/in.h>
#endif

class QRegExp;
//namespace qpe {

class RecordPrivate;
class QTOPIA_EXPORT Record
{
    friend class RecordPrivate;
    friend class Database;
    friend class DatabaseView;
public:
    enum FieldType {
	UndefinedType,
	BoolType,
	IntType,
	DateType,
	DateTimeType,
	StringType
    };

    Record( const QByteArray &ba ) : mIndex( -1 ), data( ba ), catsDirty( FALSE ) 
    { if ( !ba.data() ) initEmpty(); }
    Record();
    Record( const Record &c ) : mIndex( c.mIndex), data( c.data.copy() ), catsDirty( c.catsDirty ) { }
    virtual ~Record();
    
    Record &operator=( const Record &c )
    { mIndex = c.mIndex; data = c.data.copy(); catsDirty = c.catsDirty; return *this; }

    virtual bool match( QRegExp & ) { return FALSE; }
    virtual int compare( const Record &other ) const;

    void setCategories( const QArray<int> &v );
    void setCategories( int single );
    QArray<int> categories() const;

    QUuid uid() const;

    bool operator == ( const Record &r ) const { return header()->uid() == r.header()->uid(); }
    bool operator != ( const Record &r ) const { return header()->uid() != r.header()->uid(); }

    FieldType typeOf( int fieldId );
    
    QDate dateField( int fieldId, bool *ok = 0 ) const;
    QDateTime dateTimeField( int fieldId, bool *ok = 0 ) const;
    int intField( int fieldId, bool *ok = 0 ) const;
    QString stringField( int fieldId, bool *ok = 0 ) const;
    bool boolField( int fieldId, bool *ok = 0 ) const;

    void setDateField( int fieldId, const QDate &date );
    void setDateTimeField( int fieldId, const QDateTime & );
    void setIntField( int fieldId, int i );
    void setStringField( int fieldId, const QString &str );
    void setBoolField( int fieldId, bool b );
    
private:
    void initEmpty();
    

    struct RecordHeader {
    private:
	QUuid uuid;
	uint numCats;
	ushort numAttr;
    public:	
	QUuid uid() { 
	    if ( uuid.isNull() ) {
		uuid = Record::generateUuid(); 
	    }
	    return uuid; 
	}
	void setUid( QUuid uid ) { uuid = uid; }
	uint numCategories() { return ntohl( numCats ); }
	ushort numAttributes() { return ntohs( numAttr ); }
	void setNumCategories( uint num ) { numCats = htonl( num ); }
	void setNumAttributes( ushort num ) { numAttr = htons( num ); }
    };
    struct AttributeEntry {
    private:
	ushort nid;
	ushort ntype;
	int noffsetOrData;
    public:	
	ushort id() { return ntohs( nid ); }
	ushort type() { return ntohs( ntype ); }
	uint offsetOrData() { return ntohl( noffsetOrData ); }
	void setId( ushort num ) { nid = htons( num ); }
	void setType( ushort num ) { ntype = htons( num ); }
	void setOffsetOrData( uint num ) { noffsetOrData = htonl( num ); }
    };
    
	
    
    RecordHeader *header() const { return (RecordHeader *)data.data(); }
    AttributeEntry *firstAttribute() const {
	RecordHeader *h = header();
	return ( (h && h->numAttributes()) ? 
		 (AttributeEntry *) ( data.data() + sizeof( RecordHeader ) + 4*h->numCategories() ) :
		 0 );
    }
    int categoryOffset() const {
	return sizeof( RecordHeader );
    }	
    int attributeOffset() const {
	return sizeof( RecordHeader ) +
	    sizeof(int) * header()->numCategories();
    }
    int dataOffset() const {
	RecordHeader *h = header();
	return ( sizeof( RecordHeader ) + 
		 sizeof(int) * h->numCategories() + 
		 sizeof( AttributeEntry ) * h->numAttributes() );
    }
    AttributeEntry *findAttribute( int id ) const;
    AttributeEntry *findAttribute( int id, bool add  );
    
    void insertBytes( int point, uint bytes );
    void removeBytes( int point, uint bytes );
    
    friend struct RecordHeader;
    static QUuid generateUuid();

    int mIndex;
    QByteArray data;
    bool catsDirty : 1;
};

//};

#endif