Series60套接字使用指南

Series60套接字使用指南
一、关键组件：
1、 套接字服务器：提供对套接字协议的共享且通用性的访问。
2、 客户端API：提供对套接字服务器的受控访问。
3、 服务器插件系统：这里称为协议模块或PRT。
二、客户端和服务器：
套接字表示两个参与者之间连接的端点，两个参与者分别被称为服务器和客户端。服务器被动等待到来的连接，而客户端则主动请求与服务器建立连接。
三、断开式和连接式套接字：
1、 断开式：
断开式套接字把数据包（数据包）简单地从一个参与者传递到另一个参与者，而没有在两个参与者之间进行会话的概念。这导致：
a、 每次向断开式套接字写入数据时，都必须指定目的参与者的地址。
b、 类似地，从断开式套接字读取数据时，每次读取都必须指定发送者的地址。
c、 断开式套接字不保证数据包将按照发送时相同的次序到达目的地。
类似于向一个朋友发送一系列信件。
2、 连接式（面向连接）：
连接式套接字保证了在两个参与者之间建立会话的概念，因此只需在首次连接时一次性指定地址，并且数据报会按次序到达。类似于给一个朋友打电话。这种套接字的特点是：建立和使用效率较低。

注意：Series60同时支持连接式和断开式套接字，而且两者使用的类完全相同，例如Rsocket和RsocketServ。区别仅在于建立和配置套接字的方式，以及之后用于发送和接收数据的Rsocket成员函数。
四、连接式套接字：
这种套接字要比断开式常用，但是以效率的少量降低为代价，提供了两个端点间的可靠数据流传输，使开发人员将精力集中于数据本身，而不是传输数据的机制。
1、 连接symbian OS的Socket服务器：
无论是客户端还是服务器，所有Series60套接字编程的第一步都是连接到symbian OS套接字服务器。这比串行通信所需的初始化简单的多，不需要预先装载驱动器，也不需要显式启动服务器。
Tint err=iSocketServer.Connect();
If(err!=KerrNone && err!=KErrAlreadyExists)
{
User::Leave(err)
}
其中：上面的Connect（）函数的定义是：
TInt Connect(TUint aMessageSlots=KESockDefaultMessageSlots);
在这里提供了一个默认的参数值，即如果使用此函数时不指定参数值的话，就会使用这个缺省的参数。
在这里，参数aMessageSlots代表所要连接的服务器，可以是系统定义的其他服务器，也可以是程序员自己编写的服务器。
包含客户端套接字的应用程序必须连接到Symbian OS套接字服务器以创建套接字。接下来需要再执行两个步骤，首先，作为健全性检查，应该确保套接字服务器至少支持一种协议（即提供一个或多个PRT插件模块）
Tuint numProtocols;
err=iSocketServer.NumProtocols(numProtocols);
User::LeaveIfError(err);
最后需要获取与希望使用的协议相关的信息。根据名字查找协议并获取描述：
_LIT(KPotocol,”RFCOMM”);
TprotocolName protocolName(KProtocol);
err=iSocketServer.FindProtocol(protocolName,iProtocolInfo);
User::LeaveIfError(err);
2、 打开套接字
连接到Symbian OS套接字服务器后，即可打开一个套接字。这通过调用Rsocket::Open()执行，该方法带有以下参数：
l RsocketServ& aServer：对一个打开的套接字服务器的会话的引用。
l Tuint addrFamily：表示地址族的常数值。
l Tuint sockType：表示套接字类型的常数值。
l Tuint protocol：表示协议的常数值。
举例：
Tint err;
//创建一个服务器端套接字对象iSocket
Err=iSocket.Open(iSocketServer,iProtocolInfo.iAddrFamily,iProtocolInfo.iSockType,iProtocolInfo.iProtocol);
If(err!=KerrNone&&err!=KErrAlreadyExists)
{
User::Leave(err);
}
注意：打开套接字实际上并未连接它，只是初始化一个套接字对象。
3、 连接服务器套接字：
为把套接字初始化为服务器，需要3个步骤。
a、首先，把该套接字绑定到一个地址和一个端口号，客户端套接字连接到此服务器时需要指定它们。
Const Tuint KportNumber=0x02;
iIrdaSockAddr.setPort(KPortNumber);
iSocket.Bind(iIrdaSocketAddr);
b、把套接字绑定到地址和端口号后，使用Listen（）方法令它监听从别处到达的连接。为Listen（）方法传递的KsizeOfListenQueue参数指定了监听队列的长度，即拒绝更多请求之前，套接字可以放入队列的未处理连接请求的个数。
此外，需要使用第二个套接字为所有到达的请求服务，因为监听的套接字必须保持空闲，以监视其他到达的连接请求。
Const Tuint KsizeOfListenQueue=1;
iSocket.Listen(KSizeOfListenQueue);
//创建空的套接字iServiceSocket
iServiceSocket.Open(iSocketServer);
c、最后需要调用Accept（）接受第一个到达的请求。注意，有可能尚未接收到请求。但Accept（） 是一个异步请求，因此它将在接收到请求时最终完成。另一方面，如果其他设备已经发出一个请求，该请求将被挂起至Listen（）的监听队列中，导致Accept（）快速返回。
任意情况下，调用Accept（）的形式都是相同的：
iSocket.Accept(iServicSocket,iStatus);
iState=EAccepting;
SetActive();
在上面的一系列代码片断中，注意：
l 把第二个套接字（iServiceSocket）作为参数传递到Accept（），因为它才是连接建立之后实际用于传输数据的套接字。
l CirSocketEngine类是一个活动对象，为此，把自己的iStatus成员传递到Accept（），随后调用自己的SetActive（）方法。连接请求发生时，调用该对象的RunL（）方法。
l 使用iState成员在CIrSocketEngine类内实现了一个基本的状态机。这是必不可少的，因为套接字API本质上是异步的――调用RunL（）时，必须能判断当前处于哪种状态（例如接受中、读取中、写入中等）。iState是CirSocketsEngine类中这样的状态机中实现的一部分，而不是套接字API的一部分。注意，其他Series60套接字代码可能使用不同的变量名（或类型），不过，一般来说总会在这些行中实现某中状态机。
4、 连接客户端套接字
在最简单的层次中，连接客户端套接字只涉及调用Connect（）并指定需要的地址和端口信息。比如把一个TCP/IP套接字连接到已知地址和端口的因特网服务器就属于这种情况。对于红外线、蓝牙，预先不知道目标机器地址，连接前需要有一个搜索阶段，设备会在此时查找范围内为给定协议提供服务（在某个套接字监听）的其他机器。
（1）、搜寻
用于搜寻其他设备的类是RhostResolver。同时，该类还被TCP/IP套接字用于把主机名解析为数字ip地址。这和搜寻红外和蓝牙是完全不同的过程，但它们扮演的角色相似，同时RhostResolver类确保所有套接字类型有一致的API集。打开RhostResolver对象的方法与打开Rsocket的方法相同：调用Open（）方法，并传递一个打开的套接字服务器会话、一个地址族和一个协议。
搜寻有可能需要较长的时间，因此，对应的API（RhostResolver::GetByName()）是异步的。CirSocketsEngine类本身是一个活动对象，将会发出这些异步请求并处理它们的完成。启动搜寻阶段所需的代码如下：
const Tuint KnumOfDevicesToDiscover=1;
Tint err;
THostName hostname;
TPckgBuf<TUint> buf (KNumOfDevicesToDiscover);
iSocket.SetOpt(KdiscoverySlotsOpt,KleverIrlap,buf);
err=iHostResolver.Open(iSocketServer,iProtocolInfo.iAddrFamily,iProtocolInfo.iProtocol);
User::LeaveIfError(err);
iState=EDiscovering;
iHostResolver.GetByName(hostname,iNameEntry,iStatus);
SetActive();
这段代码最终调用异步函数iHostResolver::GetByName（），并传入自己的iStatus成员，启动搜索过程，同时把自己设置为活动。这使得RunL（）方法将在搜索结束时被调用，注意同时相应的设置了iState变量，因此RunL（）将能正确地判断正在处理的是哪种请求。
注意：可以通过调用RhostResolver::Cancel()取消GetByName（）以及RhostResolver上的其他异步调用。
（2）连接
活动对象处理GetByName（）的调用成功结束时，iNameEntry成员将包含搜寻到的某个有效服务器机器的地址。之后，使用该地址进行连接，如下：
iHostResolver.Close();
iIrdaSockAddr=TirdaSockAddr(iNameEntry().iAddr);
iIrdaSockAddr.SetPort(KPortNumber);
iState=Econnecting;
iSocket.Connect(iIrdaSockAddr,iStatus);
SetActive();

Connect（）也是一个异步函数。注意，即使搜索阶段成功，此函数仍有可能失败，例如服务器在被搜寻到之后移动到了范围之外。