Java-WebSocket 项目的研究(三) WebSocketClient 类 详解

通过之前两篇文章

Java-WebSocket 项目的研究(一) Java-WebSocket类图描述


Java-WebSocket 项目的研究(二) 小试身手:客户端连接服务器并发送消息实例

的介绍我们大概了解到了整个项目的类结构,其中有一个重要的类:WebSocketClient,下面就让我们详细了解一下这个类


首先看一下我们之前的类图关于WebSocketClient的描述,可以看出:

1.继承自WebSocketAdapter

2.依赖于类WebSocketImpl(实际上关于WebSocket核心代码都在类WebSocketImpl里)

3.实现了WebSocket接口(实际上通过类WebSocketImpl实现的)


很简单的,从字面意思我们就大概能猜到WebSocketAdapter是适配器类,架起了WebSocketImplWebSocketClient之间的桥梁,WebSocketImpl是web implementation的缩写,意思就是真正实现了websocket里主要的功能。


然后我们看一下WebSocketClient的几个主要方法:

首先是connect方法

[java] view plain copy print ?
  1. /** 
  2.      * Initiates the websocket connection. This method does not block. 
  3.      */  
  4.     public void connect() {  
  5.         if( writeThread != null )  
  6.             throw new IllegalStateException( "WebSocketClient objects are not reuseable" );  
  7.         writeThread = new Thread( this );  
  8.         writeThread.start();  
  9.     }  
/**
	 * Initiates the websocket connection. This method does not block.
	 */
	public void connect() {
		if( writeThread != null )
			throw new IllegalStateException( "WebSocketClient objects are not reuseable" );
		writeThread = new Thread( this );
		writeThread.start();
	}

我们可以发现:

他其实是起了一个线程,由于WebSocketClient类实现了Runnable接口,因此他会自动去调用run方法,然后我们进一步到run方法里去一探究竟

[java] view plain copy print ?
  1. public void run() {  
  2.         try {  
  3.             if( socket == null ) {  
  4.                 socket = new Socket( proxy );  
  5.             } else if( socket.isClosed() ) {  
  6.                 throw new IOException();  
  7.             }  
  8.             System.out.println("---->  "+uri.toString()+"   port: "+getPort() );  
  9.             if( !socket.isBound() )  
  10.                 socket.connect( new InetSocketAddress( uri.getHost(), getPort() ), connectTimeout );  
  11.             istream = socket.getInputStream();  
  12.             ostream = socket.getOutputStream();  
  13.   
  14.             sendHandshake();  
  15.         } catch ( /*IOException | SecurityException | UnresolvedAddressException | InvalidHandshakeException | ClosedByInterruptException | SocketTimeoutException */Exception e ) {  
  16.             onWebsocketError( engine, e );  
  17.             engine.closeConnection( CloseFrame.NEVER_CONNECTED, e.getMessage() );  
  18.             return;  
  19.         }  
  20.   
  21.         writeThread = new Thread( new WebsocketWriteThread() );  
  22.         writeThread.start();  
  23.   
  24.         byte[] rawbuffer = new byte[ WebSocketImpl.RCVBUF ];  
  25.         int readBytes;  
  26.   
  27.         try {  
  28.             while ( !isClosed() && ( readBytes = istream.read( rawbuffer ) ) != -1 ) {  
  29.                 engine.decode( ByteBuffer.wrap( rawbuffer, 0, readBytes ) );  
  30.             }  
  31.             engine.eot();  
  32.         } catch ( IOException e ) {  
  33.             engine.eot();  
  34.         } catch ( RuntimeException e ) {  
  35.             // this catch case covers internal errors only and indicates a bug in this websocket implementation   
  36.             onError( e );  
  37.             engine.closeConnection( CloseFrame.ABNORMAL_CLOSE, e.getMessage() );  
  38.         }  
  39.         assert ( socket.isClosed() );  
  40.     }  
public void run() {
		try {
			if( socket == null ) {
				socket = new Socket( proxy );
			} else if( socket.isClosed() ) {
				throw new IOException();
			}
			System.out.println("---->  "+uri.toString()+"   port: "+getPort() );
			if( !socket.isBound() )
				socket.connect( new InetSocketAddress( uri.getHost(), getPort() ), connectTimeout );
			istream = socket.getInputStream();
			ostream = socket.getOutputStream();

			sendHandshake();
		} catch ( /*IOException | SecurityException | UnresolvedAddressException | InvalidHandshakeException | ClosedByInterruptException | SocketTimeoutException */Exception e ) {
			onWebsocketError( engine, e );
			engine.closeConnection( CloseFrame.NEVER_CONNECTED, e.getMessage() );
			return;
		}

		writeThread = new Thread( new WebsocketWriteThread() );
		writeThread.start();

		byte[] rawbuffer = new byte[ WebSocketImpl.RCVBUF ];
		int readBytes;

		try {
			while ( !isClosed() && ( readBytes = istream.read( rawbuffer ) ) != -1 ) {
				engine.decode( ByteBuffer.wrap( rawbuffer, 0, readBytes ) );
			}
			engine.eot();
		} catch ( IOException e ) {
			engine.eot();
		} catch ( RuntimeException e ) {
			// this catch case covers internal errors only and indicates a bug in this websocket implementation
			onError( e );
			engine.closeConnection( CloseFrame.ABNORMAL_CLOSE, e.getMessage() );
		}
		assert ( socket.isClosed() );
	}


下面我们对上面的代码进行详细研究:

[java] view plain copy print ?
  1. socket = new Socket( proxy );  
				socket = new Socket( proxy );

这句显而易见,是创建了一个socket套接字。

[java] view plain copy print ?
  1. socket.connect( new InetSocketAddress( uri.getHost(), getPort() ), connectTimeout );  
				socket.connect( new InetSocketAddress( uri.getHost(), getPort() ), connectTimeout );

这句的意思是创建连接,参数就是服务器地址,端口号,超时时间。

[java] view plain copy print ?
  1. istream = socket.getInputStream();  
			istream = socket.getInputStream();

是接受服务器端的数据,关于接受的详细过程,我会在后期的博客中阐述,敬请期待。

[java] view plain copy print ?
  1. ostream = socket.getOutputStream();  
			ostream = socket.getOutputStream();

是发送数据用的。

其他的先不解释,我们继续之前的流程------connect之后就要发送信息,也就是调用send方法,send方法如下:

[java] view plain copy print ?
  1. /** 
  2.      * Sends text to the connected websocket server. 
  3.      *  
  4.      * @param text 
  5.      *            The string which will be transmitted. 
  6.      */  
  7.     public void send( String text ) throws NotYetConnectedException {  
  8.         engine.send( text );  
  9.     }  
/**
	 * Sends text to the connected websocket server.
	 * 
	 * @param text
	 *            The string which will be transmitted.
	 */
	public void send( String text ) throws NotYetConnectedException {
		engine.send( text );
	}

它调用了engine的send方法,那么engine是啥东东呢,在类的声明处有这么一句话:

[java] view plain copy print ?
  1. private WebSocketImpl engine = null;  
	private WebSocketImpl engine = null;

说明了 WebSocketImpl类实现了send的操作。


转自:http://blog.csdn.net/zjh171/article/details/24800493

你可能感兴趣的:(网络原理,JAVA)