java.net
クラス Socket

java.lang.Object
  java.net.Socket

public class Socket
extends Object

このクラスはクライアントソケットを実装しています。 このクラスのメソッドはすべて処理が終了するまでブロックします。

ソケットはコンストラクタの呼び出しによって生成します。 コンストラクタが例外をスローしなければ、サーバとクライアントの間で接続に成功したことを意味します。

ソケットでデータを送信または受信するには、ソケットに付属する OutputStream または InputStream をそれぞれ使います。

たとえば、一つのスレッドでデータを送信して、別のスレッドで受信するなど、ソケットは複数の並行スレッドから安全に使用できます。 ただし、送信、受信のスレッドはそれぞれ同時に一つのスレッドだけが送信または受信できます。

コンストラクタの概要

Socket(String host, int port)
ストリームソケットを作成し、指定されたホストの、指定されたポートに接続します。

メソッドの概要

void	close() このソケットをクローズします。
InetAddress	getInetAddress() このソケットが接続されている接続先のアドレスを返します。
InputStream	getInputStream() このソケットの入力ストリームを返します。
OutputStream	getOutputStream() このソケットの出力ストリームを返します。
int	getPort() このソケットが接続されている接続先のポート番号を返します。

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

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

コンストラクタの詳細

Socket

public Socket(String host,
              int port)
       throws UnknownHostException,
              IOException

ストリームソケットを作成し、指定されたホストの、指定されたポートに接続します。

パラメータ:

host - ホストの名前

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

例外:

UnknownHostException - ホストのIPアドレスが解決できなかった場合

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

メソッドの詳細

getInetAddress

public InetAddress getInetAddress()

このソケットが接続されている接続先のアドレスを返します。

戻り値:

このソケットが接続されている接続先のIPアドレス。 接続されていなければ null 。

getInputStream

public InputStream getInputStream()
                           throws IOException

このソケットの入力ストリームを返します。 この入力ストリームを使用してソケットからデータを受信できます。

戻り値:

このソケットの入力ストリーム

例外:

IOException - I/Oエラーが発生した場合。 下位の接続が異常な状態の場合。 たとえば接続がクローズされている、ソケットが接続されていないなど。

getOutputStream

public OutputStream getOutputStream()
                             throws IOException

このソケットの出力ストリームを返します。 この出力ストリームを使用してソケットにデータを送信できます。

戻り値:

このソケットの出力ストリーム

例外:

IOException - I/Oエラーが発生した場合。 下位の接続が異常な状態の場合。 たとえばソケットが接続されていないなど。

close

public void close()
           throws IOException

このソケットをクローズします。 このメソッドは、このソケットの入力ストリームと出力ストリームもクローズします。

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

いったんソケットをクローズすると、再度ネットワーク処理を実行するには新たなソケットを作成する必要があります。 クローズしたソケットでは再接続などのネットワーク処理は実行できません。

例外:

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

getPort

public int getPort()

このソケットが接続されている接続先のポート番号を返します。

戻り値:

このソケットが接続されている接続先のポート番号。 まだ接続されていなければ 0。