java.net
クラス DatagramSocket

java.lang.Object
  java.net.DatagramSocket

public class DatagramSocket
extends Object

DatagramSocket クラスはデータグラムパケットを送受信するためのソケットを表します。

コンストラクタの概要

DatagramSocket()
データグラムソケットを生成して、ローカルホストで使用可能なポートにバインドします。

DatagramSocket(int port)
データグラムソケットを生成して、ローカルホストマシンの指定されたポートにバインドします。

DatagramSocket(int port, InetAddress laddr)
データグラムソケットを生成して、指定されたローカルアドレス・ポートにバインドします。

メソッドの概要

void	bind(int port, InetAddress address) このデータグラムソケットを、指定されたアドレス・ポートにバインドします。
void	close() このデータグラムソケットをクローズします。
void	connect(InetAddress address, int port) このソケットを指定されたリモートアドレス・ポートに接続します。
void	disconnect() ソケット接続を切断します。
void	receive(DatagramPacket p) このソケットからデータグラムパケットを受信します。
void	send(DatagramPacket p) 指定されたデータグラムパケットをこのソケットで送信します。

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait

コンストラクタの詳細

DatagramSocket

public DatagramSocket()
               throws IOException

データグラムソケットを生成して、ローカルホストで使用可能なポートにバインドします。 また、データグラムソケットはワイルドカードアドレス（システムに選択されたIPアドレス）にバインドされます。

例外:

IOException - I/Oエラーが発生した場合

DatagramSocket

public DatagramSocket(int port)
               throws IOException

データグラムソケットを生成して、ローカルホストマシンの指定されたポートにバインドします。 また、データグラムソケットはワイルドカードアドレス（システムに選択されたIPアドレス）にバインドされます。

パラメータ:

port - ポート番号。0から65535までの値。 このパラメータに有効なポート番号以外を指定した場合の振る舞いは保証されません。

例外:

IOException - I/Oエラーが発生した場合

DatagramSocket

public DatagramSocket(int port,
                      InetAddress laddr)
               throws IOException

データグラムソケットを生成して、指定されたローカルアドレス・ポートにバインドします。 また、laddr が0.0.0.0 の場合、ワイルドカードアドレス（システムに選択されたIPアドレス）にバインドされます。

パラメータ:

port - ローカルポート番号。0から65535までの値。 このパラメータに有効なポート番号以外を指定した場合の振る舞いは保証されません。

laddr - ローカルアドレス

例外:

IOException - I/Oエラーが発生した場合

メソッドの詳細

bind

public void bind(int port,
                 InetAddress address)
          throws IOException

このデータグラムソケットを、指定されたアドレス・ポートにバインドします。

パラメータ:

port - ポート番号。0から65535までの値。 このパラメータに有効なポート番号以外を指定した場合の振る舞いは保証されません。

address - アドレス

例外:

IOException - I/Oエラーが発生した場合

close

public void close()

このデータグラムソケットをクローズします。

このメソッドが呼び出されると、このソケットの入出力でブロックされているスレッドがあれば、そのスレッドでは IOException がスローされます。

receive

public void receive(DatagramPacket p)
             throws IOException

このソケットからデータグラムパケットを受信します。 このメソッドはデータグラムを受信するまでブロックします。

このメソッドが呼び出し元に帰ると、DatagramPacket p のバッファには受信したデータが格納されています。 p.getLength は受信したメッセージの長さを表します。 もしメッセージの実際の長さが p の長さより長かった場合、メッセージは切り詰められて格納されています。 また、p は送信元のIPアドレスとポートの情報を保持しており、getAddress と getPort でそれぞれ取得できます。

パラメータ:

p - 着信したデータを格納するデータグラムパケット

例外:

IOException - I/Oエラーが発生した場合

send

public void send(DatagramPacket p)
          throws IOException

指定されたデータグラムパケットをこのソケットで送信します。 p に設定されている送信データを、p に設定されているIPアドレス・ポートに送信します。

パラメータ:

p - 送信するデータグラムパケット

例外:

IOException - I/Oエラーが発生した場合

connect

public void connect(InetAddress address,
                    int port)
             throws IOException

このソケットを指定されたリモートアドレス・ポートに接続します。 リモートアドレスに接続した場合、データグラムパケットはそのアドレスとの間でだけ送受信できます。

パラメータ:

address - 接続先リモートアドレス

port - 接続先リモートポート。 このパラメータに有効なポート番号以外を指定した場合の振る舞いは保証されません。

例外:

IOException - I/Oエラーが発生した場合

disconnect

public void disconnect()
                throws IOException

ソケット接続を切断します。 ソケットが接続されていない場合、このメソッドは何もしません。

このメソッドが呼び出されると、このソケットの入出力でブロックされているスレッドがあれば、そのスレッドでは IOException がスローされます。

例外:

IOException - I/Oエラーが発生した場合