第三步

自定义新增服务

上面的例子里，createTutorial转换使用了隐式的自动实体服务create#Tutorial。我们来看下如何手动的定义和实现一个服务。

首先定义一个服务使用默认的自动实体增删改查（CrUD）实现。将服务定义XML文件放在下面的位置： runtime/component/tutorial/service/tutorial/TutorialServices.xml

第二步

我的第一个实体

实体是一个基本的扁平列表的数据结构，并且通常为数据库中的一张表。一条实体值等价于数据库表的一行记录。Moqui框架没有使用对象关系映射方式，所以我们要做的就是定义一个实体，然后通过实体门面模式（或者其他的高抽象层级的工具）去写代码操作使用实体。

概要

本章是篇教你一步步创建并运行你自己的Moqui组件的向导，包含了人机交互界面，业务逻辑以及数据库交互。

• 第一步：以创建一个“Hello world！”的界面开始你的第一个组件

• 第二步：延续上步，你将会定义一个自己的实体（数据库表），然后添加表单去查询和创建实体的记录

• 第三步：创建一些自定义的业务逻辑，而不使用框架自带的默认基于实体定义的CrUD逻辑操作

下载Moqui以及必备软件

Moqui框架默认的配置软件只需要Java的JDK 6及以后版本（推荐JDK 7）。源码构建编译框架需要Gradle 1.6及以后版本。

你可以从SourceForge下载Moqui框架：

https://sourceforge.net/projects/moqui/files/

Web浏览器请求

一个web浏览器请求经由Servlet容器会传递到框架层面（默认实现是内嵌了Winstone Servlet容器，同样也支持Tomcat以及其他的Java Servlet规范容器）。Servlet容器通过web.xml文件按照标准的方式在服务器上找到安装的MoquiServlet，并查找到相应的请求路径。MoquiServlet很简单，仅仅设置了一个运行时上下文，然后渲染请求的界面。