通用Excel导入工具V1.0使用说明

简介:

通用Excel导入工具V1.0 

使用说明

    有时候我们的数据存放在Excel中(特别是对于用户来说更喜欢使用Excel收集一些常用数据),而系统又需要这些数据来处理其他业务,那么此时我们就 需要将这些数据导入到数据库中。但是鉴于Excel的样式多种多样,因此每次导入时都必须书写很多重复的代码。很明显对于一个软件开发者做这些重复劳动是 一件很无趣的事情。那么怎样来寻找一种通用的方法呢?今天我们就看一下如何解决这个问题。 

   总体设计思路 

    设 计通用Excel的目的就是为了避免重复工作,也就是说不必因为Excel的样式、数据等变化而重新从零做起、重复劳动。因此我们就必须抽取一个通用的东 西出来,使用时只需要关注相关的业务而不必过度关注相关excel操作和存储。再简单一点就是封装共同点,暴漏个性点。考虑到这种情况,我们可以使用配置 文件的方式来解决这个问题。在配置文件中我们配置Excle要导入的表、字段等信息,在进行导入时再依据配置文件将数据导入到数据库中。这样一来,在需要 进行Excel导入时只需要为某个或多个excel配置一个xml文件,然后调用相关的类就可以完成整个excel导入工作了。 

    补充说明:通用的局限性 

    在 这里说明一下,虽然我们设计的是一个通用的Excel导入程序,但是这里的"通用"只是相对来说的,并不是考虑了所有Excel的情况,因为Excel的 设计情况十分的复杂多样,要将所有的情况都考虑进去是一个漫长的过程。程序目前暂时不考虑包含统计行的情况(可以包含合并行、代码表字段等)。

    配置文件设计 

    考 虑使用xml配置的方式来设计通用Excel导入,如何设计好xml就成了设计的重点。对于单表导入(一个Excel主要导入到一个数据库表中,不排除牵 扯其他代码表的情况)我们的配置文件无论以数据库为基础设计(主要依据数据库表结构)还是以Excel(主要依据Excel格式设计)为基础设计都可以, 但如果是多表导入(也就是一个Excel可以导入到几张表中的情况)考虑其复杂性还是以数据库为基础更为合适。基于此种考虑,我们整个配置设计会以数据库 表结构为基础来设计。最终的配置文件设计样例如下:  

<?xml version="1.0"?>  <Config EndTag="RowBlank" HeaderIndex="1" DataIndex="2" WorkSheetCount="0">        <Table Name="" DeleteRepeat="true" ExcludedColumns="" >                <Column IsPrimaryKey="" ColumnName="" HeaderText="" Required="true" DataType="number" DataLength="100" DefaultValue="" Comment="">                    <CodeTalbe Name="" PrimaryKey=""  ReferenceColumn="" Condition=""/>          </Column>            </Table>  </Config>

 

Config节点

    Config节点位于最外层,代表整个配置。其属性EndTag(数据读取的结束标志,例如"RowBlank"代表空行结束,在读取Excel时遇到某行没有任何数据的情况则视为结束;也可以为某个列地址(如C),在导入时到了此列为空就会结束导入操作);

    HeaderIndex代表excel表头对应的行值,相当于标题行(默认从1开始)。

    DataIndex表示数据行起始行索引(从2开始)。

    WorkSheetCount表示对于整个Excel文件,如果其包含多个工作表,则会根据所设的值处理前几个工作表,属性值为0,则会处理所有工作表,默认为0。 

Table节点

    Table节点位于Config节点内,对应数据库中的表,可以有多个;

    Name属性对应要导入的表名称;

    DeleteRepeat属性表示是否删除重复行(如果为true则会根据主键先删除重复行再执行插入操作);

    ExcludedColumns表示排除列,多个列名使用","分割(这些字段不会导入)。 

Column节点

    Column节点位于Table节点内,对列的相应配置,通常有多个(注意对于excel中没有的列,而数据库表需要导入的,也需要配置Column节点,此时HeaderText为空或不配置HeaderText属性);

    IsPrimarykey属性表示是否为主键(当Table节点配置DeleteRepeat为ture时必须至少指定一个Column节点的    IsPrimaryKey为true,此属性是为delete条件做准备的[有可能它不是真正的主键]);

    ColumnName表示对应的列名;

    HeaderText表示对应的Excel列头(在依据Excel别名导入时根据此值确定导入的列);

    Required指定此列是否为必须导入的列(如果配置为true,excel中此列为空并且没有配置默认值则会抛出异常);

    DataType为数据类型(例如string、number、datetime用于数据校验);

    DefaultValue 为默认值(注意其值不一定是指定的字符值,可以是"Max"、"NewID"、如果指定为“WORKSHEETNAME”则取当前工作薄的名称做为其值, 如果为Max,那么此列必须为数值类型,此时在导入的时候如果需要使用默认值,就会在原来数据库表中此列最大值的基础上加上1导入到数据库中,如果为 NewID在导入的时候需要使用默认值系统就会自动生成Guid值);

    Comment是此列的说明。 

