com.docomo_um.module.net.ssl
クラス SecureSocket

java.lang.Object
  java.net.Socket
      com.docomo_um.module.net.ssl.SecureSocket

public class SecureSocket
extends java.net.Socket

セキュアソケットを表すクラスです。

ソケット生成の一例を以下に示します。

 SecureContext context = SecureContext.getInstance();
 SecureSocketFactory factory = context.getSocketFactory();
 SecureSocket socket = factory.createSocket("example.com", 1000);
 socket.startHandshake();

 OutputStream os = socket.getOutputStream();
 os.write("Hello world!".getBytes());

 os.close();
 socket.close();
 

メソッドの概要

java.io.InputStream	getInputStream() このソケットの入力ストリームを返却します。
java.io.OutputStream	getOutputStream() このソケットの出力ストリームを返却します。
void	startHandshake() SSLハンドシェークを開始し、接続を確立します。

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

close, getInetAddress, getPort

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

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

メソッドの詳細

startHandshake

public void startHandshake()
                    throws SecureHandshakeException,
                           CommunicationFailureException

SSLハンドシェークを開始し、接続を確立します。

例外:

SecureHandshakeException - ハンドシェイクに失敗した場合に発生します。

CommunicationFailureException - 通信異常の場合に発生します。

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

このソケットの入力ストリームを返却します。

本メソッドでストリームを取得する前に、startHandshake()で接続先サーバとSSL接続を確立する必要があります。 SSL接続が確立される前に、本メソッドをコールした場合は、IOExceptionが発生します。

取得した入力ストリームで、データを受信中にIOExceptionが発生した場合、自動的にSSL接続が切断され、セキュアソケットはクローズされます。

オーバーライド:

クラス java.net.Socket 内の getInputStream

戻り値:

入力ストリームを返します。

例外:

java.io.IOException - 入力ストリームの作成時に入出力エラーが発生した場合、またはソケットが正常に接続されていない状態の場合に発生します。

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException

このソケットの出力ストリームを返却します。

本メソッドでストリームを取得する前に、startHandshake()で接続先サーバとSSL接続を確立する必要があります。 SSL接続が確立される前に、本メソッドをコールした場合は、IOExceptionが発生します。

取得した出力ストリームで、データを送信中にIOExceptionが発生した場合、自動的にSSL接続が切断され、セキュアソケットはクローズされます。

オーバーライド:

クラス java.net.Socket 内の getOutputStream

戻り値:

出力ストリームを返します。

例外:

java.io.IOException - 出力ストリームの作成時に入出力エラーが発生した場合、またはソケットが正常に接続されていない状態の場合に発生します。