【转】HTML5 WebSockets 基础使用教程

鉴客 发布于 2010/08/12 07:50
阅读 1K+
收藏 12

HTML5之中一个很酷的新特性就是WebSockets,它可以让我们无需AJAX请求即可与服务器端对话。今天彬Go将让大家通过Php环境的服务器端运行WebSocket,创建客户端并通过WebSockets协议发送和接收服务器端信息。

什么是WebSockets?

WebSockets是在一个(TCP)接口进行双向通信的技术,PUSH技术类型。同时WebSockets仍将基于W3C标准,目前为止,Chrome和Safari的最新版本浏览器已经支持WebSockets了。

WebSockets将会替代什么?

WebSockets可以替代Long Polling(PHP服务端推送技术),这是一个有趣的概念。客户端发送一个请求到服务器,现在,服务器端并不会响应还没准备好的数据,它会保持连接的打开状态直到最新的数据准备就绪发送,之后客户端收到数据,然后发送另一个请求。这有它的好处:减少任一连接的延迟,当一个连接已经打开时就不需要创建另一个新的连接。但是Long-Polling并不是什么花俏技术,他仍有可能发生请求暂停,因此会需要建立新的连接。

一些AJAX应用使用上述技术-这经常是归因于低资源利用。

试想一下,如果服务器在早晨会自启动并发送数据到那些希望接收而不用提前建立一些连接端口的客户端,这是一件多棒的事情啊!欢迎来到PUSH技术的世界!

第一步:搞定WebSocket服务器

这篇教程会把更多的精力放在客户端的创建而不是服务器端的执行等操作。

我使用基于windows 7的XAMPP来实现本地运行PHP。phpwebsockets是PHP WebSocket服务器。(以我的经验这个版本存在一些小问题,我已对它做了些修改并上传源文件共享给大家)下面的这些不同版本也可以实现WebSocket,如果某个不能用,你可以试试其它版本或者继续看下面的教程。

jWebSocket (Java)
web-socket-ruby (ruby)
Socket IO-node (node.js)

启动Apache服务器

html5-websocket-apache

第二步:修改URLs和端口

根据你之前的安装修改服务器,下面是setup.class.php中的例子:

1
2
3
4
public  function __construct ( $host = 'localhost' , $port = 8000 , $max = 100 )  
{  
     $this -> createSocket ( $host , $port ) ;  
}

浏览文件并在适当情况下进行更改。

第三步:开始创建客户端

下面来创建基本模板,这是我的client.php文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<!DOCTYPE html>  
<html>  
<head>  
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>  
  
<title>WebSockets Client </title>  
  
</head>  
<body>  
<div id="wrapper">  
  
     <div id="container">  
  
         <h1>WebSockets Client </h1>  
  
         <div id="chatLog">  
  
         </div> <!-- #chatLog -->  
         <p id="examples">e.g. try 'hi', 'name', 'age', 'today' </p>  
  
         <input id="text" type="text" />  
         <button id="disconnect">Disconnect </button>  
  
     </div> <!-- #container -->  
  
</div>  
</body>  
</html>

我们已经创建里基本模板:一个chat log容器,一个input输入框和一个断开连接的按钮。

第四步:添加一些CSS

没什么花俏代码,只是处理一下标签的样式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
body  {  
     font-family :Arial , Helvetica ,  sans-serif ;  
}  
#container {  
     border : 5px  solid grey ;  
     width : 800px ;  
     margin : 0  auto ;  
     padding : 10px ;  
}  
#chatLog {  
     padding : 5px ;  
     border : 1px  solid  black ;  
}  
#chatLog p  {  
     margin : 0 ;  
}  
.event  {  
     color : #999 ;  
}  
.warning {  
     font-weight : bold ;  
     color : #CCC ;  
}

第五步:WebSocket事件

首先让我们尝试并理解WebSocket事件的概念:
WebSocket-事件

WebSocket事件:
我们将使用三个WebSocket事件:
onopen: 当接口打开时
onmessage: 当收到信息时
onclose: 当接口关闭时

