(rontolisp) docs

Java 言語のサブセット(実験的)

実験的。 rontolisp は Java 言語のサブセットを読み、Common Lisp と同じコアフォームに 変換します。そのため .java のプログラムはどのバックエンドでも動きます。サブセットであることは 設計上の選択で、ここにあるものは互換性の保証ではありません。サブセットにない構文は、 プログラムを実行する前に、構文の名前と位置を示して拒否します。フロントエンドとライブラリは 公開されている仕様から rontolisp のために書いたものです。JDK のコードは読み込まず、同梱せず、 コンパイルしたプログラムにも含めません。

.java のファイルはこのサブセットとして読まれます。それ以外のファイルと -e では --source-language java で指定します。プログラムは、開始するファイルと、そのファイルが名前を 挙げるソースツリー内のファイル、それにソースパス上のライブラリのうちプログラムが到達する部分です (ライブラリを使う)。

rontolisp Hello.java                                # interpreter
rontolisp Hello.java -o Hello.class && java Hello   # JVM
rontolisp Hello.java -o hello.wasm && wasmtime run hello.wasm
rontolisp Hello.java -o hello-c.wasm --component && wasmtime run hello-c.wasm
rontolisp -e 'void main() { IO.println(1 + 2); }' --source-language java

--no-gc は拒否されます。そのバックエンドには構造体も文字列もクロージャもないからです。 プログラムを与えずに --source-language java を指定すると REPL が起動します (プロンプトで)。

examples/java/ に、 複数のパッケージからなるプログラムとその期待される出力、HTTP サーバーとその クライアント、小さな httpbin、およびソース jar から読んだライブラリでフォームを検証する プログラムがあります。

circle 1.5, 2 shapes, total 11.068583470577035
-2147483648

プログラムの開始位置

ファイルの最初のクラスに main があればそのクラスから、なければファイルと同じ名前のクラスから 始まります。main() より main(String[]) が優先されます。インスタンスメソッドの main は、 引数のないコンストラクタで作ったインスタンスに対して呼ばれます。引数の配列は空です。 トップレベルにメソッドやフィールドを書いたファイルはコンパクトソースファイルです。それらは 1 つのクラスのメンバーになり、ライブラリのクラスはすべて import なしで使えます。同じファイルに 書いたクラスも、そのクラスのメンバーになります。static を付けたクラス、レコード、列挙型、 インターフェース以外は内部クラスです。

複数ファイルのプログラム

プログラムが名前を挙げたクラスを、それまでに読んだどのファイルも宣言していなければ、 ソースツリーのルートの下で、そのクラスのパッケージと名前が示すファイルから読みます。ルートは、 開始するファイルのパッケージが示すディレクトリの上です。package app; を宣言する app/Main.java では、util.Strings は util/Strings.java、パッケージ app の Helper は app/Helper.java です。読んだファイルのクラスはすべてプログラムに加わり、プログラム全体を まとめてコンパイルします。開始するファイルの上のディレクトリは、そのパッケージと一致して いなければなりません。Common Lisp から (load "app/Main.java") すると、 rontolisp app/Main.java と同じようにプログラムを実行します(言語をまたぐ呼び出し)。

$ rontolisp app/Main.java
$ rontolisp app/Main.java -o main.wasm

import には、クラス、オンデマンドのパッケージ、module java.base(java.sql を除く ライブラリのすべてのクラス)、module java.sql を指定できます。オンデマンドのパッケージは モジュールのインポートより優先します。同じ種類の 2 つのパッケージが同じ名前を持ち込むと、 その名前は拒否されます(reference to Date is ambiguous)。static を付けると、クラスの static メンバー 1 つ、またはオンデマンドで そのすべてを指定できます。public でないクラスとアクセス修飾子のないメンバーには、同じ パッケージからだけアクセスできます。protected のメンバーには、同じパッケージと、そのクラスの サブクラスからアクセスできます。

ライブラリを使う

プログラムが名前を挙げたクラスをソースツリーが宣言していなければ、次にプログラムの ソースパスから読みます。ソースパスは、使うライブラリのルートをソースのまま並べたものです。 ライブラリは、プログラムが到達した範囲だけを、どのバックエンドでもプログラムと一緒に コンパイルします。出力の横に置くものはなく、.wasm はライブラリのうち使う部分を含みます。

$ rontolisp app/Main.java --java-source-path libs/geo-sources.jar:other/src/main/java
$ rontolisp app/Main.java --java-source-dep org.example:geo:1.2.0 -o main.wasm
  • --java-source-path には、ディレクトリと jar をクラスパスと同じ区切りで並べます。クラス geo.Table は、最初にそれを持つルートの下の geo/Table.java です。
  • --java-source-dep には Maven 座標を指定します。繰り返し指定できます。そのライブラリの ソース jar(geo-1.2.0-sources.jar)と、それが実行時に依存するもののソース jar が、 Maven Central から ~/.m2/repository を経由してソースパスに加わります。 --java-repository でリポジトリを追加できます。指定したライブラリがソース jar を公開して いなければ拒否します。依存先がソース jar を公開していない場合は警告にとどめ、そのクラスは 無いものとして扱います。

examples/java/yavi には、YAVI(--java-source-dep am.ik.yavi:yavi:0.18.0)を使うプログラムが 2 つあり、どの バックエンドでも動きます。1 つはレコードを検証し、もう 1 つはスキーマでマップからレコードを 読み取ります。

これは --java-classpath や --java-dep とは別のものです。そちらは Common Lisp や Clojure の java: 呼び出しのためにホストが実行するクラスファイルで、Java サブセットのプログラムは それを呼びません。

ライブラリが動くかどうかは、プログラムがそのどこに到達するかで決まります。コンパイルするのは、 呼び出したメソッド、インスタンスを作ったクラス、使った static 初期化だけで、それぞれに プログラム自身のコードと同じ検査をします。したがって、プログラムが使う部分がサブセットと このページに挙げたライブラリクラスの範囲に収まっていれば、そのライブラリは動きます。 プログラムが到達した先にサブセットに無いものがあれば、ライブラリ内のその位置のエラーになり、 プログラムからそこへ至る経路を添えます。

geo-sources.jar!/geo/Table.java:42:54: the class java.util.Currency is not supported by the experimental Java subset yet
  reached through geo.Table.column(String,geo.Table.ToMoney)

ライブラリが宣言の中でだけ名前を挙げるクラス(プログラムが呼ばないメソッドの引数の型など)は 素通りします。ライブラリ内のアノテーションは、その型がソースパスに無ければ読み飛ばします。 コンパイラがクラスファイルをその型なしで読むのと同じで、アノテーションだけの依存は無くても かまいません。別のクラスの名前のファイルに宣言されたクラスは、そのファイルを読んだ後で 見つかります。同じ名前のファイルがプログラムのソースツリーとソースパスの両方にあれば、 プログラムのものを使います。

プロンプトで

プログラムを与えずに --source-language java を指定したときと、プレイグラウンドで Java を 選んだときは、バッファを 1 つずつ読みます。バッファに書けるのは、文、式、変数、メソッド、 クラス、import です。文の ; は省略できます。式の値は $1、$2、... という生成された名前で 表示され、後のバッファはその名前で式の型のまま値を読めます。変数の値はその変数の名前で 表示されます。文字列と char はリテラルの形で、配列は型と要素で表示されます。

java> int twice(int n) { return 2 * n; }
java> int quad(int n) { return twice(twice(n)); }
java> quad(1)
$1 ==> 4
java> int twice(int n) { return n + 1; }
java> quad(1)
$2 ==> 3
java> var names = new String[] { "a", "b" }
names ==> String[2] { "a", "b" }
java> 1 / 0
Error: Exception java.lang.ArithmeticException: / by zero

宣言は、同じ名前(メソッドは名前と引数の型)の以前の宣言を置き換えます。以前に宣言したものは 新しい宣言を呼びます。後から加えたメソッド、オーバーライド、サブクラスにも、すべての呼び出しが 届きます。クラスの static フィールドは、そのクラスを宣言し直すまで値を保ちます。宣言し直すと、 そのクラスを型に含む変数は null になります。セッションはソースツリーのファイルを読みません。 ソースパス上のライブラリのクラスは、プログラムと同じように読みます。 プレイグラウンドにはソースパスがありません。

言語をまたぐ呼び出し

Common Lisp のプログラムは .java ファイルを load できます。main のあるファイルは main を 実行します。main のないファイルはクラスを定義するだけで、何も実行しません。static メソッドは、 クラス名、メソッド名、引数の型からなる名前の関数です。たとえば |Geometry.area(int)|、 パッケージ内なら |app.Geometry.area(int)|、コンストラクタなら |Point.new(int,int)| です。 Java プログラムの native な static メソッドは、名前の各大文字の前にハイフンを入れた名前の Common Lisp 関数です。stringUpcase は string-upcase で、プログラムを load したパッケージで 読まれます。

