超简单易用的 Java Web 框架 - Javalin

  • 我习惯用 Go 来做一些小网站,最近想换个口味,试试 Java. 我以前嫌弃 Java 太啰嗦,但自从尝试在 Python 里严格认真地使用 type hint, 累死我了,这比 Java 更啰嗦。这样折腾过后, Java 在我眼中也眉清目秀起来。
  • 以前虽然学过 Java, 但几乎没有真正用过,并且已经多年完全没写过 Java, 因此需要重新学习,就看了一遍 dev.java
  • 由于我主要是想做些自用的小工具,就没必要学 Spring 了,找个更简单易用的框架,够用就行(我需要的功能非常少,能让前后端通过 JSON 互相交流就行),最后找到了 Javalin, 非常满意,真的太易学易用了。

最终效果

  • 只要执行 mvn package 就可以打包一个 jar 文件
  • 把这个 jar 文件放在任何安装了 JVM 的电脑/服务器里,只要执行 java -jar XXX.jar 就可以启动网站,连静态资源都包含在内。

其中:

  • 新建项目很简单,点几下鼠标就行,详见下面 "第一步"
  • 配置 Maven (添加依赖) 很简单,复制粘贴就行,详见下面 "第二步"
  • 添加前端文件 (html, js) 很简单,在指定目录添加文件就行,详见下面 "第三步"
  • "第四步" 写 App.java 文件,内容也非常简单。

第一步: JetBrains IntelliJ IDEA

如果想新建一个受 Maven 管理的 Java 项目,使用 IDEA 是最方便的。

Maven_New_Project.jpg

如上图所示,填写必要的信息, Build system 选择 Maven 即可。

  • 新建项目后,可得到类似这样的文件夹结构: MyProject - src - main - java
  • 在 IDEA 里右建点击 java 文件夹,选择新建 package, 填写类似这样的包名称: com.example.myproject
  • 右建点击 com.example.myproject, 选择新建 class, 建议填写名称 App

第二步: 修改 pom.xml 文件

参考: github.com/ahui2016/monostich/.../pom.xml

在 IDEA 左边栏的目录树里可以看到有 pom.xml 文件。
pom.xml 文件是 Maven 的配置文件,基本上复制粘贴上面链接里的内容即可,但要注意:

  • <groupId> 修改为你自己的域名(确保不会与别人的域名相同)
  • <artifactId> 修改为你的项目名称(即前面图片中的 MyProject)
  • <mainClass> 修改为你的 package 名称和 class 名称 (例如:如果在前面新建 package 时填写了 com.example.myproject, 新建 class 时填写了 App, 那么现在就应该填写 com.example.myproject.App )
  • 最后按 Ctrl+Shift+O 进行更新 (该快捷键的作用是 Load Maven Changes)

第三步: 添加前端文件

在这一步,关键的是 index.html 和 index.js, 由于只是用于演示,文件内容非常简单,一看就懂。

这两个前端文件只实现了一个功能: 用 axios 与后端通信,获取一个 JSON, 再用 jquery 把该 JSON 的内容反映到 HTML 页面中。

第四步: 写 App.java 文件

App.java 文件的内容全文如下:

package cc.ai42.monostich;

import io.javalin.Javalin;
import io.javalin.http.staticfiles.Location;
import java.util.Map;

public class App {
    public static void main(String[] args) {
        @SuppressWarnings("resource")
        Javalin app = Javalin.create(config -> {
            config.addStaticFiles(staticFiles -> {
                staticFiles.hostedPath = "/";
                staticFiles.directory = "/public";
                staticFiles.location = Location.CLASSPATH;
            });
        }).start(7070);

        app.get("/api/hello", ctx -> {
            var result = Map.of("hello", "world");
            ctx.json(result);
        });
    }
}
  • 如上所示,代码非常简单, config 指定了静态文件的位置,另外 app.get() 函数负责向前端提供 JSON。
  • 前面第三步的 index.js 文件中的 axios.get('/api/hello') 与 这里的 app.get("/api/hello", ctx) 对应。

最后

代码已经全部写好,在终端进入项目的根目录(第一步创建的 MyProject 文件夹),执行命令 mvn package, 然后执行命令 java -jar ./target/XXX.jar 即可启动网站。

其中 XXX.jar 的具体文件名可用命令 ls ./target 查看。

开发阶段

在上面的 App.java 文件里,这几句的作用是把前端静态文件打包进 jar 文件里:

    staticFiles.hostedPath = "/";
    staticFiles.directory = "/public";
    staticFiles.location = Location.CLASSPATH;

但这样做,每次修改前端文件时,都需要执行 mvn package 重新打包。

因此,在开发阶段可以把这几行代码改为:

    staticFiles.hostedPath = "/";
    staticFiles.directory = "src/main/resources/public";
    staticFiles.location = Location.EXTERNAL;

这样,每次修改前端文件,只需要在前端刷新页面即可看到最新变化。

总结

从以上内容可以看出,后端用 pom.xml 添加依赖后,后端只需要一个 App.java 文件,前端两个文件 index.html, index.js, 内容都非常简短,就能实现一个前后端分离的网站,并且可打包成一个 jar 文件。

一个四个关键文件,以及目录结构,全部源码见这里: github.com/ahui2016/monostich/

Javalin网站框架介绍之二 - 数据库
https://geeknote.net/SuperMild/posts/1430

3
4
1