(rontolisp) docs
← プロトコル、レコード、型

defprotocol

(defprotocol Name docstring? (method [target & args]+ docstring?)*)

プロトコルを宣言します。メソッドごとにターゲットのタグ上のディスパッチャ(階層 探索なしの multimethod 形)を持ちます。名前はプロトコルのマップをオラクルと同じ形で 答えます。:on/:on-interface にインタフェース(ここではクラスキーワード)、:sigs に 各メソッドのパラメータベクター、メソッドマップと拡張表を :impls に持ち、extend・ satisfies?・extends?・extenders は呼び出し位置の名前と同様にこれを受け取ります。 :var と :method-builders は持ちません。インタフェースのドット付きの名前(user.P、 my_app.core.P)はそのクラス値です。名前として印字し、class? に答え、それへの instance?、isa?、class でディスパッチするマルチメソッドは、本体でプロトコルを実装する record・deftype・reify をオラクルと同じく受け取ります(拡張では実装になりません)。その print-method も同様です。:on-interface のキーワードとは = になりません。 呼び出しは ターゲットのタグの完全一致、次にターゲットが継承または実装するクラスのうちプロトコルを extend したもの(throwable、IRef など。extend-protocol)、 それから Object 行でディスパッチし、Object 行なしの外れはオラクル同様シグナルを 上げます。メソッドはアリティごとに1つのパラメータ ベクターを宣言し、どのベクターも先頭でターゲットを受け取ります。呼び出しは、実装の アリティのうち引数の数が一致するものに届きます。defrecord・deftype・reify の本体は メソッド名を別のパラメータベクターで書き直して別のアリティを実装し、どのアリティも プロトコルが宣言したものでなければなりません。extend-protocol、 extend-type、extend はアリティを fn の節として書きます。 実装が受け取らない引数の数の呼び出しは ArityException をシグナルします(インライン本体が 実装していないアリティについて、オラクルは AbstractMethodError を投げます)。

メソッドを1つも宣言しないプロトコル(マーカープロトコル)も書けます。extend-type・ extend-protocol・extend・defrecord・deftype・reify は実装なしでそれを名指しでき、 satisfies?/extends? は他のプロトコルと同じように答えます。

:extend-via-metadata true のプロトコルでは、値がメタデータ(with-meta) でもメソッドを実装できます。キーは名前空間で修飾したメソッドのシンボル(`area または 'user/area)です。順序はオラクルと同じで、defrecord/deftype/reify 本体の実装、 メタデータ、extend-type の行と Object の順です。satisfies? はオラクル同様メタデータを 見ません。