1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ 2 /* 3 * This file is part of the LibreOffice project. 4 * 5 * This Source Code Form is subject to the terms of the Mozilla Public 6 * License, v. 2.0. If a copy of the MPL was not distributed with this 7 * file, You can obtain one at http://mozilla.org/MPL/2.0/. 8 * 9 * This file incorporates work covered by the following license notice: 10 * 11 * Licensed to the Apache Software Foundation (ASF) under one or more 12 * contributor license agreements. See the NOTICE file distributed 13 * with this work for additional information regarding copyright 14 * ownership. The ASF licenses this file to you under the Apache 15 * License, Version 2.0 (the "License"); you may not use this file 16 * except in compliance with the License. You may obtain a copy of 17 * the License at http://www.apache.org/licenses/LICENSE-2.0 . 18 */ 19 20 #pragma once 21 22 #include <file/FTable.hxx> 23 #include <connectivity/CommonTools.hxx> 24 #include <tools/urlobj.hxx> 25 26 27 namespace connectivity::dbase 28 { 29 typedef file::OFileTable ODbaseTable_BASE; 30 class ODbaseConnection; 31 32 class ODbaseTable : public ODbaseTable_BASE 33 { 34 // The first byte of a dBase file specifies its type 35 public: 36 enum DBFType { dBaseIII = 0x03, 37 dBaseIV = 0x04, 38 dBaseV = 0x05, 39 VisualFoxPro = 0x30, 40 VisualFoxProAuto = 0x31, // Visual FoxPro with AutoIncrement field 41 dBaseFS = 0x43, 42 dBaseFSMemo = 0xB3, 43 dBaseIIIMemo = 0x83, 44 dBaseIVMemo = 0x8B, 45 dBaseIVMemoSQL = 0x8E, 46 FoxProMemo = 0xF5 47 }; 48 enum DBFMemoType { MemodBaseIII = 0, 49 MemodBaseIV, 50 MemoFoxPro 51 }; 52 53 private: 54 // sources: https://www.clicketyclick.dk/databases/xbase/format/dbf.html (dBASE III and 5) 55 // http://www.dbase.com/KnowledgeBase/int/db7_file_fmt.htm (dBASE 7) which is similar at least for this part 56 struct DBFHeader { // address/pos in trailer 57 DBFType type; // dBASE/xBASE type, see DBFType 00h 58 sal_uInt8 dateElems[3]; // Date of last change (YYMMDD) 01h 59 sal_uInt32 nbRecords; // Number of records 04h 60 sal_uInt16 headerLength; // 08h 61 sal_uInt16 recordLength; // Length of 1 record 10h 62 sal_uInt8 trailer[20]; 63 // this last field contains these data: 64 // - reserved:2 bytes:should be filled with 0 12h/0 65 // - incomplete transaction:1 byte:dBASE IV 14h/2 66 // 00h Transaction ended (or rolled back) 67 // 01h Transaction started 68 // - encryptionFlag:1 byte: dBASE IV 15h/3 69 // 00h not encrypted 70 // 01h for encrypted 71 // - freeRecordThread:4 bytes:reserved for LAN only 16h/4 72 // - multiUserdBASE:8 bytes:reserved for multi-user dBASE (dBASE III+) 20h/8 73 // - MDXFlag:1 byte:dBASE IV 28h/16 74 // 0x01 if a production .MDX file exists for this table 75 // 0x00 if no .MDX file exists 76 // - languageDriver:1 byte:codepage (from Foxpro) 29h/17 77 // - reserved:2 bytes: should be filled with 0 30h/18 78 }; 79 struct DBFColumn { /* Column descriptors */ 80 sal_uInt8 db_fnm[11]; /* Field name */ 81 sal_uInt8 db_typ; /* Field type */ 82 sal_uInt32 db_adr; /* Field address */ 83 sal_uInt8 db_flng; /* Field length */ 84 sal_uInt8 db_dez; /* Decimal places for N */ 85 sal_uInt8 db_free2[14]; /* Reserved */ 86 }; 87 struct DBFMemoHeader 88 { 89 DBFMemoType db_typ; /* File type */ 90 sal_uInt32 db_next; /* Next free block */ 91 sal_uInt16 db_size; /* Block size: dBase 3 fixed */ DBFMemoHeaderconnectivity::dbase::ODbaseTable::DBFMemoHeader92 DBFMemoHeader() 93 : db_typ(MemodBaseIII) 94 , db_next(0) 95 , db_size(0) 96 { 97 } 98 }; 99 100 std::vector<sal_Int32> m_aTypes; // holds all types for columns just to avoid to ask the propertyset 101 std::vector<sal_Int32> m_aPrecisions; // same as above 102 std::vector<sal_Int32> m_aScales; 103 std::vector<sal_Int32> m_aRealFieldLengths; 104 DBFHeader m_aHeader = {}; 105 DBFMemoHeader m_aMemoHeader; 106 std::unique_ptr<SvStream> m_pMemoStream; 107 rtl_TextEncoding m_eEncoding; 108 109 void alterColumn(sal_Int32 index, 110 const css::uno::Reference< css::beans::XPropertySet>& descriptor , 111 const css::uno::Reference< css::sdbcx::XDataDescriptorFactory>& xOldColumn ); 112 void readHeader(); 113 void fillColumns(); 114 OUString createTempFile(); 115 void copyData(ODbaseTable* _pNewTable,sal_Int32 _nPos); 116 bool CreateFile(const INetURLObject& aFile, bool& bCreateMemo); 117 bool CreateMemoFile(const INetURLObject& aFile); 118 bool HasMemoFields() const; 119 void ReadMemoHeader(); 120 bool ReadMemo(std::size_t nBlockNo, ORowSetValue& aVariable); 121 122 void WriteMemo(const ORowSetValue& aVariable, std::size_t& rBlockNr); 123 bool WriteBuffer(); 124 bool UpdateBuffer(OValueRefVector& rRow, const OValueRefRow& pOrgRow, const css::uno::Reference< css::container::XIndexAccess>& _xCols, bool bForceAllFields); 125 css::uno::Reference< css::beans::XPropertySet> isUniqueByColumnName(sal_Int32 _nColumnPos); 126 bool AllocBuffer(); 127 128 void throwInvalidDbaseFormat(); 129 /// @throws css::sdbc::SQLException 130 /// @throws css::container::ElementExistException 131 /// @throws css::uno::RuntimeException 132 void renameImpl( const OUString& newName ); 133 void throwInvalidColumnType(TranslateId pErrorId, const OUString& _sColumnName); 134 135 protected: 136 virtual void FileClose() override; 137 // using ::connectivity::sdbcx::OTableDescriptor_BASE::rBHelper; 138 139 public: 140 virtual void refreshColumns() override; 141 virtual void refreshIndexes() override; 142 143 public: 144 ODbaseTable( sdbcx::OCollection* _pTables,ODbaseConnection* _pConnection); 145 ODbaseTable( sdbcx::OCollection* _pTables,ODbaseConnection* _pConnection, 146 const OUString& Name, 147 const OUString& Type, 148 const OUString& Description = OUString(), 149 const OUString& SchemaName = OUString(), 150 const OUString& CatalogName = OUString() 151 ); 152 153 void construct() override; // can throw any exception 154 155 virtual sal_Int32 getCurrentLastPos() const override; 156 virtual bool seekRow(IResultSetHelper::Movement eCursorPosition, sal_Int32 nOffset, sal_Int32& nCurPos) override; 157 virtual bool fetchRow(OValueRefRow& _rRow,const OSQLColumns& _rCols, bool bRetrieveData) override; 158 159 virtual css::uno::Any SAL_CALL queryInterface( const css::uno::Type & rType ) override; 160 //XTypeProvider 161 virtual css::uno::Sequence< css::uno::Type > SAL_CALL getTypes( ) override; 162 virtual void SAL_CALL disposing() override; 163 164 // XAlterTable 165 virtual void SAL_CALL alterColumnByName( const OUString& colName, const css::uno::Reference< css::beans::XPropertySet >& descriptor ) override; 166 virtual void SAL_CALL alterColumnByIndex( sal_Int32 index, const css::uno::Reference< css::beans::XPropertySet >& descriptor ) override; 167 // XRename 168 virtual void SAL_CALL rename( const OUString& newName ) override; 169 170 bool DropImpl(); 171 bool CreateImpl(); 172 173 174 virtual bool InsertRow(OValueRefVector& rRow, const css::uno::Reference< css::container::XIndexAccess>& _xCols) override; 175 virtual bool DeleteRow(const OSQLColumns& _rCols) override; 176 virtual bool UpdateRow(OValueRefVector& rRow, OValueRefRow& pOrgRow,const css::uno::Reference< css::container::XIndexAccess>& _xCols) override; 177 178 virtual void addColumn(const css::uno::Reference< css::beans::XPropertySet>& descriptor) override; 179 virtual void dropColumn(sal_Int32 _nPos) override; 180 181 static OUString getEntry(file::OConnection const * _pConnection, std::u16string_view _sURL ); 182 static bool Drop_Static(std::u16string_view _sUrl, bool _bHasMemoFields, sdbcx::OCollection* _pIndexes ); 183 184 virtual void refreshHeader() override; 185 186 virtual css::uno::Reference< css::sdbc::XDatabaseMetaData> getMetaData() const override; 187 }; 188 189 } 190 191 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ 192
xref:
/core/connectivity/source/inc/dbase/DTable.hxx
(revision f4ba2e1c5a1ee9243a9d5df80d1a7f216653c960)