# 22.5 Java 开发环境
Java 作为跨平台编程语言的典范，其“一次编写，到处运行”的理念与 BSD 的可移植性设计理念形成了有趣的技术呼应。
## JDK
参见：java\[EB/OL]. \[2026-03-26]. . 这是 FreeBSD 官方 Java 开发环境配置指南。
### OpenJDK
搜索名称或描述中包含“jdk”的软件包：
```sh
# pkg search -o jdk
java/bootstrap-openjdk11 Java Development Kit 11
java/bootstrap-openjdk17 Java Development Kit 17
java/bootstrap-openjdk8 Java Development Kit 8
java/openjdk11 Java Development Kit 11
java/openjdk11-jre Java Runtime Environment 11
java/openjdk17 Java Development Kit 17
java/openjdk17-jre Java Runtime Environment 17
java/openjdk18 Java Development Kit 18
java/openjdk19 Java Development Kit 19
java/openjdk20 Java Development Kit 20
java/openjdk21 Java Development Kit 21
java/openjdk22 Java Development Kit 22
java/openjdk23 Java Development Kit 23
java/openjdk8 Java Development Kit 8
java/openjdk8-jre Java Runtime Environment 8
comms/rxtx Native interface to serial ports in Java
```
本文将以 `java/openjdk23` 为例。
### 安装 OpenJDK 23
使用 pkg 安装 OpenJDK 23：
```sh
# pkg install openjdk23
```
或者使用 ports 安装：
```sh
# cd /usr/ports/java/openjdk23
# make install clean
```
显示已安装 Java 的版本信息：
```sh
# java -version
openjdk version "23.0.2" 2025-01-21
OpenJDK Runtime Environment (build 23.0.2+7-1)
OpenJDK 64-Bit Server VM (build 23.0.2+7-1, mixed mode, sharing)
```
安装完成后尚未配置 `$JAVA_HOME` 环境变量，可使用以下命令查看其当前值：
```sh
# echo $JAVA_HOME
```
查看 OpenJDK 23 安装路径：
```sh
# ls /usr/local/openjdk23/
/usr/local/openjdk23/bin/ /usr/local/openjdk23/include/ /usr/local/openjdk23/lib/
/usr/local/openjdk23/conf/ /usr/local/openjdk23/jmods/ /usr/local/openjdk23/man/
/usr/local/openjdk23/demo/ /usr/local/openjdk23/legal/ /usr/local/openjdk23/release
```
相关文件结构：
```sh
/usr/local/
└── openjdk23/
├── bin/ # Java 可执行文件
├── include/ # C/C++ 头文件
├── lib/ # Java 库文件
├── conf/ # 配置文件
├── jmods/ # JMOD 模块文件
├── man/ # 手册页
├── demo/ # 示例程序
├── legal/ # 法律文件
└── release # 发布信息文件
```
### 配置环境变量
请读者根据自己的 Shell，选择合适的路径。
```sh
~/
├── .bashrc # Bash 配置文件
├── .profile # 通用配置文件
├── .shrc # FreeBSD 默认 sh 配置文件
└── .zshrc # Zsh 配置文件
```
将以下内容写入：
```ini
export JAVA_HOME="/usr/local/openjdk23" # 设置 JAVA_HOME 环境变量指向 OpenJDK 23 安装路径
export PATH=$JAVA_HOME/bin:$PATH # 将 JAVA_HOME/bin 添加到 PATH，确保 java 命令可用
```
刷新 shell 环境变量：
```sh
# . ~/.shrc # 重新加载 ~/.shrc 配置文件（注意前面的点表示 source）
# echo $JAVA_HOME # 显示当前 JAVA_HOME 环境变量值
/usr/local/openjdk23
# echo $PATH # 显示当前 PATH 环境变量值，包含 JAVA_HOME/bin
/usr/local/openjdk23/bin:/sbin:/bin:/usr/sbin:/usr/bin:/usr/local/sbin:/usr/local/bin:/root/bin
```
## Eclipse
### 安装 Eclipse
使用 pkg 安装：
```sh
# pkg install eclipse
```
或者使用 ports 安装：
```sh
# cd /usr/ports/java/eclipse
# make install clean
```
### 设置中文
点击菜单 `Help`，然后选择 `Install New Software`。
取消勾选 `Contact all update sites during install to find required software`，然后点击 `Add`：
清除 `Location` 原有内容，加入 ``。再点击 `Add`：
加载中：
勾选 `Babel Language Packs in Chinese (Simplified)`。点击 `Next`。
点击 `Next`。
同意协议：
建议先点击界面底部的任意位置，然后再进行全选，否则可能导致界面卡顿。
重启即可：
#### 参考文献
* Eclipse 2024.03 安装教程（附中文语言设置教程）\[EB/OL]. . 提供 Eclipse IDE 安装与中文本地化的详细步骤。
### HelloWorld
点击“创建 Java 项目”，项目名 test。
右键创建一个 `包`，再创建一个 `java 类`，名称 `test`。
在类文件中写入以下代码：
```java
package test;
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello World!");
}
}
```
点击绿色三角，即可看到输出。
#### 参考文献
* Eclipse 使用配置全面讲解\[EB/OL]. . 介绍 Eclipse IDE 的常用配置与开发技巧。
## IntelliJ IDEA
### 安装 IntelliJ IDEA Ultimate
使用 pkg 安装：
```sh
# pkg install intellij-ultimate
```
或者使用 ports 安装：
```sh
# cd /usr/ports/java/intellij-ultimate
# make install clean
```
### 查看安装后说明
```sh
# pkg info -D intellij-ultimate
intellij-ultimate-2024.3.1.1:
On install:
There is a native (faster) file watching support backed by kqueue which is
enabled by default. If you encounter problems with watching large
trees, you can disable it by adding the following property via the menu
entry Help -> Edit Custom Properties...
idea.filewatcher.disabled=true
有一个由 kqueue 支持的本地（更快的）文件监视功能，默认启用。如果你在监视大的文件树时遇到问题，可以通过菜单项 Help -> Edit Custom Properties... 添加以下属性来禁用它：
idea.filewatcher.disabled=true
```
***
系统默认启用了基于 kqueue 的内置（更快的）文件监视支持。若你监视大型目录结构时出现了问题，可以通过菜单路径 `Help`（帮助） -> `Edit Custom Properties...`（编辑自定义属性……）添加以下属性来禁用该功能：
```ini
idea.filewatcher.disabled=true
```
## 使用
在 FreeBSD 上使用时可能会出现报错“编辑器中的文件不可运行”，而 Windows 版本则正常。该问题已报告为 [Bug 285130 - Port java/intellij-ultimate always shows This file in the editor is not runnable](https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=285130)，记录 IntelliJ IDEA 在 FreeBSD 上的运行问题。
IntelliJ IDEA 社区版可以正常使用，但长期未更新，最新版本仍为 2020.2。
### 故障排除与未竟事宜
#### 提示“the file in the editor is not runnable”
该问题仍待解决。
## 课后习题
1. 配置 OpenJDK 23 开发环境，使用 Eclipse 创建一个简单的 Java Swing 程序并运行，验证中文显示。
2. 分析 IntelliJ IDEA 在 FreeBSD 上文件不可运行的 bug，尝试通过 Ports 构建不同版本复现并定位问题。
3. 对比 OpenJDK 与 Linux 兼容层 OracleJDK 在 FreeBSD 上的性能差异，分析兼容层带来的性能开销。