Windows Socket API 使用经验

转自其他网站

 

核心提示：本文是我在进行MS-Windows 、HP-Unix 网络编程的实践过程中总结出来的一些经验，仅供大家参考。本文所谈到的Socket 函数如果没有特别说明，都是指的Windows Socket API 。... 推广和普及Java 技术，为国内众多的Java 爱好者提供一个“ 平等自由协作创造” 的开放式交

        本文是我在进行MS-Windows 、HP-Unix 网络编程的实践过程中总结出来的一些经验，仅供大家参考。本文所谈到的Socket 函数如果没有特别说明，都是指的Windows Socket API 。

一、WSAStartup 函数
    int WSAStartup(
      WORD wVersionRequested,  
      LPWSADATA lpWSAData  
    );
        使用Socket 的程序在使用Socket 之前必须调用WSAStartup 函数。该函数的第一个参数指明程序请求使用的Socket 版本，其中高位字节指明副版本、低位字节指明主版本；操作系统利用第二个参数返回请求的Socket 的版本信息。当一个应用程序调用WSAStartup 函数时，操作系统根据请求的Socket 版本来搜索相应的Socket 库，然后绑定找到的Socket 库到该应用程序中。以后应用程序就可以调用所请求的Socket 库中的其它Socket 函数了。该函数执行成功后返回0 。
例：假如一个程序要使用2.1 版本的Socket, 那么程序代码如下
            wVersionRequested = MAKEWORD( 2, 1 );
            err = WSAStartup( wVersionRequested, &wsaData );

  二、WSACleanup 函数
    int WSACleanup (void);
        应用程序在完成对请求的Socket 库的使用后，要调用WSACleanup 函数来解除与Socket 库的绑定并且释放Socket 库所占用的系统资源。

三、socket 函数
   SOCKET socket(
      int af,       
      int type,     
      int protocol  
    );
        应用程序调用socket 函数来创建一个能够进行网络通信的套接字。第一个参数指定应用程序使用的通信协议的协议族，对于TCP/IP 协议族，该参数置PF_INET; 第二个参数指定要创建的套接字类型，流套接字类型为SOCK_STREAM 、数据报套接字类型为SOCK_DGRAM ；第三个参数指定应用程序所使用的通信协议。该函数如果调用成功就返回新创建的套接字的描述符，如果失败就返回INVALID_SOCKET 。套接字描述符是一个整数类型的值。每个进程的进程空间里都有一个套接字描述符表，该表中存放着套接字描述符和套接字数据结构的对应关系。该表中有一个字段存放新创建的套接字的描述符，另一个字段存放套接字数据结构的地址，因此根据套接字描述符就可以找到其对应的套接字数据结构。每个进程在自己的进程空间里都有一个套接字描述符表但是套接字数据结构都是在操作系统的内核缓冲里。下面是一个创建流套接字的例子：
        struct protoent *ppe;
        ppe=getprotobyname("tcp");
        SOCKET ListenSocket=socket(PF_INET,SOCK_STREAM,ppe->p_proto);

四、closesocket 函数
   int closesocket(
      SOCKET s  
    );
        closesocket 函数用来关闭一个描述符为s 套接字。由于每个进程中都有一个套接字描述符表，表中的每个套接字描述符都对应了一个位于操作系统缓冲区中的套接字数据结构，因此有可能有几个套接字描述符指向同一个套接字数据结构。套接字数据结构中专门有一个字段存放该结构的被引用次数，即有多少个套接字描述符指向该结构。当调用closesocket 函数时，操作系统先检查套接字数据结构中的该字段的值，如果为1 ，就表明只有一个套接字描述符指向它，因此操作系统就先把s 在套接字描述符表中对应的那条表项清除，并且释放s 对应的套接字数据结构；如果该字段大于1 ，那么操作系统仅仅清除s 在套接字描述符表中的对应表项，并且把s 对应的套接字数据结构的引用次数减1 。
closesocket 函数如果执行成功就返回0 ，否则返回SOCKET_ERROR 。

