软件研发 --- hello world 项目 之 java扩展 groovy
https://gitee.com/null_465_7266/groovy4helloworld
Groovy Hello World 项目
这是一个最小化的 Groovy Hello World 项目,用于演示 Groovy 的基本使用方法。
环境安装
1. 安装 Java
Groovy 需要 Java 运行环境,建议使用 Java 11 或更高版本。
Windows 系统
方法一:使用 Oracle JDK
-
下载 JDK
- 访问 Oracle JDK 下载页面
- 选择适合 Windows 的 JDK 版本(推荐 JDK 17 或 21)
- 下载
.msi安装包
-
安装 JDK
- 双击下载的
.msi文件 - 按照安装向导完成安装
- 默认安装路径:
C:\Program Files\Java\jdk-<version>
- 双击下载的
方法二:使用 OpenJDK
# 使用 Chocolatey
choco install openjdk
# 使用 Scoop
scoop install openjdk
方法三:使用 SDKMAN(推荐)
# 安装 SDKMAN
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
# 安装 Java
sdk install java 17.0.8-tem
macOS 系统
# 使用 Homebrew
brew install openjdk@17
# 使用 SDKMAN
curl -s "https://get.sdkman.io" | bash
sdk install java 17.0.8-tem
Linux 系统
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-17-jdk
# CentOS/RHEL
sudo yum install java-17-openjdk-devel
# 使用 SDKMAN
curl -s "https://get.sdkman.io" | bash
sdk install java 17.0.8-tem
2. 安装 Groovy
Windows 系统
方法一:使用 SDKMAN(推荐)
# 如果已安装 SDKMAN
sdk install groovy
方法二:手动安装
-
下载 Groovy
- 访问 Groovy 官网
- 下载最新的二进制发行版(.zip 文件)
-
解压和配置
- 解压到
C:\groovy目录 - 添加环境变量:
GROOVY_HOME:C:\groovy- 在
PATH中添加:%GROOVY_HOME%\bin
- 解压到
方法三:使用包管理器
# 使用 Chocolatey
choco install groovy
# 使用 Scoop
scoop install groovy
macOS 系统
# 使用 Homebrew
brew install groovy
# 使用 SDKMAN
sdk install groovy
Linux 系统
# 使用 SDKMAN(推荐)
sdk install groovy
# Ubuntu/Debian(手动安装)
wget https://archive.apache.org/dist/groovy/4.0.15/distribution/apache-groovy-binary-4.0.15.zip
unzip apache-groovy-binary-4.0.15.zip
sudo mv groovy-4.0.15 /opt/groovy
echo 'export GROOVY_HOME=/opt/groovy' >> ~/.bashrc
echo 'export PATH=$PATH:$GROOVY_HOME/bin' >> ~/.bashrc
source ~/.bashrc
3. 验证安装
安装完成后,验证 Java 和 Groovy 是否正确安装:
步骤 1:检查 Java 版本
java -version
javac -version
预期输出示例:
java version "17.0.8" 2023-07-18 LTS
Java(TM) SE Runtime Environment (build 17.0.8+9-LTS-211)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+9-LTS-211, mixed mode, sharing)
步骤 2:检查 Groovy 版本
groovy -version
预期输出示例:
Groovy Version: 4.0.15 JVM: 17.0.8 Vendor: Eclipse Adoptium OS: Windows 10
步骤 3:检查环境变量(Windows)
echo $env:JAVA_HOME
echo $env:GROOVY_HOME
echo $env:PATH | Select-String "groovy"
项目结构
groovy-hello-world/
├── HelloWorld.groovy # 主程序文件
├── build.gradle # Gradle 构建文件(可选)
└── GROOVY_README.md # 项目说明文档
代码说明
HelloWorld.groovy
这是主程序文件,包含两种 Hello World 的实现方式:
// 最简单的方式 - 直接执行
println "Hello, World!"
// 传统的类方式
class HelloWorld {
static void main(String[] args) {
println "Hello from Groovy class!"
}
}
build.gradle(可选)
如果您想使用 Gradle 构建工具,这个文件定义了项目的依赖和构建配置。
编译和运行
方法一:直接运行 Groovy 脚本(推荐)
# 运行 Groovy 脚本
groovy HelloWorld.groovy
这是最简单的方式,Groovy 会自动编译并运行脚本。
方法二:编译为 Java 字节码
# 编译 Groovy 文件为 .class 文件
groovyc HelloWorld.groovy
# 运行编译后的类文件
java -cp ".;%GROOVY_HOME%\lib\*" HelloWorld
注意:
- Windows 使用分号
;分隔路径 - Linux/macOS 使用冒号
:分隔路径
方法三:使用 Gradle(如果有 build.gradle)
# 初始化 Gradle 项目(首次运行)
gradle wrapper
# 运行应用程序
./gradlew run
# 或者运行脚本任务
./gradlew runScript
方法四:交互式 Groovy Shell
# 启动 Groovy 交互式 shell
groovysh
# 在 shell 中输入代码
groovy:000> println "Hello, World!"
Hello, World!
方法五:使用 Groovy Console(图形界面)
# 启动 Groovy Console
groovyConsole
这会打开一个图形界面,您可以在其中编写和运行 Groovy 代码。
常用 Groovy 命令
groovy <文件名>- 运行 Groovy 脚本groovyc <文件名>- 编译 Groovy 文件groovysh- 启动交互式 shellgroovyConsole- 启动图形界面控制台groovy -version- 查看版本信息groovy -help- 查看帮助信息
预期输出
运行程序后,您应该看到以下输出:
Hello, World!
Hello from Groovy class!
Groovy 特性示例
创建一个更丰富的示例文件 GroovyFeatures.groovy:
// 变量定义(动态类型)
def name = "Groovy"
def version = 4.0
// 字符串插值
println "Welcome to ${name} ${version}!"
// 列表操作
def numbers = [1, 2, 3, 4, 5]
println "Numbers: ${numbers}"
println "Doubled: ${numbers.collect { it * 2 }}"
// 映射(Map)
def person = [name: "Alice", age: 30, city: "Beijing"]
println "Person: ${person}"
// 闭包(Closure)
def greet = { name -> "Hello, ${name}!" }
println greet("World")
// 简化的类定义
class Person {
String name
int age
String toString() {
"Person(name: ${name}, age: ${age})"
}
}
def p = new Person(name: "Bob", age: 25)
println p
下一步
现在您已经成功创建并运行了第一个 Groovy 程序!您可以:
- 学习 Groovy 的语法特性(闭包、动态类型、元编程等)
- 探索 Groovy 的标准库和 GDK(Groovy Development Kit)
- 尝试使用 Groovy 进行脚本编写、构建自动化或 Web 开发
- 学习 Grails 框架进行 Web 应用开发
- 探索 Groovy 官方文档:http://groovy-lang.org/documentation.html
故障排除
Windows 常见问题
-
"groovy 不是内部或外部命令" 错误
'groovy' 不是内部或外部命令,也不是可运行的程序或批处理文件。解决方案:
- 检查 Groovy 是否正确安装
- 验证环境变量
GROOVY_HOME和PATH设置 - 重启命令提示符或 PowerShell
- 重新安装 Groovy
-
Java 版本不兼容
Unsupported major.minor version解决方案:
- 确保 Java 版本为 11 或更高
- 检查
JAVA_HOME环境变量 - 更新 Java 到兼容版本
-
环境变量配置问题 手动配置环境变量:
- 按
Win + R,输入sysdm.cpl - 点击"高级" → "环境变量"
- 添加系统变量:
JAVA_HOME: Java 安装路径GROOVY_HOME: Groovy 安装路径
- 编辑
PATH变量,添加:%JAVA_HOME%\bin%GROOVY_HOME%\bin
- 按
-
编码问题
# 如果遇到中文字符编码问题 groovy -Dfile.encoding=UTF-8 HelloWorld.groovy -
权限问题
- 以管理员身份运行命令提示符
- 检查文件和目录的读写权限
通用问题
-
编译错误
- 检查 Groovy 语法是否正确
- 确保文件编码为 UTF-8
- 验证类名与文件名是否匹配
-
依赖问题
# 检查 Groovy 类路径 groovy -cp "lib/*" HelloWorld.groovy -
版本兼容性
# 检查 Groovy 和 Java 版本兼容性 groovy -version java -version
获取帮助
如果遇到其他问题:
- 官方文档:http://groovy-lang.org/documentation.html
- Groovy 用户邮件列表:http://groovy-lang.org/mailing-lists.html
- Stack Overflow:搜索 "groovy" 标签
- GitHub Issues:https://github.com/apache/groovy/issues
- Groovy 社区:http://groovy-lang.org/community.html
性能优化建议
-
使用 @CompileStatic 注解
import groovy.transform.CompileStatic @CompileStatic class FastHelloWorld { static void main(String[] args) { println "Hello, World!" } } -
预编译脚本
# 编译为字节码以提高启动速度 groovyc HelloWorld.groovy -
使用 Grape 管理依赖
@Grab('commons-lang:commons-lang:2.6') import org.apache.commons.lang.StringUtils println StringUtils.capitalize("hello world")
完全重新安装
如果问题无法解决,可以完全重新安装:
# 卸载现有安装(如果使用 Chocolatey)
choco uninstall groovy
choco uninstall openjdk
# 清理环境变量
# 手动删除 JAVA_HOME, GROOVY_HOME 和 PATH 中的相关条目
# 重新安装
choco install openjdk17
choco install groovy
# 验证安装
java -version
groovy -version
浙公网安备 33010602011771号