一、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);
wrs.addCell(number);
//添加时间单元格
DateTime dt = new DateTime(0,4,new Date());
wrs.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的示例．
