# idea插件使用指南

# 安装插件

官网下载社区（免费）版本的idea，验证版本号为：232.10300.40。
打开idea，左上角点击File - Settings，选择Plugins，点击从本地安装插件，选择eos4idea-8.3LA2.zip插件。为保证所有功能正常生效，安装插件后，重启idea。
若idea已安装过eos4idea插件，需要先在已安装插件页面，卸载eos4idea插件，重启idea后重新安装eos4idea插件。

# 特性介绍

支持EOS项目的创建：文件 - 新建 - 项目，右边树选择EOS项目，左边列表可选精简项目、独立项目、微服务项目、AFC定制项目，下一页详细信息中可选基座版本8.3.1/8.3.0，其余功能和eclipse相似。
支持构件包的创建：右击根项目目录 - 新建 - 构件包，填写构件包名称和类型。
支持数据库的连接和简单操作，透视图右侧数据库管理视图，可以增删改数据库配置，以展示数据库，主要作用与数据集进行交互。
支持数据集的创建、展示、开发、编译，数据集和单个/多个数据实体可创建SDO代码，实体的生成与重载。

—— 数据集创建：右击软件包 - 新建 - 数据集。

—— 数据集的开发界面和操作与afcenter低开环境雷同，需要手动进行保存操作：点击保存按钮、或快捷键Ctrl+S。

—— 数据集编译：idea不支持自动编译，需要手动点击构建 - 构建项目/重新编译，在编译输出目录中生成数据集的编译文件。

—— 创建SDO代码：右击数据集/打开的数据集中的数据实体 - 创建SDO代码。

—— 生成数据实体：从数据库窗口中，直接拖拽表至数据集中，生成数据实体。
支持运算逻辑的创建、编译。

—— 创建运算逻辑：右击软件包 - 新建 - 运算逻辑，生成带有Bizlet注解的java文件。

—— 运算逻辑编译：手动构建编译项目后，在编译输出目录中生成class.edoc文件。
支持命名SQL集的创建、编译。

—— 创建命名SQL集：右击软件包 - 新建 - 命名SQL集。

—— 命名SQL集编译：手动构建编译项目后，在编译输出目录中生成namingsql文件。
支持逻辑流文件的编译。

仅支持正确的逻辑流文件编译，不支持逻辑流的创建以及图形化展示编辑。
支持EOS服务文件的编译。

仅支持正确的EOS服务文件编译，不支持EOS服务的创建以及生成。
支持工作流文件的编译。

仅支持正确的工作流文件编译，不支持工作流的创建以及图形化展示编辑。
支持Rest单表功能向导：右击IMPL构件包 - Rest单表维护功能向导，根据选择的单个数据实体，生成对应的SDO、Dao、Service、Controller代码。

# 问题说明

EOS项目启动时，报错提示Error running Application. Command line is too long. Shorten the command line via JAR manifest or via a classpath file and rerun. 解决方法一：直接点击报错提示中JAR manifest链接。解决方法二：在Edit Configurations -> Modify options勾选Shorten command line -> Shorten command line:下拉选项中的JAR File
创建项目后，如果遇到子项目无法识别为maven项目的情况，打开根目录下的pom.xml文件，查看modules节点有没有被idea删除，如果删除请手动增加，示例如下(注意module的顺序):
在生成的SDO代码中，由于idea对Java文件的校验级别问题，代码行高亮标红报错：Cannot resolve symbol 'value' 。解决方法一：解决单个文件，点击右上角标红和警告的提示处，选择HighLight：All Problems下的Syntax。解决方法二：解决所有Java文件，在File -> Settings里Editor下的Inspections中将整个Java去掉勾选（不推荐）。
idea每次新开一个窗口都需要重新配置Maven。创建完EOS项目后，请第一时间配置Maven(File - Settings)，如果Maven update报错找不到远程仓库，请配置本机可运行的Maven。
idea是自动保存文件更改，但不支持保存文件后自动编译。所以在数据集中选中实体创建SDO代码时，需要先编译项目。同理，在数据集选择引用实体以及功能向导选择实体时，也要保证被选择实体已经过编译。(注意：不分环境编译后不会自动刷新target下的EOS资源，需要手动刷新target目录)
部分环境，在功能向导和生成SDO后不会自动刷新资源树，需要手动右击资源树，点击“从磁盘重新加载”。
部分环境，在创建项目后可能会出现项目展示不全的情况（如下图）此时需要打开pom.xml文件，确定modules标签是否被系统删除，如果不存在modules标签，需要手动增加modules标签内容（modules标签内容确定项目下所有子项目）最后在idea右边maven视图中，点击刷新按钮，项目结构将成功展示。