可以创建 Java™ 发射器模板(JET)来生成使用“新建 SQLJ 文件”向导收集的信息的 SQLJ 文件。
先决条件:在工作台中创建 JET 项目。
要执行此任务,必须具有创建 Java 发射器模板的经验。有关创建 Java 发射器模板的信息,请参阅下列关于 eclipse.org Web 站点的文章:
要节省任务步骤中的空间,则省略 ...\com.ibm.etools.sqlj 目录的完整路径。完整路径是 install_directory\rwd\eclipse\plugins\com.ibm.etools.sqlj。
要创建和实现“新建 SQLJ 文件”向导的 JET 模板:
- 将框架添加至 JET 项目:
- 将 SQLJFileSkeleton.skel 文件导入至 JET 项目。此文件位于 ...\com.ibm.etools.sqlj\templates\skeleton 目录中。
- 在 JET 项目中创建框架。此框架必须定义一个类,该类使用接受 IBeanData 参数的 generate() 方法实现 ISQLTemplate 接口。
- 在 JET 项目中创建模板。 可以创建文件或导入工作台提供的其中一个模板并更改它的内容以满足需要。这些模板文件位于...\com.ibm.etools.sqlj\templates 目录中。
模板中的 JET 伪指令必须包含:
- 在...\com.ibm.etools.sqlj\templates 目录的所有模板中唯一的类名。和模板名一样的类名是个好实践。
- 引用正在使用的框架的 skeleton 属性。
- 将 SQLJ 插件的运行时 JAR 文件添加至项目的 Java 构建路径。在项目的“属性”窗口中,单击 Java 构建路径,然后执行“库”页上的下列其中一个操作:
- 如果使用“新建 SQLJ 文件”向导创建 SQLJ 文件,则单击添加变量,然后双击“新建变量类路径条目”窗口中的 SQLJPLUGIN。
- 如果没有使用“新建 SQLJ 文件”向导,则单击添加外部 JAR,转至“JAR 选择”窗口中的 ...\com.ibm.etools.sqlj 目录,然后双击 sqlj.jar 文件。
SQLJ 插件的运行时 JAR 文件将模板中的引用解析为 SQLJ 插件中的类。
- 成功编译此模板之后,将它的 .sqljjet 文件复制至 ...\com.ibm.etools.sqlj\templates 目录。如果创建了新的框架文件,则将它复制至与 JET 伪指令中的引用匹配的 ...\com.ibm.etools.sqlj 下的子目录。
- 将模板的描述添加至 ...\com.ibm.etools.sqlj\template\properties 目录中的 user.properties 文件。 在文本编辑器中打开该文件并将下列两行添加到注释行后:
template_file_name.label=Template name
template_file_name.desc=Template description.
在此标签中指定的模板名包含在“新建 SQLJ 文件”向导中的模板列表中。当在此列表中选择此模板时,它的描述会显示在列表旁边的显示框中。
- 使用此向导来创建 SQLJ 文件,选择模板,然后复查生成的 SQLJ 文件中得到的代码。
如果需要对该模板作出更改,则可以使用下列其中一种方法:
- 使用文本编辑器来直接更改 ...\com.ibm.etools.sqlj\templates 目录中的模板文件。
- 使用工作台来更改 JET 项目中的模板,然后将已更新的文件复制至 SQLJ 插件目录(...\com.ibm.etools.sqlj\templates)。
下次使用“新建 SQLJ 文件”向导创建新的 SQLJ 文件时,SQLJ 插件将会检测到模板文件已更改并将使用已更新的模板。