JET之JETEmitter

在这之前，希望大家能看看我之前写的JET入门以方便了解JET的原理及工作过程，我在这里就简单说说它的工作过程，需要两个步骤：翻译和生成。第一步翻译模板，模板实现类；第二步使用模板实现类生成文本。前面的例子中都是在工程中直接将工程设置成JET工程，自动编译（保存模板生成模板实现类），但是在通常情况下我们都想对模板做绝对控制（通过代码去编译模板及生成代码），这个时候就得通过JET提供的编译器（JETCompiler）和代码生成器（JETEmitter）。JETCompiler：这是模板翻译的核心类。 此类负责翻译模板，模板实现类的 Java 源代码。 实际的翻译被委派给其他此包中的类。 一个 JETParser 用于解析为模板元素的模板。 JETCompiler 实现 JETParseEventListener 接口，并将自身注册的解析器解析器确认模板元素时得到通知。 认可的模板的每个元素的 JETCompiler 将 Java 源代码的模板元素使用一个 JETGenerator。 模板分析完成后，JETCompiler 将使用一个 JETSkeleton 装配到单个编译单元 （Java 类） 的 Java 源的代码元素。所在包：org.eclipse.emf.codegen.jet.JETCompiler；JETEmitter： 此类为此软件包的用户提供了一个方便的高级别 API。 生成 此类的方法将一个模板，Java 源代码转换为编译此源代码，一个的模板执行类要求，生成的文字的模板类、 最后返回生成的结果。 此类创建一个工作区中称为 .JETEmitters 的 Java 项目模板转换为这一项目，只是要求要编译的源代码的 .JETEmitters 项目的 建设。 如果翻译或编译失败，则会引发一个 JETException。 模板执行的 Java 类是"main"通过调用其 生成 的方法。JETSkeleton：此类提供一个接口，装配成一个单一的 Java 编译单元 （Java 类） 的 Java 源的代码元素。 Java 源的代码元素将装配依法类的主干定义。 骨架可以用于将样板代码添加到翻译的模板实现类。 此类提供一个默认的自定义模板实现类的骨架定义，但也可以组合使用自定义的骨架的 Java 元素。 实际分析和生成的 Java 源代码被委派给 org.eclipse.jdt.core.jdom 包中的类。
JETEmitter使用：

String templateURI = "platform:/resource" + fullPath;
            ClassLoader classloader = getClass().getClassLoader();
          JETEmitter emitter = new JETEmitter(templateURI, classloader);

templateURI：任何类型是 uri 的可以接受的，只要协议处理程序是 uri 的可用的，这意味着，file:/ uris，ftp： / uris 和 http:/ uris 所有可用。Eclipse添加特殊协议处理程序的 平台： 基 / /，平台：/插件/，平台： 片段/ 和 平台：/资源/ 因此插件可以使用了像 platform:/resource/myproject/myfolder/mytemplate.jet 的 uri 来指定模板文件的 uris。 注意： Eclipse 3.0 推出了 bundleentry 以其特殊的协议的列表。 它应在对 Eclipse 插件和功能等元素的引用。
在插件的我们示例中我们将派我们的模板文件连同我们插件，模板文件将位于 Eclipse 插件 文件夹下的 myplugin/模板 文件夹。 然后可以使用下面的代码找到并从该文件夹中生成的模板：

String pluginId = "myplugin.id";
 String base = Platform.getBundle(pluginId).getEntry("/").toString();
 String uri = base + "templates/myTemplate.javajet";
 JETEmitter emitter = new JETEmitter(uri);
 String generatedText = emitter.generate(new Object[] {parameter});

构造一个 JETEmitter 对象后，客户端调用generate方法生成文本，生成文本的方法执行以下步骤操作：
1.创建一个称为 .JETEmitters，在工作区中的项目
2.这一项目准备给 Java 自然和添加到其类路径的类路径变量
3.翻译一个模板执行 Java 源文件在 .JETEmitters 项目中的模板
4.生成要编译到一个 Java .class 文件模板执行源代码的项目
5.翻译的 Java 模板实现类调用 生成 方法并返回一个字符串作为生成的文本

.JETEmitters 是模板转换的过程中创建的项目的默认名称。 setProjectName 方法，可以更改此值。
JETEmitter 陷阱：
1.插件所需初始化，就是前面所说的，必须在插件环境下才能调用JETEmitter，JETEmitter不能作为Application独立运行。
2.类加载程序问题：
当您将自定义对象作为参数传递给 JETEmitter.generate 方法时，您可能会一 NoClassDefFoundError。 如果您将作为参数传递的对象不是一个 java"bootstrap"类 （引导类是运行时类在 rt.jar 和 i18n.jar 中的国际化类） 的这就可能发生。
为防止出现此错误时使用 JETEmitter 时必须指定类加载器的您的插件。 如果不指定了任何类加载器 JETEmitter 使用自己通常是在 org.eclipse.emf.codegen 插件的类加载器的类的类加载器，此类加载程序不能看到很多。 如果，在最新版本的EMF （因为 1.1.0 版生成 20030527_0913VL)，JETEmitter 类加载器参数的构造函数。
请注意，另一种方法来指定类加载器子类 JETEmitter 在自己的项目 ； 如果不指定了任何类加载器，则 JETEmitter 将使用此子类的类加载器。 （如果使用的旧版本的电磁场有没有采取类加载器参数的构造函数，将在自己的项目没有选择，只好子类 JETEmitter。
下面的示例显示了一个操作类的转换和调用一个使用 JETEmitter 的所选的模板。 该示例显示了如何可以构造一个 JETEmitter  类加载程序参数。

ClassLoader classloader = getClass().getClassLoader();
          JETEmitter emitter = new JETEmitter(templateURI, classloader);

3.类路径问题 ：
JETEmitter 将转换您的模板，以 .JETEmitters 项中的 Java 源文件，并调用编译这些源代码文件 JavaBuilder。 如果您的模板使用不标准的 Java 类的类或不在插件您需要将这些类添加到类路径的 .JETEmitters 项或在 JavaBuilder 的电磁场中无法编译模板执行源代码文件。 幸运的是，JETEmitter 提供了一种执行此操作通过方法 addVariable 的 .JETEmitter 项目中添加一个类路径变量的简单方法。下面的示例显示如何将加载类到.JETEmitter中：

emitter.addVariable(Config.CLASSPATHVARIABLE, Config.PLUGIN_ID);

CLASSPATHVARIABLE = "JET_TUTORIAL"；
后面加了个PLUGIN_ID，意思是说将该plugin也加载到.JETEmitter中，这样做的原因就是当你的模板中引入了该插件下的包时就得将该插件也加载到.JETEmitter的CLASSPATH中。