CodeTable节点

    在Column节点中还可以配置CodeTable节点,表示代码表。

    Name属性值表示引用表的表名称;

    PrimaryKey指待引用主表的主键,也就是子表的外键,Column配置节点的ColumnName属性值应该与CodeTable节点的PrimaryKey属性值设置一至,如以下配置:

<Column ColumnName="CategoryID" HeaderText="商品种类" DefaultValue="">

   <CodeTalbe Name="Categories" PrimaryKey="CategoryID"  ReferenceColumn="CategoryName"/>

</Column>

    ReferenceColumn 表示对应代码字段关联名称列,就是我们导入时所依据的excel对应值(例如CategoryID对应CategoryName,那么 ReferenceColumn就是CategoryName,往往Excel中可能存放的是类似于CategoryName的东西而不是 CategoryID,而导入操作时需要CategoryID)。 

导入实例说明:

图一 待导入Excel文件,可同时导入多个工作薄(WorkSheet)

 

图二 设置导入规则

图三 使用开发的导入工具进行导入

图四 导入完成后入库的数据


本文转自yonghu86 51CTO博客,原文链接:http://blog.51cto.com/yonghu/1321313,如需转载请自行联系原作者

相关文章
|
1月前
|
easyexcel Java 测试技术
读取Excel还用POI?试试这款开源工具EasyExcel
读取Excel还用POI?试试这款开源工具EasyExcel
55 0
|
XML SQL JavaScript
SpringBoot+vue实现导入导出excel,使用hutool工具
在实际应用场景中,我们常常需要迁移应用到另一个环境中。「应用的导入导出」功能可以便捷实现应用的迁移与重塑,甚至可以选择不同菜单,数据模型,与审批流程,业务事件,选择性导入,更高效便捷完成应用的迁移。其次,在导入的应用中,选择所需导入的部分,可以全选,也可以选择部分导入。「部分导入」实现了模块迁移的效果,对于企业级应用迁移来说,不仅利用率高,适用性也极为普遍。有了「应用导入导出」功能,就可以轻松迁移各类应用。同时,在使用应用市场中的应用,与更新应用方面,都非常灵活易用。 下面来介绍,这个功能性是如何实现的。
1225 0
SpringBoot+vue实现导入导出excel,使用hutool工具
|
3月前
|
数据挖掘 数据安全/隐私保护 Python
【Python数据分析】<数据分析工具>基于Excel的数据分析
【1月更文挑战第22天】【Python数据分析】<数据分析工具>基于Excel的数据分析
|
2月前
|
自然语言处理 安全 Unix
一键式Excel分词统计工具:如何轻松打包Python脚本为EXE
一键式Excel分词统计工具:如何轻松打包Python脚本为EXE
44 0
|
3月前
|
JSON 数据格式
将json格式的数据快速转换为excel,使用在线工具轻松搞定
将json格式的数据快速转换为excel,使用在线工具轻松搞定
125 0
Excel工具-HUTOOL-读取Excel
Excel工具-HUTOOL-读取Excel
|
8月前
|
存储 Java BI
探索Apache POI库:强大的Excel和Word文档处理工具
在企业应用和数据处理中,Excel和Word文档是常见的数据交换和存储格式。然而,处理和操作这些文档可能是一项繁琐的任务。Apache POI库作为一款强大的文档处理工具,可以帮助我们更轻松地进行Excel和Word文档的读写、编辑和生成。本文将深入探讨Apache POI库的基本概念、特点,以及如何在实际应用中使用它进行文档处理。
404 0
|
3月前
|
数据可视化 数据挖掘 Python
基于Python开发的Excel数据分析系统(源码+可执行程序+程序配置说明书+程序使用说明书)
基于Python开发的Excel数据分析系统(源码+可执行程序+程序配置说明书+程序使用说明书)
|
4月前
|
小程序 索引 Python
Python自动化办公之Excel对比工具
Python自动化办公之Excel对比工具
|
6月前
|
XML 数据格式
关于 SAP UI5 控件内容的 Excel 导出功能,如何加载所需的导出工具库
关于 SAP UI5 控件内容的 Excel 导出功能,如何加载所需的导出工具库
36 0