data: first event

data: second event
id: 100

event: myevent
data: third event
id: 101

: this is a comment
data: fourth event
data: fourth event continue

如之前所述，服務(wù)器端可以返回自定義類型的事件。對于這些事件，可以使用 addEventListener 方法來添加相應(yīng)的事件處理方法。代碼清單 2 給出了 EventSource 對象的使用示例。

EventSource 對象的使用示例

var es = new EventSource('events');
es.onmessage = function(e) {
    console.log(e.data);
};

es.addEventListener('myevent', function(e) {
    console.log(e.data);
});

如上所示，在指定 URL 創(chuàng)建出 EventSource 對象之后，可以通過 onmessage 和 addEventListener 方法來添加事件處理方法。當(dāng)服務(wù)器端有新的事件產(chǎn)生，相應(yīng)的事件處理方法會被調(diào)用。EventSource 對象的 onmessage 屬性的作用類似于 addEventListener( ‘ message ’ )，不過 onmessage 屬性只支持一個事件處理方法。在介紹完服務(wù)器推送事件的規(guī)范內(nèi)容之后，下面介紹服務(wù)器端的實現(xiàn)。

服務(wù)器端和瀏覽器端實現(xiàn)

從上一節(jié)中對通訊協(xié)議的描述可以看出，服務(wù)器端推送事件是一個比較簡單的協(xié)議。服務(wù)器端的實現(xiàn)也相對比較簡單，只需要按照協(xié)議規(guī)定的格式，返回響應(yīng)內(nèi)容即可。在開源社區(qū)可以找到各種不同的服務(wù)器端技術(shù)相對應(yīng)的實現(xiàn)。自己開發(fā)的難度也不大。本文使用 Java 作為服務(wù)器端的實現(xiàn)語言。相應(yīng)的實現(xiàn)基于開源的 jetty-eventsource-servlet 項目，見參考資源。下面通過一個具體的示例來說明如何使用 jetty-eventsource-servlet 項目。示例用來模擬一個物體在某個限定空間中的隨機(jī)移動。該物體從一個隨機(jī)位置開始，然后從上、下、左和右四個方向中隨機(jī)選擇一個方向，并在該方向上移動隨機(jī)的距離。服務(wù)器端不斷改變該物體的位置，并把位置信息推送給瀏覽器，由瀏覽器來顯示。

服務(wù)器端實現(xiàn)

服務(wù)器端的實現(xiàn)由兩部分組成：一部分是用來產(chǎn)生數(shù)據(jù)的 org.eclipse.jetty.servlets.EventSource 接口的實現(xiàn)，另一部分是作為瀏覽器訪問端點(diǎn)的繼承自 org.eclipse.jetty.servlets.EventSourceServlet 類的 servlet 實現(xiàn)。下面代碼給出了 EventSource 接口的實現(xiàn)類。

