言語との差異
サブセットであることは設計上の選択です。サブセットが受け付けるプログラムの動作が言語仕様と
異なる箇所はここに挙げたとおりで、.wasm のスレッドを除けば、どのバックエンドでも
同じです。
動作が異なる点
文字列はコードポイントの列です。 length、charAt、substring は Unicode の
コードポイントを数えます。言語仕様は UTF-16 のコード単位を数えるので、基本多言語面の外の
文字を含む文字列では結果が変わります。hashCode は仕様どおりの値です。toCharArray は
UTF-16 のコード単位を返し、new String(char[]) はそれを元の文字列に読み戻します。
toUpperCase と toLowerCase は 1 文字を 1 文字に変えます。"ß".toUpperCase() は ß です
(JDK は SS を返します)。相手のないサロゲートは、UTF-8 では 3 バイトになります(JDK は
? を書きます)。Character.digit、getNumericValue、Integer.parseInt、UUID.fromString、
java.sql の valueOf、BigInteger と BigDecimal に渡す文字列は、ASCII の外の
数字('٣')をインタプリタと JVM では読み、.wasm では読みません。
3 2 57834039
JDK は 4 3 57834039 を表示します。
2 つのボックスの == は値を比較します。 ボックスは値そのものなので、同じ値のボックスは
同じオブジェクトです。言語仕様は、-128 から 127 までの値についてこれを保証し、それ以外の値に
ついても許しています。
true false true
JDK は false false true を表示します。
型引数は実行時に検査しません。 言語仕様では、型引数を通して読んだ値は、使う箇所で検査
されます。rontolisp は型を信頼します。型引数と異なるクラスの値が入るのは、raw 型を通した
場合か、コンパイラが unchecked と警告するキャストを通した場合だけです。その値は、言語仕様では
ClassCastException になる箇所でも、そのまま使われます。型変数へのキャストはその境界を、
型引数付きの型へのキャストはそのクラスを検査します。
配列への格納は検査しません。 配列自身の型より上の配列型を通して格納した値
(Object[] a = new String[1]; a[0] = 1;)は、言語仕様では ArrayStoreException になる場合でも
格納されます。
long、short、参照型の配列のクラスは、拡大変換で記録したクラスです。 値をこれらの配列型へ
キャストまたは判定(instanceof)するプログラムと、これらの配列でありうる値のクラス名
(getClass())を求めるプログラムでは、配列の型を拡大したとき(Object や自身より上の配列型への
代入、型パラメーターの位置への受け渡し)にクラスを記録します。それ以外のプログラムでは、
Object として読んだこれらの配列の toString() は、long と参照型の配列を Object[]、
short の配列を char[] と名付けます。
[Ljava.lang.Object;
JDK は [Ljava.lang.String; と出力します。
クラスが最初の使用時に初期化されるのは、プログラムからその違いを観測できる場合だけです。
言語仕様では、クラスは最初に使われたときに初期化されます。rontolisp も、static 初期化が
次のいずれかを行うクラスは、最初に使われたときに初期化します。出力する、例外を投げる、
ほかのクラスの static フィールドに書き込む、ほかのクラスから「変更できない値を持つ final
フィールド」以外のものを読む、のいずれかです。それ以外のクラスは main の前に初期化します。
そのクラスの初期化は、最初の使用時に行った場合と区別できないからです。
main starts
Report is initialized
9 3
static 初期化の中で、またはそこから呼ばれたコードの中で throw 文が投げた例外は、言語仕様の
とおりに初期化を終わらせます。その例外は ExceptionInInitializerError の原因になり、Error
はそのまま届き、以後そのクラスを使うたびに NoClassDefFoundError が投げられます。
static 初期化の中で起きた実行時エラーの扱いは、言語仕様と異なります。エラーはそのまま
プログラムに届き、クラスは初期化が進んだところまでの状態で使い続けられます。main の前に
行われる初期化の中で起きた場合は、main が始まる前に発生します。
filling
java.lang.ArrayIndexOutOfBoundsException: Index 2 out of bounds for length 2
2
JDK は最初の読み出しで java.lang.ExceptionInInitializerError を表示し、2 回目の読み出しで
NoClassDefFoundError を投げてプログラムを終了します。
実行時の例外のメッセージのうち 2 つが異なります。 実行時のエラーは言語仕様が定める例外で、
catch はその例外のクラスとして捕捉します。null を通したメンバー・要素・長さの読み出し、
null のボックスのアンボクシング、null に対する switch は NullPointerException、
0 による整数の除算は ArithmeticException、配列・文字列・StringBuilder の範囲外の添字は
ArrayIndexOutOfBoundsException または StringIndexOutOfBoundsException、負の長さの配列は
NegativeArraySizeException、引数と変換が合わない String.format は
IllegalFormatException です。メッセージは JDK のものと同じですが、2 つだけ異なります。
実行時に起きる NullPointerException はメッセージを持ちません。JDK のメッセージは null
だった式を名前で説明し、その名前はクラスのコンパイル方法によって変わるためです。
ClassCastException のメッセージは 2 つのクラスを示し、JDK が加えるモジュールとクラス
ローダーの説明を含みません。スタックオーバーフローは、プログラムが捕捉できる StackOverflowError になりません。
捕捉されなかった例外は、スタックトレースなしで報告されます。 標準エラー出力には、JDK が
書く内容からフレームの行を除いたものを書きます。Exception in thread "main" と例外の
toString()、続いてその例外が抑制した例外と原因です。そのあと終了ステータス 1 で終了します。
フレームの代わりに、原因の行のあとに 1 行だけ書きます。例外が発生した文のファイルと行、
その文が書かれているメソッドです。インタプリタと JVM 出力はこの行を書きます。.wasm 出力は
--report-locations
を付けてコンパイルしたときに書きます。printStackTrace() は、この 1 行を除いた同じ行を
書きます。
例外はフレームを保持しません。getStackTrace() は、setStackTrace のあとも空の配列を
返します。
$ rontolisp Uncaught.java
Exception in thread "main" java.lang.RuntimeException: withdrawal refused
Caused by: java.lang.IllegalStateException: insufficient funds: 30
at Uncaught.java:12 in Uncaught.withdraw(int,int)
コンパイラが報告するエラーの一部は報告されません。 そのようなプログラムは実行されます。
protected のメンバーには、そのクラスのサブクラスならどこからでも
アクセスできます。言語仕様では、インスタンスメンバーにはサブクラス自身の型の参照を通してだけ、
コンストラクタには super(..) を通してだけアクセスできます。コンパイラが表示する警告のうち、
表示するのは呼び出し、変換、キャスト、可変長引数の
unchecked の警告と、到達しない catch 節の警告だけです。
レコードの hashCode は、コンポーネントを宣言順に 31 * h + hash で畳み込んだ値です。
言語仕様はこの値を定めていません。
hashCode も toString も宣言していないオブジェクトの hashCode と toString は、
rontolisp が割り当てる識別番号と、Name@ にその番号の 16 進表記を続けた文字列です。
このようなオブジェクト(列挙型の定数を含みます)をキーにした HashMap は、JDK と異なる順序で
キーをたどります。JDK でも、この順序は実行のたびに変わります。
HashMap の順序が JDK と異なる場合が 2 つあります。 バケットが 64 個以上の表で、ハッシュ
コードが 1 つのバケットに集まるキーが 8 個を超えると、それらのキーは追加した順にたどられます。
桁数の少ない Float のキー(0.0、0.5、1.0 など。ハッシュコードが上位ビットでしか
違いません)は 25 個から、桁数の少ない Double のキーは 64 個からこの状態になります。hashCode が取る値の少ないクラスのキーも同様です。
文字列と整数のキーはこの状態になりません。
Set.of と Map.of の順序は 1 つに決まっています。JDK は起動のたびに別の順序を選びます。
Math の関数は StrictMath の関数です。 そのため、結果はどのバックエンドとプロセッサでも
同じです。JDK の Math.sin、Math.exp などは、最後の桁がこれと異なることがあります。
NaN はペイロードを持ちません。 NaN はすべて 1 つの値です。floatToRawIntBits と
doubleToRawLongBits は floatToIntBits と doubleToLongBits と同じビットを返し、
intBitsToFloat と longBitsToDouble はどの NaN のビットからもその NaN を返します。
正規表現は UTF-16 の単位ではなく文字を数えます。 java.util.regex と、パターンを取る
String のメンバーは、Pattern のドキュメントを基に本プロジェクトで書いたエンジンの上で
動きます。マッチの start と end は入力の文字数で数えます(ここでの length と charAt と
同じです)。JDK の find がサロゲートペアの間に入る場合は、マッチが異なります。CANON_EQ の
下の文字クラスとプロパティ、および \N{name} は、パターンのコンパイル時にエラーになります。
Pattern にあるのは compile、matches、quote、matcher、split、pattern、flags、
asPredicate、asMatchPredicate とフラグの定数です。Matcher にあるのは find、lookingAt、
matches、group、start、end、groupCount、hasMatch、reset、region、regionStart、
regionEnd、アンカー境界と透過境界の設定、hitEnd、requireEnd、文字列または関数を取る
replaceAll と replaceFirst、appendReplacement、appendTail、toMatchResult、
quoteReplacement、results、splitAsStream です。usePattern と namedGroups はありません。
透過境界のリージョンで lookingAt または matches を呼んだあと、後読みがリージョンより前を
読んでいると、JDK の start() は 0 を返します。ここではリージョンの開始位置を返します。
String.format の変換は概要に挙げたものだけです。 それ以外の変換は名前を
示すエラーになります。ロケールはルートと英語のものだけで、どれもロケールなしの
String.format と同じ書式になります。デフォルトのロケールは Locale.US です。
MessageFormat には書式型がありません。 書式型を指定したパターン({0,number}、
{0,date}、{0,choice,...})は、読んだ時点で名前を示す UnsupportedOperationException
になります。2^63 以上の Double は、読み戻すと同じ値になる最短の桁で書きます。JDK は
別の桁を書くことがあり、1e23 はここでは 100,000,000,000,000,000,000,000、JDK では
99,999,999,999,999,990,000,000 です。applyPattern が拒否したパターンは書式を変えません。
JDK では前後 2 つのパターンが混ざった状態が残ります。
BigInteger と BigDecimal には素数のメンバーがなく、String.format で書けるのは %s
だけです。 isProbablePrime、nextProbablePrime、probablePrime、乱数のビットを取る
コンストラクタは、名前を示して拒否されます。BigInteger に対する %d、BigDecimal に対する
%f と %e は IllegalFormatConversionException になります。JDK はその数値を書きます。
java.time のゾーンは、オフセットが変わらないものだけです。 使えるゾーンは、オフセット
(+09:00、Z)、UTC、GMT、UT とそれにオフセットを付けたもの(UTC+09:00)、
tz データベースの固定ゾーン(Etc/GMT+5、Etc/UTC、Zulu)です。Europe/Paris のように
独自の規則を持つ地域は未知の名前として扱います。ZoneId.of は ZoneRulesException を投げ、
ZonedDateTime.parse は角括弧内にその名前がある文字列を拒否します。
ZoneId.systemDefault() は ZoneOffset で、呼び出した時点でホストのゾーンが持つオフセット
です。LocalDate.now() はホストの日付になります。夏時間の有無が現在と異なる時期の日時も、
現在のオフセットで読みます。.wasm がホストのゾーンを知る方法は
decode-universal-time と同じで、分からなければ UTC です。
java.util.Date はゾーンをオフセットで書きます。 toString は、ホストが UTC なら UTC、
それ以外では GMT+09:00 のように書きます。JDK はゾーンの略称(JST、EST)を書きます。
地域の最初の規則より前のオフセットは、ホストの地方平均時です(ニューヨークの 1883 年より前は
GMT-04:56)。JDK はその地域の最初の標準時のオフセットを使います。clone と、JDK 1.1 から
非推奨のメンバー(getYear、getHours)は名前を挙げて拒否します。
java.time にフォーマッターはありません。 DateTimeFormatter と、それを取る format、
parse は、名前を示して拒否されます。文字列だけを取る parse と toString は ISO-8601 の
形式を読み書きします。MonthDay、OffsetTime、TemporalAdjusters、TemporalQuery と
query、ISO 以外の暦、getDisplayName、datesUntil、Duration.dividedBy も拒否されます。
フィールドから値を作れなかった文字列のメッセージは、フィールドを決まった順で並べます
({Year=2020, MonthOfYear=13})。JDK では実行のたびに順序が変わります。ValueRange、
ZoneRules、Clock のハッシュコードは JDK と異なります。
Normalizer は JDK 25 の Unicode データを使います。 それより新しい JDK の Unicode で
追加または変更された文字も、JDK 25 と同じ結果になります。すでにその形式になっている文字列を
normalize に渡すと、その文字列自体を返します。JDK は内容の等しい別の文字列を返すことが
あります。
古い 2 つのクラスは新しいクラスと同じものです。 StringBuffer は StringBuilder であり、
getClass().getName() も StringBuilder の名前を返します。Vector は instanceof で
ArrayList と判定されます。
標準ストリームは文字のストリームです。 System.in は、ホストの標準入力の文字を、その
UTF-8 のバイト列として読みます。そのため、テキストでない入力は元のバイト列のままでは
読めません。System.out と System.err に書いたバイトは UTF-8 のバイトとして扱い、文字は
その最後のバイトが書かれたときに出力します。System.in から複数のバイトを読むと、最初の
1 バイトを待ち、その時点で読めるバイトまでを返します。.wasm は読めるバイトの有無をホストに
問い合わせられないため、行末まで読みます。System.out と System.err は差し替えられず
(System.setOut)、close() の後も出力できます。
文字セットは 6 つです。 デフォルトの UTF-8 と、ISO-8859-1、US-ASCII、UTF-16、
UTF-16BE、UTF-16LE です。それ以外の名前は UnsupportedEncodingException または
UnsupportedCharsetException になります。UTF-8 または UTF-16 として不正なバイト列は U+FFFD に
デコードします。U+FFFD の個数は JDK 25 と同じです。UTF-16 の PrintStream の charset() は、
最初の出力のあと、同じ名前の別のオブジェクトを返します。
クラスオブジェクトはクラスが何であるかを答えるだけで、リフレクションはありません。
Class は、名前、スーパークラス、値がインスタンスかどうかの検査、キャスト、列挙型の定数を
返します。名前によるクラスの取得(Class.forName)、クラスのメンバー、コンストラクタ、
アノテーションの取得、getInterfaces() は、コンパイル時に名前を示して拒否されます。
ライブラリのクラスのスーパークラスは、このライブラリでの宣言に従います。
StringBuilder.class.getSuperclass() は Object です(JDK では、間に JDK 独自のクラスが
あります)。isAssignableFrom は、このライブラリのクラスが宣言するインターフェースで判定します
(String は Comparable であり CharSequence です)。ラムダ式の getClass() は実行時エラーに
なります。synchronized (Name.class) が保持するモニターは、そのクラスの
static synchronized メソッドが保持するモニターであり、変数に入れたクラスオブジェクトの
モニターとは別のものです。
ストリームは、結果を求めたスレッドで順に実行されます。 parallel() と
parallelStream() は記録されるだけです(isParallel() は true を返します)。要素は
ソースの順に 1 つずつ流れ、コレクターの combiner と、collect、reduce の第 3 引数は
呼ばれません。String.chars() と codePoints() は同じストリームで、コードポイントを
返します。flatMap または flatMapping の中で作ったストリームは、最後の要素を取り出した
ときに閉じられます。findFirst や limit で途中まで読んだストリームは閉じられません。
コレクターの finisher は、characteristics() の内容にかかわらず必ず呼ばれます。
プログラム自身のクラスのコレクターから作ったコレクター(mapping、groupingBy)は、
元のコレクターの特性を引き継ぎません。ライブラリのスプリッテレーターは分割しません。
trySplit は null を返します。スプリッテレーターで読んでいる途中にコレクションを変更すると、
次の要素を渡す前に ConcurrentModificationException が投げられます。JDK はその要素を
渡してから投げます。mapMulti、gather、ストリーム自身の spliterator()、int、long、
double のスプリッテレーター、Collectors.groupingByConcurrent と toConcurrentMap、
Random のストリームはありません。
ホストへの問い合わせには決まった値を返します。 Runtime.availableProcessors() は 1 です。
System.getProperty は line.separator、file.separator、path.separator と、エンコーディング
(file.encoding、native.encoding、stdin.encoding、stdout.encoding、stderr.encoding。
どれも UTF-8)に答えます。それ以外のキーは null です。System.gc() は何もしません。
System.getenv(name) はホストの環境変数を返します。.wasm が読めるのは、ホストが渡した
変数です(wasmtime run --env NAME=value)。すべての変数を返す getenv() はありません。
スレッド
.wasm のスレッドは、交代しながら 1 つずつ実行されます。 .wasm にはスタックが 1 本しか
ないため、スレッドは待機するまで実行を続け、待機したときに、実行できる別のスレッドへ交代
します。待機するのは、wait、join、sleep、yield を呼んだときと、別のスレッドが保持
しているモニターに入ろうとしたときです。開始されたスレッドは、開始した側のスレッドが
待機したときに初めて動きます。言語仕様はスレッドに実行の順番を保証していないため、この
実行順序はどれも仕様の範囲内です。違いが現れるのは次の 4 種類のプログラムです。
- 待機しないループは、別のスレッドへ交代しません。ただし、別のスレッドが書き込む値を言語
仕様の定める方法で読むループは、およそ 1000 回に 1 回交代します。該当するのは、
volatileフィールド、アトミッククラス、synchronizedのメソッドまたはブロック、割り込みの状態を 読むループです。通常のフィールドだけを読むループ、本体の中でインターフェース型の変数を 通じて問い合わせるループ(while (true) { if (future.isDone()) break; })、スレッドが モニターを保持したまま回るループは、終了するまでほかのスレッドを動かしません。ループの 中でThread.yield()またはsleepを呼べば交代します。 - すべてのスレッドが互いを待って進めなくなったプログラムは、標準エラーにその旨のメッセージを
書き出し、ステータス 1 で終了します。JDK では待ち続けます。該当するのは、2 つのスレッドが
相手の入ろうとするモニターをそれぞれ保持している場合、シャットダウンしないプールがある
場合、キャンセルしない
Timerがある場合です。wasmtime serveの下でリクエストを受ける プログラムは、この形では終了しません。待機中のリクエストが、次のリクエストの処理を 待っている場合があるからです(HTTP サーバー)。 String.formatまたはprintfが呼び出すtoString()とhashCode()、および報告される 例外のtoString()は、待機できません。たとえばsynchronizedなtoString()のモニターを スリープ中のスレッドが保持していると、待機が必要になります。このときプログラムは、上と 同じくメッセージを書き出してステータス 1 で終了します。- Common Lisp のプログラムが読み込む
mainのない Java ファイルは、スレッドまたはサーバーを 開始するとコンパイル時に拒否されます。
ブラウザでは、スレッドを開始するプログラムを .wasm として実行します。 このサイトの
Run とプレイグラウンドは、プログラムをブラウザの中のインタープリターで実行します。
ブラウザの中のインタープリターにはスタックが 1 本しかなく、待機中のスレッドを残して別の
スレッドへ交代することができません。そのため、スレッドを開始しうるプログラム全体は、ページの
中で Preview 1 の .wasm にコンパイルし、ブラウザがそれを実行します。スレッドは上記のとおり
交代しながら動き、使える機能は Preview 1 のモジュールと同じです。スレッドを開始し、かつ
HTTP リクエストを送るプログラムは、その理由を示すメッセージとともに拒否されます。スレッドを
開始しないプログラムは、ブラウザでも HTTP リクエストを送れます。プレイグラウンドの REPL に
入力したコードはインタープリターで実行するため、REPL ではスレッドを開始できません。start() は
メッセージを出して拒否されます。スレッドを開始するコードは、プログラム全体をプレイグラウンドの
Run source で実行します。
モニターも volatile も使わずに共有したデータの見え方は、ホストに従います。
インタープリターと JVM では、2 つのスレッドがどちらも使わずに読み書きするフィールドから、
古い値が読まれることがあります。これは言語仕様が許す動作です。volatile、synchronized、
Thread.start、join による順序付けは言語仕様のとおりです。
プールには JDK と異なる点があります。 プログラムが getQueue() に直接入れたタスクは、次の
execute まで実行されません。スケジュール実行のプールはタスクを独自の表に保持するため、
getQueue() は空です。CompletableFuture.defaultExecutor() はステージを実行するプールを
返しますが、これは ForkJoinPool.commonPool() が返すオブジェクトとは別のものです。
LongAccumulator と DoubleAccumulator は値を 1 つだけ保持します。JDK はスレッドごとに
値を畳み込んでから合わせるため、渡した値が関数の単位元であることを前提にします。
ForkJoinPool は、タスクを実行できるスレッドが空いていなければ
スレッドを開始します。そのため並列度は問い合わせに答えるだけの数値で、new ForkJoinPool()
では 2、共通プールでは 1 です。タスクが投げた例外は、そのまま再スローされます。JDK は、
別のスレッドがタスクを実行した場合、元の例外を原因に持つ同じクラスの例外を投げます。
ConcurrentHashMap の走査順は JDK 25 と同じです。 ただし、チェーンが 64 本以上ある
テーブルで、1 本のチェーンに 9 個のキーが入った場合の順序は一致しません。
wait で通知を受けたスレッドの状態は、WAITING のままの場合があります。 ほかのスレッドが
保持しているモニターに入るのを待っているスレッドに対して、getState は BLOCKED を返します。
一方、wait で通知を受けてモニターを取り直そうとしているスレッドに対しては、モニターを
取り直すまで WAITING または TIMED_WAITING を返すことがあります。未捕捉例外ハンドラーが呼ばれるのはプログラムが開始したスレッドだけで、
main のスレッドでは呼ばれません。
フィールドアップデーターは、クラスリテラルと定数の名前から作ります。
AtomicIntegerFieldUpdater.newUpdater(Node.class, "next") は書かれた場所で読まれるので、
クラスはクラスリテラル、名前は定数でなければなりません。それ以外の呼び出しは、コンパイル時に
名前を挙げて拒否されます。呼び出すクラスから読めないフィールドもコンパイル時に拒否されます
(JDK は呼び出しの実行時に例外を投げます)。フィールドそのものの問題(その名前のフィールドが
ない、型が違う、volatile でない、static である)は、JDK と同じ例外が呼び出しの実行時に
投げられます。
スレッドの番号は rontolisp 独自のものです。 threadId() と toString() に含まれる番号は、
プログラムのスレッドを 1 から数えた値です。
HTTP クライアント
リクエストは、ターゲットのトランスポートが送ります
(rontolisp:fetch)。接続に関する設定はトランスポートが決める
ため、対応するメンバーはありません。プロキシ、認証、クッキーハンドラー、SSLContext、
WebSocket です。version(..) で指定した値は保持され、問い合わせには答えますが、どの
トランスポートもこの値を読みません。応答の version() は、実際に使われたバージョンに
かかわらず HTTP_1_1 です。User-Agent を指定していないリクエストには、rontolisp の
User-Agent が付きます。
時間制限はトランスポートがミリ秒単位で数えます。 timeout と connectTimeout は、
rontolisp:fetch の :first-byte-timeout と
:connect-timeout です。1 ミリ秒に満たない時間は 1 ミリ秒として扱い、応答のボディの受信に
時間制限はありません。コンポーネントでは、timeout の時間を接続に対して一度、応答の開始に
対してもう一度数えます。wasmtime serve の下のコンポーネントはリクエストに時間制限を
付けられず、時間制限のあるリクエストは IOException になります。
どのビルダーにも時間制限を渡していないプログラムでは、プログラム自身のクラスの
HttpRequest が timeout() で時間を返すと、リクエストを送る時点で
UnsupportedOperationException になります。
送れるメソッドは GET、HEAD、POST、PUT、DELETE、OPTIONS、PATCH です。 ビルダーが
受け付けたそれ以外のメソッド(TRACE、get)と expectContinue(true) は、リクエストを送る
時点で UnsupportedOperationException になります。
ボディは全体をまとめて読みます。 send が戻るのも、sendAsync のフューチャーが完了する
のも、応答をすべて受け取ったあとです。そのため、BodyHandlers.ofInputStream() が返す
ストリームは、受信済みのボディを読みます。BodyPublishers.ofInputStream のストリームは、
リクエストを送る前に終わりまで読まれます。BodyHandler は BodySubscribers のサブスクライバー
から 1 つを選ぶ関数として書き、リクエストのボディは BodyPublishers で作ります。プログラムが
独自に実装したサブスクライバーとパブリッシャーは、使われた時点で
UnsupportedOperationException になります。BodyHandlers.ofString() は、応答の Content-Type
が示す文字セットが UTF-8、ISO-8859-1、US-ASCII のいずれかであればその文字セットで読み、
それ以外は UTF-8 として読みます。ofString(charset) には、どの文字セットも指定できます。
失敗は、トランスポートのメッセージを持つ IOException です。 接続を拒否された場合は、
どのバックエンドでも ConnectException になります。JDK にはこのほかにも例外クラスがあります
(UnknownHostException、SSLHandshakeException)。
sendAsync のフューチャーは、共通プールのスレッドで完了します。 クライアントに
executor を指定した場合は、そのエグゼキューターのスレッドで完了します。.wasm では
スレッドが交代しながら実行されます。コンポーネントでは、応答を待つスレッドは
sleep で待つスレッドと同じように扱われ、そのあいだもほかのスレッドは実行されます。
--native の実行ファイルでは、応答を待つスレッドは、まず実行できるほかのスレッドに一度ずつ
順番を譲ります。そのあとは、応答をすべて受け取るまで、ほかのスレッドは動きません。スリープ中の
スレッドも、プログラム自身のサーバーに届いたリクエストも同じです。そのため、main が
自分のサーバーにリクエストを送ると、--native では応答を待ち続けます。
URI は、JDK と同じ検査を同じメッセージで行います。ただし、角括弧で囲んだアドレスに
ついては、使われている文字だけを検査します。hashCode の値は JDK と一致せず、compareTo は
文字列としての順序で比較します。複数の部分を取るコンストラクタ、normalize、relativize、
toURL、toASCIIString はありません。
HTTP サーバー
サーバーは、ターゲットのトランスポートを通してリクエストを受けます。 これは Clack
アプリケーションが使うものと同じトランスポートです。接続に関する設定はトランスポートが
決めるため、HttpsServer とその設定のクラス、SimpleFileServer はありません。バックログの
値は読まれません。1 つのプログラムが使えるサーバーは 1 つです。サーバーをバインドしている
あいだに別のサーバーをバインドすると、UnsupportedOperationException になります。
wasmtime serve では、ポートとプログラムの寿命をホストが管理します。 create に渡した
アドレスはバインドされず(使われるのは --addr です)、getAddress() は渡されたアドレスを
そのまま返します。ホストは、必要に応じてプログラムのインスタンスを起動します。wasmtime 49
は、1 つのインスタンスに最大 128 個のリクエストを渡します。同時に渡すのは 16 個までです。
処理中のリクエストがない状態が 1 秒間続くと、そのインスタンスを破棄します。そのため、static
フィールドの値が保たれるのは、そのインスタンスが破棄されるまでです。インスタンスの起動は、
main が終わるか、実行できるスレッドがなくなった時点で終わります。それ以降、プログラムが
動くのは、ホストがそのインスタンスのリクエストを処理中として扱っているあいだです。応答を
返したあとのリクエストも、プログラムのスレッドが時刻を待っているあいだ、またはその
リクエストの処理中にホストへ送ったリクエストの応答を待っているあいだは、処理中として
扱われます。したがって、ハンドラーがスケジュールしたタスクは、ハンドラーが応答したあとに
実行されます。最初のリクエストより前からスリープしているスレッドは、リクエストが届いた
ときに再開します。stop を呼んだインスタンスは、ホストに破棄されるまで 503 を
返します。wasi:http は、接続元のアドレスも、リクエストを受けたポートもハンドラーに
伝えません。getRemoteAddress() は 0.0.0.0:0 を返し、getLocalAddress() のポートは 80 です。
スタックが 1 本のターゲットでは、リクエストはプログラムのスレッドの 1 つとして、ほかの
スレッドと交代しながら実行されます(スレッド)。そのため、--native の
実行ファイルとコンポーネントでも、ハンドラーはほかのスレッドを待つことができ、main は
start() のあとで待ち続けることができます。待機しないスレッドが動き続けているあいだは、
どのリクエストにも応答できません。
-
--nativeの実行ファイルが次のリクエストを受け取るのは、実行できるスレッドがなくなった ときです。したがって、ハンドラーが待機しないかぎり、リクエストは 1 つずつ処理されます。 実行できるスレッドも受け取るリクエストもなければ、すべてのスレッドが待機したプログラム として拒否されます。 -
wasmtime serveでは、ハンドラーが待機しているあいだ、ホストは同じインスタンスに別の リクエストを渡します。スリープ、ほかのスレッドの終了、自分が送ったリクエストの応答、 別のリクエストの処理のどれを待っていても同じです。server.createContext("/held", exchange -> { RELEASED.await(); // /release が届くと応答する exchange.sendResponseHeaders(204, -1); }); server.createContext("/release", exchange -> { RELEASED.countDown(); exchange.sendResponseHeaders(204, -1); });ただし、待機を終わらせるリクエストは、待機しているリクエストと同じインスタンスに届く 必要があります。どのインスタンスに渡すかはホストが決めます。wasmtime 49 は、すべての リクエストが待機中のインスタンスには次のリクエストを渡しますが、複数のリクエストが同時に 届くと別のインスタンスを起動することがあります。待っているものが届かないリクエストは、 ホストが打ち切るまで待ち続けます。
ハンドラーはエグゼキューターのスレッドで実行され、エクスチェンジはハンドラーが戻ると
終わります。 エグゼキューターのないサーバーでは、リクエストを受け取るスレッドがハンドラーを
1 つずつ実行します。このスレッドの名前は、JDK と同じ HTTP-Dispatcher です。
エグゼキューターを設定したサーバーでは、このスレッドがリクエストをエグゼキューターに渡し、
ハンドラーが戻るまで待ちます。JDK のスレッドは、待たずに次のリクエストへ進みます。
ハンドラーが戻った時点で閉じられていないエクスチェンジは、そこで閉じられます。そのため、
あとから別のスレッドで応答することはできません。
チャンクで送るボディが書き込みのたびに送られるのは、wasmtime serve だけです。
sendResponseHeaders(status, 0) のあとの書き込みは、wasmtime serve では、書き込みが戻った
時点でそのチャンクが送信されています。インタプリタ、JVM、--native の実行ファイルは、
ハンドラーが戻ってから、長さを付けてボディ全体を送ります。長さを事前に知らせたボディは、
その長さをすべて書き込んだ時点で送られます。レスポンスの区切り方はトランスポートが決める
ため、ハンドラーが設定した Content-Length と Transfer-Encoding は捨てられます。
すべてのリクエストに応答があります。 ハンドラー、フィルター、オーセンティケーターが
例外を投げた場合、ハンドラーがヘッダーを送らずに戻った場合、ボディが知らせた長さに満たない
場合は、ボディのない 500 を返します。JDK は、これらの場合に接続を閉じるか、リクエストに
応答しないままにします。エグゼキューターがリクエストを受け付けなかった場合も 500 です。
start() のあとで main が例外を捕捉しなかった場合、プログラムは終了します。
stop は、JDK と同じように遅延時間を待ちます。 待つのは、処理中のリクエストすべてに
応答するか、遅延時間が過ぎるまでです。ハンドラーが呼んだ stop は、遅延時間いっぱいまで
待ちます。ハンドラーが stop を呼んだあとも処理中のリクエストが残っている場合、サーバーは
それらに応答してから閉じます。JDK は、残ったリクエストの接続を切ります。
リクエストは、ハンドラーが動く前にすべて読み込まれています。 ボディは読み込み済みです。
同じ名前で複数回送られたフィールドは、値を , でつないだ 1 つの値になります。チャンクで
送るボディを閉じたあとに書き込むと、stream closed というメッセージの IOException に
なります。JDK は、この場合に独自のクラスの例外を投げます。
名前解決は行いません。 InetAddress.getByName と、ホストを指定した InetSocketAddress
が受け付けるのは、数値で書いたアドレスと localhost です。それ以外の名前を渡すと、
getByName は UnknownHostException を投げ、InetSocketAddress は未解決のままになります。
未解決の InetSocketAddress の名前は、トランスポートがバインドします。
InetAddress.getLocalHost と逆引きのメソッドはありません。
拒否される構文
どれも、構文の名前と位置を示すエラーになります。
assert。- リフレクション。
Class.forName、クラスのメンバー、コンストラクタ、アノテーションの取得 (getMethods、getDeclaredFields、newInstance)、getInterfaces()。 long、float、double、booleanに対するswitch。修飾したsuperを通すメソッド参照と フィールド(Interface.super::m、Outer.super.x)。String、StringBuilder、ボックスを継承するクラス。java.util.concurrentのうち、概要の表にないもの。優先度順または遅延順の キュー、ConcurrentSkipListMapです。Dateを取るTimerのschedule、スレッドグループも 拒否されます。- 概要の表にないライブラリのクラスとメンバー。
TreeMap、Scanner、ファイル(File、FileReader、java.nio.file)、java.util.DateとCalendar、 リフレクションなどです。java.netでは、URI、サーバーのアドレス、HTTP クライアント以外の すべてが該当します。URL、ソケット、HttpURLConnectionです。