DBF文件的解析介绍

news2024/12/24 20:28:23

1.基本介绍

DBF是Digital Beam Forming的缩写，“.dbf”文件扩展名代表据库处理系统所产生的数据库文件，起初意为保存数据的文件是一个简单的表，可以使用ASCII字符集添加、修改、删除或打印数据，随着产品变得越来越流行，底层文件类型 .dbf 得到扩展，并添加了其他文件以增强数据库系统的功能。所以DBF是一个非常小型的数据库文件，它支持的文本类型的长度也非常短，不超过256个长度。

2.JavaDBF介绍

JavaDBF 是一个用于读写 XBase 文件的 Java 库。有很多遗留应用程序都以 .dbf 作为主要存储格式。JavaDBF 最初是为此类应用程序的数据传输而编写的。直到 90 年代末，dBase 及其同类产品仍然是中小型企业应用程序最喜欢的数据库平台。它们需要较低的硬件配置并且开发成本较低。最终，功能更强大的桌面数据库（例如 Microsoft Access）出现了，DBF 文件格式仍然是存储和传输数据的最简单方法之一。（理论上：什么年代了，还不淘汰这种远古时期的数据库数据文件；实际上：无论什么年代了也架不住有这种业务需求）。

Github上有许多关于DBF的开源读写库，我这边使用的较多的是JavaDBF，它是一个用于读写 XBase 文件的 Java 库。有很多遗留应用程序都以 .dbf 作为主要存储格式。JavaDBF 最初是为此类应用程序的数据传输而编写的，支持几乎所有 XBase 数据类型，这些类型被解释为适当的 Java 类型，参考下表显示了匹配类型，如下：

2.1 读和写的类型

XBase Type	XBase Symbol	Java Type used in JavaDBF
Character	C	java.lang.String
Numeric	N	java.math.BigDecimal
Floating Point	F	java.math.BigDecimal
Logical	L	java.lang.Boolean
Date	D	java.util.Date

2.2 读的类型

FoxPro Type	Symbol	Java Type used in JavaDBF
Currency	Y	java.math.BigDecimal
Long	I	java.lang.Integer
Date Type	T	java.util.Date
Timestamp	@	java.util.Date
AutoIncrement	+	java.lang.Integer
Memo	M	java.lang.String or byte[]
Binary	B	byte[] or java.lang.Double
Blob	W	byte[]
General	G	byte[]
Picture	P	byte[]
VarBinary	Q	byte[]
Varchar	V	java.lang.String
Double	O	java.lang.Double

3.代码实现

创建Maven项目，集成pom坐标时注意使用JavaDBF相关的坐标，经过在“https://mvnrepository.com/”查找dbf和JavaDBF相关的关键字后，输入后者更加精确，本次选择的坐标为com.github.albfernandez，最后更新为为2022年的，相对稍显新一些，而且在GitHub上有此项目的源代码“GitHub - albfernandez/javadbf: Java library for reading and writing Xbase (dBase/DBF) files.”，参考如下最新版本的坐标：

<!-- https://mvnrepository.com/artifact/com.github.albfernandez/javadbf -->
<dependency>
    <groupId>com.github.albfernandez</groupId>
    <artifactId>javadbf</artifactId>
    <version>1.14.0</version>
</dependency>

3.1 写DBF代码

@RunWith(JUnit4.class)
public class DbfWriterTest {

    @Test
    public void writeDbf() throws Exception {
        File desktop = FileSystemView.getFileSystemView().getHomeDirectory();
        File dbfFile = new File(desktop , "用户信息.dbf");
        Charset charset = Charset.forName("GBK");
        try (DBFWriter writer = new DBFWriter(new FileOutputStream(dbfFile) , charset)) {
            //设置字段类型
            DBFField[] fields = new DBFField[4];
            //字段 id
            DBFField idField = new DBFField("id" , DBFDataType.NUMERIC , 16);
            fields[0] = idField;
            //字段 name
            DBFField nameField = new DBFField("name" , DBFDataType.CHARACTER , 32);
            fields[1] = nameField;
            //字段 bonus
            DBFField performanceField = new DBFField("bonus" , DBFDataType.NUMERIC , 16 , 2);
            fields[2] = performanceField;
            //字段 birthday
            DBFField birthdayField = new DBFField("birthday" , DBFDataType.DATE);
            fields[3] = birthdayField;

            writer.setFields(fields);
            //设置数据
            SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMdd");
            for (int i=1 ; i <= 10 ; i++) {
                Object[] values = new Object[4];
                values[0] = 1000 + i;
                values[1] = "chen冬冬_" + i;
                values[2] = new BigDecimal(Math.random() * 10000).setScale(2 , RoundingMode.HALF_UP);
                values[3] = dateFormat.parse("2023070" + i);
                writer.addRecord(values);
            }
        }
        System.out.println(String.format("文件 %s 已生成" , dbfFile.getAbsolutePath()));
    }

}

（生成示例）

3.2 读DBF代码

@RunWith(JUnit4.class)
public class DbfReadTest {

    @Test
    public void readDbf() throws Exception {
        File desktop = FileSystemView.getFileSystemView().getHomeDirectory();
        File dbfFile = new File(desktop , "用户信息.dbf");
        if (! dbfFile.exists()) {
            System.err.println(String.format("文件 %s 未找到，请先运行文件写入示例！" , dbfFile.getAbsolutePath()));
            return;
        }
        Charset charset = Charset.forName("GBK");
        try (DBFReader reader = new DBFReader(new FileInputStream(dbfFile) , charset)) {
            int fieldCount = reader.getFieldCount();
            System.out.println("===字段===");
            for (int i = 0; i < fieldCount; i++) {
                DBFField field = reader.getField(i);
                System.out.println(String.format("%s , %s , %s , %s" ,
                        field.getName() , field.getType() , field.getLength() , field.getDecimalCount()));
            }
            System.out.println("===数据===");
            int recordCount = reader.getRecordCount();
            for (int i = 0; i < recordCount; i++) {
                Object[] values = reader.nextRecord();
                System.out.println(Arrays.toString(values));
            }
        }
        System.out.println(String.format("文件 %s 已读取" , dbfFile.getAbsolutePath()));
    }

}