ExcelReport源码解析
ExcelReport第二篇：ExcelReport源码解析
导航
下一篇：扩展元素格式化器
概述
针对上一篇随笔收到的反馈，在展开对ExcelReport源码解析之前，我认为把编写该组件时的想法分享给大家是有必要的。
编写该组件时，思考如下：
1）要实现样式、格式与数据的彻底分离。
为什么要将样式、格式与数据分离呢？恩，你不妨想一想在生成报表时，那些是变的而那些又是不变的。我的结论是：变的是数据。
有了这个想法，很自然的想到用模板去承载不变的部分（常量内容的样式、格式、数据及变量内容的样式、格式），在程序中控制变的部分（变量内容的数据）。
这里以上一篇中的例子标识：
变量内容已使用粉红色边框标出，其余为常量内容。好了，相信“内容的数据”大家都知道那个是那个的。下面截图，内容的样式和格式。
现在我们回到上篇中使用的模板，相信你应该知道它承载那些东西了。
啰嗦了这么多，总结一下样式、格式与数据分离的好处:它让我们编写程序时关注更少（只需关心“变量内容的数据”）。
2）关注“变量内容的数据”填充到模板的最小单元（我们把这些称之为元素格式化器），然后利用合成模式（Composite）搞定整个文档的数据填充。
为什么要抽象一个“元素格式化器”的概念呢？我们看数据源，我们有可能要将某个类型的数据填充到某个单元格、也可能将一个集合填充到多行、有可能将一张图片填充到某个位置、也有可能就将某个字符串合并到某个单元格的内容中......如此种种。那么它们有什么共同点呢？它们都是填充“变量内容的数据”到模板的。
3）外部调用,统一从一个处理入口处理。
源码解析
有了上面的背景，这张UML想必不难理解了。
当然，如果你还是觉得复杂， 没关系。我会先介绍一下这里面几个重点关系。
1）从Export类开始吧！
这是一个静态类，非常简单。只有两个静态方法：ExportToLocal()、ExportToWeb()分别将生成的文件导出到本地和Web。这多半是废话了，下面是重点：
这便引出了SheetFormatterContainer类，SheetFormatterContainer类是何许也？
- SheetFormatterContainer是一个存储“格式化一个Sheet用到的元素格式化器集合”的容器。
说到这，顺便说下：ElementFormatter类和SheetFormatterContext类。
- ElementFormatter：元素格式化器。
- SheetFormatterContext：Sheet格式化上下文。
回到Export：
public static byte[] ExportToBuffer(string templateFile, params SheetFormatterContainer[] containers)
{
var workbook = LoadTemplateWorkbook(templateFile);
foreach (var container in containers)
{
var sheet = workbook.GetSheet(container.SheetName);
var context = new SheetFormatterContext(sheet, container.Formatters);
context.Format();
}
return workbook.SaveToBuffer();
}
如上代码，在执行导出的过程中，将每一个SheetFormatterContainer对象转换成了SheetFormatterContext对象。然后SheetFormatterContext对象调用自身的Format()方法格式化Sheet。
public void Format()
{
if (null == Sheet || null == Formatters)
{
return;
}
foreach (var formatter in Formatters)
{
formatter.Format(this);
}
}
Formatters就是从SheetFormatterContainer传过来的“元素格式化器”集合。
抽象的“元素格式化器”：
至此，ExcelReport组件的核心部分已经介绍完成了,下面附上代码（如下代码仅供参考，了解ExcelReport组件最新动态，请到GitHub下载最新源码）。
2）附--（ExcelReport1.0源码）
SheetFormatterContainer.cs
/*
类：SheetFormatterContainer
描述：Sheet中元素的格式化器集合
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.Collections.Generic;
namespace ExcelReport
{
public class SheetFormatterContainer
{
#region 成员字段及属性
private string sheetName;
public string SheetName
{
get { return sheetName; }
}
private IEnumerable<ElementFormatter> formatters;
public IEnumerable<ElementFormatter> Formatters
{
get { return formatters; }
}
#endregion 成员字段及属性
#region 构造函数
public SheetFormatterContainer(string sheetName, IEnumerable<ElementFormatter> formatters)
{
this.sheetName = sheetName;
this.formatters = formatters;
}
#endregion 构造函数
}
}
SheetFormatterContext.cs
/*
类：SheetFormatterContext
描述：Sheet格式化的上下文
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.Collections.Generic;
using NPOI.SS.UserModel;
namespace ExcelReport
{
public class SheetFormatterContext
{
#region 成员字段及属性
private int _increaseRowsCount = 0;
public ISheet Sheet { get; set; }
public IEnumerable<ElementFormatter> Formatters { get; set; }
#endregion 成员字段及属性
#region 构造函数
public SheetFormatterContext()
{
}
public SheetFormatterContext(ISheet sheet, IEnumerable<ElementFormatter> formatters)
{
this.Sheet = sheet;
this.Formatters = formatters;
}
#endregion 构造函数
#region 获取指定行当前行标
/// <summary>
/// 获取指定行当前行标
/// </summary>
/// <param name="rowIndexInTemplate">指定行在模板中的行标</param>
/// <returns>当前行标</returns>
public int GetCurrentRowIndex(int rowIndexInTemplate)
{
return rowIndexInTemplate + _increaseRowsCount;
}
#endregion 获取指定行当前行标
#region 在指定行后插入一行（并将指定行作为模板复制样式）
/// <summary>
/// 在指定行后插入一行（并将指定行作为模板复制样式）
/// </summary>
/// <param name="templateRowIndex">模板行在模板中的行标</param>
public void InsertEmptyRow(int templateRowIndex)
{
var templateRow = Sheet.GetRow(GetCurrentRowIndex(templateRowIndex));
var insertRowIndex = GetCurrentRowIndex(templateRowIndex + 1);
if (insertRowIndex < Sheet.LastRowNum)
{
Sheet.ShiftRows(insertRowIndex, Sheet.LastRowNum, 1, true, false);
}
var newRow = Sheet.CreateRow(GetCurrentRowIndex(templateRowIndex + 1));
_increaseRowsCount++;
foreach (var cell in templateRow.Cells)
{
newRow.CreateCell(cell.ColumnIndex).CellStyle = cell.CellStyle;
}
}
#endregion 在指定行后插入一行（并将指定行作为模板复制样式）
#region 清除指定行单元格内容
/// <summary>
/// 清除指定行单元格内容
/// </summary>
/// <param name="rowIndex">指定行在模板中的行标</param>
public void ClearRowContent(int rowIndex)
{
var row = Sheet.GetRow(GetCurrentRowIndex(rowIndex));
foreach (var cell in row.Cells)
{
cell.SetCellValue(string.Empty);
}
}
#endregion 清除指定行单元格内容
#region 删除指定行
/// <summary>
/// 删除指定行
/// </summary>
/// <param name="rowIndex">指定行在模板中的行标</param>
public void RemoveRow(int rowIndex)
{
var row = Sheet.GetRow(GetCurrentRowIndex(rowIndex));
Sheet.RemoveRow(row);
}
#endregion 删除指定行
#region 格式化Sheet
/// <summary>
/// 格式化Sheet
/// </summary>
public void Format()
{
if (null == Sheet || null == Formatters)
{
return;
}
foreach (var formatter in Formatters)
{
formatter.Format(this);
}
}
#endregion 格式化Sheet
}
}
ElementFormatter.cs
/*
类：ElementFormatter
描述：（元素）格式化器（抽象）
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System;
using NPOI.SS.UserModel;
namespace ExcelReport
{
public abstract class ElementFormatter
{
#region 设置单元格值
protected virtual void SetCellValue(ICell cell, object value)
{
if (null == cell)
{
return;
}
if (null == value)
{
cell.SetCellValue(string.Empty);
}
else
{
var valueTypeCode = Type.GetTypeCode(value.GetType());
switch (valueTypeCode)
{
case TypeCode.String: //字符串类型
cell.SetCellValue(Convert.ToString(value));
break;
case TypeCode.DateTime: //日期类型
cell.SetCellValue(Convert.ToDateTime(value));
break;
case TypeCode.Boolean: //布尔型
cell.SetCellValue(Convert.ToBoolean(value));
break;
case TypeCode.Int16: //整型
case TypeCode.Int32:
case TypeCode.Int64:
case TypeCode.Byte:
case TypeCode.Single: //浮点型
case TypeCode.Double:
case TypeCode.UInt16: //无符号整型
case TypeCode.UInt32:
case TypeCode.UInt64:
cell.SetCellValue(Convert.ToDouble(value));
break;
default:
cell.SetCellValue(string.Empty);
break;
}
}
}
#endregion 设置单元格值
#region 格式化操作
public abstract void Format(SheetFormatterContext context);
#endregion 格式化操作
}
}
CellFormatter.cs
/*
类：CellFormatter
描述：单元格（元素）格式化器
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.Drawing;
namespace ExcelReport
{
public class CellFormatter : ElementFormatter
{
#region 成员字段及属性
private Point _cellPoint;
private object _value;
#endregion 成员字段及属性
#region 构造函数
public CellFormatter(Point cellPoint, object value)
{
_cellPoint = cellPoint;
_value = value;
}
public CellFormatter(int rowIndex, int columnIndex, object value)
{
_cellPoint = new Point(rowIndex, columnIndex);
_value = value;
}
#endregion 构造函数
#region 格式化操作
public override void Format(SheetFormatterContext context)
{
var rowIndex = context.GetCurrentRowIndex(_cellPoint.X);
var row = context.Sheet.GetRow(rowIndex);
if (null == row)
{
row = context.Sheet.CreateRow(rowIndex);
}
var cell = row.GetCell(_cellPoint.Y);
if (null == cell)
{
cell = row.CreateCell(_cellPoint.Y);
}
SetCellValue(cell, _value);
}
#endregion 格式化操作
}
}
TableFormatter.cs
/*
类：TableFormatter
描述：表格（元素）格式化器
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System;
using System.Collections.Generic;
namespace ExcelReport
{
public class TableFormatter<TSource> : ElementFormatter
{
#region 成员字段
private int _templateRowIndex;
private IEnumerable<TSource> _dataSource;
private List<TableColumnInfo<TSource>> _columnInfoList;
#endregion 成员字段
#region 构造函数
public TableFormatter(int templateRowIndex, IEnumerable<TSource> dataSource, params TableColumnInfo<TSource>[] columnInfos)
{
_templateRowIndex = templateRowIndex;
_dataSource = dataSource;
_columnInfoList = new List<TableColumnInfo<TSource>>();
if (null != columnInfos && columnInfos.Length > 0)
{
_columnInfoList.AddRange(columnInfos);
}
}
#endregion 构造函数
#region 格式化操作
public override void Format(SheetFormatterContext context)
{
context.ClearRowContent(_templateRowIndex); //清除模板行单元格内容
if (null == _columnInfoList || _columnInfoList.Count <= 0 || null == _dataSource)
{
return;
}
foreach (TSource rowSource in _dataSource)
{
var row = context.Sheet.GetRow(context.GetCurrentRowIndex(_templateRowIndex));
foreach (TableColumnInfo<TSource> colInfo in _columnInfoList)
{
var cell = row.GetCell(colInfo.ColumnIndex);
SetCellValue(cell, colInfo.DgSetValue(rowSource));
}
context.InsertEmptyRow(_templateRowIndex); //追加空行
}
context.RemoveRow(_templateRowIndex); //删除空行
}
#endregion 格式化操作
#region 添加列信息
public void AddColumnInfo(TableColumnInfo<TSource> columnInfo)
{
_columnInfoList.Add(columnInfo);
}
public void AddColumnInfo(int columnIndex, Func<TSource, object> dgSetValue)
{
_columnInfoList.Add(new TableColumnInfo<TSource>(columnIndex, dgSetValue));
}
#endregion 添加列信息
}
}
ExportHelper.cs
/*
类：ExportHelper
描述：导出助手类
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.IO;
using NPOI.SS.UserModel;
namespace ExcelReport
{
internal static class ExportHelper
{
#region 加载模板,获取IWorkbook对象
private static IWorkbook LoadTemplateWorkbook(string templateFile)
{
using (var fileStream = new FileStream(templateFile, FileMode.Open, FileAccess.Read)) //读入excel模板
{
return WorkbookFactory.Create(fileStream);
}
}
#endregion 加载模板,获取IWorkbook对象
#region 将IWorkBook对象转换成二进制文件流
private static byte[] SaveToBuffer(this IWorkbook workbook)
{
using (var ms = new MemoryStream())
{
workbook.Write(ms);
ms.Flush();
ms.Position = 0;
return ms.GetBuffer();
}
}
#endregion 将IWorkBook对象转换成二进制文件流
#region 导出格式化处理后的文件到二进制文件流
public static byte[] ExportToBuffer(string templateFile, params SheetFormatterContainer[] containers)
{
var workbook = LoadTemplateWorkbook(templateFile);
foreach (var container in containers)
{
var sheet = workbook.GetSheet(container.SheetName);
var context = new SheetFormatterContext(sheet, container.Formatters);
context.Format();
}
return workbook.SaveToBuffer();
}
#endregion 导出格式化处理后的文件到二进制文件流
}
}
Export.cs
/*
类：Export
描述：导出
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System;
using System.IO;
using System.Web;
namespace ExcelReport
{
public static class Export
{
#region 导出到本地
public static void ExportToLocal(string templateFile, string targetFile, params SheetFormatterContainer[] containers)
{
#region 参数验证
if (string.IsNullOrWhiteSpace(templateFile))
{
throw new ArgumentNullException("templateFile");
}
if (string.IsNullOrWhiteSpace(targetFile))
{
throw new ArgumentNullException("targetFile");
}
if (!File.Exists(templateFile))
{
throw new FileNotFoundException(templateFile + " 文件不存在!");
}
#endregion 参数验证
using (FileStream fs = File.OpenWrite(targetFile))
{
var buffer = ExportHelper.ExportToBuffer(templateFile, containers);
fs.Write(buffer, 0, buffer.Length);
fs.Flush();
}
}
#endregion 导出到本地
#region 导出到Web
public static void ExportToWeb(string templateFile, string targetFile, params SheetFormatterContainer[] containers)
{
#region 参数验证
if (string.IsNullOrWhiteSpace(templateFile))
{
throw new ArgumentNullException("templateFile");
}
if (string.IsNullOrWhiteSpace(targetFile))
{
throw new ArgumentNullException("targetFile");
}
if (!File.Exists(templateFile))
{
throw new FileNotFoundException(templateFile + " 文件不存在!");
}
#endregion 参数验证
HttpContext.Current.Response.ContentType = "application/vnd.ms-excel";
HttpContext.Current.Response.AppendHeader("Content-Disposition", "attachment;filename=" + HttpUtility.UrlEncode(targetFile, System.Text.Encoding.UTF8));
HttpContext.Current.Response.BinaryWrite(ExportHelper.ExportToBuffer(templateFile, containers));
HttpContext.Current.Response.End();
}
#endregion 导出到Web
}
}
Parameter.cs
/*
类：Parameter
描述：参数信息
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.Drawing;
namespace ExcelReport
{
public class Parameter
{
public Parameter()
{
}
public Parameter(string sheetName, string parameterName, Point cellPoint)
{
this.SheetName = sheetName;
this.ParameterName = parameterName;
this.CellPoint = cellPoint;
}
public string SheetName { set; get; }
public string ParameterName { set; get; }
public Point CellPoint { set; get; }
}
}
ParameterCollection.cs
/*
类：ParameterCollection
描述：模板中参数信息的集合
编 码 人：韩兆新 日期：2015年01月17日
修改记录：
*/
using System.Collections.Generic;
using System.Drawing;
using System.IO;
using System.Xml.Serialization;
namespace ExcelReport
{
public class ParameterCollection
{
protected List<Parameter> parameterList = new List<Parameter>();
public Point this[string sheetName, string parameterName]
{
get
{
foreach (Parameter parameter in parameterList)
{
if (parameter.SheetName.Equals(sheetName) && parameter.ParameterName.Equals(parameterName))
{
return parameter.CellPoint;
}
}
return new Point();
}
set
{
bool isExist = false;
foreach (Parameter parameter in parameterList)
{
if (parameter.SheetName.Equals(sheetName) && parameter.ParameterName.Equals(parameterName))
{
isExist = true;
parameter.CellPoint = value;
}
}
if (!isExist)
{
parameterList.Add(new Parameter(sheetName, parameterName, value));
}
}
}
public void Load(string xmlPath)
{
string fileName = xmlPath;
if (File.Exists(fileName))
{
XmlSerializer xmlSerializer = new XmlSerializer(parameterList.GetType());
using (Stream reader = new FileStream(fileName, FileMode.Open, FileAccess.Read))
{
parameterList = xmlSerializer.Deserialize(reader) as List<Parameter>;
}
}
else
{
parameterList = new List<Parameter>();
}
}
public void Save(string xmlPath)
{
string fileName = xmlPath;
FileInfo fileInfo = new FileInfo(fileName);
DirectoryInfo directoryInfo = fileInfo.Directory;
if (!directoryInfo.Exists)
{
directoryInfo.Create();
}
XmlSerializer xmlSerializer = new XmlSerializer(parameterList.GetType());
using (Stream writer = new FileStream(fileName, FileMode.Create, FileAccess.Write))
{
xmlSerializer.Serialize(writer, parameterList);
}
}
}
}
源码下载：
ExcelReport源码解析的更多相关文章
- ExcelReport第二篇：ExcelReport源码解析
导航 目 录:基于NPOI的报表引擎——ExcelReport 上一篇:使用ExcelReport导出Excel 下一篇:扩展元素格式化器 概述 针对上一篇随笔收到的反馈,在展开对ExcelRep ...
- 【原】Android热更新开源项目Tinker源码解析系列之三：so热更新
本系列将从以下三个方面对Tinker进行源码解析: Android热更新开源项目Tinker源码解析系列之一:Dex热更新 Android热更新开源项目Tinker源码解析系列之二:资源文件热更新 A ...
- 【原】Android热更新开源项目Tinker源码解析系列之一：Dex热更新
[原]Android热更新开源项目Tinker源码解析系列之一:Dex热更新 Tinker是微信的第一个开源项目,主要用于安卓应用bug的热修复和功能的迭代. Tinker github地址:http ...
- 【原】Android热更新开源项目Tinker源码解析系列之二:资源文件热更新
上一篇文章介绍了Dex文件的热更新流程,本文将会分析Tinker中对资源文件的热更新流程. 同Dex,资源文件的热更新同样包括三个部分:资源补丁生成,资源补丁合成及资源补丁加载. 本系列将从以下三个方 ...
- 多线程爬坑之路-Thread和Runable源码解析之基本方法的运用实例
前面的文章:多线程爬坑之路-学习多线程需要来了解哪些东西?(concurrent并发包的数据结构和线程池,Locks锁,Atomic原子类) 多线程爬坑之路-Thread和Runable源码解析 前面 ...
- jQuery2.x源码解析(缓存篇)
jQuery2.x源码解析(构建篇) jQuery2.x源码解析(设计篇) jQuery2.x源码解析(回调篇) jQuery2.x源码解析(缓存篇) 缓存是jQuery中的又一核心设计,jQuery ...
- Spring IoC源码解析——Bean的创建和初始化
Spring介绍 Spring(http://spring.io/)是一个轻量级的Java 开发框架,同时也是轻量级的IoC和AOP的容器框架,主要是针对JavaBean的生命周期进行管理的轻量级容器 ...
- jQuery2.x源码解析(构建篇)
jQuery2.x源码解析(构建篇) jQuery2.x源码解析(设计篇) jQuery2.x源码解析(回调篇) jQuery2.x源码解析(缓存篇) 笔者阅读了园友艾伦 Aaron的系列博客< ...
- jQuery2.x源码解析(设计篇)
jQuery2.x源码解析(构建篇) jQuery2.x源码解析(设计篇) jQuery2.x源码解析(回调篇) jQuery2.x源码解析(缓存篇) 这一篇笔者主要以设计的角度探索jQuery的源代 ...
随机推荐
- Unity3d 导入图像尺寸失真解决方案
导入到unity3d内的图像被默认长宽变换为满足2^n关系. 例如以下图,我有张图片名称为984plus598表示我尺寸为984*598.拷贝到unity3d中后的大小为1024*512 方法一: 在 ...
- Groovy与Java集成常见的坑(转)
groovy特性 Groovy是一门基于JVM的动态语言,同时也是一门面向对象的语言,语法上和Java非常相似.它结合了Python.Ruby和Smalltalk的许多强大的特性,Groovy 代码能 ...
- Docker简明教程（转）
Docker自从诞生以来就一直备受追捧,学习Docker是一件很炫酷.很有意思的事情.我希望通过这篇文章能够让大家快速地入门Docker,并有一些学习成果来激发自己的学习兴趣.我也只是一个在Docke ...
- Android发展Singleton模式
这是什么Singleton模式?它是Java23之间的一种模式,在Android发展也有着广泛的应用,例Calander类别,当对象是由未创建 new Calander而是Calander.getIn ...
- Play Framework + ReactiveMongo
Play Framework + ReactiveMongo Play!是一个full-stack(全栈的)Java/Scala Web应用框架,包括一个简单的无状态MVC模型,具有Hibernate ...
- WebHooks
WebHooks ASP.NET 5 Beta 7 版本 在 VS2015 发布的同时,微软也发布了 ASP.NET 5 的路线图(详见ASP.NET 5 Schedule and Roadmap ...
- document.all使用
document.all 一个. document.all它是在页面中的所有元素的集合.例如: document.all(0)一个元素 二. document.all能够推断浏览器是否是IE ...
- Oracle实践--PL/SQL表分区的基础
PL/SQL基础入门之表分区 PL/SQL:过程语言(Procedure Language)和结构化语言(Structured Query Language)结合而成的编程语言.是对SQL的扩展.支 ...
- （大数据工程师学习路径）第四步 SQL基础课程----select详解
准备 在正式开始本内容之前,需要先从github下载相关代码,搭建好一个名为mysql_shiyan的数据库(有三张表:department,employee,project),并向其中插入数据. 具 ...
- Centos7系统配置上的变化（一）
原文 Centos7系统配置上的变化(一) 安装后,一开始有点儿无力吐槽的感觉,变化这么大? 一.Runlevel 首先一条,原来一直用的CentOS-6.5-x86_64-minimal.iso光盘 ...