AOO410/main/connectivity/source/drivers/macab/MacabRecords.hxx

/**************************************************************
 * 
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 * 
 *************************************************************/



#ifndef _CONNECTIVITY_MACAB_RECORDS_HXX_
#define _CONNECTIVITY_MACAB_RECORDS_HXX_

#include "MacabRecord.hxx"
#include "MacabHeader.hxx"

#include <premac.h>
#include <Carbon/Carbon.h>
#include <AddressBook/ABAddressBookC.h>
#include <postmac.h>
#include <com/sun/star/util/DateTime.hpp>

namespace connectivity
{
	namespace macab
	{
		/* This struct is for converting CF types to AB types (Core Foundation
		 * types to Address Book types).
		 */
		struct lcl_CFType {
			sal_Int32 cf;
			sal_Int32 ab;
		};

		class MacabRecords{
			protected:
				/* MacabRecords is, at its core, a table of macabfields, in the
				 * form of a header and a list of objects of type MacabRecord.
				 * It also has a unique name that refers to the name of the table.
				 */
				sal_Int32 recordsSize;
				sal_Int32 currentRecord;
				CFStringRef recordType;
				MacabHeader *header;
				MacabRecord **records;
				ABAddressBookRef addressBook;
				::rtl::OUString m_sName;

				/* For converting CF types to AB types */
				sal_Int32 lcl_CFTypesLength;
				lcl_CFType *lcl_CFTypes;

				/* For required properties */
				CFStringRef *requiredProperties;
				sal_Int32 numRequiredProperties;
				
			private:
				/* All of the private methods are for creating a MacabHeader or a
				 * MacabRecord. They are used by the initialize method that goes
				 * about filling a MacabRecords using all of the records in the
				 * Mac OS X Address Book.
				 */
				void bootstrap_CF_types();
				void bootstrap_requiredProperties();
				MacabHeader *createHeaderForProperty(const ABRecordRef _record, const CFStringRef _propertyName, const CFStringRef _recordType, const sal_Bool _isPropertyRequired) const;
				MacabHeader *createHeaderForProperty(const ABPropertyType _propertyType, const CFTypeRef _propertyValue, const CFStringRef _propertyName) const;
				void manageDuplicateHeaders(macabfield **_headerNames, const sal_Int32 _length) const;
				ABPropertyType getABTypeFromCFType(const CFTypeID cf_type ) const;
				void insertPropertyIntoMacabRecord(MacabRecord *_abrecord, const MacabHeader *_header, const ::rtl::OUString  _propertyName, const CFTypeRef _propertyValue) const;
				void insertPropertyIntoMacabRecord(const ABPropertyType _propertyType, MacabRecord *_abrecord, const MacabHeader *_header, const ::rtl::OUString  _propertyName, const CFTypeRef _propertyValue) const;
			public:
				MacabRecords(const ABAddressBookRef _addressBook, MacabHeader *_header, MacabRecord **_records, sal_Int32 _numRecords);
				MacabRecords(const MacabRecords *_copy);
				MacabRecords(const ABAddressBookRef _addressBook);
				~MacabRecords();

				void initialize();

				void setHeader(MacabHeader *_header);
				MacabHeader *getHeader() const;

				void setName(const ::rtl::OUString _sName);
				::rtl::OUString getName() const;

				MacabRecord *insertRecord(MacabRecord *_newRecord, const sal_Int32 _location);
				void insertRecord(MacabRecord *_newRecord);
				MacabRecord *getRecord(const sal_Int32 _location) const;
				void swap(const sal_Int32 _id1, const sal_Int32 _id2);

				macabfield *getField(const sal_Int32 _recordNumber, const sal_Int32 _columnNumber) const;
				macabfield *getField(const sal_Int32 _recordNumber, const ::rtl::OUString  _columnName) const;
				sal_Int32 getFieldNumber(const ::rtl::OUString  _columnName) const;

				sal_Int32 size() const;

				MacabHeader *createHeaderForRecordType(const CFArrayRef _records, const CFStringRef _recordType) const;
				MacabRecord *createMacabRecord(const ABRecordRef _abrecord, const MacabHeader *_header, const CFStringRef _recordType) const;

				MacabRecords *begin();
				sal_Int32 end() const;
				class iterator{
					protected:
						MacabRecords *records;
					public:
						sal_Int32 id;
						void operator= (MacabRecords *_records);
						iterator();
						~iterator();
						void operator++ ();
						sal_Bool operator!= (const sal_Int32 i) const;
						sal_Bool operator== (const sal_Int32 i) const;
						MacabRecord *operator* () const;
				};

		};
	}
}

#endif // _CONNECTIVITY_MACAB_RECORDS_HXX_