项目小总结之简易井字棋

Category : 笔记

(个人笔记) 就算是玩具项目，做完也会有不少收获——主要是对 gradle 和 groovy 的初步认识

这次学到了包管理工具和 jar 相关，还有一门脚本语言 Groovy。

包管理工具常见的有 maven 和 gradle，我选择了后者。

我们知道，依赖多并复杂起来的时候，谁都想要一个可以帮忙自动处理 dependency 的工具。于是我就尝试使用一下 gradle。

写在前面

还是日常将文档页面放在这里: gradle doc

一瞥

这次没有先去看文档，而是先用 IDEA 新建了一个 gradle project，可以看出多了许多东西。

目录结果可能如下（摘自官方）。不过 IDEA 中，默认 gradle 生成的，其中除了build.gradle，都在 app 文件夹外面。（应该是因为 IDEA 创建的为单项目，没有包含子项目的原因吧）

├── gradle
│   └── wrapper
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── app
    ├── build.gradle
    └── src
        ├── main
        │   └── java
        │       └── demo
        │           └── App.java
        └── test
            └── java
                └── demo
                    └── AppTest.java

比如setting.gradle和build.gradle（用 IDEA 的 wizard 新建的）

其中setting.gradle项目的设置，里面包含着子项目和 build 的一些 definition。而build.gradle就是特定的一个项目或者子项目的 build script。它们都是用的 groovy 语言或者 kotlin（这里我选择的是 groovy）

//setting.gradle
rootProject.name = 'gradletest'

//build.gradle
plugins {
    id 'java'
}

group 'org.example'
version '1.0-SNAPSHOT'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'
}

test {
    useJUnitPlatform()
}

从上面可以看出，除此之外。他生成了一些文件和文件夹，gradle/wrapper里头装着gradle wrapper，然后就还有 wrapper 的启动脚本。

关于这个 wrapper，他虽然很小，但是它可以调用来下载对应的 gradle 版本，帮你快速构建，免去手动下载安装 gradle 的麻烦。

这个 wrapper 执行的步骤大概是：先下载 dist 到本地，然后解压，最后使用这个 dist 来构建这个项目。的确有点意思

我的项目

这次实践的就是一个简单的井字棋了，大致原理也不是很难，所以就不多多解释了。这次的目的主要是：一些工具的学习与使用。

先搁出这个练手小项目的 github repo 吧: SimpleTicTacToeGame

从大致的目录结构中可以看出，里面有两个子项目:client和server，顾名思义，就是对应着客户端和服务端。setting.gradle搁在 root 下，而build.gradle搁在每个子项目文件夹里头，这符合了官方对这两个文件的解释。

里面用到的东西不是很多，我用 gradle 来管理自己的项目的最初想法，也就是想隔离开来方便管理而已，后来才想起用它来构建 jar。但是 dependencies 这个就没有碰过了。

这次我就用到了这些东西

  • 将 server 和 client 隔开来

要实现这个，我就需要用到子项目这个操作了，看了看官方对它的说明，我开始按葫芦画瓢。新建了文件夹server和client，然后每个下面放好build.gradle和文件夹src。最后，项目根目录下的setting.gradle如下所示

rootProject.name = 'SimpleTicTacToeGame'
include 'server', 'client'
  • 构建 jar 包

既然有 wrapper 了，官网查询一下命令。然后在命令行里头输入

./gradlew jar # for the whole project
#or
./gradlew client:jar # jar task for sub project client

这样就能在在 build 文件夹里头找到 jar 了，通过上述操作，命令大概也就是 ./gradlew <subproject>:<task> 或者 ./gradlew <task>吧

Groovy 语言

这也是一个跑在 JVM 上面的语言，还是一种脚本语言，动态语言…为什么要了解一下这个呢？因为 gradle 里面的 script 都用着 groovy 或者 kotlin 的 DSL(Domain-Specific Language)啊。不知道一些基础的话，写起来就奇奇怪怪的。

不过由于是 DSL，那么就不用完全了解过一遍这个语言，事实上有 java 的基础，迁移学习 groovy 是非常容易的，并且官方也给出了Groovy 与 Java 的差别

通过阅读，我大概发现了，要在 gradle 的配置文件里写，几点东西需要看看：

  • 默认 import 了一些常用包，比如java.lang.*也就是说可以不用System.out.print而是print即可
  • 初始化数组，对比一下，groovy 用的[]
//java
int[] a = {114, 514}; // or new int[]{114, 514}
//groovy
int[] a = [114, 514] //有py内味
List b = [1919, '810'] // powerful
  • 跟 Java 中的 Lambda 比较，这边叫做闭包 Closure 了，主要是 () ->变成了{ }，inner class 和 anonymous inner class 的写法跟 java 也差不多，但是…真香?

The implementation of anonymous inner classes and nested classes follow Java closely, but there are some differences, e.g. local variables accessed from within such classes don’t have to be final.

Runnable run = () -> System.out.println("Run");  // Java
list.forEach(System.out::println);

Runnable run = { println 'run' } //Groovy
list.each { println it } // or list.each(this.&println)
  • 自 Java7 开始出现的 ARM 也变了写法
//本来是 try(Scanner in = ...) {} 的
//But in Groovy
new File('/path/to/file').eachLine('UTF-8') {
   println it
}
  • == 变成equals()了（
  • 一些可能用到的新 keyword
it //in closure
def // def i = 1919810
var // var i = 1919810 (from Java)
in // (Python
  • pass 参数的时候，可以不需要带符号
print '114514'
new Thread().start { /** closure */ }
  • 多方法

groovy 动态，要运行的方法都是在运行时选择的，而不是像 Java 那样由 declared type 决定

int method(String arg) {
    return 1;
}
int method(Object arg) {
    return 2;
}
Object o = "Object";
int result = method(o);

java 运行就是2，Groovy 就是1

  • 字符串

就像这样，'i=${i}'，接触多了 js 应该不陌生

  • class 为一等公民

即 Class 可以忽略.class

  • with 操作对象

使用with，可以批量对一个对象进行操作

Test test = new Test()
test.with {
  ds = 114514
  sq = 1919810
}
  • 判断非 null
print obj?.id?.number
  • 范围
114..514 // 114(inclusive) to 514(inclusive)
  • switch

不仅可以是数字，字符，Enumerate，还可以是其他

switch (test) {
  case Integer:
  case [1, 14514, 'dssq']:
  case { it > 891 }:
  case 114..514:
}

继续学习

初步入手了这几个东西，现在或以后想要用的时候，就要去 gradle 的文档里头查 api 用了。（据说难度跟 CMake 一样，害怕