Ktor 快速上手
第一个APP
工程创建
首先你需要创建一个Ktor工程,这里有两种办法创建:
- 网页创建后下载包到本地,作为工程打开:Ktor: Project Generator
- 直接在IDEA里面创建Ktor工程
为了方便操作,这里直接在IDEA里面生成Ktor工程;
IDEA版本为2024.1
选择创建新项目,按照下图所示操作,但要注意以下几个关键点:
- Ktor版本不宜过高,有些库还不支持这么高的版本,建议选择2.3.12就好了
- 配置文件使用经典的YAML,方便管理
- 构建系统推荐使用Gradle(当然你用Maven也不是不可以哈)
进入“下一步”,选择Ktor所需要用到的插件,这个插件就相当于Springboot的库;
我们目前对于基础项目,只需要以下三个库即可:
- call logging :日志库
- default header :网络请求头库
- routing :RESTful风格请求库,类似于Springboot Web库
工程运行
首先修改一下配置文件中服务器的运行端口,默认的8080大概率会被占用;
我这里改成了10002
ktor:
application:
modules:
- com.example.ApplicationKt.module
deployment:
port: 10002
配置完毕后就可以正常运行了;
- 直接去程序入口点Application.kt运行main函数
- 点击IDEA上方工具栏的运行按钮运行
打开网页:127.0.0.1:10002
你就会发现显示了“Hello World!”字样,这就算配置完成了!!!
Gradle 打包
Docker - 快速入门 - Ktor (kotlincn.net)
对于ktor而言,推荐使用的包管理工具为Gradle,最好不要使用Maven;
若您的工程使用了Gradle,则可以在idea的右侧栏找到Gradle按钮,按照下图所示找到shadowJar后双击运行它即可;
此操作会在项目根目录的 build/libs
下生成打包好的后端Jar包;
该文件夹下会生成两个包,一个是需要依赖的,一个是不需要依赖的,我们移植到Docker上的一般会选择不需要依赖的Jar包(也就是后缀为-all
的那个)
您可以在windows下使用命令行运行此Jar包: java -jar xxx.jar
END