Fixflow引擎解析(三)(模型)

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提供的高级功能。