esolang/java

Java 编程语言 Docker 镜像

• Java 官方参考

该镜像属于 https://github.com/hakatashi/esolang-box 项目的一部分。

镜像概述

https://github.com/hakatashi/esolang-box 旨在通过 Docker 为多种（目前已支持 227 种！）编程语言提供简单且标准化的接口，尤其针对不常见的 深奥编程语言。

本镜像包含 Java 语言的实现和解释器，可通过简单命令 java 调用（该命令也是 script 命令的别名，两者可互换使用）。脚本接受标准输入作为程序输入，第一个参数作为程序代码文件，输出结果将打印至标准输出。此约定在 https://hub.docker.com/u/esolang/ 中通用，便于轻松切换使用其他语言。

核心功能和特性

• 提供 Java 语言的运行环境，支持通过 java 或 script 命令执行代码
• 统一接口设计，与其他 esolang-box 镜像操作方式一致
• 支持标准输入作为程序输入，文件路径作为代码参数
• 输出结果直接打印至标准输出，便于集成和处理
• 支持通过 strace 追踪 execve 和 execveat 系统调用（需配置环境变量和权限）

使用场景和适用范围

• 快速执行 Java 脚本文件
• 处理需要标准输入的 Java 程序
• 调试 Java 代码（通过交互式 shell）
• 分析 Java 程序的系统调用行为（通过 strace 追踪）

使用方法和配置说明

运行单个 Java 脚本

假设当前目录下有 hello.java 文件，内容如下：

java
public class A {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

执行以下命令运行该脚本：

bash
$ docker run --rm -v "$PWD":/code:ro esolang/java java /code/hello.java
Hello, World!

处理输入

通过标准输入为程序提供输入：

bash
$ docker run -i --rm -v "$PWD":/code:ro esolang/java java /code/hello.java < input.txt

使用 shell 调试代码

进入交互式 shell 环境调试代码：

bash
$ docker run -it --rm -v "$PWD":/code:ro esolang/java sh
# java /code/hello.java
Hello, World!

观察 exec 系统调用的使用

esolang-box 2.4.0 支持通过 strace 命令追踪 execve 和 execveat 系统调用。设置 STRACE_OUTPUT_PATH 环境变量并启用 ptrace 权限，可将 strace 日志输出至指定路径：

bash
$ docker run --cap-add=SYS_PTRACE --rm -v "$PWD":/code --env STRACE_OUTPUT_PATH=/code/strace.txt esolang/java java /code/hello.java
Hello, World!

注意事项：

• https://bugs.chromium.org/p/project-zero/issues/detail?id=1718 使用 --cap-add=SYS_PTRACE 时需格外谨慎（尤其不应在 Xenial 系统中使用）。
• 使用 strace 会带来显著性能开销，系统调用速度可能降低 10 倍。