Jxl简析

       现阶段 JAVA 操作 Excel 的 JAR 主要有 apache 的 POI 及 jxl.

一、 API 系列

       Jxl 的 API 主要有三个包， jxl,jxl.format,jxl.write ．如果单独的分析 API ，可能对于更明确的了解此 API 没有太多的帮助，我们还是从 Excel 文件的层次来剥离此 API 吧．

一个 excel 文件由一个工作簿组成，一个工作簿又由 n 个工作表组成．每个工作表又由多个单元格组成．对应于 Jxl 中的结构为

读文件（包 jxl ）	写文件 ( 包 jxl.write)	说明
Workbook	WritableWorkbook	工作簿
Sheet	WritableSheet	工作表
Cell/Image/Hyperlink	WritableCell/WritableImage//WritableHyperlink	单元格 / 图像 / 超链接

         单元格（此处指文本单元格，图像及链接和单元格做为一个层次）分为好多种，所以在 API 的设计中将 Cell 作为一个接口而存在．

       对应的 jxl 中的结构为：

读文件（包 jxl ）	写文件 ( 包 jxl.write)	说明
Cell	WritableCell	单元格
BooleanCell	Boolean	布尔值单元格
DateCell	DateTime	时间单元格
ErrorCell		形式错误的单元格
LabelCell	Label	文本单元格
NumberCell	Number	数字单元格
FormualCedll	Formual	公式单元格
	Blank	空格单元格
BooleanFormualCell		布尔公式单元格
DateFormualCell		时间公式单元格
ErrorFormualCell		错误公式单元格
StringFormualCell		文本公式单元格
NumberFormualCell		数字公式单元格

 

而有的时候，我们可能将几个单元格作为一个整体来处理，在 API 中对应的则是：

    jxl.Range  

    虽然数据是电子表格的核心，但是同时其也需要一些辅助类　比如文件格式设置，工作表设置与显示效果．单元格设置与显示效果等．按照其层次，则依次有以下接口或类．

 

读文件（包 jxl ）	写文件 ( 包 jxl.write)	说明
WorkbookSettings	WorkbookSettings （包 jxl ）	设置 workbook 属性的 bean
SheetSettings	SheetSettings （包 jxl ）	设置具体 sheet 的属性的 bean （比如表头表底等）
HeaderFooter	HeaderFooter （包 jxl ）	表示表头表底类
HeaderFooter.Contents	HeaderFooter.Contents （包 jxl ）	具体表头表底设置
CellFeatures	WritableCellFeautres	表格内容相关设置（验证）
CellReferenceHelper		得到引用单元格相关属性
CellType		表格相关类型
CellView	CellView （包 jxl ）	表格视图相关设置
CellFormat	WritableCellFormat	表格显示样式设置
	BoldStyle	边框枚举
	DateFormat	时间格式
	DateFormats	时间格式枚举
	NumbreFormat	数据格式
	NumbreFormats	数字模式枚举
	WritableFont	字体设置
	WriteableFont.Fontname	静态字体内部类

（二）应用

       在进行实践前 , 我们需要对 excel 有一个大致的了解 ,excel 文件由一个工作簿 (Workbook) 组成 , 工作簿由工作表 (sheet) 组成 , 每个工作表又由很多单元格 (cell) 组成 . 工作簿有自己的特征 , 同样工作表 , 单元格也一样 . 从大局上了解了 excel 文件 , 对于我们更好的使用 jxl 是有一定的帮助的 . 具体请查看（一） API

  在 jxl 中其大概的层次是这样的  

名称	属性
Workbook	WorkbookSettings
Sheet	SheetSettings
Cell	CeLlFormat CellFeatures CellView CellType

Jxl 读 excel ：

得到工作簿的方法主要有四个 :

       getWorkbook(File file)

       getWorkbook(File file,WorkSettings ws)

       getWorkbook(InputStream is)

       getWorkbook(InputStream is,WorkSettings ws)

参数有两个 :

第一个参数是必须的 : 文件或输入流 ,

第二个参数 : 工作簿 ws 是作为读出来的 excel 的一些约定 , 如地区 , 编码等 .

如果文件错误或格式错误 , 将会抛出 BiffException 或 IOException.

  代码段 :  

Workbook wb=null;

try

{

wb = Workbook.getWorkbook(excelFile);

wb.close();

}

catch(BiffException ex){

       // 转换错误

}catch(IOException ex){

       //IO 错误

}

以上如果一切正常的话 , 将得到此 excel 文件的工作簿 . 接下来我们就可以通过此文件簿得到其他的东西了 . 以下是得到工作表有关的方法

  int getNumberOfSheets()// 工作表个数

Sheet getSheet(String  name);// 得到此对应名称的工作表

Sheet getSheet(int index);// 得到此序列号的工作表

Sheet[] getSheets();// 得到工作表数组

String[] getSheetNames();// 得到工作表名称数组

  示例代码如下：

Sheet sheet;

if(wb.getNumberOfSheets()>0)

{

       sheet = wb.getSheet(0);

}

以下的方法除非特别目的，否则用到的地方不多．

Range[] finaName(String name);// 得到此名称的表格区

Cell findCellByName(String name);// 得到此名称的 Cell

Cell getCell(String loc)

String[] getRangeNames();

与文件是否可写有关的

boolean isProected();

  得到了工作簿文件的某个工作表时．

对于工作表而言其主要的内容就是单元格了．

// 根据内容查看

Cell findCell(Pattern pattern,int firstCol,int firstRow,int lastCol,int lastRow,Boolean reverse)

