FCS--Server端與Client端method觸發與data廣播概念

在FCS的應用上常會需要讓Client與Server間的資料傳遞與method呼叫,以下幾點概念應該可以避免
呼叫method沒反應或資料沒傳到你要的地方等狀況發生

一.Server端method如何被呼叫
Server端上要能讓Client所呼叫觸發的function,需定義在Server端的Client物件上
你可以用prototype方式去extend 原本Client 類別的method,讓Client類別所產生的
instance都擁有該method
例:
Client.prototype.newfun=function(){}
你也可以把這function定義在單一Client instance下,

例:
application.onConnect(newClient)=function(){
.....
newClient.newfun=function(){}
}

二.Client端的method如何被呼叫
在Client端上要讓Server端可以呼叫的function,一定要定義在Netconnection上
例:
nc=new NetConnection();
.....
nc.myfun=function(){}
三.send或call這兩個method在使用上有何差異?如何使用

call:這method在Client端上可使用的是netconnection物件,在Server端上可使用的是netconnection與Client物件

1. 在Client端利用netconnection.call來觸發執行Server端上Client 物件的method


2. 在Server端上利用Client物件.call來觸發Client端上netconnection上的method


3. 在Server端上使用netconnection.call時,這時這server的角色就像一個client端一樣,是在觸發另一個Server
   端上Client 物件的method

send:在Client端上可使用這method的包含SharedObject與netStream。 send這個method很有趣,他讓你由client端去啟動所有同在client端的function,但因為在觸發function時可以帶
參數過去,這個特性是可以讓你利用來做小量資料的廣播的,要廣播給所有人接收到的資料,並不一定就要放在
SharedObject內,利用其onSync來做同步,有時用send也是一個很簡單的做法,如何定義

1. 在netStream或SharedObject上定義好method "myfun"
2. 利用netStream.send("myfun")或sharedobject.send("myfun",myvar)可讓所有client上的"myfun"都會被觸發

四.幾種可能的互動型態範例

1. Client端對Server端傳送data或呼叫執行Server端function
   應用範例:一個簡易聊天室,聊天內容只存在Server端的變數內,不使用SharedObject存放
   呼叫Server端的message這method來處理client傳上去的msg這對話內容
   
   Client端:
   nc.call("message", null, msg);
   Server端:
   application.onAppstart=function(){
   application.chat_content="";
   }
   application.onConnect=function(newClient){
   .......
   newClient.message=function(msg){
   application.chat_content+=msg;
   }
   }
   


2. Client端對所有Client廣播data並執行指定Client端function
   應用範例:以之前在站上回覆過的問題為例,一個clinet要輸入一個網址url_txt,要讓所有的client都
   會開啟這網址的網頁
   
   Client端:
   先定義一個附掛在so上的method
   lobby_so.openPage=function(receive_url){
   getURL(receive_url);
   }
   利用send就可讓所有client接收到這網址並開啟
   lobby_so.send("openPage",url_txt);
   


3. Server傳送data給特定Client
   應用範例:當有使用者連線上server,當使用者資料驗證正確時,接受其連線一方面要client去執行指定的function跳到某頁或讓某mc出現...,同時又要把server端的資料帶過去
   說明:server只回應正在與server做互動的那個client,如以上範例,server只會去觸發請求連線的該client去執行指定的function,其他client不會有反應
   
   Server端:
   application.onConnect=function(newClient,pwd){
   if(pwd=="ok"){
   application.acceptConnection(newClient);
   newClient.call("get_message",null,message);
   }else{
   application.rejectConnection(newClient,errObj);
   }
   }
   Client端:
   ........
   nc.get_message=function(message){};
   


4. Server廣播data給所有Client
   應用範例:當有人斷線時,由server端廣播所有client,讓所有client都能同步更新client名單
   說明:以上範例來說,當clinet無預警的斷線,只有Server上的application.onDisconnect 這handler會被觸發,也就是說你需要在這handler內寫一些程式去廣播通知給所有的client
   如何廣播?有以下兩種做法
   
   
   
   1. 把資料放在remote SharedObject物件內,只要SO物件內容更動,即自動觸發Client端的so.onSync
      將線上人員名單寫在remote SharedObject物件內,當有人斷線,只要把so內該筆資料剔除掉,因為so內容改變,
      因此所有Client端的so.onSync 這handler將被觸發,即可達到你要更新資料的目的
      
      Server端
      application.onDisconnect=function(newClient){
      userlist_so.setProperty(newClient.name,"");
      }
      註:相對的當server端無預警的斷線,client端可由nc.onStatus這handler內由判斷info.code 來取得資訊
      
   
   
   2. 當資料不是存在so內時,只是存在server端的一個變數上,可以善加利用application.clients來對所有client廣播
      以下會觸發所有client端上的client_fun,並把server上的sendvar變數帶過去
      
      server端,
      application.onDisconnect=function(newClient){
      for(var i=0;i<application.clients.length;i++) {<br />
      application.clients[i].call("client_fun",null,sendvar);
      }
      }
      Client端
      nc.client_fun=function(myvar){ }