Jbuilder Practice ： “项目名.项目类型.local”的用法
在使用了Jbuilder一段时间后，很想写点什么来记住其中的一些实践技巧，免得辛苦了半天的劳动果实，因为忘记而付之东流。Jbuilder的使用技巧有很多，而我在这里列举的大多是一些不太引人注意，或很少被人提及的技巧，可以戏称为【边缘技巧】。
如果以后有时间，我会继续填充这一系列文章。
在第一篇中，我将介绍一下“项目名.项目类型.local”文件的一些用法。
标题：【JP1：“项目名.项目类型.local”的用法】
版本：7～9
JBuilder开发都以项目概念为中心，项目文件包含一个（属于这个项目的）文件列表以及项目属性，其中项目属性包括项目模板、缺省路径、类库和连接配置等，JBuilder使用这些信息加载、保存、编译和运行项目。使用Jbuilder开发环境添加、移除文件，或者设置、更改项目属性都会更改项目文件。可以在项目面板中看到项目文件作为主节点显示。
生成项目的便捷方式是使用项目模板工具，可用来设置项目名称、类型和模板，以及JDK、工作目录、备份路径和编译输出路径等。其中项目类型可选择.jpx或者.jpr【注1】，二者内容一样，区别是前者使用XML格式文件，因此适合于共享的项目。
当创建项目以后，都会生成“项目名.项目类型.local”文件。既然是.local，当然这个文件主要记载该项目在本地Jbuilder中的一些信息。下面是这个文件的内容：
build.menu.1[0]=com.borland.jbuilder.build.ProjectBuilder$ProjectBuildAction;make
build.menu.2[0]=com.borland.jbuilder.build.ProjectBuilder$ProjectBuildAction;rebuild
debug.NoTracingClasses.1[0]=23 com.borland.datastore.*1 1 -1
debug.NoTracingClasses.10[0]=7 javax.*1 1 -1
debug.NoTracingClasses.11[0]=5 sun.*1 1 -1
debug.NoTracingClasses.12[0]=23 com.borland.appclient.*1 1 -1
debug.NoTracingClasses.13[0]=21 com.borland.console.*1 1 -1
debug.NoTracingClasses.14[0]=17 com.borland.ejb.*1 1 -1
debug.NoTracingClasses.15[0]=24 com.borland.enterprise.*1 1 -1
debug.NoTracingClasses.16[0]=18 com.borland.jafa.*1 1 -1
debug.NoTracingClasses.17[0]=17 com.borland.jss.*1 1 -1
debug.NoTracingClasses.18[0]=24 com.borland.management.*1 1 -1
debug.NoTracingClasses.19[0]=23 com.borland.primetime.*1 1 -1
debug.NoTracingClasses.2[0]=21 com.borland.dbswing.*1 1 -1
debug.NoTracingClasses.20[0]=22 com.borland.security.*1 1 -1
debug.NoTracingClasses.21[0]=18 com.borland.util.*1 1 -1
debug.NoTracingClasses.22[0]=17 com.borland.xml.*1 1 -1
debug.NoTracingClasses.23[0]=13 com.inprise.*1 1 -1
debug.NoTracingClasses.24[0]=15 com.visigenic.*1 1 -1
debug.NoTracingClasses.25[0]=9 org.omg.*1 1 -1
debug.NoTracingClasses.3[0]=16 com.borland.dx.*1 1 -1
debug.NoTracingClasses.4[0]=16 com.borland.jb.*1 1 -1
debug.NoTracingClasses.5[0]=18 com.borland.jbcl.*1 1 -1
debug.NoTracingClasses.6[0]=30 com.borland.jbuilder.runtime.*1 1 -1
debug.NoTracingClasses.7[0]=17 com.borland.sql.*1 1 -1
debug.NoTracingClasses.8[0]=9 com.sun.*1 1 -1
debug.NoTracingClasses.9[0]=6 java.*1 1 -1
sys.Author[0]=
sys.DefaultPackage[0]=testjpr
其中build和debug部分中的内容在文件生成以后，一般不需要修改，因为它是自动产生的。sys.Author[0]表示的是作者的名称，缺省为空,即（图－1）中的@Author字段的值。
图－1
sys.DefaultPackage[0]表示的是项目的缺省包名，新建时为项目的名称。当然还可以在.local文件中加入断点的信息，如：
debug.Breakpoints.1[0]=1 329 net.befresh.oa.common.CheckLogin 10 1 10 1 10 1 0 -1
该行文本就为整个项目设置了一个断点，一旦你debug项目时，它都会启动。
我之所以要说.local文件，主要的目的是为了配置Team开发环境。.local文件中包含了Team开发环境中的信息。如【注2】：
team.ActiveVCS[0]=Visual SourceSafe
team.VssAutosaveEnabled[0]=1
team.VssDatabaseLoc[0]=F:\VSS_DB_SPOA
team.VssModuleName[0]=$/spoa/code/PROJECTS
team.VssPassword[0]=123
team.VssUsername[0]=vss
当把项目放入配置管理工具的repository中以后，各个Jbuilder通过“pull project from *”来得到整个项目文件。见（图－2）
图－2
首次从repsotory拉项目文件时，需要设置配置管理工具的信息，而这些信息就存在.local文件中。但是因为.local文件一般都被check in了，所有你每次打开项目时，都需要重新配置，十分麻烦【建议：当把项目加入repository时，不用把.local文件加入】。这时，你就可以手动来修改.local文件，修改完后，也不用把.local文件check in。这样，你就不需要每次都配置这些信息。
为了不把.local文件同步到repository中，你可以单击“Team -> Status Browser…”菜单，然后选择“File Include Lists”，如（图－3），不要选中.local文件,这样就不会把该文件同步了。不但.local文件可以这么做，其它不需要同步的文件（.class）也可以这么来操作。
图－3
参考资料：
【注1】：在Jbuilder7中只有一种项目类型.jpx。在Jbuilder9中，项目类型还有一种.tpr，我在创建这种类型的项目时，出现Error。
【注2】：示例中用的配置管理工具是Microsoft Visual SourceSafe 6.0，其它配置工具显示的信息可能不同。
By Befresh
2003-9-8
