跳转到内容
Trantor 文档

Trantor资源树 (ToolWindow）

ToolBar

refresh 刷新Trantor项目资源(⌃⇧T) ，当前文件定位到资源节点(⌥T) ， expand展开所有资源树 ，collapse 收起所有资源树

toolBar

基本信息

跳转到 trantor.yml

双击基本信息节点

可视化（T.UI）

Tips：插件给trantor.yml建了个FileEditorForm (T.UI)，可以更加直观的看到trantor模块的信息。

  • 单击 Refresh T.UI 等效于从T.UI页面切换到Text，将会读取trantor.yml文本信息，更新T.UI
  • 单击 Update trantor.yml等效于从Text页面切换到T.UI，将会读取T.UI的模块信息，更新trantor.yml

TUI

编辑

右键Edit

baseInfo

模块依赖

编辑：右键Edit

跳转到 trantor.yml：双击

dependency

模型资源

模型（Model）

相关跳转（Model）

声明的类：双击模型实例节点

**查看模型资源：**点击模型类的声明行左侧的)blueT，再单击相应资源

JumpModel

新建

持久化/非持久化模型

Model/TransientModel可以通过下列几种方式新建：

1）在资源树上模型右键 再点击 New Model

2）在资源树上具体模型右键 再点击 New -> Model

3）👍🏻 在project文件树上右键 再点击New Trantor -> Model，参考 New Model

newModel

配置模型（SettingModel）

可以通过下列几种方式新建配置模型：

1）在资源树上模型右键 再点击 New SettingModel

2）在资源树上具体模型右键 再点击 New -> SettingModel

3）👍🏻 在project文件树上右键 再点击New Trantor -> SettingModel，参考 New SettingModel

搜索模型（SearchModel）

可以通过下列几种方式新建搜索模型：

1）在资源树上模型右键 再点击 New SearchModel

2）在资源树上具体模型右键 再点击 New -> SearchModel

3）👍🏻 在project文件树上右键 再点击New Trantor -> SearchModel，参考 New SearchModel

编辑（Model）

具体模型实例节点右键 -> Edit

Tips：编辑模型的key，模型下面的资源key会自动更新。

editModel

配置（Model）

具体模型实例节点右键 再点击New -> Configure -> @FieldGroup / @Index / SettingListener

字段组（@FieldGroup）

configureFieldGroup

模型索引（@Index）

configureIndex

删除（Model）

具体模型实例节点右键 -> Delete…

Tips:

  • ☑️ 删除模型下所有View（xml对象）：删除视图XML文件中的有model字段=modelKey的Tag。
  • 0.13 <= trantor < 0.16
    • ☑️删除模型下所有ServerAction方法：参考ServerAction的删除
    • ☑️ 删除模型下所有DataAction类：参考DataAction的删除
    • ☑️ 删除模型下所有ViewAction（json对象）：删除ViewAction所在xx-actions.json中的 JsonObject

delModel

字段（ModelField）

相关跳转（Field）

  • 跳转到声明的字段：双击字段实例节点

新建（Field）

字段可以通过下列三种方式新建：

1）在资源树上字段右键 再点击 New

2）在资源树上具体模型右键 再点击New -> Model Field

3）👍🏻 在代码编辑窗口指定行上右键 再点击Genarate Trantor.../ModelFile ，参考Genarate Trantor

  • 在模型文件中新建字段，并创建注解。

newModelField

Meta注解

参考 字段Meta注解

编辑（Field）

具体字段实例节点右键 -> Edit

Tips：只有模型自定义的字段可以编辑，BaseModel/RootModel的字段（置灰字段）不支持Edit。

删除（Field）

具体字段实例节点右键 -> Delete…

Tips：只有模型自定义的字段可以编辑，BaseModel的字段（置灰字段）不支持Delete。

视图（View）

Trantor v0.16.+

新建

视图可以通过下列三种方式新建：

1）在资源树上视图右键 再点击 New

2）在资源树上具体模型右键 再点击 New -> View

3）👍🏻 在project文件树上右键 再点击New Trantor -> View，参考 New View

new16view

Trantor v0.13-v0.15.*

相关跳转（View）
  • 跳转到对应的XML文件：双击视图行为实例节点
  • 跳转到声明的JsonObejct：视图实例节点 右键 -> Goto Json
    • forModel 跳转到模型定义类文件：⌘+鼠标左键
    • template跳转到对应的xml文件：⌘+鼠标左键

⬇️新建Gif里面有演示

新建（View）

视图可以通过下列三种方式新建：

1）在资源树上视图右键 再点击 New

2）在资源树上具体模型右键 再点击 New -> View

3）👍🏻 在view-manifest.json指定行上右键 再点击Genarate Trantor.../view ，参考 Genarate Trantor

Tips：新建视图模版xml文件的.xml 和 Controller文件的.ts后缀可写可不写。

  • 创建视图 template文件，并填充title

  • 在视图清单 “view-manifest.json” 创建对应的 JsonObject

  • 若填写新 Controller 文件名，则字段创建视图 Controller文件

  • 视图xml中的model可跳转到对应模型类

newView

ViewType 与 XMl

根据不同的视图类型会生成不同xml

viewType

删除（View）

具体视图实例节点右键 -> Delete…

Tips：删除视图并不会删除template文件

  • 勾选删除“view-manifest.json”中的Json对象，则JsonObejct会被删除
  • 勾选删除对应controller文件，则对应controller文件会被删

