Jxl简析

文章来自网络

 

（一）API

最近，完成了一个网上报表系统，刚巧用到了一个JAVA操作excel表格的API．闲来无事，就将其大概的总结了一下．现阶段JAVA操作Excel的JAR主要有apache 的POI及jxl.因为现在的eclipse操作excel用的插件为jxl，所以在项目中就使用了jxl．想想两者都差不了太多．此简单系列为两个部分，一是API系列，另一部分则是应用系列．

一、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	静态字体内部类

 

最后，关于Jxl.format包．此包主要是一些与具体样式有关的接口和枚举．不进行具体描述．

 

（二）应用

       在进行实践前,我们需要对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();

<span l