五、send 函数
   int send(
      SOCKET s,              
      const char FAR *buf,  
      int len,               
      int flags              
    );
        不论是客户还是服务器应用程序都用send 函数来向TCP 连接的另一端发送数据。客户程序一般用send 函数向服务器发送请求，而服务器则通常用send 函数来向客户程序发送应答。该函数的第一个参数指定发送端套接字描述符；第二个参数指明一个存放应用程序要发送数据的缓冲区；第三个参数指明实际要发送的数据的字节数；第四个参数一般置0 。这里只描述同步Socket 的send 函数的执行流程。当调用该函数时，send 先比较待发送数据的长度len 和套接字s 的发送缓冲区的长度，如果len 大于s 的发送缓冲区的长度，该函数返回SOCKET_ERROR ；如果len 小于或者等于s 的发送缓冲区的长度，那么send 先检查协议是否正在发送s 的发送缓冲中的数据，如果是就等待协议把数据发送完，如果协议还没有开始发送s 的发送缓冲中的数据或者s 的发送缓冲中没有数据，那么send 就比较s 的发送缓冲区的剩余空间和len ，如果len 大于剩余空间大小send 就一直等待协议把s 的发送缓冲中的数据发送完，如果len 小于剩余空间大小send 就仅仅把buf 中的数据copy 到剩余空间里（注意并不是send 把s 的发送缓冲中的数据传到连接的另一端的，而是协议传的，send 仅仅是把buf 中的数据copy 到s 的发送缓冲区的剩余空间里）。如果send 函数copy 数据成功，就返回实际copy 的字节数，如果send 在copy 数据时出现错误，那么send 就返回SOCKET_ERROR ；如果send 在等待协议传送数据时网络断开的话，那么send 函数也返回SOCKET_ERROR 。要注意send 函数把buf 中的数据成功copy 到s 的发送缓冲的剩余空间里后它就返回了，但是此时这些数据并不一定马上被传到连接的另一端。如果协议在后续的传送过程中出现网络错误的话，那么下一个Socket 函数就会返回SOCKET_ERROR 。（每一个除send 外的Socket 函数在执行的最开始总要先等待套接字的发送缓冲中的数据被协议传送完毕才能继续，如果在等待时出现网络错误，那么该Socket 函数就返回SOCKET_ERROR ）

注意：在Unix 系统下，如果send 在等待协议传送数据时网络断开的话，调用send 的进程会接收到一个SIGPIPE 信号，进程对该信号的默认处理是进程终止。

六、recv 函数
    int recv(
      SOCKET s,       
      char FAR *buf,  
      int len,        
      int flags       
    );
        不论是客户还是服务器应用程序都用recv 函数从TCP 连接的另一端接收数据。该函数的第一个参数指定接收端套接字描述符；第二个参数指明一个缓冲区，该缓冲区用来存放recv 函数接收到的数据；第三个参数指明buf 的长度；第四个参数一般置0 。这里只描述同步Socket 的recv 函数的执行流程。当应用程序调用recv 函数时，recv 先等待s 的发送缓冲中的数据被协议传送完毕，如果协议在传送s 的发送缓冲中的数据时出现网络错误，那么recv 函数返回SOCKET_ERROR ，如果s 的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv 先检查套接字s 的接收缓冲区，如果s 接收缓冲区中没有数据或者协议正在接收数据，那么recv 就一直等待，只到协议把数据接收完毕。当协议把数据接收完毕，recv 函数就把s 的接收缓冲中的数据copy 到buf 中（注意协议接收到的数据可能大于buf 的长度，所以在这种情况下要调用几次recv 函数才能把s 的接收缓冲中的数据copy 完。recv 函数仅仅是copy 数据，真正的接收数据是协议来完成的），recv 函数返回其实际copy 的字节数。如果recv 在copy 时出错，那么它返回SOCKET_ERROR ；如果recv 函数在等待协议接收数据时网络中断了，那么它返回0 。

注意：在Unix 系统下，如果recv 函数在等待协议接收数据时网络断开了，那么调用recv 的进程会接收到一个SIGPIPE 信号，进程对该信号的默认处理是进程终止。