$ cat Geometry.java
record Point(int x, int y) { }

class Geometry {
    static native int square(int n);
    static native String stringUpcase(String s);

    static int norm2(Point p) {
        return square(p.x()) + square(p.y());
    }

    static String shout(String s) {
        return stringUpcase(s) + "!";
    }
}
$ cat main.lisp
(defun square (n) (* n n))
(load "Geometry.java")
(print (|Geometry.norm2(Point)| (|Point.new(int,int)| 3 4)))
(print (|Geometry.shout(String)| "hi"))
$ rontolisp main.lisp
25
"HI!"

値は変換しません。例外は 2 つだけで、char は文字として渡り、boolean は T か NIL として 戻ります。数値は数値、文字列は文字列、null は NIL、プログラムのオブジェクトは構造体、 Object[] はベクタです。Common Lisp のリストは List ではありません。Java のメソッドには ベクタを渡します。

ツール

rontolisp test は .java ファイルを拒否します。このサブセットにはテストフレームワークがなく、 プログラムの終了ステータスがそのまま結果になるからです。rontolisp format も拒否します。 このコマンドが整形するのは S 式です。

Maven プロジェクト

rontolisp-maven-plugin の wasm ゴールは、Maven プロジェクトの src/main/java にある プログラムを、メインクラスから始めて package で WebAssembly にコンパイルします。同じソースは 引き続き javac がコンパイルし、そのテストは surefire が実行するので、プログラムは JDK でも 動きます。

<plugin>
    <groupId>am.ik.rontolisp</groupId>
    <artifactId>rontolisp-maven-plugin</artifactId>
    <version>VERSION</version>
    <configuration>
        <mainClass>app.Main</mainClass>
    </configuration>
    <executions>
        <execution>
            <id>preview1</id>
            <goals><goal>wasm</goal></goals>
        </execution>
        <execution>
            <id>component</id>
            <goals><goal>wasm</goal></goals>
            <configuration>
                <component>true</component>
                <outputFile>${project.build.directory}/app-component.wasm</outputFile>
            </configuration>
        </execution>
    </executions>
</plugin>
$ mvn package
$ wasmtime run target/app-1.0.0.wasm
$ wasmtime run target/app-component.wasm
  • プログラムは rontolisp src/main/java/app/Main.java -o target/app-1.0.0.wasm がコンパイル するものと同じです。メインクラスのファイルと、それが名前を挙げるツリー内のファイルです (複数ファイルのプログラム)。
  • 出力は outputFile で別の名前を指定しない限り target/<finalName>.wasm です。 <native>true</native> はネイティブ実行ファイル target/<finalName> を書き出します。
  • パラメータはコマンドラインのフラグをキャメルケースにしたものです: component、noWasi、 optimize、simd、hostRandom、hostFetch、reentrant、hostBoundary、 reportLocations、emitWit、emitJsGlue、native、nativeTarget、nativeCpu、 dynamic、noPrune、warningsAsErrors、javaSourcePath。skip (-Drontolisp.skip=true)でゴールを無効にします。
  • フロントエンドが読むのはソースで、クラスファイルではありません(ライブラリを使う)。 スコープが compile、provided、system の各依存について、その sources jar をプロジェクトの リポジトリから取得し、ソースパスに加えます。順序は <javaSourcePath> に並べたディレクトリと jar の後です。sources jar のない依存は警告になり、プログラムがそのクラスを名指しすると、 ゴールはその名前と位置を示して失敗します。そうした jar の @Nullable なら .../app/Main.java:7:9: cannot find symbol: class Nullable です。
  • 前回のビルドより新しいファイル(ツリーとソースパス上のディレクトリの .java ファイル、 ソースパス上の jar)がなく、追加も削除もなく、パラメータとソースパスが同じで出力が存在する ときは、何もコンパイルしません。そうでなければプログラム全体をコンパイルします。
  • component でビルドした HTTP サーバーは、target/ から wasmtime serve で 動きます。

読める構文

型int、long、short、byte、char、double、float、boolean、String、クラス、インターフェース、列挙型、レコード、配列。ローカル変数の var。型引数、ワイルドカード(?、? extends T、? super T)、raw 型。型パラメータを持つクラスの内部クラス(Outer<String>.Inner)
宣言extends と implements を持つクラス、抽象クラスと抽象メソッド。型パラメータとその境界を持つクラス、インターフェース、レコード、メソッド。フィールド、コンストラクタ、メソッド、本体付きの定数を持つ列挙型。コンパクトコンストラクタと標準コンストラクタを持つレコード。抽象メソッド、default メソッド、static メソッド、private メソッド、定数を持つインターフェース。sealed、permits、non-sealed。static なネストクラス、内部クラス、ローカルクラス、匿名クラス。フィールド、static フィールド、上位クラスのフィールドを隠すフィールド、static 初期化ブロックとインスタンス初期化ブロック。this(..)、super(..)、outer.super(..)、およびその前の文を持つコンストラクタ。メソッドのオーバーロードと可変長引数。synchronized メソッドと volatile フィールド。package と import
文ローカル変数(final、無名変数 _)、if、while、do、for、配列または Iterable に対する拡張 for、コロン形式または矢印形式の case・パターン・ガードを持つ switch、ラベル付きの文、ラベルの有無を問わない break と continue、yield、return、throw、catch(1 つまたは複数の型)と finally を持つ try、try-with-resources、オブジェクトまたはクラスリテラルに対する synchronized
式プリミティブ型のすべての演算子とその変換、文字列連結、条件演算子、代入と複合代入、キャスト(複数の型への (A & B) x も、ラムダとメソッド参照のものも)、型・型パターン・レコードパターンに対する instanceof、switch 式、コンストラクタの型引数の有無を問わない new(new <T>Box(..))、クラス本体の有無を問わない outer.new Inner()、Outer.this、長さを 1 つ以上指定する配列の生成と初期化子、テキストブロック、型引数の有無を問わないメソッド呼び出し、super.m(..)、フィールドを読み書きする super.x、Interface.super.m(..)、Outer.super.m(..)、クラス本体の有無を問わない new Box<>(..)、任意の関数型インターフェースに対するラムダとメソッド参照(Type::name、expression::name、super::name、Type::new、int[]::new、List<String>::size、Type::<T>name、Type::<T>new)

アノテーションは、宣言に付いたものも型に付いたもの(List<@Label String>)も読み飛ばします。 ただし @Override と @FunctionalInterface はコンパイラと同じように検査し、 @SuppressWarnings("unchecked") と @SafeVarargs は下記の警告を抑止します。アノテーションの 名前は、そのファイルから見えるアノテーション型のものでなければなりません。java.lang と java.lang.annotation のもの、プログラムやライブラリが @interface で宣言したものがそれに あたります。それ以外の名前はコンパイラと同じように拒否します。実行時にアノテーションを読む ものはありません。int、long、short、byte は 2 の補数として桁あふれします。 float は演算のたびに単精度へ丸めます。double と float は、読み戻すとその型の同じ値になる 最短の文字列で表示されます。

Circle[r=1.0] is a shape of area 3.141592653589793
Rect[w=2.0, h=2.0] is a square of area 4.0
Rect[w=2.0, h=3.0] is a shape of area 6.0
CM 0 1 small
M 1 100 large

unchecked の警告

コンパイラが unchecked と警告するもの(raw 型を通したメンバーの呼び出し、raw 型から型引数付きの 型への変換、実行時に検査しきれないキャスト、実行時に検査しきれない型の可変長引数)は、プログラムの 実行前に、コンパイラと同じ形式で標準エラーに表示します。コンパイル(-o)ではコンパイル時に 表示し、コンパイルしたプログラムは何も表示しません。@SuppressWarnings("unchecked") を付けた 宣言の中では警告しません。try が投げる例外のうち受け取れるものを、前の catch 節がすべて 受け取っている catch 節も、同じ形式で警告します(unreachable catch clause)。

[ann]

Raw.java として実行すると、その前に標準エラーへ次を表示します。

Raw.java:3: warning: [unchecked] unchecked call to add(E) as a member of the raw type List
    names.add("ann");
             ^
  where E is a type-variable:
    E extends Object declared in interface List
1 warning

型パラメータ、ラムダ、メソッド参照

型パラメータは、プログラムを読む間だけ存在します。呼び出しと new Box<>(..) の型引数は、 引数、値が求められている型、引数にあるラムダから決まります。型引数がボックスになる箇所では、 値をボクシングまたはアンボクシングします。ラムダとメソッド参照は、抽象メソッドを 1 つ持つ インターフェースであれば、プログラムのものでもライブラリのものでも作れます。

[4, 3, 6] Pair[first=pear, second=6] Pair[first=pear, second=9.0]
1 [false, false, true]

ライブラリ

