精通JBuilder：维护JBuilder类库
可以通过Tools->Configrue->Libraries在弹出的Configure Libraries对话框左窗格列表中列出的已有的JBuilder类库，选中一个类库，右窗格中Class标签页中将列出这个类库对应的类库包，如图3-26所示。www.ad119.cn/bbs/attachments/basic/20090317/20093178133915677801.jpg
图3-26JBuilder类库
右窗格中的标签页说明如下。
—Class：class文件的JAR档案文件。
—Source：类库对应的Java源代码档案文件，JBuilder在编辑器中可以通过Ctrl Enter查看类的源文件。
—Documentation：类库对象的Javadoc帮助文档档案文件，在按F1键时，JBuilder用Help Viewer加载类库的对应帮助文件。
—Framework：JSP标签库档案文件。
—Required Libraries：该类库需要JBuilder中其他相关的类库。
其中Source和Documentation是可有可无的，只不过如果具备的话JBuilder在开发过程中将提供更详细的支持。
JBuilder中的每个类库都对应一个.library的配置文件，配置文件描述了类库类文件、源文件、Javadoc文件所在的路径。如图3-26中选择的类库Axis的配置文件Axis.library内容如代码清单3-1所示。
代码清单3-1JBuilder类库的配置文件
1．<?xml version="1.0" encoding="UTF-8"?>
2．
3．<library>
4． <!--JBuilder Library Definition File-->
5． <fullname>Axis</fullname>
6． <class>
7． <path></path>
8． <path></path>
9． <path></path>
10． <path></path>
11． <path></path>
12． <path></path>
13． <path></path>
14． </class>
15． <source>
16． <path>[../extras/ws-axis.zip]ws-axis/java/src/</path>
17． </source>
18． <documentation>
19． </documentation>
20．</library>
第5行的内容为类库的名字，第6"14行是类库对应的类包档案文件所在的路径，这些路径将在编译和运行时附在javac/java的-classpath参数后，第15"17行为类库的源程序档案文件，第18"19行类库的Javadoc帮助档案文件，由于Axis类库的Javadoc帮助文件和类文件一起被打包中JAR的文件中，所以这里是空的，如果类文件和Javadoc文件单独打包成不同的JAR文件，则Javadoc文件需要在<document ation></document ation>中指定。
图3-26左窗格中包含4个文件夹，即Project、D: /test、User Home及JBuilder，其中D: /test是自定义的文件夹，其他3个文件夹为JBuilder默认的文件夹。在不同的文件夹下配置类库，JBuilder将把类库配置文件放在不同的目录下面。
—Project：在Project文件夹下配置类库，.library类库配置文件将放置在当前工程的根目录下，这样其他的工程将看不到这个类库。
—User Home：.library类库配置文件放置在C:/Documents and Settings/<操作系统用户名>/.jbuilder2005目录下，这样用其他账号登录机器的用户将看不到这些类库。对于多人共用的机器，这个设置有用。
—JBuilder：.library类库配置文件放置在<JBuilder2005根目录>/lib目录下，所有的用户及工程都可以看到并引用这些类库。
此外，你还可以通过图3-26中左窗格下方的Add Folder...按钮创建一个新的文件夹来放置这些类库的配置文件，如一台机器共有3个人使用，你可以创建一个不可见文件夹，将类库配置文件放置在这个文件夹下，这样另外一个人打开JBuilder时就看不到这个类库了。
不过以笔者认为直接将类库配置在JBuilder文件夹下就可以了，不必做过多的复杂设置。
下面通过一个实际的例子演示添加一个JBuilder类库的过程。请从本书的配置光盘中拷贝chapter3到D:\JTJB2005，在chapter3\extralib下有一个hibernate的目录，这个目录中有两个子目录：lib子目录中包含hibernate2.jar及其他众多类库JAR文件，而doc子目录有hibernate2.jar档案文件，它对应Hibernate的Javadoc帮助文档（Hibernate是一个著名的开源项目，用于Java对象到数据库的映射，已经在全球Java程序员中造成风靡效应）。下面通过具体的步骤将Hibernate类包及其Javadoc帮助档案文件加入到JBuilder类库中，以便在程序中调用Hibernate程序包的功能。
1．为新增类库取名并指定其配置文件放置的位置
通过Tools->Configure->Libraries...调出Configure Libraries对话框，如图3-26所示。单击对话框左窗格下的New...按钮，弹出New Library Wizard对话框，如图3-27所示。
www.ad119.cn/bbs/attachments/basic/20090317/20093178133921877802.jpg
图3-27指定类库名字及配置文件的位置
在Name中为类库取一个名字，名字以明了达意为宜。在Location下拉框中选择该类库配置文件所存放的位置，我们选择JBuilder。然后单击Add...按钮到第2步。
2．选择类库档案文件所在的位置
在Select One More Directories对话框中，定位到D:\JTJB2005\chapter3\extraLib \hibernate\lib目录，按住Shift或Ctrl键将目录下所有的JAR文件都选中，如图3-28所示（当进行多文件选择后，Directory下拉框中的值会变成<Multiple selectings>，此时你可以定位到其他目录按住Ctrl键选择不同目录下的JAR文件）。
单击OK按钮后回到New Library Wizard对话框中，此时Library paths列表中列出所有已经添加的类库包，如图3-29所示。
www.ad119.cn/bbs/attachments/basic/20090317/20093178133926577803.jpg
图3-28选择类库档案文件所在位置
www.ad119.cn/bbs/attachments/basic/20090317/20093178133931277804.jpg
图3-29添加了类库包后的类库列表
上一页
单击OK按钮后到下一步。
3．添加类库的Javadoc帮助文档
在Configure Libraries对话框的右边页面中切换到Documentation标签页中，如图3-30所示。
www.ad119.cn/bbs/attachments/basic/20090317/20093178133935977805.jpg
图3-30类库Javadoc帮助文档设置
单击Add...按钮弹出Select One or More Directories对话框，定位到D:/JTJB2005/ chapter3/extraLib/hibernate/doc/api目录，这个目录即Javadoc帮助文档所在的根目录，其下的目录结构和类包的目录结构是一致的，如图3-31所示。
如果这个目录指定不正确，将无法在JBuilder中获取类库的在线帮助，直接的表现是在类名上按F1键时，弹出的Help Viewer不能调出对应类的Javadoc帮助文档。如果Javadoc帮助文档和class类文件一起打包成JAR包，则无须进行这一步的设置。
单击OK按钮返回Configure Libraries对话框，再单击该对话框的OK按钮完成hibernate JBuilder类库的创建。此时在<JBuilder 2005>\lib目录下多了一个hibernate. library类库配置文件。对于高级用户，也可以直接更改这个文件的配置信息维护JBuilder类库，但为了安全起见，不推荐这种做法。
www.ad119.cn/bbs/attachments/basic/20090317/20093178133940677806.gif
图3-31指定类库的Javadoc帮助文档目录 上一页
页:
[1]