七、bind 函数
   int bind(
      SOCKET s,                          
      const struct sockaddr FAR *name,   
      int namelen                        
    );
        当创建了一个Socket 以后，套接字数据结构中有一个默认的IP 地址和默认的端口号。一个服务程序必须调用bind 函数来给其绑定一个IP 地址和一个特定的端口号。客户程序一般不必调用bind 函数来为其Socket 绑定IP 地址和断口号。该函数的第一个参数指定待绑定的Socket 描述符；第二个参数指定一个sockaddr 结构，该结构是这样定义的：
struct sockaddr {
            u_short sa_family;
            char sa_data[14];
        };
       sa_family 指定地址族，对于TCP/IP 协议族的套接字，给其置AF_INET 。当对TCP/IP 协议族的套接字进行绑定时，我们通常使用另一个地址结构：
        struct sockaddr_in {
            short    sin_family;
            u_short sin_port;
            struct   in_addr sin_addr;
            char     sin_zero[8];
        };
        其中sin_family 置AF_INET ；sin_port 指明端口号；sin_addr 结构体中只有一个唯一的字段s_addr ，表示IP 地址，该字段是一个整数，一般用函数inet_addr （）把字符串形式的IP 地址转换成unsigned long 型的整数值后再置给s_addr 。有的服务器是多宿主机，至少有两个网卡，那么运行在这样的服务器上的服务程序在为其Socket 绑定IP 地址时可以把htonl(INADDR_ANY) 置给s_addr ，这样做的好处是不论哪个网段上的客户程序都能与该服务程序通信；如果只给运行在多宿主机上的服务程序的Socket 绑定一个固定的IP 地址，那么就只有与该IP 地址处于同一个网段上的客户程序才能与该服务程序通信。我们用0 来填充sin_zero 数组，目的是让sockaddr_in 结构的大小与sockaddr 结构的大小一致。下面是一个bind 函数调用的例子：
    struct sockaddr_in saddr ；
    saddr.sin_family = AF_INET;
    saddr.sin_port = htons(8888);
    saddr.sin_addr.s_addr = htonl(INADDR_ANY);
    bind(ListenSocket,(struct sockaddr *)&saddr,sizeof(saddr)) ；

八、listen 函数
        int listen( SOCKET s, int backlog );
        服务程序可以调用listen 函数使其流套接字s 处于监听状态。处于监听状态的流套接字s 将维护一个客户连接请求队列，该队列最多容纳backlog 个客户连接请求。假如该函数执行成功，则返回0 ；如果执行失败，则返回SOCKET_ERROR 。

九、accept 函数
    SOCKET accept(
      SOCKET s,
      struct sockaddr FAR *addr,  
      int FAR *addrlen  
    );
        服务程序调用accept 函数从处于监听状态的流套接字s 的客户连接请求队列中取出排在最前的一个客户请求，并且创建一个新的套接字来与客户套接字创建连接通道，如果连接成功，就返回新创建的套接字的描述符，以后与客户套接字交换数据的是新创建的套接字；如果失败就返回INVALID_SOCKET 。该函数的第一个参数指定处于监听状态的流套接字；操作系统利用第二个参数来返回新创建的套接字的地址结构；操作系统利用第三个参数来返回新创建的套接字的地址结构的长度。下面是一个调用accept 的例子：
        struct sockaddr_in ServerSocketAddr;
        int addrlen;
        addrlen=sizeof(ServerSocketAddr);
        ServerSocket=accept(ListenSocket,(struct sockaddr *)&ServerSocketAddr,&addrlen);

十、connect 函数
    int connect(
      SOCKET s,                          
      const struct sockaddr FAR *name,  
      int namelen                        
    );
        客户程序调用connect 函数来使客户Socket s 与监听于name 所指定的计算机的特定端口上的服务Socket 进行连接。如果连接成功，connect 返回0 ；如果失败则返回SOCKET_ERROR 。下面是一个例子：
        struct sockaddr_in daddr;
        memset((void *)&daddr,0,sizeof(daddr));
        daddr.sin_family=AF_INET;
        daddr.sin_port=htons(8888);
        daddr.sin_addr.s_addr=inet_addr("133.197.22.4");
        connect(ClientSocket,(struct sockaddr *)&daddr,sizeof(daddr));

<script type="text/javascript"> </script> <script type="text/javascript"> </script>