各クラスにあるメンバーは次の表のものだけです。表にないクラスとメンバーは名前を示して拒否します。 String、StringBuilder、ボックス、Math、System、IO はフロントエンドの一部です。 それ以外のクラスはこのサブセット自身で書かれていて、プログラムが使う部分だけがプログラムと 一緒にコンパイルされます。そのため、プログラムのクラスはライブラリのクラスを継承または実装 できます(AbstractList、Iterable、Comparator)。

クラスメンバー
Objectnew Object()、toString、equals、hashCode、getClass()、wait()、wait(long)、notify、notifyAll
Classクラスリテラル(Name.class、int.class、String[].class、void.class)と getClass()。getName、getSimpleName、getCanonicalName、getTypeName、getPackageName、getSuperclass、getComponentType、isInstance、cast、isAssignableFrom、isInterface、isArray、isPrimitive、isEnum、isRecord、getEnumConstants、toString、equals、hashCode
列挙型values()、valueOf(String)、Enum.valueOf(Class, String)、name、ordinal、compareTo、getDeclaringClass、toString
レコードアクセサ、equals、hashCode、toString
配列length、clone()
Stringlength、charAt、isEmpty、isBlank、equals、equalsIgnoreCase、compareTo、compareToIgnoreCase、hashCode、substring、subSequence、開始位置の指定がある、またはない、文字列または文字の indexOf と lastIndexOf、範囲を取る indexOf、codePointAt、codePointBefore、codePointCount、offsetByCodePoints、regionMatches、contentEquals、getChars、indent、contains、startsWith、endsWith、toUpperCase、toLowerCase、trim、strip、stripLeading、stripTrailing、repeat、replace、replaceAll、replaceFirst、matches、concat、toCharArray、split、intern、formatted、引数なし、Charset、文字セットの名前を取る getBytes、Locale を取る toUpperCase と toLowerCase。String.valueOf、String.copyValueOf、String.join、Locale の指定がある、またはない String.format、String.CASE_INSENSITIVE_ORDER。new String()、new String(String)、new String(char[])、new String(char[], int, int)、範囲と、Charset または文字セットの名前を指定できる new String(byte[])、chars、codePoints、lines
StringBuilder、StringBuffer引数なし、容量、文字列を取るコンストラクタ。値、または文字列か char[] の範囲を取る append、insert、reverse、setLength、setCharAt、deleteCharAt、delete、replace、開始位置の指定がある、またはない indexOf と lastIndexOf、appendCodePoint、文字列またはコードポイントを取る repeat、compareTo、toString、length、isEmpty、charAt、substring、subSequence、chars、codePoints
CharSequencelength、charAt、subSequence、isEmpty、chars、codePoints。String と StringBuilder は CharSequence です
AppendableCharSequence、その範囲、char を取る append。StringBuilder、Writer、PrintStream は Appendable です
Integer、Longボクシングとアンボクシング。MAX_VALUE、MIN_VALUE、SIZE、BYTES、基数の指定がある、またはない parseInt / parseLong、valueOf、decode、基数の指定がある、またはない toString、toBinaryString、toHexString、toOctalString、基数の指定がある、またはない Integer.parseUnsignedInt と Long.parseUnsignedLong、基数の指定がある、またはない toUnsignedString、Integer.toUnsignedLong、divideUnsigned、remainderUnsigned、compareUnsigned、highestOneBit、lowestOneBit、numberOfLeadingZeros、numberOfTrailingZeros、reverse、reverseBytes、rotateLeft、rotateRight、compare、signum、sum、max、min、bitCount、hashCode、intValue、longValue、doubleValue、compareTo
Byte、Shortボクシングとアンボクシング。MAX_VALUE、MIN_VALUE、SIZE、BYTES、基数の指定がある、またはない parseByte / parseShort、valueOf、toString、compare、hashCode、toUnsignedInt、byteValue / shortValue、intValue、longValue、floatValue、doubleValue、compareTo
FloatMAX_VALUE、MIN_VALUE、MIN_NORMAL、MAX_EXPONENT、MIN_EXPONENT、SIZE、BYTES、POSITIVE_INFINITY、NEGATIVE_INFINITY、NaN、parseFloat、valueOf、toString、toHexString、compare、hashCode、floatToIntBits、floatToRawIntBits、intBitsToFloat、isNaN、isInfinite、isFinite、sum、max、min、floatValue、doubleValue、intValue、longValue、compareTo
DoubleMAX_VALUE、MIN_VALUE、MIN_NORMAL、MAX_EXPONENT、MIN_EXPONENT、SIZE、BYTES、POSITIVE_INFINITY、NEGATIVE_INFINITY、NaN、parseDouble、valueOf、toString、toHexString、compare、hashCode、doubleToLongBits、doubleToRawLongBits、longBitsToDouble、isNaN、isInfinite、isFinite、sum、max、min、intValue、longValue、doubleValue、compareTo
Boolean、CharacterBoolean.TRUE、FALSE、parseBoolean、valueOf、toString、hashCode、compare、logicalAnd、logicalOr、logicalXor、booleanValue、compareTo。Character.MAX_VALUE、MIN_VALUE、valueOf、toString、compare、hashCode、isDigit、isLetter、isLetterOrDigit、isAlphabetic、isWhitespace、isSpaceChar、isUpperCase、isLowerCase、toUpperCase、toLowerCase、getNumericValue、digit、forDigit、charValue、compareTo。getType と一般カテゴリの定数、isTitleCase、isDefined、isMirrored、isIdeographic、isISOControl、isJavaIdentifierStart、isJavaIdentifierPart、isUnicodeIdentifierStart、isUnicodeIdentifierPart、isIdentifierIgnorable、isEmoji、isEmojiPresentation、isEmojiModifier、isEmojiModifierBase、isEmojiComponent、isExtendedPictographic。判定はどれも char とコードポイントのどちらも取ります。書き込み先の配列の指定がある、またはない、コードポイントを取る toChars、配列を取る codePointAt、reverseBytes、コードポイントを取る toString、charCount、isValidCodePoint、isBmpCodePoint、isSupplementaryCodePoint、isHighSurrogate、isLowSurrogate、isSurrogate、isSurrogatePair、toCodePoint、highSurrogate、lowSurrogate。MIN_RADIX、MAX_RADIX、SIZE、BYTES、MIN_CODE_POINT、MAX_CODE_POINT、MIN_SUPPLEMENTARY_CODE_POINT とサロゲートの範囲の定数
NumberintValue、longValue、floatValue、doubleValue、byteValue、shortValue。Number を継承するクラス(先頭の 4 つを宣言します)
Math、StrictMathPI、E、TAU、abs、max、min、sqrt、cbrt、pow、exp、log、log10、floor、ceil、rint、round、signum、sin、cos、tan、asin、acos、atan、atan2、sinh、cosh、tanh、hypot、toRadians、toDegrees、floorDiv、floorMod、random、addExact、subtractExact、multiplyExact、negateExact、toIntExact、absExact、incrementExact、decrementExact、divideExact、floorDivExact、ceilDivExact、ceilDiv、ceilMod、clamp、multiplyFull、multiplyHigh、unsignedMultiplyHigh、log1p、expm1、IEEEremainder、copySign、getExponent、nextAfter、ulp、nextUp、nextDown、fma、scalb
Systemout、err(どちらも PrintStream)、in(InputStream)、currentTimeMillis、nanoTime、exit、arraycopy、identityHashCode、lineSeparator、既定値の指定がある、またはない getProperty、名前を取る getenv、gc
RuntimeRuntime.getRuntime、availableProcessors、gc、exit、halt
IOprintln、print、readln
InputStream、OutputStream1 バイトまたは配列への read、readAllBytes、readNBytes、skip、skipNBytes、available、mark、reset、markSupported、transferTo、close、InputStream.nullInputStream。1 バイトまたは配列の write、flush、close、OutputStream.nullOutputStream。プログラムのクラスはどちらも継承できます
ByteArrayInputStream、ByteArrayOutputStreambyte[] またはその範囲を対象にします。toByteArray、size、reset、writeTo、writeBytes、文字セットの指定がある、またはない toString
FilterInputStream、FilterOutputStream、BufferedInputStream、BufferedOutputStreamほかのストリームの上に作るストリーム。バッファ付きのものはサイズを指定できます
PushbackInputStream、SequenceInputStreamサイズを指定できます。1 バイトまたは配列の unread。2 つのストリーム、またはストリームの Enumeration の上に作ります
DataInput、DataOutput、DataInputStream、DataOutputStreamreadBoolean、readByte、readUnsignedByte、readShort、readUnsignedShort、readChar、readInt、readLong、readFloat、readDouble、readFully、skipBytes、readLine、readUTF。それぞれに対応する write、writeBytes、writeChars、writeUTF、size
PrintStreamOutputStream の上に作ります。自動フラッシュと文字セットを指定できます。各型の print と println、Locale の指定がある、またはない printf と format、append、write、writeBytes、flush、close、checkError、charset
Reader、Writer1 文字または配列への read、skip、ready、mark、reset、markSupported、transferTo、close。1 文字、配列、文字列の write、append、flush、close。Reader.nullReader、Writer.nullWriter。プログラムのクラスはどちらも継承できます
FilterReader、FilterWriter、CharArrayReader、CharArrayWriter、PushbackReader、LineNumberReaderほかのリーダーやライターの上に作るもの。char[] またはその範囲を対象にするもの(toCharArray、size、reset、writeTo)。サイズを指定でき、1 文字または配列を unread できるもの。getLineNumber、setLineNumber
StringReader、StringWriter、InputStreamReader、OutputStreamWriter文字列を対象にします。getBuffer、toString。ストリームを対象にするものは Charset または文字セットの名前を指定できます。getEncoding
BufferedReader、BufferedWriter、PrintWriterバッファのサイズを指定できます。readLine、lines。newLine。PrintWriter は Writer または OutputStream の上に作り、自動フラッシュと文字セットを指定できます。メンバーは PrintStream の文字版です
Charset、StandardCharsetsUTF_8、ISO_8859_1、US_ASCII、UTF_16、UTF_16BE、UTF_16LE。Charset.forName、defaultCharset、isSupported、name、displayName、toString
LocaleROOT、ENGLISH、US、UK、CANADA、Locale.getDefault(US を返します)、getLanguage、getCountry、toLanguageTag、toString
MessageFormatパターンを取る、Locale の指定がある、またはない new MessageFormat、MessageFormat.format。Object[] を取る format、applyPattern、toPattern、getLocale、setLocale。パターンの引数は書式型のない {n} です。数値は JDK が英語で書く形(1,000、1,234.568)になり、BigInteger と BigDecimal はその値の桁から書きます。それ以外の値は toString の結果になります
Normalizer、Normalizer.FormCharSequence と正規化形式を取る Normalizer.normalize と isNormalized。正規化形式は NFD、NFC、NFKD、NFKC です
Iterable、Iteratoriterator、forEach、spliterator。hasNext、next、remove、forEachRemaining
Spliterator、Spliterators、RandomAccesstryAdvance、forEachRemaining、trySplit、estimateSize、getExactSizeIfKnown、characteristics、hasCharacteristics、getComparator と 8 つの特性。コレクションの spliterator は JDK と同じ特性と見積もりを返す。コレクション、イテレーターとその大きさ、または配列を取る Spliterators.spliterator、spliteratorUnknownSize、emptySpliterator、iterator、AbstractSpliterator。ArrayList、List.of と Arrays.asList のリストが実装する RandomAccess
Collectionsize、isEmpty、contains、add、remove、containsAll、addAll、removeAll、retainAll、removeIf、clear、引数なし、配列、または配列を作る関数を取る toArray、iterator、forEach、stream、parallelStream、equals、hashCode、toString
List、ArrayListCollection のメンバー。get、set、添字を指定する add と addAll、添字を指定する remove、indexOf、lastIndexOf、subList、sort、replaceAll、getFirst、getLast、removeFirst、removeLast、addFirst、addLast、reversed、添字の指定がある、またはない listIterator(ListIterator のメンバーは hasNext、next、hasPrevious、previous、nextIndex、previousIndex、remove、set、add)。List.of、List.copyOf。引数なし、容量、コレクションを取る new ArrayList<>()、ensureCapacity、trimToSize
Set、HashSetCollection のメンバー。Set.of、Set.copyOf。引数なし、容量、コレクションを取る new HashSet<>()
Map、HashMap、Map.Entrysize、isEmpty、containsKey、containsValue、get、getOrDefault、put、putIfAbsent、putAll、remove、replace、clear、keySet、values、entrySet、forEach、replaceAll、computeIfAbsent、computeIfPresent、compute、merge、equals、hashCode、toString。10 組までの Map.of、Map.entry、Map.ofEntries、Map.copyOf。引数なし、容量、マップを取る new HashMap<>()。getKey、getValue、setValue、Map.Entry.comparingByKey、comparingByValue。キーと値、またはエントリを取る AbstractMap.SimpleEntry と SimpleImmutableEntry
LinkedHashMap、LinkedHashSetHashMap と HashSet のメンバー。キーを加えた順にたどります。new LinkedHashMap<>(capacity, loadFactor, true) は最後に触れた順にたどり、キーを加えるたびに removeEldestEntry を呼びます。引数なし、容量、コレクションを取る new LinkedHashSet<>()
Queue、Deque、ArrayDequeCollection のメンバー。offer、poll、peek、element、remove。addFirst、addLast、offerFirst、offerLast、removeFirst、removeLast、pollFirst、pollLast、getFirst、getLast、peekFirst、peekLast、push、pop、descendingIterator
LinkedListList と Deque のメンバー。removeFirstOccurrence、removeLastOccurrence。要素に null を使えます。引数なし、コレクションを取るコンストラクタ
AbstractCollection、AbstractList、AbstractSequentialList、AbstractSet、AbstractMapプログラムのクラスがコレクションになるために継承するクラス
Vector、Stack、EnumerationArrayList のメンバー。addElement、elementAt、firstElement、lastElement、setElementAt、insertElementAt、removeElementAt、removeElement、removeAllElements、elements。push、pop、peek、empty、search。hasMoreElements、nextElement
HashtableMap のメンバー。keys、elements、contains。キーにも値にも null は使えません
ArraysasList、toString、fill、equals、copyOf、copyOfRange、配列全体または範囲に対する、コンパレータの指定がある、またはない sort、binarySearch。対象は int、long、double、char、boolean、オブジェクトの配列。byte[] には toString、fill、equals、copyOf、copyOfRange。short[] と float[] には toString と equals。hashCode はすべての配列。int[]、long[]、double[]、オブジェクトの配列の setAll。deepToString、deepEquals、deepHashCode。オブジェクトの配列、int[]、long[]、double[] と、その範囲を取る stream。オブジェクトの配列とその範囲を取る spliterator
Collectionssort、コンパレータの指定がある、またはない binarySearch、reverse、shuffle、swap、max、min、frequency、addAll、fill、nCopies、emptyList、emptySet、emptyMap、singletonList、singleton、unmodifiableList、unmodifiableSet、unmodifiableCollection、unmodifiableMap、synchronizedList、synchronizedSet、synchronizedCollection、synchronizedMap、reverseOrder、rotate、replaceAll、indexOfSubList、lastIndexOfSubList
Objectsequals、hashCode、hash、toString、isNull、nonNull、メッセージまたはメッセージのサプライヤの指定がある、またはない requireNonNull、requireNonNullElse、requireNonNullElseGet、compare、checkIndex、checkFromIndexSize、checkFromToIndex
Optionalempty、of、ofNullable、isPresent、isEmpty、get、orElse、orElseGet、orElseThrow、ifPresent、ifPresentOrElse、filter、map、flatMap、or、stream、equals、hashCode、toString
OptionalInt、OptionalLong、OptionalDoubleempty、of、isPresent、isEmpty、getAsInt / getAsLong / getAsDouble、orElse、orElseGet、orElseThrow、ifPresent、ifPresentOrElse、stream、equals、hashCode、toString
StreamStream.of、ofNullable、empty、条件を指定できる iterate、generate、concat、builder。filter、map、mapToInt、mapToLong、mapToDouble、flatMap、flatMapToInt、flatMapToLong、flatMapToDouble、distinct、コンパレータを指定できる sorted、peek、limit、skip、takeWhile、dropWhile。forEach、forEachOrdered、引数なし、または配列を作る関数を取る toArray、3 つの形の reduce、Collector または 3 つの関数を取る collect、toList、min、max、count、anyMatch、allMatch、noneMatch、findFirst、findAny、iterator。parallel、sequential、isParallel、unordered、onClose、close
IntStream、LongStream、DoubleStreamof、empty、iterate、generate、concat、builder。前の 2 つには range と rangeClosed。数値に対する Stream のメンバーと、mapToObj、boxed、asLongStream、asDoubleStream、sum、average、min、max、summaryStatistics、toArray。iterator は PrimitiveIterator.OfInt、OfLong、OfDouble です
CollectorstoList、toSet、toCollection、toUnmodifiableList、toUnmodifiableSet。2 つの関数、またはマージ関数も取る toMap と toUnmodifiableMap、マップのサプライヤーも取る toMap。引数なし、区切り、または区切りと接頭辞と接尾辞を取る joining。分類関数、コレクター、マップのサプライヤーを取る groupingBy。コレクターを指定できる partitioningBy。counting、summingInt / Long / Double、averagingInt / Long / Double、summarizingInt / Long / Double、minBy、maxBy、3 つの形の reducing、mapping、filtering、flatMapping、collectingAndThen、teeing
Collectorsupplier、accumulator、combiner、finisher、characteristics。フィニッシャーを指定できる Collector.of。Collector.Characteristics
StreamSupportスプリッテレーター、またはそれを返すサプライヤーと特性を取る stream。スプリッテレーターに要素を求めるのはストリームが読まれるとき。SIZED を持つスプリッテレーターのストリームの count() はどの段も実行しない
IntSummaryStatistics、LongSummaryStatistics、DoubleSummaryStatistics引数なし、または個数、最小値、最大値、合計を取るコンストラクタ。accept、combine、getCount、getSum、getMin、getMax、getAverage、toString
Randomnew Random()、new Random(long)、setSeed、nextInt()、nextInt(int)、nextLong、nextDouble、nextBoolean、nextGaussian。シードを指定すると仕様どおりの列になります
UUIDnew UUID(long, long)、fromString、randomUUID。getMostSignificantBits、getLeastSignificantBits、version、variant、compareTo、equals、hashCode、toString。fromString は 1-1-1-1-1 のように JDK が受け付ける形も受け付けます。randomUUID はバージョン 4 です
BigIntegerZERO、ONE、TWO、TEN、valueOf。文字列(基数の指定がある、またはない)、2 の補数のバイト列またはその範囲、符号と絶対値のバイト列を取る new BigInteger。add、subtract、multiply、divide、remainder、mod、divideAndRemainder、pow、gcd、abs、negate、signum、sqrt、sqrtAndRemainder、modPow、modInverse。shiftLeft、shiftRight、and、or、xor、not、andNot、testBit、setBit、clearBit、flipBit、getLowestSetBit、bitLength、bitCount。compareTo、equals、hashCode、min、max。基数の指定がある、またはない toString、toByteArray。intValue、longValue、floatValue、doubleValue、intValueExact、longValueExact、shortValueExact、byteValueExact
BigDecimalZERO、ONE、TWO、TEN。long、スケールなしの long とスケール、double を取る valueOf。文字列、char[] またはその範囲、int、long、double、BigInteger(スケールの指定がある、またはない)を取る new BigDecimal(どれも MathContext の指定がある、またはない)。add、subtract、multiply、divide、divideToIntegralValue、remainder、divideAndRemainder、pow(どれも MathContext の指定がある、またはない)。スケールまたは RoundingMode を取る divide。sqrt、abs、negate、plus、round。signum、scale、precision、unscaledValue、setScale、movePointLeft、movePointRight、scaleByPowerOfTen、stripTrailingZeros、ulp。compareTo、equals、hashCode、min、max。toString、toEngineeringString、toPlainString。toBigInteger、toBigIntegerExact、intValue、longValue、floatValue、doubleValue、intValueExact、longValueExact、shortValueExact、byteValueExact。古い ROUND_UP から ROUND_UNNECESSARY と、それを取るメンバー
MathContext、RoundingMode精度(RoundingMode の指定がある、またはない)、または toString が書く文字列を取る new MathContext。UNLIMITED、DECIMAL32、DECIMAL64、DECIMAL128。getPrecision、getRoundingMode、equals、hashCode、toString。8 つの丸めモードと RoundingMode.valueOf(int)
Comparatorcompare、reversed、コンパレータ、キー、またはキーとそのコンパレータを取る thenComparing、thenComparingInt、thenComparingLong、thenComparingDouble、Comparator.naturalOrder、reverseOrder、キーのコンパレータの指定がある、またはない comparing、comparingInt、comparingLong、comparingDouble、nullsFirst、nullsLast
例外Throwable、Exception、Error、RuntimeException、IllegalArgumentException、IllegalStateException、ArithmeticException、NullPointerException、ClassCastException、IndexOutOfBoundsException、ArrayIndexOutOfBoundsException、StringIndexOutOfBoundsException、NegativeArraySizeException、UnsupportedOperationException、NumberFormatException、CloneNotSupportedException、InterruptedException、IllegalMonitorStateException、IllegalThreadStateException、NoSuchElementException、InputMismatchException、ConcurrentModificationException、EmptyStackException、MatchException、ArrayStoreException、SecurityException、AssertionError、VirtualMachineError、StackOverflowError、OutOfMemoryError、LinkageError、NoClassDefFoundError、ExceptionInInitializerError(getException を含む)、IOException、EOFException、FileNotFoundException、UTFDataFormatException、UnsupportedEncodingException、UncheckedIOException、UnsupportedCharsetException、IllegalCharsetNameException。API のコンストラクタ(引数なし、メッセージ、メッセージと原因、原因、添字)、getMessage、getLocalizedMessage、getCause、initCause、addSuppressed、getSuppressed、printStackTrace()、getStackTrace、setStackTrace、fillInStackTrace、toString。StackTraceElement には 4 引数のコンストラクタ、getClassName、getMethodName、getFileName、getLineNumber、isNativeMethod。実行時に起きる IllegalFormatException とその 3 つのサブクラス(コンストラクタなし):IllegalFormatConversionException、UnknownFormatConversionException、MissingFormatArgumentException。java.util.concurrent の ExecutionException、TimeoutException、CancellationException、RejectedExecutionException、CompletionException、BrokenBarrierException
Runnable、Comparable、AutoCloseable、Closeable、Flushablerun。compareTo(String、ボックス、列挙型の定数にもあります)。close。flush
Thread引数なし、Runnable、名前、その両方を取るコンストラクタ。Thread を継承するクラス。start、run、join()、join(long)、join(Duration)、interrupt、isInterrupted、isAlive、getName、setName、isDaemon、setDaemon、getPriority、setPriority、isVirtual、threadId、getId、toString。Thread.currentThread、sleep(long)、sleep(long, int)、sleep(Duration)、yield、onSpinWait、interrupted、holdsLock、startVirtualThread。Thread.ofPlatform() と ofVirtual()(name、daemon、priority、start、unstarted、factory)。getState と Thread.State。setUncaughtExceptionHandler、getUncaughtExceptionHandler、Thread.setDefaultUncaughtExceptionHandler、getDefaultUncaughtExceptionHandler
ThreadLocal、InheritableThreadLocalnew ThreadLocal<>()、withInitial、get、set、remove、initialValue。childValue
AtomicInteger、AtomicLongget、set、lazySet、getAndSet、compareAndSet、getAndAdd、addAndGet、getAndIncrement、getAndDecrement、incrementAndGet、decrementAndGet、getAndUpdate、updateAndGet、getAndAccumulate、accumulateAndGet、toString。どちらも Number です
AtomicBoolean、AtomicReferenceget、set、lazySet、getAndSet、compareAndSet、toString。AtomicReference には getAndUpdate、updateAndGet、getAndAccumulate、accumulateAndGet もあります
AtomicIntegerArray、AtomicLongArray、AtomicReferenceArray、LongAdder長さ、または配列を取るコンストラクタ。値が 1 つのアトミッククラスと同じメンバー(いずれも添字を取ります)、length、toString。add、increment、decrement、sum、reset、sumThenReset、toString。LongAdder は Number です
LongAccumulator、DoubleAdder、DoubleAccumulator関数とその単位元を取るコンストラクタ。accumulate、get、reset、getThenReset。add、sum、reset、sumThenReset。toString。いずれも Number です
AtomicIntegerFieldUpdater、AtomicLongFieldUpdater、AtomicReferenceFieldUpdaterクラスリテラルと定数のフィールド名を取る newUpdater。get、set、lazySet、getAndSet、compareAndSet、weakCompareAndSet、getAndUpdate、updateAndGet、getAndAccumulate、accumulateAndGet。int と long のアップデーターには getAndAdd、addAndGet、getAndIncrement、getAndDecrement、incrementAndGet、decrementAndGet もあります
TimeUnit7 つの単位。convert、toNanos、toMicros、toMillis、toSeconds、toMinutes、toHours、toDays、sleep、timedJoin、timedWait
Lock、ReentrantLock、Conditionlock、lockInterruptibly、制限時間の指定がある、またはない tryLock、unlock、newCondition、isLocked、isHeldByCurrentThread、getHoldCount、isFair、hasQueuedThreads、getQueueLength、toString。制限時間の指定がある、またはない await、awaitNanos、awaitUninterruptibly、signal、signalAll
ReadWriteLock、ReentrantReadWriteLockreadLock と writeLock(どちらも Lock で、書き込みロックは条件変数を作れます)。getReadLockCount、getReadHoldCount、getWriteHoldCount、isWriteLocked、isWriteLockedByCurrentThread、isFair、hasQueuedThreads、getQueueLength、toString
StampedLockwriteLock、readLock(どちらにも Interruptibly 版と、制限時間の指定がある、またはない try.. 版があります)。tryOptimisticRead、validate。unlockWrite、unlockRead、unlock、tryUnlockWrite、tryUnlockRead。tryConvertToWriteLock、tryConvertToReadLock、tryConvertToOptimisticRead。isWriteLocked、isReadLocked、getReadLockCount、isLockStamp、isWriteLockStamp、isReadLockStamp、isOptimisticReadStamp。asReadLock、asWriteLock、asReadWriteLock。toString。スタンプの値は JDK 25 が返す値と同じです
CountDownLatch、Semaphore制限時間の指定がある、またはない await、countDown、getCount。acquire、acquireUninterruptibly、制限時間の指定がある、またはない tryAcquire、release(いずれも許可 1 つ、または複数)、availablePermits、drainPermits、isFair。どちらにも toString があります
CyclicBarrier、Exchangerスレッド数を取り、アクションの指定がある、またはないコンストラクタ。制限時間の指定がある、またはない await、reset、isBroken、getParties、getNumberWaiting。制限時間の指定がある、またはない exchange
Phaser引数なし、またはパーティ数、親、その両方を取るコンストラクタ。register、bulkRegister、arrive、arriveAndDeregister、arriveAndAwaitAdvance、awaitAdvance、制限時間の指定がある、またはない awaitAdvanceInterruptibly、forceTermination、getPhase、getRegisteredParties、getArrivedParties、getUnarrivedParties、getParent、getRoot、isTerminated、toString。オーバーライドできる onAdvance
BlockingQueue、ArrayBlockingQueue、LinkedBlockingQueue、SynchronousQueue、ConcurrentLinkedQueueQueue のメンバー。ブロッキングキューには put、take、制限時間を指定する offer と poll、remainingCapacity、drainTo もあります。SynchronousQueue は要素を保持せず、要素を入れるスレッドから取り出すスレッドへ直接渡します
TransferQueue、LinkedTransferQueueブロッキングキューのメンバー。transfer、制限時間の指定がある、またはない tryTransfer、hasWaitingConsumer、getWaitingConsumerCount
BlockingDeque、LinkedBlockingDeque、ConcurrentLinkedDequeDeque のメンバー。ブロッキングデックにはブロッキングキューのメンバーと、両端それぞれの putFirst、putLast、takeFirst、takeLast、制限時間を指定する offerFirst、offerLast、pollFirst、pollLast もあります
ConcurrentMap、ConcurrentHashMapMap のメンバー。キーと値を指定する remove、古い値を指定する replace、mappingCount、contains、keys、elements、値を指定する keySet、ConcurrentHashMap.newKeySet。引数なし、容量、マップを取るコンストラクタ。キーと値に null は使えません
CopyOnWriteArrayList、CopyOnWriteArraySetList のメンバー、または Set のメンバー。addIfAbsent、addAllAbsent。イテレータは作られた時点のリストをたどり、リストを変更しません
Executor、ExecutorService、Executorsexecute、Callable または Runnable を取る submit、制限時間の指定がある、またはない invokeAll と invokeAny、shutdown、shutdownNow、isShutdown、isTerminated、awaitTermination、close。newFixedThreadPool、newSingleThreadExecutor、newCachedThreadPool、newScheduledThreadPool、newSingleThreadScheduledExecutor(いずれも ThreadFactory の指定がある、またはない)、newVirtualThreadPerTaskExecutor、newThreadPerTaskExecutor、unconfigurableExecutorService、unconfigurableScheduledExecutorService、defaultThreadFactory、callable
ThreadPoolExecutor、RejectedExecutionHandlerコアサイズ、最大サイズ、時間、キューを取り、ThreadFactory、ハンドラー、またはその両方の指定がある、またはないコンストラクタ。AbortPolicy、CallerRunsPolicy、DiscardPolicy、DiscardOldestPolicy。getPoolSize、getCorePoolSize、getMaximumPoolSize、getLargestPoolSize、getActiveCount、getTaskCount、getCompletedTaskCount、getKeepAliveTime、getQueue、getThreadFactory、getRejectedExecutionHandler、setRejectedExecutionHandler、setCorePoolSize、setMaximumPoolSize、setKeepAliveTime、setThreadFactory、allowCoreThreadTimeOut、allowsCoreThreadTimeOut、prestartCoreThread、prestartAllCoreThreads、remove、purge、isTerminating、toString。オーバーライドできる beforeExecute、afterExecute、terminated
ScheduledExecutorService、ScheduledThreadPoolExecutor、ScheduledFuture、DelayedRunnable または Callable を取る schedule、scheduleAtFixedRate、scheduleWithFixedDelay。コアサイズを取り、ThreadFactory の指定がある、またはないコンストラクタ。setRemoveOnCancelPolicy、setExecuteExistingDelayedTasksAfterShutdownPolicy、setContinueExistingPeriodicTasksAfterShutdownPolicy と、それぞれの値を読むメンバー。getDelay、compareTo
ForkJoinPool、ForkJoinTask、RecursiveTask、RecursiveAction、CountedCompleternew ForkJoinPool()、並列度を取るコンストラクタ、ForkJoinPool.commonPool。invoke、execute、submit、getParallelism、getCommonPoolParallelism、getPoolSize と ExecutorService のメンバー。fork、join、invoke、invokeAll、制限時間の指定がある、またはない get、cancel、isDone、isCancelled、isCompletedNormally、isCompletedAbnormally、getException、complete、completeExceptionally、quietlyComplete、quietlyJoin、quietlyInvoke、getRawResult、ForkJoinTask.adapt、inForkJoinPool、getPool。compute。CountedCompleter には tryComplete、propagateCompletion、onCompletion、onExceptionalCompletion、getCompleter、getRoot、getPendingCount、setPendingCount、addToPendingCount、compareAndSetPendingCount、decrementPendingCountUnlessZero、firstComplete、nextComplete、quietlyCompleteRoot、helpComplete もあります
Timer、TimerTask引数なし、名前、デーモンかどうか、その両方を取るコンストラクタ。遅延を取り、周期の指定がある、またはない schedule、scheduleAtFixedRate、cancel、purge。run、cancel、scheduledExecutionTime
Callable、Future、FutureTask、ThreadFactorycall。制限時間の指定がある、またはない get、isDone、cancel、isCancelled、state、resultNow、exceptionNow。run、toString。newThread
CompletableFuture、CompletionStageエグゼキューターの指定がある、またはない supplyAsync と runAsync、completedFuture、failedFuture、completedStage、failedStage、allOf、anyOf。thenApply、thenAccept、thenRun、thenCompose、handle、whenComplete、thenCombine、thenAcceptBoth、runAfterBoth、applyToEither、acceptEither、runAfterEither、exceptionally、exceptionallyCompose(いずれも、エグゼキューターの指定がある、またはない Async 版があります)。complete、completeExceptionally、completeAsync、obtrudeValue、obtrudeException、cancel、orTimeout、completeOnTimeout、delayedExecutor、copy、minimalCompletionStage、newIncompleteFuture、defaultExecutor、join、制限時間の指定がある、またはない get、getNow、isDone、isCancelled、isCompletedExceptionally、getNumberOfDependents、state、resultNow、exceptionNow、toString
java.util.functionFunction、BiFunction、UnaryOperator、BinaryOperator、Supplier、Consumer、BiConsumer、Predicate、BiPredicate、BooleanSupplier。Int、Long、Double のそれぞれに IntFunction、IntPredicate、IntUnaryOperator、IntBinaryOperator、IntSupplier、IntConsumer、ToIntFunction、ToIntBiFunction、ObjIntConsumer。3 つの型の間の IntToLongFunction、IntToDoubleFunction、LongToIntFunction、LongToDoubleFunction、DoubleToIntFunction、DoubleToLongFunction。各インターフェースの抽象メソッドと andThen、compose、and、or、negate、identity、not、isEqual
DurationZERO。ofDays、ofHours、ofMinutes、ナノ秒の指定がある、またはない ofSeconds、ofMillis、ofNanos、parse。getSeconds、getNano、isZero、isNegative、isPositive。単位の個数を取る of、between、from。Duration または単位の個数を取る plus と minus、plusDays から plusNanos、minusDays から minusNanos、multipliedBy、negated、abs、withSeconds、withNanos、truncatedTo。get、getUnits、addTo、subtractFrom。toDays、toHours、toMinutes、toSeconds、toMillis、toNanos、toDaysPart から toNanosPart。compareTo、equals、hashCode、toString。DateTimeException、DateTimeParseException
LocalDateMIN、MAX、EPOCH。ゾーンまたは Clock の指定がある、またはない now、of、ofYearDay、ofEpochDay、ofInstant、parse、from。getYear、getMonth、getMonthValue、getDayOfMonth、getDayOfYear、getDayOfWeek、isLeapYear、lengthOfMonth、lengthOfYear。withYear から withDayOfYear、plusYears から plusDays、minusYears から minusDays。日付までを Period で返す until。atTime、ゾーンの指定がある、またはない atStartOfDay、toEpochDay、toEpochSecond。isAfter、isBefore、isEqual、compareTo、equals、hashCode、toString
LocalTimeMIN、MAX、MIDNIGHT、NOON。now、of、ofSecondOfDay、ofNanoOfDay、ofInstant、parse、from。getHour から getNano。withHour から withNano、plusHours から plusNanos、minusHours から minusNanos、truncatedTo。atDate、toSecondOfDay、toNanoOfDay、toEpochSecond。isAfter、isBefore、compareTo、equals、hashCode、toString
LocalDateTimeMIN、MAX。now、日付と時刻またはその数値を取る of、ofInstant、ofEpochSecond、parse、from。toLocalDate、toLocalTime と両者のゲッター。withYear から withNano、plusYears から plusNanos、minusYears から minusNanos、truncatedTo。atOffset、atZone、toEpochSecond、toInstant。isAfter、isBefore、isEqual、compareTo、equals、hashCode、toString
OffsetDateTimeMIN、MAX。now、of、ofInstant、parse、from。getOffset、withOffsetSameLocal、withOffsetSameInstant、toLocalDateTime、toLocalDate、toLocalTime とゲッター、LocalDateTime と同じ with..、plus..、minus..、truncatedTo。toInstant、toEpochSecond、toZonedDateTime、atZoneSameInstant、atZoneSimilarLocal。isAfter、isBefore、isEqual、compareTo、equals、hashCode、toString
ZonedDateTimenow、of、ofLocal、ofInstant、ofStrict、parse、from。getOffset、getZone、withZoneSameLocal、withZoneSameInstant、withFixedOffsetZone、withEarlierOffsetAtOverlap、withLaterOffsetAtOverlap、toLocalDateTime、toLocalDate、toLocalTime とゲッター、LocalDateTime と同じ with..、plus..、minus..、truncatedTo。toOffsetDateTime、toInstant、toEpochSecond。isAfter、isBefore、isEqual、compareTo、equals、hashCode、toString
InstantEPOCH、MIN、MAX。Clock の指定がある、またはない now、ナノ秒の指定がある、またはない ofEpochSecond、ofEpochMilli、parse、from。getEpochSecond、getNano、toEpochMilli。plusSeconds、plusMillis、plusNanos、minusSeconds、minusMillis、minusNanos、truncatedTo。atOffset、atZone。isAfter、isBefore、compareTo、equals、hashCode、toString
Year、YearMonthnow、of、parse、from。Year.isLeap、getValue、isLeap、length、plusYears、minusYears、atDay、atMonth。getYear、getMonth、getMonthValue、isLeapYear、isValidDay、lengthOfMonth、lengthOfYear、withYear、withMonth、plusYears、plusMonths、minusYears、minusMonths、atDay、atEndOfMonth。isAfter、isBefore、compareTo、equals、hashCode、toString
PeriodZERO。of、ofYears、ofMonths、ofWeeks、ofDays、between、parse、from。getYears、getMonths、getDays、isZero、isNegative、toTotalMonths。withYears から withDays、量を取る plus と minus、plusYears から plusDays、minusYears から minusDays、multipliedBy、negated、normalized。get、getUnits、addTo、subtractFrom。equals、hashCode、toString
java.time.temporalTemporal、TemporalAccessor、TemporalAdjuster、TemporalAmount、TemporalField、TemporalUnit、ChronoField、ChronoUnit、ValueRange、UnsupportedTemporalTypeException。上の日付と時刻の各クラスには、フィールドまたは単位を取る isSupported、get、getLong、range、フィールドまたはアジャスターを取る with、量または単位の個数を取る plus と minus、単位を取る until、adjustInto があります。フィールド、単位、アジャスター、量はプログラムでも書けます
java.time.chronoChronoLocalDate、ChronoLocalDateTime、ChronoZonedDateTime。LocalDate、LocalDateTime、ZonedDateTime が実装するインターフェースで、変換と順序のメンバーを持ちます
ZoneOffset、ZoneId、ZoneRulesUTC、MIN、MAX。ZoneOffset.of、ofHours、ofHoursMinutes、ofHoursMinutesSeconds、ofTotalSeconds、from、getTotalSeconds、compareTo。ZoneId.of、ofOffset、systemDefault、from、getId、getRules、normalized、equals、hashCode、toString。ZoneRules.of、isFixedOffset、getOffset、getValidOffsets、isValidOffset、getStandardOffset、getDaylightSavings、isDaylightSavings。ZoneRulesException。ゾーンはオフセットが変わらないものだけです
ClocksystemUTC、systemDefaultZone、system、fixed、offset、tick、tickSeconds、tickMinutes、tickMillis。instant、millis、getZone、withZone。Clock を継承するクラス
DayOfWeek、Month各定数。of、from、getValue、plus、minus。Month.length、minLength、maxLength、firstDayOfYear、firstMonthOfQuarter
java.util.Datenew Date()、new Date(long)、Date.from。getTime、setTime、before、after、compareTo、equals、hashCode、toInstant、toString
java.sql.Date、Time、Timestampモジュール java.sql のパッケージです。ミリ秒を取る new。文字列、LocalDate、LocalTime、LocalDateTime を取る valueOf。toLocalDate、toLocalTime、toLocalDateTime、toString。Timestamp.from、toInstant、getNanos、setNanos、Timestamp を取る equals、compareTo、before、after。日時はホストのゾーンで読み書きし、1582-10-15 より前はユリウス暦です
URI、URISyntaxExceptionnew URI(String)、URI.create。getScheme、getSchemeSpecificPart、getAuthority、getUserInfo、getHost、getPort、getPath、getQuery、getFragment と、それぞれの getRaw..。isAbsolute、isOpaque、URI または文字列を取る resolve、equals、hashCode、compareTo、toString。getInput、getReason、getIndex
HttpClientnewHttpClient。newBuilder と、そのビルダーの version、followRedirects、executor、connectTimeout、build。send、sendAsync、followRedirects、version、executor、connectTimeout、close、shutdown、shutdownNow、isTerminated。HttpClient.Version、HttpClient.Redirect
HttpRequestURI の指定がある、またはない newBuilder と、そのビルダーの uri、header、headers、setHeader、GET、POST、PUT、DELETE、HEAD、method、version、expectContinue、timeout、copy、build。method、uri、headers、bodyPublisher、version、expectContinue、timeout、equals、hashCode、toString。Charset の指定がある、またはない BodyPublishers.ofString、配列またはその範囲を取る ofByteArray、ofInputStream、noBody。BodyPublisher.contentLength
HttpResponsestatusCode、headers、body、uri、request、previousResponse、version、toString。Charset の指定がある、またはない BodyHandlers.ofString、ofByteArray、ofInputStream、discarding、replacing。同じ名前の BodySubscribers と mapping。ResponseInfo(statusCode、headers、version)を見てサブスクライバーを選ぶ、プログラム独自の BodyHandler
HttpHeadersfirstValue、firstValueAsLong、allValues、map、HttpHeaders.of、equals、hashCode、toString
HttpTimeoutException、HttpConnectTimeoutExceptionメッセージを取るコンストラクタ。時間制限を過ぎたときに send が投げ、sendAsync の future が失敗の原因として持つ例外です
HttpServer、HttpContext、HttpHandler引数なし、アドレスとバックログ、またはそれにパスとハンドラーとフィルターを加えた引数を取る HttpServer.create、bind、ハンドラーの指定がある、またはない createContext、パスまたはコンテキストを取る removeContext、setExecutor、getExecutor、start、stop、getAddress。getPath、getHandler、setHandler、getServer、getAttributes、getFilters、setAuthenticator、getAuthenticator。handle
HttpExchange、RequestgetRequestMethod、getRequestURI、getProtocol、getRequestHeaders、getRequestBody、getResponseHeaders、sendResponseHeaders、getResponseBody、getResponseCode、close、getHttpContext、getRemoteAddress、getLocalAddress、getAttribute、setAttribute、setStreams、getPrincipal。with
Filter、HttpHandlersdoFilter、description、Filter.beforeHandler、afterHandler、adaptRequest。フィルターのリストとハンドラーを取る new Filter.Chain と、その doFilter。ステータスとフィールドとボディを取る HttpHandlers.of、handleOrElse
Authenticator、BasicAuthenticator、HttpPrincipalauthenticate。Failure、Retry、Success と、その getResponseCode または getPrincipal。レルムを取り、Charset の指定がある、またはない BasicAuthenticator のコンストラクタ、getRealm、checkCredentials。ユーザー名とレルムを取る new HttpPrincipal、getUsername、getRealm、getName、equals、hashCode、toString
HeadersMap のメンバー。getFirst、add、set。引数なし、またはマップを取る new Headers()、名前と値を交互に並べるかマップを取る Headers.of
InetSocketAddress、InetAddress、BindException、UnknownHostExceptionポート、ホストとポート、InetAddress とポートを取るコンストラクタ、createUnresolved。getPort、getHostString、getHostName、getAddress、isUnresolved、equals、hashCode、toString。getHostAddress、getHostName、getAddress、isLoopbackAddress、isAnyLocalAddress、InetAddress.getLoopbackAddress、数値で書いたアドレスまたは localhost を取る getByName と getAllByName、getByAddress