EventSource 接口的實現(xiàn)類 MovementEventSource

 public class MovementEventSource implements EventSource {
 
 private int width = 800;
 private int height = 600;
 private int stepMax = 5;
 private int x = 0;
 private int y = 0;
 private Random random = new Random();
 private Logger logger = Logger.getLogger(getClass().getName());
 
 public MovementEventSource(int width, int height, int stepMax) {
  this.width = width;
  this.height = height;
  this.stepMax = stepMax;
  this.x = random.nextInt(width);
  this.y = random.nextInt(height);
 }

 @Override
 public void onOpen(Emitter emitter) throws IOException {
  query(emitter); //開始生成位置信息
 }

 @Override
 public void onResume(Emitter emitter, String lastEventId)
   throws IOException {
  updatePosition(lastEventId); //更新起始位置
  query(emitter);  //開始生成位置信息
 }
 
 //根據(jù)Last-Event-Id來更新起始位置
 private void updatePosition(String id) {
  if (id != null) {
   String[] pos = id.split(",");
   if (pos.length > 1) {
    int xPos = -1, yPos = -1;
    try {
     xPos = Integer.parseInt(pos[0], 10);
     yPos = Integer.parseInt(pos[1], 10);
    } catch (NumberFormatException e) {
     
    }
    if (isValidMove(xPos, yPos)) {
     x = xPos;
     y = yPos;
    }
   }
  }
 }
 
 private void query(Emitter emitter) throws IOException {
  emitter.comment("Start sending movement information.");
  while(true) {
   emitter.comment("");
   move(); //移動位置
   String id = String.format("%s,%s", x, y);
   emitter.id(id); //根據(jù)位置生成事件標(biāo)識符
   emitter.data(id); //發(fā)送位置信息數(shù)據(jù)
   try {
    Thread.sleep(2000);
   } catch (InterruptedException e) {
    logger.log(Level.WARNING, \

               "Movement query thread interrupted. Close the connection.", e);
    break;
   }
  }
  emitter.close(); //當(dāng)循環(huán)終止時，關(guān)閉連接
 }

 @Override
 public void onClose() {
  
 }
 
 //獲取下一個合法的移動位置
 private void move() {
  while (true) {
   int[] move = getMove();
   int xNext = x + move[0];
   int yNext = y + move[1];
   if (isValidMove(xNext, yNext)) {
    x = xNext;
    y = yNext;
    break;
   }
  }
 }

 //判斷當(dāng)前的移動位置是否合法
 private boolean isValidMove(int x, int y) {
  return x >= 0 && x <= width && y >=0 && y <= height;
 }
 
 //隨機(jī)生成下一個移動位置
 private int[] getMove() {
  int[] xDir = new int[] {-1, 0, 1, 0};
  int[] yDir = new int[] {0, -1, 0, 1};
  int dir = random.nextInt(4);
  return new int[] {xDir[dir] * random.nextInt(stepMax), \

     yDir[dir] * random.nextInt(stepMax)};
 }
}

類 MovementEventSource 需要實現(xiàn) EventSource 接口的 onOpen、onResume 和 onClose 方法，其中 onOpen 方法在瀏覽器端的連接打開的時候被調(diào)用，onResume 方法在瀏覽器端重新建立連接時被調(diào)用，onClose 方法則在瀏覽器關(guān)閉連接的時候被調(diào)用。onOpen 和 onResume 方法都有一個 EventSource.Emitter 接口類型的參數(shù)，可以用來發(fā)送數(shù)據(jù)。EventSource.Emitter 接口中包含的方法包括 data、event、comment、id 和 close 等，分別對應(yīng)于通訊協(xié)議中各種不同類型的事件。而 onResume 方法還額外包含一個參數(shù) lastEventId，表示通過 Last-Event-ID 頭發(fā)送過來的最近一次事件的標(biāo)識符。

MovementEventSource 類中事件生成的主要邏輯在 query 方法中。該方法中包含一個無限循環(huán)，每隔 2 秒鐘改變一次位置，同時把更新之后的位置通過 EventSource.Emitter 接口的 data 方法發(fā)送給瀏覽器端。每個事件都有對應(yīng)的標(biāo)識符，而標(biāo)識符的值就是位置本身。如果連接斷開之后，瀏覽器重新進(jìn)行連接，可以從上一次的位置開始繼續(xù)移動該物體。

與 MovementEventSource 類對應(yīng)的 servlet 實現(xiàn)比較簡單，只需要繼承自 EventSourceServlet 類并覆寫 newEventSource 方法即可。在 newEventSource 方法的實現(xiàn)中，需要返回一個 MovementEventSource 類的對象，如下所示。每當(dāng)瀏覽器端建立連接時，該 servlet 會創(chuàng)建一個新的 MovementEventSource 類的對象來處理該請求。

servlet 實現(xiàn)類 MovementServlet

 public class MovementServlet extends EventSourceServlet { 

 @Override 
 protected EventSource newEventSource(HttpServletRequest request, 
 String clientId) { 
 return new MovementEventSource(800, 600, 20); 
 } 
 }

