代码拉取完成，页面将自动刷新
一个类似于spring-shell的框架，不同之处在于这个框架生成gui界面。
导入依赖
<!-- https://mvnrepository.com/artifact/io.gitee.qq1134380223/gui-shell-core -->
<dependency>
<groupId>io.gitee.qq1134380223</groupId>
<artifactId>gui-shell-core</artifactId>
<version>1.1.1.RELEASE</version>
</dependency>
oracle jdk8 包含有javax的相关模块，而jdk11以后javafx已经不是jdk的内置模块，因此需要额外引入。
如果你使用jdk11或更高的jdk版本，那么还需要以下依赖。
<!-- https://mvnrepository.com/artifact/org.openjfx/javafx-fxml -->
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-fxml</artifactId>
<version>17</version>
</dependency>
编写TestMethodGroup
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "嗨", desc = "点击执行功能按钮，然后这个方法的输出将会输出到结果输出区")
public String hi() {
return "hi!";
}
}
编写主方法
public class Main {
public static void main(String[] args) {
GuiShellApplication.runApplication("测试窗口标题", new TestMethodGroup());
}
}
运行主方法,你会看到这个界面
展开右侧的列表中的“测试功能组”，选择“嗨”，然后点击“执行功能”按钮，这时hi()方法的的返回值就会显示在结果输出区。
① 来自与main方法中GuiShellApplication.runApplication的第一个参数。
② TestMethodGroup的@GuiShellGroup注解值，注意需要在main方法中GuiShellApplication.runApplication
的第二个参数传入TestMethodGroup实例。
③ hi()的注解@GuiShellGroupMethod的value值，这个值是“功能名称”。
④ 选择了“嗨”这个功能后，点击“执行功能”按钮时会执行 hi()方法，返回值会显示在结果输出区。
⑤ 功能说明，来自于hi()的注解@GuiShellGroupMethod的desc值，这个值是“功能说明”。
你可以在TestMethodGroup中添加多个注解有@GuiShellGroupMethod的public
方法。注意，框架并不要求多个方法的@GuiShellGroupMethod的value值必须各不相同，只是如果你写相同的value值，会在使用的过程中无法区分两个value相同的方法。
GuiShellApplication.runApplication的第二个参数是变长参数，因此你也可以传入多个带有@GuiShellGroup
注解的类型的实例。同样@GuiShellGroup注解的value值并不要求必须不同，但相同的value会让使用过程中难以区分两个同名的功能组。
方法可以有参数，框架会为参数生成对应的输入组件。现在修改TestMethodGroup的hi()方法
import io.gitee.qq1134380223.guishellcore.annotation.Param;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "嗨", desc = "点击执行功能按钮，然后这个函数的输出将会输出到结果输出区")
public String hi(@Param("姓名") String name) {
return "hi! " + name;
}
}
重新运行程序并选择“嗨”功能,可以看到参数输入区出现一个输入姓名的输入框，输入姓名并点击执行功能。
① 输入框前的参数名称来自于@Param的value值
② 执行功能时，框架会将输入框中的值传入hi方法
框架能为大部分类型生成人性化的输入组件，但并非所有，框架支持的参数类型包括在以下列表中：
| 类型 | 对应的输入组件 |
|---|---|
| int,Integer | 整数输入框 |
| double,Double | 小数输入框 |
| boolean,Boolean | 勾选框 |
| String | 输入框 |
| @Choices String[] | 多选框 |
| @Single @Choices String | 下拉框 |
| File | 文件选择器 |
| @Directory File | 目录选择器 |
| LocaleDate | 日期选择框 |
| 上述类型的数组（注意是数组[]不是集合List） | 可增加减少的上述输入框 |
| 至少有一个setter的bean类型，bean的属性字段是上述类 | 将上述输入框组合而成的输入框 |
| 上述类型的子类 | 父类对应的输入框 |
| 上述类型的数组（注意：本行没有重复） | 可增加减少的上述输入框 |
| 至少有一个setter的bean类型，bean的属性字段是上述类（（注意：本行没有重复）） | 将上述输入框组合而成的输入框 |
| 上述类型的子类 （注意：本行没有重复） | 父类对应的输入框 |
修改一下功能
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "多选", desc = "点击选择选项")
public String multiChoice(@Param("选项") @Choices({"item1", "item2", "item3"}) String[] choices) {
return String.join(",", choices);
}
}
效果如图：
修改一下功能
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
import io.gitee.qq1134380223.guishellcore.annotation.Single;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "嗨", desc = "点击执行功能按钮，然后这个函数的输出将会输出到结果输出区")
public String hi(@Param("问候语") @Single @Choices({"hi", "hello"}) String greeting, @Param("姓名") String name) {
return greeting + " " + name;
}
}
效果如图：
当@Single注解的参数类型为String时，@Single可以省略。但当其注解的类型是String[]时，则不能省略，因为省略后就不能区分是多个单选还是一个多选。 注解或String[][]或String数组的数组的数组等等时@Single同理不能省略。
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod("输入一个文件")
public File getAFile(@Param("文件") File file) {
return file;
}
}
运行测试：
点击选择文件后弹出：
选择文件然后点击执行功能：
import io.gitee.qq1134380223.guishellcore.annotation.Directory;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod("输入一个目录")
public File getAFile(@Param("目录") @Directory File file) {
return file;
}
}
效果同File，只是弹出的选择框时目录选择框：
定义一个Bean类型参数
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
@Data //lombok
public class Student {
@Param("姓名")
String name;
@Param("年龄")
int year;
@Param("性别")
@Choices({"男", "女", "其他"})
String gender;
}
写一个方法
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
import io.gitee.qq1134380223.guishellcore.annotation.Single;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "输入一个学生信息")
public Student hi(@Param("学生信息") Student student) {
return student;
}
}
运行测试：
以学生信息为例
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
import io.gitee.qq1134380223.guishellcore.annotation.Single;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupMethod(value = "输入一群学生信息")
public Student[] hi(@Param("学生信息") Student[] students) {
return students;
}
}
运行测试：
单击结果输出区的文字，可以进入复制模式。
在windows操作系统中，结果输出区会为File类型的返回值生成一个“在资源管理查看”的按钮，点击可打开文件所在目录。
会输出“功能已执行完毕，没有任何返回值”
这个框架会尽量的使用json格式数据表达返回的对象，如果返回的对象无法用json表达则会显示它toString()后的值。
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.GuiShellGroupProperty;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
import io.gitee.qq1134380223.guishellcore.annotation.Single;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupProperty("字段属性")
int i = 0;
public int getI() {//字段属性必须有getter
return i;
}
@GuiShellGroupProperty("方法属性")
public int getIp1() {//方法属性必须public且无参
return i + 1;
}
@GuiShellGroupMethod(value = "改变属性")
public void hi() {
i++;
}
}
每次点击“执行功能”属性区都会刷新并更新属性的值。
点击属性的字符，可以进入复制模式。
例子：
import io.gitee.qq1134380223.guishellcore.annotation.Directory;
import io.gitee.qq1134380223.guishellcore.annotation.GuiShellGroupProperty;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupProperty("目录")
File dir;
public File getDir() {
return dir;
}
@GuiShellGroupMethod("输入一个目录")
public void getAFile(@Param("目录") @Directory File file) {
dir = file;
}
}
对于File类型的属性，在windows操作系统下，会为其生成一个“在资源管理器中查看”的按钮。
对于其他类型的属性，框架会尽量以json的格式展示其内容，如果不能则以其toString的值展示。
以Student类为例子：
import io.gitee.qq1134380223.guishellcore.annotation.Choices;
import io.gitee.qq1134380223.guishellcore.annotation.GuiShellGroupProperty;
import io.gitee.qq1134380223.guishellcore.annotation.Param;
import io.gitee.qq1134380223.guishellcore.annotation.Single;
@GuiShellGroup("测试功能组")
public class TestMethodGroup {
@GuiShellGroupProperty("学生信息")
Student student;
public Student getStudent() {
return student;
}
@GuiShellGroupMethod(value = "输入一个学生信息")
public void hi(@Param("学生信息") Student student) {
this.student = student;
}
}
效果如图：
如果一个@GuiShellGroupMethod注解的函数是耗时任务，可以为其加上@Async注解，这样在执行耗时任务的时候就会输出“功能正在执行，请稍后”。
示例：
@GuiShellGroup("耗时任务")
public class Test {
@GuiShellGroupMethod("耗时任务")
@Async
public void test() {
//耗时任务的代码
}
}
整合springboot的步骤如下
@Component注解注意gui-shell-core依赖中包含springboot的启动配置，无需手动调用GuiShellApplication.runApplication
使用spring boot 的ioc功能，你能向功能组中注入你需要的bean，比如dao，service等
在application.properties中配置
guishell.title=你的标题
使用kotlin可以简化开发，至少不用写那么多public、getter和setter。使用spring boot initializer可以很方便的创建基于kotlin的springboot项目，这样在项目中就可以很方便的使用kotlin开发功能。
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。