---

###目录:###

• 任务列表
• 结构
• 常用操作
• 任务内容

---

##任务列表##

在任务列表中，我们可以管理任务，并选择要执行的任务运行。

##结构##

任务包括三层结构

• 项目：一个大类可以归为一个项目，项目下可以有多个目录。
• 目录：一个大类下的次级分类归为一个目录，目录下可以有多个任务。
• 任务：执行生成的具体单元，一个任务只能（新建/合并/覆盖)一个文件；它包含三种类型：
• 新建：文件不存在时，新建文件并根据模板生成新内容。
• 合并：文件已经存在，根据模板合并指定的部分，其它内容不变。
• 覆盖：文件已经存在，重新执行并覆盖所有内容。

例如：下面是一个Web项目的任务结构

• 项目：按MVC结构分别有3个项目。
• 目录：目录结构又细分成entity(实体)、dao、service、action、jsp等。
• 任务：具体生成不同文件。

##常用操作##

右键可以查看到以下操作，或者右侧按钮栏里也有对应的一些操作。

• 新项目、新目录、新任务、编辑

（项目/目录/任务）名称自定义，不影响生成，但是同级别的不能重名。

• 设置模型、清除模型

我们可以在任务中修改对应的模型，但是如果多个任务都需要修改模型时，效率就会很低。

使用批量的方式设置模型，选中多个任务

选择新的模型

通过批量选择，只要有新模型或者变更模型，就可以快速使用。

任务有以下3种提示状态， 这些状态会根据环境的变化而自动更新，比如模板有语法错误，文件目录找不到等。

• 正常：
• 警告：
• 错误：

如模板中有语法错误，或者找不到文件等其他错误警告，对应的任务状态也会改变

• 刷新

任务的状态虽然会自动更新，但有时候会有延迟，可以使用刷新手动刷新状态。

• 向上、向下

任务的执行顺序是由上到下，可以通过向上向下来更换任务的执行顺序。

• 复制、粘贴

任务可以复制，粘贴到需要的位置。

• 删除

可以删除任何元素，项目和目录被删除将同时删除它的子元素。

• 拖拽

需要移动鼠标拖拽，任务会从一个位置移动到另一个位置，等同于剪切。

##任务内容##

• 任务名：可通过点击修改。
• 模型：点击浏览选择模型，。

模型来源为当前文件的模型列表

一个任务只能选择一个组

• Action：点击浏览选择Action，点击 或者可以打开Action文件。关于Action的用法请阅读：Action

Action必须选择父类是org.jmr.core.JmrActionSupport的类，对话框会自动匹配这些类，输入**会列出所有符合条件的类。选择的Action必须在同一个项目中（jmr文件所在项目）。

• 模板：点击浏览选择模板，点击 或者可以打开模板文件。

模板选择对话框，会列出当前项目下的所有模板，可以在搜索框中输入名称过滤。选择的模板必须是当前项目的（jmr文件所在项目）。

• 任务类型：选择好任务类型能够更方便的执行任务。
• 新建：当文件不存在时为新建，执行任务，生成文件后会自动选择为覆盖。
• 合并：文件中有合并标识的位置会被更新，其余部分不变。关于合并的详细内容请阅读：合并使用。
• 覆盖：文件已经存在，执行任务替换掉文件的所有内容。

第一次运行任务的状态是新建，接下来都是以合并和覆盖为主。

例如，spring、struts这2个任务都是往配置文件中添加注册信息，menu是在左侧栏目的界面中添加新的链接，所以它们的模式都是合并，其余的都是覆盖。合并还有更多的运用，请阅读：合并使用。

• 目录：文件所在目录，点击浏览选择目录。

点击创建新目录。创建的目录必须在当前项目下（jmr文件所在项目）。

点击可以使用表达式自定义目录结构。通过选择目录，得到目录的值，再插入模型变量，可以通过模型变量来生成目录。在新建模式下，如果目录不存在，会自动创建。

例子：使用表达式生成目录。

模型组中，relation为one的模型有属性class，值为book。

目录设置如下：

生成的文件目录

• 文件名：生成文件的名称，双击或者回车可以编辑。

• 点击可以使用表达式构成文件名。

例子：使用表达式生成文件名。

模型组中，relation为one的模型有属性class，值为book。

文件名设置如下：

生成的文件名

• 扩展名：生成文件的扩展名，双击或者回车可以编辑。