Fixflow引擎解析(三)(模型) - 创建EMF模型来读写XML文件

Fixflow引擎解析(四)(模型) - 通过EMF扩展BPMN2.0元素

Fixflow引擎解析(三)(模型) - 创建EMF模型来读写XML文件

Fixflow引擎解析(二)(模型) - BPMN2.0读写

Fixflow引擎解析(一)(介绍) - Fixflow开源流程引擎介绍

关于EMF

　　EMF（全称Eclipse Modeling Framework），是Eclipse组织推出的建模框架。它能够帮助软件开发人员将模型(UML, XSD等)转换成为健壮且功能丰富的Java代码。通过使用EMF，程序员编写的程序能免费的获得一个健壮的模型层，它通常比程序员自己手工编写的模型层更为健壮。事实上，有很多商业产品都使用了 EMF 来作为其模型层。由于 EMF 的广泛使用，Eclipse 组织为其推出了众多的周边模块。

Fixflow中的EMF

　　Fixflow引擎读写BPMN2.0模型文件都是通过EMF来实现，扩展的"fixflow:"的元素也是通过EMF提供的注入技术实现,Eclipse的流程设计器上也使用EMF去读写模型文件，

除此之外，系统里的各种.xml配置文件都是EMF完成读写，同时还涉及到了脱离Eclipse环境在web中使用EMF。

设计模型

假设我们需要通过EMF读写一个这样格式的XML文件:

 <bookRepository>
    <book id="1" name="我的奋斗" author＝"阿道夫·希特勒"></book>
    <book id="2" name="闪击英雄" author＝"海因茨·古德里安"></book>
    <book id="3" name="失去的胜利" author＝"冯·埃里希·曼施泰因"></book>
 </bookRepository>

下面就根据上面XML实例来创建一个EMF模型。(当然EMF支持用一个XSD文件来生成模型,这种方式我们这里先不做介绍)

注意:下面的内容我用的是Eclipse Modeling Tools版本的Eclipse

(1) 创建一个空的EMF项目(并不一定非要是EMF项目)

(2) 项目名称EMFTest

　　

(3) 在model目录下创建一个Diagram模型设计文件

(4) 给这个Diagram模型设计文件所对应的ecore文件起名: book.ecore

创建完成之后会同时生成两个文件，.ecore文件为模型文件，.ecorediag 为模型的设计文件用来图形化设计器EMF模型。

　　

(5) 打开book.ecorediag文件设计模型，这里我们可以修改一下命名空间，EClass 对应到XML的Element，EAttribute对应到XML Element的字段。

(6) 创建两个EClass 分别起名 BookRepository 和 Book ，在Book类的定义中 添加三个 EAttribute id、name、author。

(7) 设置 EAttribute 的属性 ，除了名字，三个 EAttribute 采用相同的设置。

设置为attribute类型

(8)设置两个类之间的关系，添加一个 BookRepository 到 Book 的引用

继续关系设置

这样我们的模型文件设计完毕，下面我们需要来生成java代码。

生成Java代码

要生成java代码光有 .ecore文件和.ecorediag文件还不够,还需要一个.genmodel文件。

(1)创建一个.genmodel 配置文件

(2) 配置.genmodel文件

(3)生成Java模型文件

读写XML文件

模型和java代码创建完毕之后我们来创建测试类,来尝试读写一个XML文件。

创建一个 test.java 带main方法的:

 import java.io.IOException;
 import java.util.Collections;
 import java.util.Map;

 import org.eclipse.emf.common.util.URI;
 import org.eclipse.emf.ecore.resource.Resource;
 import org.eclipse.emf.ecore.resource.ResourceSet;
 import org.eclipse.emf.ecore.resource.impl.ResourceSetImpl;
 import org.eclipse.emf.ecore.xmi.impl.XMIResourceFactoryImpl;
 import org.fixflow.model.book.Book;
 import org.fixflow.model.book.BookFactory;
 import org.fixflow.model.book.BookPackage;
 import org.fixflow.model.book.BookRepository;
 import org.fixflow.model.book.util.BookResourceImpl;

 public class test {

     public static void main(String[] args) {

         // 初始化模型
         BookPackage.eINSTANCE.eClass();

         // 创建根元素
         BookRepository bookRepository = BookFactory.eINSTANCE.createBookRepository();

         // 创建书籍1
         Book book = BookFactory.eINSTANCE.createBook();
         book.setId("1");
         book.setName("我的奋斗");
         book.setAuthor("阿道夫·希特勒");
         // 将创建的书创建到根元素下
         bookRepository.getBook().add(book);

         // 创建书籍2
         book = BookFactory.eINSTANCE.createBook();
         book.setId("2");
         book.setName("闪击英雄");
         book.setAuthor("海因茨·古德里安");
         // 将创建的书创建到根元素下
         bookRepository.getBook().add(book);

         // 创建书籍3
         book = BookFactory.eINSTANCE.createBook();
         book.setId("3");
         book.setName("失去的胜利");
         book.setAuthor("冯·埃里希·曼施泰因");
         // 将创建的书创建到根元素下
         bookRepository.getBook().add(book);

         //注册XML扩展
         Resource.Factory.Registry reg = Resource.Factory.Registry.INSTANCE;
         Map<String, Object> m = reg.getExtensionToFactoryMap();
         m.put("xml", new XMIResourceFactoryImpl());

         // 创建一个资源
         BookResourceImpl resource = new BookResourceImpl(URI.createURI("modelfile/book.xml"));

         //设置文件编码
         resource.setEncoding("UTF-8");
         //将模型保存到资源中
         resource.getContents().add(bookRepository);

         try {
             //保存文件
             resource.save(Collections.EMPTY_MAP);
         } catch (IOException e) {
             e.printStackTrace();
         }

         //加载测试
         load();

     }

     public static BookRepository load() {
         // 初始化模型
         BookPackage.eINSTANCE.eClass();

         // 注册XML扩展
         Resource.Factory.Registry reg = Resource.Factory.Registry.INSTANCE;
         Map<String, Object> m = reg.getExtensionToFactoryMap();
         m.put("xml", new XMIResourceFactoryImpl());

         //创建一个 资源 ResourceSet
         ResourceSet resSet = new ResourceSetImpl();

         // 获取资源
         Resource resource = resSet.getResource(URI.createURI("modelfile/book.xml"), true);

         //或者根节点
         BookRepository bookRepository = (BookRepository) resource.getContents().get(0);

         return bookRepository;
     }
 }

下面运行测试类之后生成文件：

至此一个最简单的XML文件通过EMF来读写的功能已经介绍完了,在后面的章节中我还会详细介绍EMF提供的高级功能。