String.format、formatted、printf が受け付ける変換は %d、%s、%S、%f、%e、%E、 %x、%X、%o、%c、%b、%h、%H、%n、%% です。フラグ -、0、+、空白、,、(、# と、 幅、精度、引数の番号(%2$s)を指定できます。

java.util.regex.Pattern と Matcher は、Pattern のドキュメントが記す構文を受け付けます。 和と積のある文字クラス、グループ(捕捉、名前付き、アトミック)、先読みと後読み、後方参照、 貪欲・最短・所有の量指定子、インラインフラグ、\\p{..} のプロパティ、\\X と \\b{g} です。 String.matches、replaceAll、replaceFirst、split も同じ構文を取ります。不正なパターンは JDK と同じメッセージの PatternSyntaxException になります。Matcher はリージョンの中を 検索でき(region、useAnchoringBounds、useTransparentBounds)、検索が入力の終わりを 読んだかどうかを答え(hitEnd、requireEnd)、マッチごとに置換結果を組み立て (appendReplacement、appendTail、関数を取る replaceAll)、マッチを保存します (toMatchResult)。Pattern.splitAsStream と Matcher.results はストリームを返します。 言語との差異も参照してください。

ストリームは、終端操作が要素を求めたときに、ソースから要素を 1 つずつ取り出します。ある ステージに届くのは、それより前のステージをすべて通過した要素だけです。終わりのない ストリームは limit、takeWhile、findFirst で打ち切れます。count() は、ソースと ステージから要素数がわかる場合、JDK 25 と同じくステージを 1 つも実行しません。 コレクション、配列、範囲に map、peek、sorted、skip、limit、boxed を重ねた場合です。 ストリームは 1 回だけ読めます。2 回目の操作は IllegalStateException になります。

[Bergen, Lyon, Oslo, Paris]
{NO=2, FI=1, FR=2}
{NO=Oslo+Bergen, FI=Turku, FR=Lyon+Paris}
IntSummaryStatistics{count=5, sum=3824, min=201, average=764.800000, max=2103}
Paris
55 [1, 2, 4, 8, 16, 32, 64, 128]
4 to,be,or,not

java.io のストリームは、配列、文字列、標準ストリーム、ほかのストリームの上に作ります。 ファイルはありません。PrintStream、PrintWriter、バイトと文字をつなぐ 2 つのクラスが 受け付ける文字セットは、UTF-8(デフォルト)、ISO-8859-1、US-ASCII、UTF-16、UTF-16BE、 UTF-16LE です。

12 bytes: 2026 naïve
FIRST
SECOND

HashMap、HashSet、Hashtable は、キーを equals と hashCode で探し、JDK と同じ順序で キーをたどります。LinkedHashMap と LinkedHashSet は、キーを加えた順にたどります。

origin [0, 1] [Point[x=1, y=1], Point[x=3, y=1]] [not, be, or, to]
pi    | 3.14|0042|ff
tried 30
insufficient funds: 30
tried 100
tried 50
2 ok, 1 refused, null

スレッド

Thread の開始、join、割り込み、名前は言語仕様のとおりに動きます。synchronized は オブジェクトのモニターを保持し、wait と notify はモニターをスレッドからスレッドへ 受け渡します。volatile フィールドを読むと、最後に書き込まれた値が得られます。スレッドが 捕捉しなかった例外は、スレッド名とその例外の原因とともに標準エラーに書き出され、その スレッドだけが終了します。プログラムは、デーモンでないスレッドがすべて終了したときに終了します。

4000 after worker-3

インタープリターと JVM では、スレッドはホストの仮想スレッドであり、複数のスレッドが並列に 動きます。.wasm にはスタックが 1 本しかないため、スレッドはそのスタックを交代で使います。 スレッドは、待機、スリープ、yield、終了のいずれかをするまで実行を続け、待機やスリープを した場合は、あとで順番が来たときにその位置から再開します。共有するデータをモニター、 volatile フィールド、アトミッククラスのいずれかで保護しているプログラムは、どのバックエンド でも同じ出力になります。それ以外のプログラムで交代の仕方から生じる違いは 言語との差異にあります。

このサイトの Run とプレイグラウンドは、スレッドを開始するプログラムをページの中で この .wasm にコンパイルして実行します(言語との差異)。

java.util.concurrent には、ロック、ラッチ、バリア、キュー、並行マップ、エグゼキューター (プログラムが構成するプール、スケジュール実行のプール、fork/join のプール)、 CompletableFuture があり、java.util には Timer があります。どれも同じモニターの上に 実装されています。Vector、Hashtable、 StringBuffer と、Collections.synchronizedList などが返すラッパーは、どのメンバーも 自身のモニターを保持して実行します。

{one=3, seven=5, three=5} 8

HTTP

java.net.http には HTTP クライアントがあります。HttpClient は HttpRequest を送り、 HttpResponse を返します。レスポンスのボディは、ハンドラーが応答から作った値です。send は 応答をすべて受け取ってから戻り、sendAsync は CompletableFuture を返します。すべての リクエストは rontolisp:fetch を通るため、fetch が使えるすべての トランスポートで同じソースが動きます。

ターゲットビルドトランスポート
インタプリタ、JVMrontolisp App.java、-o App.classJDK の HttpClient
WASM コンポーネント-o app.wasm --component、wasmtime run -S http=y で実行wasi:http
ネイティブ実行ファイル--native実行ファイル自身のクライアント

素の Preview 1 モジュールにはトランスポートがありません。コンパイルはそのプログラムを拒否し、 トランスポートを与えるフラグを示します。java.net は java.base に含まれます。コンパクト ソースファイルでは、import module java.net.http; でクライアントをインポートします。

200 application/json
404

ビルダーは、JDK のビルダーが拒否するものを同じメッセージで拒否します。制限されたヘッダー、 不正なヘッダー、絶対の http または https でない URI です。 followRedirects(Redirect.NORMAL) と ALWAYS は、JDK のクライアントと同じ規則で 301、302、 303、307、308 をたどり、途中の応答は previousResponse() で取り出せます。接続を拒否された 場合は ConnectException になります。HttpRequest.Builder.timeout は応答が届き始めるまでの 時間を、HttpClient.Builder.connectTimeout は接続にかけてよい時間を制限します。どちらも java.time.Duration を取り、制限を過ぎたリクエストは HttpTimeoutException または HttpConnectTimeoutException になります。トランスポートが提供できないものと、用意していない メンバーは言語との差異にあります。

com.sun.net.httpserver には HTTP サーバーがあります。HttpServer にコンテキストを登録し、 HttpHandler が HttpExchange に応答します。サーバーはターゲットのトランスポートを通して リクエストを受けるため、同じソースがどのターゲットでもサーバーになります。

ターゲットビルドポートを開くもの
インタプリタ、JVMrontolisp App.java、-o App.classプログラム(create に渡したアドレス)
WASM コンポーネント-o app.wasm --component、wasmtime serve -S cli=y app.wasm で実行ホスト(--addr)。リクエストごとに wasi:http でプログラムを呼びます
ネイティブ実行ファイル--native実行ファイル(create に渡したアドレス)

素の Preview 1 モジュールはポートを開けません。create は、--component と --native を 示す IOException を投げます。コンパクトソースファイルでは、import module jdk.httpserver; で サーバーをインポートします。

プログラムは、開始したサーバーが動いているあいだ終了しません。main が戻っても待機しても、 stop が呼ばれるまでリクエストに応答します。ハンドラーは、サーバーに設定した エグゼキューターのスレッドで実行され、プログラムのほかのスレッドを待つことができます。 コンテキストには、フィルター(getFilters)とオーセンティケーターを設定できます。 wasmtime serve では、ホストが必要に応じてプログラムを起動し、create に渡したアドレスは 使われません。 sendResponseHeaders(status, length) の length は、ボディの長さです。-1 はボディが ないことを、0 は長さを事前に知らせないボディを表します。長さを知らせないボディは、 トランスポートが対応していれば(wasmtime serve)、書き込むたびにチャンクとして送られます。 それ以外のトランスポートでは、全体がまとめて送られます。

次のプログラムは、コンテキストを 1 つ持つサーバーを開始し、main からそのサーバーに リクエストを 1 回送ります。サーバーとクライアントが同じプロセスで動くため、実行できるのは スレッドのあるターゲット(インタプリタと JVM)です。

200 Hello, Ann!

サーバーだけのプログラムと、各ターゲットでの実行手順は examples/java/http にあります。トランスポートが提供できないものと、用意していないメンバーは 言語との差異にあります。

言語と動作が異なる点と、拒否される構文は言語との差異にあります。