我们如何来实现呢?
首先创建WebSocket对象

1
var socket  =  new WebSocket ( "ws://localhost:8000/socket/server/startDaemon.php" ) ;

然后向下面这样检测事件

1
2
3
socket. onopen  =  function ( ) {  
     alert ( "Socket has been opened!" ) ;  
}

当我们收到信息时这样做:

1
2
3
socket. onmessage  =  function (msg ) {  
     alert (msg ) ;  //Awesome!  
}

但我们还是尽量避免使用alert,现在我们可以把我们学的东西整合到客户端页面中了。

第六步:JavaScript

首先我们将代码放到jQuery 的 document.ready函数中,然后我们还要检查用户的浏览器是否支持WebSocket。如果不支持,我们就添加一个链向Chrome浏览器页面的链接。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
$ (document ). ready ( function ( )  {  
     if ( ! ( "WebSocket"  in window ) ) {  
        $ ( '#chatLog, input, button, #examples' ). fadeOut ( "fast" ) ;  
        $ ( '<p>Oh no, you need a browser that supports WebSockets. How about <a href="http://www.google.com/chrome">Google Chrome</a>?</p>' ). appendTo ( '#container' ) ;  
     } else {  
  
     //The user has WebSockets  
  
    connect ( ) ;  
  
     function connect ( ) {  
         //the connect function code is below  
  
     }  
} ) ;

如你所见,如果用户浏览器支持WebSocket,我们将执行connect()函数。这里是核心功能,我们将开始创建open、close和receive事件。

我们将在我们的服务器定义URL。

1
2
var socket ;  
var host  =  "ws://localhost:8000/socket/server/startDaemon.php" ;

你可能会发现URL中怎么没有http?恩,是的,这是一个WebSocket URL,使用了不同的协议。下面是URL分解图示:
html5-websocket-url

下面让我们继续完成connect()函数,我们将代码放入try/catch块,这样如果代码出现问题,我们能让用户知道。我们创建WebSocket,并将信息传递到message()函数,之后会做讲解。我们创建我们的onopen、onmessage和onclose函数. 需要注意的是我们为用户提供了端口状态,这并不是必需的,但我们把它放进来主要是为了方便调试。

CONNECTING = 0
OPEN = 1
CLOSED = 2

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
function connect ( ) {  
     try {  
  
     var socket ;  
     var host  =  "ws://localhost:8000/socket/server/startDaemon.php" ;  
     var socket  =  new WebSocket (host ) ;  
  
        message ( '<p class="event">Socket Status: ' +socket. readyState ) ;  
  
        socket. onopen  =  function ( ) {  
             message ( '<p class="event">Socket Status: ' +socket. readyState + ' (open)' ) ;  
         }  
  
        socket. onmessage  =  function (msg ) {  
             message ( '<p class="message">Received: ' +msg. data ) ;  
         }  
  
        socket. onclose  =  function ( ) {  
             message ( '<p class="event">Socket Status: ' +socket. readyState + ' (Closed)' ) ;  
         }             
  
     }  catch (exception ) {  
         message ( '<p>Error' +exception ) ;  
     }  
}

message()函数很简单, 它将我们想展现给用户的文本填入chat log容器内。 我们在socket事件函数中为段落(<p>)标签创建适当的class,我们在message函数中只有一个段落结束标签。

1
2
3
function message (msg ) {  
    $ ( '#chatLog' ). append (msg + '</p>' ) ;  
}

目前的成果

如果你已按上面教程按部就班的做的话,很好,我们已经创建了 HTML/CSS模板、创建并建立Websocket连接、通过创建连接保持用户的进展更新。

HTML5-websocket

第七步:发送数据

现在我们已经有了提交按钮,但我们还需要监听用户按下键盘的事件,并运行send函数,下面的’13′便是回车键对应的ASCII码。

1
2
3
4
5
$ ( '#text' ). keypress ( function (event )  {  
     if  (event. keyCode  ==  '13' )  {  
        send ( ) ;  
     }  
} ) ;

下面是send()函数:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
function send ( ) {  
  
     var text  = $ ( '#text' ). val ( ) ;  
     if (text == "" ) {  
        message ( '<p class="warning">Please enter a message' ) ;  
         return  ;  
     }  
     try {  
        socket. send (text ) ;  
        message ( '<p class="event">Sent: ' +text )  
     }  catch (exception ) {  
    message ( '<p class="warning"> Error:'  + exception ) ;  
     }  
  
    $ ( '#text' ). val ( "" ) ;  
  
}

下面我们需要:

1
socket. send ( ) ;

那些额外的代码做了以下工作:检测用户是否什么都没输入却仍点击返回、清空input输入框、执行message()函数。

关闭Socket

关闭Socket操作相当简单,添加对断开连接按钮的click事件监听就可以。

1
2
3
$ ( '#disconnect' ). click ( function ( ) {  
    socket. close ( ) ;  
} ) ;

websocket-close

完整JavaScript代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
$ (document ). ready ( function ( )  {  
  
   if ( ! ( "WebSocket"  in window ) ) {  
  $ ( '#chatLog, input, button, #examples' ). fadeOut ( "fast" ) ;  
  $ ( '<p>Oh no, you need a browser that supports WebSockets. How about <a href="http://www.google.com/chrome">Google Chrome</a>?</p>' ). appendTo ( '#container' ) ;  
   } else {  
       //The user has WebSockets  
  
      connect ( ) ;  
  
       function connect ( ) {  
           var socket ;  
           var host  =  "ws://localhost:8000/socket/server/startDaemon.php" ;  
  
           try {  
               var socket  =  new WebSocket (host ) ;  
  
              message ( '<p class="event">Socket Status: ' +socket. readyState ) ;  
  
              socket. onopen  =  function ( ) {  
                 message ( '<p class="event">Socket Status: ' +socket. readyState + ' (open)' ) ;  
               }  
  
              socket. onmessage  =  function (msg ) {  
                 message ( '<p class="message">Received: ' +msg. data ) ;  
               }  
  
              socket. onclose  =  function ( ) {  
                message ( '<p class="event">Socket Status: ' +socket. readyState + ' (Closed)' ) ;  
               }           
  
           }  catch (exception ) {  
             message ( '<p>Error' +exception ) ;  
           }  
  
           function send ( ) {  
               var text  = $ ( '#text' ). val ( ) ;  
  
               if (text == "" ) {  
                  message ( '<p class="warning">Please enter a message' ) ;  
                   return  ;  
               }  
               try {  
                  socket. send (text ) ;  
                  message ( '<p class="event">Sent: ' +text )  
  
               }  catch (exception ) {  
                 message ( '<p class="warning">' ) ;  
               }  
              $ ( '#text' ). val ( "" ) ;  
           }  
  
           function message (msg ) {  
            $ ( '#chatLog' ). append (msg + '</p>' ) ;  
           }  
  
          $ ( '#text' ). keypress ( function (event )  {  
               if  (event. keyCode  ==  '13' )  {  
                send ( ) ;  
               }  
           } ) ;     
  
          $ ( '#disconnect' ). click ( function ( ) {  
             socket. close ( ) ;  
           } ) ;  
  
       } //End connect  
  
   } //End else  
  
} ) ;

第九步:运行WebSocket服务器

我们要输入一些命令行,XAMPP提供了比较方便的shell选项。点击XAMPP控制面板的’shell’按钮并输入:
php -q path\to\server.php
现在你已经运行了WebSocket服务器!
HTML5-webSocket

大功告成!

当页面读取后,将尝试创建一个WebSocket连接,然后用户可以输入信息并从服务器接收信息。
html5-websocket-教程实例

感谢大家耐心阅读本教程,希望你能从中学到有用的知识,HTML5 WebSocket的确令人兴奋不已!大家可以通过The WebSocket API了解HTML5 WebSocket的最新动态。

点击这里下载源文件

加载中
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部