組み込みクラスと標準ライブラリのメソッドレベルの完全リファレンスは NDA パートナー向けに各リリースに同梱される。本ページはどのクラスが存在するかの概観と該当 example へのポインタを示す。
Core
Array と String の at: / at:put: / indexOf: / copyFrom:to: などのインデックス系メソッドは Smalltalk 慣習に従い 1-based。at: 1 が最初の要素。
| クラス | 概要 |
|---|---|
Integer | 標準算術、factorial、negated、timesRepeat:、to:、to:do:、ビット演算、比較 (min: / max: は Comparable 由来)、abs / squared / sign / between:and:。整数のゼロ除算はトラップせず、捕捉可能なエラーを送出する |
Float | IEEE 754 double で、Smalltalk の Number プロトコルを通常の名前で持つ — 算術と 4 つの比較、sqrt / raisedTo: / squared / reciprocal、exp / ln (自然) / log (常用) / log:、ラジアンの三角関数とその逆関数に degreesToRadians / radiansToDegrees と 2 引数の arcTan:、min: / max: / between:and: / sign、倍数に丸める roundTo: / truncateTo:、Integer を返す truncated / rounded / floor / ceiling / asInteger、有限範囲を出た計算を見る isFinite / isNaN、クラスメソッドの Float pi / e / epsilon / infinity / nan。ゼロ除算はハードウェアどおり infinity を返し、raise しない。暗黙の変換は無く 1 + 1.5 は型エラー、1 asFloat + 1.5 と書く — 式の型は値ではなく書かれたものに従う。リテラルは指数を取れる (1.0e10、1e-9) |
Boolean, True, False | ifTrue:ifFalse:、and:、or:、not。分岐が片方だけの ifTrue: / ifFalse: はレシーバ (その Bool) を返す — ブロックが走らなかった場合の値が無いので、値として使うことはできず、((x > 3) ifTrue: [5]) + 1 はコンパイルエラーになる |
String | バイト列であって文字列ではない — 'あ' size は 3、at: / copyFrom:to: はバイトを数えるので、任意の位置で切ると文字の途中で割れる。テキスト・ソケットのペイロード・エンコード済み blob が変換なしに同じ型になるのはこのため。文字単位で見たい時は charCount が UTF-8 のコードポイントを数え、charsFrom:to: / charAt: がその数え方で切る (charAt: が 1 文字の String を返すのは、Char が 1 バイトでマルチバイト文字を持てないから)。String fromCodes: でバイトから組み立てる。スライス、concat:、asUppercase、asLowercase、trimmed、正規表現マッチ、lines、replaceAll:with:、< |
Char | 1 バイト。文字述語と変換 (マルチバイト文字は 1 文字の String として扱う) |
Regex | compile: / compileIgnoringCase: (ASCII 英字の大小を無視) してから matches:、match:、findAll:、split:、replaceAll:with:、置換をブロックで組む replaceAll:using:、そして RegexMatch を返す search: / searchAll: — グループは group: で番号、named: で名前から読み、text / start / end も持つ。Perl 構文で、入力長に対して線形時間。lookaround と後方参照は持たない (String の正規表現系はこれ経由でディスパッチ) |
Decimal | 金額のための正確な十進。リテラルは Smalltalk の ScaledDecimal 形 (1.50s2、1.50s、3s2) で、スケールより小数桁が多いのは lex エラー。+ / - / * は正確で、/ は無い — divide:scale:rounding: / roundTo:rounding: / asIntegerRounding: がスケールと丸め (Rounding halfEven / halfUp / halfDown / up / down / ceiling / floor / unnecessary) を名指し、既定の丸めは存在しない。比較と abs / negated / sign / isZero / min: / max: / between:and: / scale。Number の下ではなく Object の下にいて、何も自動では変換しない (Integer asDecimal、Float asDecimalScale:rounding:、String asDecimal は Maybe、Decimal asFloat)。JSON は文字列として書き、ワイヤは {"__class": "Decimal", ...}。SQLite / PostgreSQL / MariaDB / Redis には全桁テキストで渡り、TORM の式評価器も正確に比較・計算する |
Date | 時刻もゾーンも持たない暦日 (Java の LocalDate に相当) — y:m:d:、parse:、today、todayIn:、year / month / day、dayOfWeek (ISO) / dayOfYear、addDays: / addMonths: / addYears:、startOfMonth / endOfMonth、isLeapYear、daysSince:、isoString / formattedAs:、比較と min: / max:、asDateTime |
DateTime | ゾーンを持たないカレンダー読み (Java の LocalDateTime に相当) — now、parse:、fromMs:、y:m:d:h:min:s: (+ ms:)、formattedAs:、isoString、year … millisecond のフィールドアクセサ (ミリ秒精度)、asInstantIn: |
Instant | 時間軸上の 1 点 (Java や Temporal の Instant) — now、parse: (RFC 3339)、fromMs:、asMs、addMs: / msSince:、比較と min: / max:、isoString。DateTime との往復は必ずどのゾーンで読むかを名指す — asDateTimeIn: / asDateTimeOffset: / asLocalDateTime、dateIn:、isoStringIn: / isoStringOffset: |
TimeZone | IANA データベースの名前付きタイムゾーン (夏時間を含む) — named:、local、utc、names、offsetAt:、databaseVersion。データベースはランタイムに内蔵されているので、どの機械でも同じリリースを読む |
Error | Error raise: で送出、Error try:onError: で捕捉 — ハンドラはメッセージ文字列を受け取る (例外型の階層は持たない) |
Array | 永続 32-way trie、with:、at:、at:put:、size、sort:、indexOf:、,。`Array build: [:add |
Dict | 永続 HAMT、new、from:、at:、at:put:、at:ifAbsent:、at:ifPresent:ifAbsent:、includesKey:、keys、size、associations、組み込みの do: / collect: / select: / reject: |
Set | 永続。2 つの構造を持ち、最初に追加された順を保つ Array が反復順を決め、要素をキーにした Dict がメンバシップに答える。だから includes: と add: は Dict 参照 1 回で実質定数時間、remove: は Array を作り直すので O(n) |
Maybe | パラメータ化された不在型、none、some:、ifPresent:ifAbsent:、値がある時だけ何かする ifPresent: (ブロックを走らせ、どちらの場合もレシーバを返す)、isPresent |
Block | value、value:、value:value: ... valueWithArguments:、whileTrue:、ensure: |
Class | クラスメタ操作、リフレクション。name / className は書かれたとおりの名前、qualifiedName は Mod::Name の同一性 (ワイヤを渡り grain の状態を引くのはこちら)、superclass、protocols、methodSelectors ほか |
Object | 値は 2 つの形で表示される — printString / printNl / print: はプログラマが読む形 (String は 'it''s' と引用符付き、Char は $a、Symbol は #name)、displayString / displayNl / display: は人が読む形 (String・Char・Symbol はその文字だけ、他の値は printString と同じ)。コレクション・レコード・Maybe・Future の結果・インスタンスのフィールドは、どちらの形でも中身を printString で見せる。asString は displayString で、WriteStream の << はそれを書き、print: は printString を書く。クラスは printString / displayString に答えれば自分のインスタンスの見せ方を決められ、コレクションの中でもその形で現れる。ほかに =、~=、printOn: (printString を書く)、className、isKindOf:、isMemberOf: (クラスそのものを比較)、fieldNames、atField:、atField:put:、copyWith: (型付き不変更新 — フィールド名はクラス宣言に、値はフィールド型に対して検査される)、asObject、perform:、perform:withArgs: |
WriteStream | << は displayString を書き (printOn: プロトコル経由でディスパッチ)、print: は printString を書く。ほかに nl、space、tab、position、isEmpty、reset |
Comparable, Arithmetic, Numeric, Enumerable | プロトコル制約付きミックスイン。Arithmetic が + / - / * を宣言し Number と Decimal が実装、Numeric が / と \\ を宣言し Number だけが実装する — だから総称的な加減乗算は Decimal にも効き、総称的な除算は Decimal を受け付けない (Decimal の除算はスケールと丸めを名指す必要があるため)。Enumerable は組み込みの反復メソッドの上に乗るより広いプロトコル (detect:、min、max、sum、count、count:、detect:ifNone:、anySatisfy:、allSatisfy:、noneSatisfy:、joinWith:、flatCollect:、do:separatedBy:、firstIfEmpty:、lastIfEmpty:) |
アクターと並行性
| クラス | 概要 |
|---|---|
Actor | self、spawn:、!、receive、receive:、receive:after:do:、ask:、monitor:、linkTo:、trapExits:。既に死んだアクターへの monitor: / linkTo: は登録を捨てずにその死を報告する。モニタもリンクも観測できない異常死は stderr に報告される |
Future | await、await:、resolved?、pending?、resolve:、fail:、new (手動生成)、Future sleep: ms (その時間が過ぎるとタイマーが完了させる Future。タイマーは作ったアクターのものではないので、そのアクターが止まっても走り続ける) |
Down, Exit | アクター参照と失敗理由を運ぶモニタ / リンク失敗エンベロープ |
サービス層
| クラス | 概要 |
|---|---|
HTTP, HttpServer, HttpResponse, HttpRequest | HTTP サーバはハンドラとしてブロックを取る。chunked と keepalive 対応。start:handler: / startGraceful:handler: は全インタフェースを、startHost:port:handler: / startGracefulHost:port:handler: は 1 つのローカルアドレスを束縛する。HttpRequest >> peerAddress はリクエストの送信元アドレス (送信元ごとのレート制限に要るもの。リバースプロキシの後ろではプロキシのアドレスになり、X-Forwarded-For を信じるかはアプリケーションの判断)。ファイルアップロード向けに HTTP parseMultipart:boundary: → MultipartPart (name / filename / contentType / bytes)。サーバ・HTTP parseResponse:・Remote・送信クライアントはメッセージを 1 つのパーサで読む — 1 行は最大 16 KiB、ヘッダブロックは最大 100 行、ヘッダ名はトークンでなければならず (Content-Length : 10 は別名で保持せず拒否)、Content-Length は数字のみで食い違う 2 つは拒否、チャンクサイズは 16 進数字のみ、相手が閉じて途中で切れた body はエラー (短い body ではない)。Content-Length と Transfer-Encoding の両方を持つリクエスト、最後の coding が chunked でない Transfer-Encoding は、長さが決まらないので拒否する。サーバはリクエスト行とヘッダに、そして body にも、クライアントと同じ読み取り予算 (LAMBDA_PRELUDE_HTTP_TIMEOUT_MS、既定 30 秒) を与え、リクエストの合間にその時間だけ黙った keep-alive 接続は閉じる |
LpHttpClient | HTTP クライアント — get:retries: / get:headers:retries:、post:body:contentType:retries: / post:body:contentType:headers:retries: → HttpResponse。https:// に到達でき、相手はシステムの証明書ストアと URL に書かれた名前で検証する — ホスト名は証明書の DNS 名に対して、アドレスは IP エントリに対して照合し、どちらでもない名前は検証できないので接続せず拒否する。Host / Content-Length / Connection / Content-Type はクライアントが書き、呼び出し側からは拒否。ヘッダ名と値は検査され、信頼できない入力から組んだヘッダでリクエストを分割できない。接続後の応答待ちは 30 秒で打ち切る (LAMBDA_PRELUDE_HTTP_TIMEOUT_MS で変更) ので、ヘッダだけ返して黙るサーバが呼び出し側アクターを掴み続けることはない。Remote / grain の RPC 経路は http のみ |
Smtp | smtp プラグイン (Plugin load: 'smtp') + stdlib の Smtp モジュール。Smtp send: conf to: addr subject: sub text: body で 1 通を 1 宛先へ送る。plain / STARTTLS / wrapped TLS、相手はシステムの証明書ストアで検証。件名は RFC 2047 encoded word、本文は base64 で送るので、送り手の書いた行が data を早く終わらせることはない。ハンドシェイクと全 read を 1 つの予算で見る (60 秒、LAMBDA_PRELUDE_SMTP_TIMEOUT_MS)。答え (SmtpResult) は拒否された段階を名指すので、パスワード違いと送信者拒否が区別できる |
TCP, TCPSocket, TCPServer | アクタースケジューラと統合された境界つきソケット I/O。TCPSocket >> peerAddress は接続の相手側のアドレス。IPv4 と IPv6 の両方を話し、サーバは両方で listen、クライアントはどちらでも接続する (RFC 8305 — 両系統を並行に試して先に繋がった方を使う)。listenHost:port: と UDP bindHost:port: は IPv6 アドレス ('::1') を取る。URL とデータベース URI では IPv6 ホストは角括弧で書く (http://[::1]:8080/rpc、postgresql://app@[::1]:5432/db)。listen: は全インタフェース、listenHost:port: は 1 つのローカルアドレスを束縛する。ホスト名解決はバックグラウンドの解決スレッドで走り connect も非ブロッキングなので、遅い DNS サーバも遅いハンドシェイクもドメインを止めない |
TLS, TLSSocket | Tls.Engine 駆動、ハンドシェイク / read / write が I/O wait で待機 |
UDP, UDPSocket, UDPDatagram | データグラムソケット — bind: / bindHost:port:、sendTo:port:data:、receiveFrom / receiveFrom: (境界つき。期限を過ぎると raise)。受信した UDPDatagram は応答用に送信元 host / port を保持 |
WebSocket | accept:on:、isUpgrade:、readFrame:、writeText:to:、writeBinary:to:、writePong:to:、writeClose: |
JSON, Json | JSON parse: はドキュメントの 1 ノードを表す Json を返す — at: / at:ifAbsent: / includesKey: / keys / asArray / size でたどり、プログラムが期待する型のメソッド stringValue / asInteger / asFloat / asBoolean / isNull で値を取る。最初の使い方が型を固定することがないので、1 つのノードを Integer と String の両方として読むコードはその場で落ちる。JSON serialize: は普通の値を書き出し、wireEncode: / wireDecode:allowedClasses: がクラス付きのワイヤ形式を扱う |
JsonRpcServer, JsonRpcClient | JSON-RPC 2.0 ディスパッチ — 単一・バッチ・通知・エラーエンベロープ |
Remote | Remote at:for:id: — JSON-RPC 越しのリモートクラスへのプロキシ。リテラルのクラスで構築すると対象クラスのプロトコルに対して型付けされる (非リテラルの for: は動的型付けのまま)。接続は呼び出しごとに張り直さず host:port ごとに再利用し、取り出した接続を相手が閉じていた場合は新しい接続で 1 度だけ再試行する |
TeriosServer, ServiceDispatcher, Res | TERIOS 方式の serviceName / requestDto / responseDto / errorInfoList エンベロープ |
ランタイム
| クラス | 概要 |
|---|---|
File | read:、write:contents:、delete:、exists:、mkdirP:、removeDir: (空ディレクトリ)、rename:to:、listDir:、isDir:、isFile:。追記専用ログ向けに File open: が握り続けるハンドル (FileHandle) を返す — readAt:size: (ファイルが先に終われば少ないバイト数)、append:、size、truncateTo:、sync、close、tryLock。ハンドルは自分の位置を持たないので read が次の write の位置を動かさず、走査は offset を値として持ち回る。tryLock は待たずにファイル全体の排他ロックを取り、他に保持者がいれば false。ロックはハンドルに属し、close か プロセス終了で (どう終わっても) 外れる — Linux では flock なので同じファイルの別の fd を閉じても落ちず、OS spawn: の子はハンドルを継承しない |
OS | stdinLine、stdinAll、stdinPasswordLine (Windows コンソールおよび POSIX TTY でエコー抑制)、hostname、デフォルト付き環境変数。flush — printNl は行を終えて画面に渡すが print はどちらもしないので、print で書いたプロンプトは flush してから入力を待つ。時計 — time はカレンダー用の壁時計、monotonic (ms) と timeNs (ns) は単調時計で、経過時間と周期の測定に使う。サブプロセス & ウォッチドッグ — exec: / exec:input:、fire-and-forget な spawn: / spawn:output:、running: 生存確認、kill:、gracefulShutdown: |
Log | 構造化ロギング (info:、warn:、error:、key-value フィールド) |
データ
| クラス | 概要 |
|---|---|
DB, DBConnection, DbRow | SQLite (組み込み) — open:、exec:、query:、close。パラメータは文中で名前を付けてレコードで渡す exec:with: / query:with: (db exec: 'INSERT INTO orders (name, due) VALUES (:name, :due)' with: { name: 'apple', due: aDate }) か、位置で渡す exec:params: / query:params:。トランザクションは `withTx: [:c |
Postgres, PostgresConnection | Dynlink プラグイン経由 PostgreSQL (インタプリタ / AOT)。呼び出しは専用スレッドで応答を待つので、その間ドメインの他のアクターは走り続け、接続プールはクエリを並行に捌く |
Mariadb, MariadbConnection | Dynlink プラグイン経由 MariaDB / MySQL (インタプリタ / AOT) |
Redis, RedisConnection | Dynlink プラグイン経由 Redis / Valkey (RESP2 over アクタースケジューラ統合 non-blocking TCP)、ping / get: (Maybe を返す) / set:value: / set:value:ex: / del: / incr: / decr: / exists: / expire:seconds: / keys: / auth: / cmd: (Json を返す) / close。複数コマンドをまとめるのは `transaction: [:tx |
TORM | Doma の 2-way SQL を移植した SQL ファイルマッピング + DAO / Entity マクロ DSL (dao: / entity: キーワード、imports: (Torm) で取り込むプラグイン)。dialect は PostgreSQL / MySQL / MariaDB / SQLite / Oracle。バインド変数・リテラル変数・埋め込み変数、%if / %elseif / %else と、空になった WHERE / GROUP BY / HAVING / ORDER BY の除去および先頭に残った AND / OR の除去、%for と <name>_index / <name>_has_next、entity: クラスからの %expand / %populate、Doma の式言語と関数、DB ごとのファイル (Find-postgres.sql) の優先、Doma のネーミング型、ビルダ設定 (IN リストのパディング、空行とコメントの除去)。Doma と違う点は実装に同梱の docs/TORM.md に列挙。DAO メソッドの答えは名前で決まる — count* はスカラー、exists* は Boolean、insert* / update* / delete* は影響行数、それ以外は行 — 名前にその接頭辞が無い文には { file: 'CreateUsers.sql', kind: #exec } と明示できる。DateTime は各 DB の timestamp としてバインドされる |
暗号
| クラス | 概要 |
|---|---|
Hash | SHA-256、SHA-512、HMAC-SHA-256 (hmacSha256:key:) |
Aes | AES-256-GCM |
Argon2 | Argon2id パスワード KDF (RFC 9106)、システム libargon2 経由 |
JWT | sign / verify |
Random | Random hex: — ランダム hex 文字列 |
Base64 | encode: / decode: は標準アルファベット + パディング、encodeUrl: / decodeUrl: は URL-safe アルファベットでパディング無し。decode は読めない入力を拒否し、間違った答えを返さない |
運用
| クラス | 概要 |
|---|---|
LpCache | サイズ / TTL 制約付きインメモリキャッシュ組み込み (start:、at:、at:put:、at:put:ttl:)。失効はスケジューラの単調時計で計るので、壁時計が飛んでも TTL は伸び縮みしない。キーは値として比較される |
LpChannel | プロセス内 pub/sub。subscribe:do: / publish:message: / subscriberCount |
Supervisor | monitor: + spawn: 上の one-for-one / one-for-all / rest-for-one 戦略。OTP の再起動強度を持ち、restarts: n within: seconds (既定 5 秒) を超えた監督者は子を止めて自分もエラーで死ぬので、それを監視またはリンクしている側が受け取る |
Metric | サービスレベル計測のための名前付きインメモリカウンタ |
Test | run:do:、assert:、assert:message:、assertEqual:to:、fail:、summary |
標準ライブラリモジュール
stdlib/ 配下に .lp ファイルとして同梱、ファイル先頭の imports: (...) ヘッダで読み込む。標準ライブラリは意図的に小さく保ち、以下が全モジュール。
コアプロトコル
comparable.lp—<ベースのデフォルト (>/min:/max:等) を持つComparableプロトコルenumerable.lp—do:ベースのデフォルトの上に乗るより広いEnumerableプロトコル (detect:/min/max/sum/count:/joinWith:/flatCollect:等)。中核の反復メソッドはArrayとDictに組み込み済みなので、import するのは残りの分と、自作クラスに乗せる場合set.lp— 永続Set、add:/remove:/includes:(順序は Array、メンバシップは Dict)ordered_dict.lp— 反復時に挿入順を保つDictバリアントassociation.lp— (key, value) ペアオブジェクト。Dict>>associations/Dict>>associationsDo:の要素型
サービスランタイム
http.lp—HTTP組み込みの上に乗せる accept ループと keep-alive 対応コネクションハンドラjson_rpc.lp— JSON-RPC 2.0 サーバ / クライアント (single / batch / notification / error)lp_server.lp— LP サービスを 1 行で JSON-RPC 2.0 エンドポイントとして公開sse.lp— HTTP/1.1 chunked 上の Server-Sent Events ライタcache.lp— 容量 (LRU) と任意 TTL 付きのアクター所有 KV キャッシュgrain.lp— 仮想アクター (grain):GrainServer/GrainStore/RedisGrainStore、ディレクトリ+オーナ+リースによる単一活性化、フェンストークン付きクロスノードリース、差し替え可能ストアsmtp.lp—SmtpConf(host / port / security / user / password / sender) とSmtpResult(ok / stage / detail)。プロトコル本体はsmtpプラグイン
コネクションプール (プラグイン — インタプリタ / AOT)
postgres_pool.lp—postgresプラグイン上の固定サイズプール、withConn:APImariadb_pool.lp—mariadbプラグイン上の固定サイズプール (MariaDB / MySQL)redis_pool.lp—redisプラグイン上の固定サイズプール (Redis / Valkey)
スーパーバイザ
supervision.lp—monitor:+spawn:の上に乗せる one-for-one / one-for-all / rest-for-one 戦略
TERIOS ツールキット (stdlib/terios/)
terios/rpc.lp— TERIOS RPC エンベロープディスパッチ (serviceName/requestDto/responseDto/errorInfoList)terios/auth.lp— bearer トークン認証スカフォールド + HTTP ミドルウェアterios/transformer.lp— 宣言的 JSON 変形エンジン (DataTransformer 移植)terios/validators.lp— クラス宣言のvalidates:キーワード向けの宣言的バリデータ
TORM ツールキット (stdlib/torm/)
torm/entity_listener.lp—prePersist:/postLoad:系フックを持つEntityListenerプロトコルtorm/select_options.lp— Doma 方式の不変 SELECT オプション (ページング / ロックヒント)