视图行为（0.13<= Trantor <0.16）

相关跳转（ViewAction）

  • 跳转到声明的JsonObejct：双击视图行为实例节点
    • forModel跳转到模型定义类文件：⌘+鼠标左键

新建（ViewAction）

视图行为可以通过下列三种方式新建：

1）在资源树上视图行为右键 再点击 New

2）在资源树上具体模型右键 再点击New -> View Action

3）👍🏻 在”-actions” 为后缀的 json 文件指定行上右键 再点击Genarate Trantor.../ViewAction ，参考 Genarate Trantor

Tips：

  • 在“xx-actions.json”创建对应的JsonObject

newViewAction

编辑（ViewAction）

具体视图行为实例节点右键 -> Edit

Tips：由于目前Trantor其他资源与View Action引用关系未实现 ，若修改“行为原标识”，需检查

删除（ViewAction）

具体视图行为实例节点右键 -> Delete…

Tips：

  • 待删除ViewAction所在的“xx-action.json”仅包含待删除ViewAction，会提示勾选删除“xx-action.json”，若勾选，则“xx-action.json”会被删除。
  • 由于目前Trantor其他资源与View Action引用关系未实现，若删除，需检查

服务行为（0.13<= Trantor <0.16）

相关跳转（ServerAction）

到声明@TAction方法：双击服务行为实例节点

新建（ServerAction）

目前插件仅支持一种方式新建服务行为：

1）👍🏻 在代码编辑窗口指定行上右键 再点击Genarate Trantor.../ServerAction ，👍🏻 在”-actions” 为后缀的 json 文件指定行上右键 再点击Genarate Trantor.../ServerAction ，参考 Genarate Trantor

编辑（ServerAction）

具体服务行为实例节点右键 -> Edit

Tips：由于目前Trantor其他资源与Servre Action引用关系未实现 ，若修改“行为原标识”，需检查或手动修改

删除（ServerAction）

具体服务行为实例节点右键 -> Delete…

Tips：由于目前Trantor其他资源与Servre Action引用关系未实现，若删除ServreAction，需检查。

数据行为（0.13<= Trantor <0.16）

相关跳转（DataAction）

跳转到声明类：双击数据行为实例节点

新建（DataAction）

数据行为可以通过下列三种方式新建：

1）在资源树上数据行为右键 再点击 New SingleDataAction/MultiDataAction

2）在资源树上具体模型右键 再点击New -> Data Action -> SingleDataAction/MultiDataAction

3）👍🏻 在proejcct文件树上右键 再点击New Trantor -> SingleDataSAction/MultiDataAction，参考 New Trantor

  • 创建名为“新建类名”的Java类，并在类上创建@Component注解，实现MultiDataAction或SingleDataAction。

newDataAction

删除（DataAction）

具体数据行为实例节点右键 -> Delete…

Tips：由于目前Trantor其他资源与Data Action引用关系未实现 ，若删除DataAction需检查是否有地方使用。

字典资源

字典（Dictionary）

相关跳转（Dictionary）

  • 跳转到声明类：双击字典实例节点

新建（Dictionary）

字典可以通过下列三种方式新建：

1）在资源树上字典右键 再点击 New

2）在资源树上具体字典右键 再点击New -> Dictionary

3）👍🏻 在proejcct文件树上右键 再点击New Trantor -> Dictionary，参考 New Dict

Tips：

  • 资源树上新建：
    • 当前Api模块若存在字典资源，则“新建类目录”会初始化为使用模块下第一个字典文件所在目录，若无则会初始化为Package路径。
    • 在“新建类目录”创建名为“新建类”的Java类，并在类上创建字典注解。

newDict

编辑（Dictionary）

具体字典实例节点右键 -> Edit

删除（Dictionary）

具体字典实例节点右键 -> Delete…

字典项（Dictionary Item）

相关跳转（Dict Item）

  • 跳转到声明变量：双击字典项实例节点

新建（Dict Item）

字典项可以通过下列三种方式新建：

1）字典项实例右键 再点击 New Item

2）在资源树上具体字典右键 再点击New -> Dictionary Item

3）👍🏻 在代码编辑窗口指定行上右键 再点击Genarate Trantor.../DictionaryItem ，参考Genarate Dictionary Item

Tips：目前声明的变量都是以 public static final 修饰的常量。

  • 在被选择的字典或字典项所在的类中，声明常量，并在常量上创建 @Label 注解。

newDictItem

编辑（Dict Item）

具体字典项实例节点右键 -> Edit

删除（Dict Item）

具体字典项实例节点右键 -> Delete…

菜单资源

菜单项（Menu Item）

相关跳转（Menu Item）

跳转到声明JsonObject：双击菜单项实例节点

新建（Menu Item）

菜单项可以通过下列三种方式新建：

1）在资源树上菜单项右键 再点击 New

2）在资源树上具体菜单项右键 再点击New -> Menu Item

3）👍🏻 在-menu-item为后缀的 json 文件指定行上右键 再点击Genarate Trantor.../MenuItem ，参考Genarate MenuItem

Tips：

  • 在对应Json文件中声明菜单项，新建时默认插入{module}-menu-item.json，手动编辑时会新建Json文件。

newMenuItem

编辑（Menu Item）

具体菜单项实例节点右键 -> Edit

删除（Menu Item）

具体菜单项实例节点右键 -> Delete…