在服務(wù)器端實現(xiàn)中，需要注意的是要添加相應(yīng)的 servlet 過濾器支持。這是 jetty-eventsource-servlet 項目所依賴的 Jetty Continuations 框架的要求，否則的話會出現(xiàn)錯誤。添加過濾器的方式是在 web.xml 文件中添加代碼如下所示的配置內(nèi)容。

Jetty Continuations 所需 servlet 過濾器的配置

 <filter> 
    <filter-name>continuation</filter-name> 
    <filter-class>org.eclipse.jetty.continuation.ContinuationFilter</filter-class> 
 </filter> 
 <filter-mapping> 
    <filter-name>continuation</filter-name> 
    <url-pattern>/sse/*</url-pattern> 
 </filter-mapping>

瀏覽器端實現(xiàn)

瀏覽器端的實現(xiàn)也比較簡單，只需要創(chuàng)建出 EventSource 對象，并添加相應(yīng)的事件處理方法即可。下面代碼給出了相應(yīng)的實現(xiàn)。在頁面中使用一個方塊表示物體。當(dāng)接收到新的事件時，根據(jù)事件數(shù)據(jù)中給出的坐標(biāo)信息，更新方塊在頁面上的位置。

瀏覽器端的實現(xiàn)代碼

 var es = new EventSource('sse/movement'); 
 es.addEventListener('message', function(e) { 
     var pos = e.data.split(','), x = pos[0], y = pos[1]; 
     $('#box').css({ 
         left : x + 'px', 
         top : y + 'px' 
         }); 
     });

在介紹完基本的服務(wù)器端和瀏覽器端實現(xiàn)之后，下面介紹比較重要的 IE 的支持。

IE 支持

使用瀏覽器原生的 EventSource 對象的一個比較大的問題是 IE 并不提供支持。為了在 IE 上提供同樣的支持，一般有兩種辦法。第一種辦法是在其他瀏覽器上使用原生 EventSource 對象，而在 IE 上則使用簡易輪詢或 COMET 技術(shù)來實現(xiàn)；另外一種做法是使用 polyfill 技術(shù)，即使用第三方提供的 JavaScript 庫來屏蔽瀏覽器的不同。本文使用的是 polyfill 技術(shù)，只需要在頁面中加載第三方 JavaScript 庫即可。應(yīng)用本身的瀏覽器端代碼并不需要進(jìn)行改動。一般推薦使用第二種做法，因為這樣的話，在服務(wù)器端只需要使用一種實現(xiàn)技術(shù)即可。

在 IE 上提供類似原生 EventSource 對象的實現(xiàn)并不簡單。理論上來說，只需要通過 XMLHttpRequest 對象來獲取服務(wù)器端的響應(yīng)內(nèi)容，并通過文本解析，就可以提取出相應(yīng)的事件，并觸發(fā)對應(yīng)的事件處理方法。不過問題在于 IE 上的 XMLHttpRequest 對象并不支持獲取部分的響應(yīng)內(nèi)容。只有在響應(yīng)完成之后，才能獲取其內(nèi)容。由于服務(wù)器端推送事件使用的是一個長連接。當(dāng)連接一直處于打開狀態(tài)時，通過 XMLHttpRequest 對象并不能獲取響應(yīng)的內(nèi)容，也就無法觸發(fā)對應(yīng)的事件。更具體的來說，當(dāng) XMLHttpRequest 對象的 readyState 為 3（READYSTATE_INTERACTIVE）時，其 responseText 屬性是無法獲取的。

為了解決 IE 上 XMLHttpRequest 對象的問題，就需要使用 IE 8 中引入的 XDomainRequest 對象。XDomainRequest 對象的作用是發(fā)出跨域的 AJAX 請求。XDomainRequest 對象提供了 onprogress 事件。當(dāng) onprogress 事件發(fā)生時，可以通過 responseText 屬性來獲取到響應(yīng)的部分內(nèi)容。這是 XDomainRequest 對象和 XMLHttpRequest 對象的最大不同，也是使用 XDomainRequest 對象來實現(xiàn)類似原生 EventSource 對象的基礎(chǔ)。在使用 XDomainRequest 對象打開與服務(wù)器端的連接之后，當(dāng)服務(wù)器端有新的數(shù)據(jù)產(chǎn)生時，可以通過 XDomainRequest 對象的 onprogress 事件的處理方法來進(jìn)行處理，對接收到的數(shù)據(jù)進(jìn)行解析，根據(jù)數(shù)據(jù)的內(nèi)容觸發(fā)相應(yīng)的事件。

不過由于 XDomainRequest 對象本來的目的是發(fā)出跨域 AJAX 請求，考慮到跨域訪問的安全性問題，XDomainRequest 對象在使用時的限制也比較嚴(yán)格。這些限制會影響到其作為 EventSource 對象的實現(xiàn)方式。具體的限制和解決辦法如下所示：

1. 服務(wù)器端的響應(yīng)需要包含 Access-Control-Allow-Origin 頭，用來聲明允許從哪些域訪問該 URL。“*”表示允許來自任何域的訪問，不推薦使用該值。一般使用與當(dāng)前應(yīng)用相同的域，限制只允許來自當(dāng)前域的訪問。
2. XDomainRequest 對象發(fā)出的請求不能包含自定義的 HTTP 頭，這就限制了不能使用 Last-Event-ID 頭來聲明瀏覽器端最近一次接收到的事件的標(biāo)識符。只能通過 HTTP 請求的其他方式來傳遞該標(biāo)識符，如 GET 請求的參數(shù)或 POST 請求的內(nèi)容體。
3. XDomainRequest 對象的請求的內(nèi)容類型（Content-Type）只能是“text/plain”。這就意味著，當(dāng)使用 POST 請求時，服務(wù)器端使用的框架，如 servlet，不會對 POST 請求的內(nèi)容進(jìn)行自動解析，無法使用 HttpServletRequest 類的 getParameter 方法來獲取 POST 請求的內(nèi)容。只能在服務(wù)器端對原始的請求內(nèi)容進(jìn)行解析，獲取到其中的參數(shù)的值。
4. XDomainRequest 對象發(fā)出的請求中不包含任何與用戶認(rèn)證相關(guān)的信息，包括 cookie 等。這就意味著，如果服務(wù)器端需要認(rèn)證，則需要通過 HTTP 請求的其他方式來傳遞用戶的認(rèn)證信息，比如 session 的 ID 等。

由于 XDomainRequest 對象的這些限制，服務(wù)器端的實現(xiàn)也需要作出相應(yīng)的改動。這些改動包括返回 Access-Control-Allow-Origin 頭；對于瀏覽器端發(fā)送的“text/plain”類型的參數(shù)進(jìn)行解析；處理請求中包含的用戶認(rèn)證相關(guān)的信息。

本文的示例使用的 polyfill 庫是 GitHub 上的 Yaffle 開發(fā)的 EventSource 項目，具體的地址見參考資源。在使用該 polyfill 庫，并對服務(wù)器端的實現(xiàn)進(jìn)行修改之后，就可以在 IE 8 及以上的瀏覽器中使用服務(wù)器推送事件。如果需要支持 IE 7，則只能使用簡易輪詢或 COMET 技術(shù)。本文的示例代碼見參考資源。

小結(jié)

如果需要從服務(wù)器端推送數(shù)據(jù)給瀏覽器，可以使用的基于 HTML 5 規(guī)范標(biāo)準(zhǔn)的技術(shù)包括 WebSocket 和服務(wù)器推送事件。開發(fā)人員可以根據(jù)應(yīng)用的具體需求來選擇合適的技術(shù)。如果只是需要從服務(wù)器端推送數(shù)據(jù)，服務(wù)器推送事件的規(guī)范更加簡單，實現(xiàn)起來更容易。本文對服務(wù)器推送事件的規(guī)范內(nèi)容、服務(wù)器端和瀏覽器端的實現(xiàn)都進(jìn)行了詳細(xì)的介紹，對如何支持 IE 瀏覽器也進(jìn)行了具體的分析。