jxl操作excel --API

jxl操作excel
一、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();

wb.close();

wrb.close();

以上就简单的完成了一次excel文件的修改．API中还提供了复制工作表，复制单元格等操作，大家可以通过查询API来了解其具体的用法．我们可以从作者提供的包中得到很多关于如何使用API的示例．