Cell findCell(String content)

Cell findCell(String content,omt forstCol,int firstRow,int lastCol,int lastRow,Boolean reverse)

LabelCell findLabelCell(String contents)

  // 根据位置得到

Cell getCell(int col,int row)

Cell getCell(String loc)//loc 的格式为 A3/B1/C3 其相同于

getCell(CellReferenceHelper.getColumn(loc0,CellReferenceHelper.getRow(loc)), 所以相对而言其性能没有 Cell getCell(int col,int row) 快

  // 单元格数组

Cell[] getRows(int row)// 当前行单元格数组

Cell[] getCols(int col)// 当前列单元格数组

  // 特殊单元格数组

// 超链接表格

Hyperlink[] getHyperlinks();// 超链接数组

// 区域表格

Range[] getMergedCells();// 区域单元格数组

// 图像表格

Int getNumberOfImages()// 拥有图片数

Image getDrawing(int index)// 对应序号的图片

  // 工作表或多个表格一些自我属性

String getName()// 工作表名

int getRows()// 行数

int getCols()// 列数

SheetSettings getSettings()// 工作表设置

CellView getColumnView(int col)// 此列的表格视图

CellView getRowView(int row)// 此行的表格视图

  以下是与单元格有关的一些操作：

CellFeatures getCellFeatures()// 主要是与表格内容有关的一些性质如验证等

CellFormat getCellFormat()// 主要是表格外在表现格式有关的一些性质．

int getColumn()// 所在列

int getRow()// 所在行

String getContents();// 内容

boolean  isHidden();// 可见否

CellType getType();// 表格类型　如果不确定表格如果转换则可以使用此方法来确定表格类型．

  以下我们讲述如何写 excel 文件．

写文件分为两种情况　一种是新建一种则是更新．

新建 excel 文件

新建 excel 文件很简单：

// 文件

WritableWorkbook createWorkbook(File file) // 无形式的创建一个 excel 文件

WritableWorkbook createWorkbook(File file Workbook in)

// 以 in 一样的格式创建一个 excel 文件，其初始内容与 in 文件相同 ( 更新文件可以用到此方法 )

WriteableWorkbook createWorkbook(File file,WorkSetting ws)// 以 ws 的设定创建文件

WritableWorkbook createWorkbook(File file,Workbook in,WorkSetting ws)

// 以 ws 的设定创建一个与 in 文件相同的文件

  // 流

WritableWorkbook createWorkbook(OutputStream os)

WritableWorkbook createWorkbook(OutputStream os Workbook in)

WriteableWorkbook createWorkbook(OutputStream os,WorkSetting ws)

WritableWorkbook createWorkbook(OutputStream os,Workbook in,WorkSetting ws)

 

代码示例：

WritableWorkbook wrb;

WriteableWorkbook wrbin;

try

{

wrb =  Workbook.createWorkbook(targetfile);

wrbin = Workbook.createWorkbook(targetfile,wb);

}

catch (IOexception e)

{

//IO 错误

}

当创建好工作簿时，我们就需要新建工作表了

WritableSheet createSheet(String name,int index);

WritableSheet wrs  = wrb.createSheet(“demo”,0);

// 创建一个名为 demo 的工作表，其为工作簿的第一个工作表．

接下来我们就可以进行其他操作了

 

添加文本类单元格：

Label 　 label = new Label(0,0,””);

wrb.addCell (label);

// 添加数据单元格

Number number = new Number(0,3,1234);

wrb.addCell (number);

// 添加时间单元格

DateTime dt = new DateTime(0,4,new Date());

Wrb.addCell (dt);

// 添加公式单元格

Fornual formual = new Formual(0,11,”Sum(A1:A9)”);

wrb.addCell (formual);

 

添加超链接类单元格

WirtableHyperlink wrlink =

  new WritableHyperlink(0,1,0,1,new URL(“www.emlog.net/fei”),”emlog”);

wrb.addHyperlink (wrlink);

 

// 添加图像

WritableImage wrimage=new WritableImage(1,5,10,10,new File(imageFilepath));

wrb.addImage (wrimage);

// 注意， API 中注明只支持 png 文件，然而我用其他格式的图片，通过将其后缘改为 png 也能放到 excel 文件中．果然，在查看其具体源代码时，发现作者只是检测了文件的后缀名，如果不对　给出警告，并没有从图像文件的具体格式进行检测．

      当然，表格中的数据算是表格的核心部分，但是同时 API 也提供了大量的其他方法来丰富表格的显示．在此，大家具体在使用过程中进行运用就行．

// 最后，写完表格后，不要忘记进行写操作，也就是常说的保存

wrb.write()

wrb.close(); 保存完后关闭相应资源是一个合格的程序员应该做的．

 

接下来，我们就来讲述写文件的另一方面：更新文件．有时候，并不仅仅只是需要新写文件，可能需要对已有文件进行更新．这时候我们可以这么来实现．

Workbook wb= Workbook.getWorkbook(modifyFile);

WritableWorkbook wrb = Workbook.createWorkbook(modifyFile, wb);

  以上就实现了得到一个已存在的文件的可修改副本．

// 得到第一个工作表

WritableSheet wrs = wrb.getSheet(0);

// 得到 A0 单元格

Cell cell = Wrs.getCell(0,0);

// 对单元格格式进行判断

If (cell.getType()==CellType.LABEL){

       Label label=(Label) cell;

       label.setString(“u r modified.”);

}//modify end

  //save excel

wrb.write();

wb.close();

wrb.close();

　　　 以上就简单的完成了一次 excel 文件的修改．