Kuin言語仕様109
netライブラリ

ネットワーク通信を行うライブラリ「net.kn」を解説します。

netライブラリに用意されているものはnetライブラリの通りです。

「net@makeTcpClient」は、TCPサーバへ接続した状態のTCPクライアントを作成する関数です(net@makeTcpClient関数の定義)。

「net@makeTcpClient」が生成する例外はnet@makeTcpClientメソッドの例外の通りです。

「net@makeTcpServer」は、TCPサーバを作成する関数です(net@makeTcpServer関数の定義)。

この関数を呼び出した時点で接続の待ち受けが開始されます。

49152以上のポート番号は動的に決定されることを前提としており、明示的に設定することはできません。

「net@makeTcpServer」が生成する例外はnet@makeTcpServerメソッドの例外の通りです。

「net@Tcp」はTCP通信を行うクラスで、定義はnet@Tcpクラスの定義の通りです。

「net@Tcp.connecting」は接続状態かどうかを取得するメソッドです(net@Tcp.connectingメソッドの定義)。

「net@Tcp.fin」は接続を切断するメソッドです(net@Tcp.finメソッドの定義)。

既に切断されているとき、このメソッドは何もしません。

接続はnet@Tcpクラスのインスタンスが解放されるときに自動で切断されます。 このメソッドは、切断するタイミングを明示的に制御したいときにお使いください。

「net@Tcp.receive」はデータを受信するメソッドです(net@Tcp.receiveメソッドの定義)。

net@Tcpクラスのインスタンスは内部に1MBのバッファを保持しており、受信可能なデータがあるとこのバッファに溜めていきます。 receiveメソッドは、このバッファにsize分のデータがあれば切り取って返し、なければ何もせずにnullを返します。

このため、1MBを超えるデータを一度に取得することはできません。 1MB以下の単位で分割取得してください。

「net@Tcp.receive」が生成する例外はnet@Tcp.receiveメソッドの例外の通りです。

「net@Tcp.send」はデータを送信するメソッドです(net@Tcp.sendメソッドの定義)。

通信が切断されているときは、このメソッドは何もせずに抜けます。

「net@TcpServer」はTCPサーバの処理を行うクラスで、定義はnet@TcpServerクラスの定義の通りです。

「net@TcpServer.fin」は接続の待ち受けを終了するメソッドです(net@TcpServer.finメソッドの定義)。

既に待ち受けを終了しているとき、このメソッドは何もしません。

待ち受けはnet@TcpServerクラスのインスタンスが解放されるときに自動で終了します。 このメソッドは、終了するタイミングを明示的に制御したいときにお使いください。

「net@TcpServer.get」はTCPクライアントとの接続を取得するメソッドです(net@TcpServer.getメソッドの定義)。

net@TcpServerクラスのインスタンスは待ち受け状態のときに、常にTCPクライアントからの接続要求を監視しています。 接続要求があると直ちに通信を開始し、その情報を記録しつつ、引き続き接続要求の待ち受けを続けます。

getメソッドを呼ぶと、記録したTCPクライアントの情報を1つ切り取って、データが送受信できるインスタンスの形で返します。 記録した情報が1つもなければ何もせずにnullを返します。