PWLib指引者

刚开始学PWLib,只能以混乱形容,翻译并拼凑出这篇短小的文章,希望后来者少走一些弯路

Portable Windows Library

 

PWLib 1.9.0

 

概述

 

为了可以同时构建在Microsoft和Unix X－Window操作系统上应用程序，从很多年前开始，PWLib从创建到逐步完善，已经成为相当完整而庞大的C＋＋类库。 PWLib在设计之初还提供了Macintosh接口，但至今未被实现。

 

从此，大量出现的多平台GUI工具包，例如KDE、wxWindows以及OpenH323等的开发成为PWLib的主要应用者。他们开始更注重于解决网络、I/O移植性能、多线程以及可移植性能。通常PWLib被用来构建高性能和高移植性能的网络中心应用程序。

 

除了这些高级别的应用，早期PWLib还扩充了一些基本的容器类，比如数组、线性队列、排序队列（RB Tree）及散列集合（hash表）。在STL作为一种标准出现前，就已经在这里被构建。很可惜的是，这些结构同算子及通用的算法规则不能兼容。当然，这个领域的开发一直在进行之中，目前已经能够同STL兼容，并将在未来会逐步增加对STL的引入。

 

PWLib被广泛应用于多家公司，包括商业性质还是开源的产品中。PWLib创立本意主要是为了支持OpenH323项目，但作为一个单独的基本库，她非常完善。

 

PWLib中的类分为两种类型：基本类和控制组件。基本类包含了所有对诸如容器、线程、SOCKET等平台特性相关的结构的基本支持。所有的PWLib程序都需要有基本类。

 

控制组件实现一些通常是平台无关或者不是所有程序都需要的的功能。在一些特殊的平台（比如Windows），基本类和控制组件甚至被分为单独的压缩库。而在其他平台（比如Unix平台）中，所有代码被组合成一个单独的类库，并在不需要的地方直接告诉链接器忽略相关代码。

 

早期PWLib还支持GUI类和GUI组件，但在新的版本中，将不再支持。

 

如何使用PWLib

 

一个关于PWLib最简便的教程，请参考http://toncar.cz/openh323/tut ,这里我们说明一下如何创建一个最简单的程序。

 

下面的代码演示如果基于PWLib架构编写标准的”Hello world!”程序。

 

 

// hello.cxx

 

 

#include <ptlib.h>

 

 

class Hello : public PProcess

 

{

 

  PCLASSINFO(Hello, PProcess)

 

  public:

 

        voidMain();

 

};

 

 

PCREATE_PROCESS(Hello)

 

 

void Hello::Main()

 

{

 

  cout << "Hello world!/n";

 

}

 

 

// End of hello.cxx

 

PCREATE_PROCESS宏定义定义了main()#函数并创建了Hello实例。使用C++初始化全局静态变量比较容易出问题（销毁更容易出问题），因此建议尽力在你的PProcess中方式所有内容，而不是在全局中定义。

 

基本类

 

基本对象类

 

• PObject – PWLib所有其他类的基本类

   

• PContainer – PWLib中所有带引用计数类的基本类

   

• PAbstractArray – 数组抽象基类，等同于STL中的vector模板类

   

• PAbstractList – 链表抽象基类，等同于STL中的list模板类

   

• PAbstractDictionary – 集合抽象基类，等同于STL中的map模板类

   

• PString – 字符串抽象基类，等同于STL中的string类

   

I/O信道类

 

基于PChannel抽象类的实现基本I/O的类集合

 

• PChannel – 所有I/O信道的基本类

   

• PIndirectChannel – 包容另一个信道的信道

   

• PConsoleChannel – 访问系统控制台的信道

   

• PPipeChannel – 执行一个程序并通过PChannel控制输入输出（管道）

   

• PSerialChannel – 通过PChannel访问串行通信端口

   

• PFile – 在主机操作系统上访问文件

   

• PTextFile – 在主机操作系统上访问文本文件

   

• PStructuredFile -在主机操作系统上通过结构记录的数组访问文件

   

• PFilePath – 在主机操作系统中访问目录

   

• PVideoChannel – 以PChannel读写视频设备。请参看PVideoDevice和 PColourConverter

   

• PSoundChannel – 以PChannel读写音频设备

   

网络类

 

实现网络Sockets抽象 (基本上基于Berkeley sockets)

 

• PSocket – 所有网络Socket基类

   

• PIPSocket – 所有基于IP的Socket基类

   

• PUDPSocket – 使用UDP协议的IP socket

   

• PTCPSocket – 使用TCP/IP协议的IP socket

   

• PICMPSocket – 使用ICMP协议的IP socket

   

• PIPXSocket – 使用IPX协议的sockets基类

   

• PEthSocket – 原始以太网络接口访问socket接口

   

进程和线程类

 

处理进程、多线程及同步的相关类

 

• PProcess – 为一个正在运行的程序实现一个主控制线程

   

• PServiceProcess – 实现后台或者系统进程

   

• PThread – 抽象一个控制线程或者执行上下文

   

• PSemaphore – 信号量，仅仅基于一个计数器的同步

   

• PMutex – 互拆量，仅仅基于一个相互的排斥的同步

   

• PCriticalSection – 临界量，实现对一个临界区域的独占访问的同步

   

• PSyncPoint – 允许多线程同步访问一个特殊的代码点，请参看PSyncPointAck

   

• PAtomicInteger – 原子，实现对一个带有原子增减操作的整型计数器

   

其他类

 

• PArgList – 为一个控制台程序分解命令行

   

• PConfig – 通过一种平台允许的机制，为程序配置提供一种安全的存储方式

   

• PTime – 抽象一个完整的时间和日期使用类

   

• PTimeInterval – 为两个PTime值之间的间隔抽象一个使用类

   

• PDynaLink – 实现动态加载代码模型

   

• PRemoteConnection – 控制远程拨号连接

   

• PMail – 通过平台允许的机制发送邮件

   

• PPluginManager – 管理插件代码模型

   

• PAbstractFactory – 通过模版实现一个“抽象工厂”的范例

   

• PSmartPointer – 一个包含引用计数指针

   

• PNotifier – 一个允许任何类回调其他类成员函数的通知函数

   

• PSmartNotifierFunction – 通过对象ID而不是指针的智能通知函数

   

控制组件

 

HTTP类

 

用来实现HTTP协议

 

• PHTTP – HTTP协议基类，请参考PHTTPClient和PHTTPServer

   

• PURL – 解析和控制URL

   

• PHTML – 处理HTML信息格式的字符流

   

• PHTTPForm – 允许创建HTTP表单

   

• PHTTPServiceProcess – 一个包含HTTP服务器的PServiceProcess子类

   

协议类

 

实现不同的Internet相关协议。大部分在PWLib中已经实现，有些需要额外的库的支持。

 

• PInternetProtocol – 所有基于文本的Internet协议的基类

   

• PPOP3 – POP3协议类的基类，请参考PPOP3Client和PPOP3Server

   

• PSMTMP – SMTP协议类的基类，请参考PSMTPClient和PSMTPServer

   

• PFTP – FTP协议类的基类，请参考PFTPClient和FTPServer

   

• PMIMEInfo – 以MIME格式实现一个键-值配对的列表。

   

• PTelnetSocket – 实现TELNET协议

   

• PSocksProtocol – SOCKS协议实现的基类，请参考PSocks4Socket, PSocks5Socket, PSocksSocket, PSocksUDPSocket

   

• PSTUNClient – 实现一个STUN客户端

   

• PSNMP – SNMP协议实现的基类，请参考PSNMPClient和PSNMPServer

   

• PSSLChannel – 通过OpenSSL实现SSL协议的PIndirectChannel

   

• PSASL – 通过Cyrus SASL library实现SASL协议

   

• PXMLRPC – 通过Expat XML library和HTTP类实现XMLRPC协议

   

• PSOAPClient – 实现一个SOAP客户端

   

• PLDAPSession – 通过OpenLDAP library实现一个LDAP客户端

   

• PILSSession -通过OpenLDAP library实现一个ILS客户端

   

• XMPP::Stream – 以PChannel方式实现XMPP (Jabber)流

   

其他类

 

• PModem –为遵循AT命令集的Modem定制一个从PSerialChannel继承的子类

   

• PIpAccessControlList – 定义一系列一定范围的IP地址或网络的准入规则

   

• PRandom – 一个随机数生成器

   

• PCypher – 实现一些代码加密方式，比如PMessageDigest5, PTEACypher, 以及PMessageDigestSHA1

   

• PWAVFile – 实现AIFF格式的WAV文件

   

• PDTMFDecoder – 从PCM数据流解码DTMF数据采样

   

• PMemoryFile – 从PFile继承一个在内存中存储数据的子类

   

• PSDLVideoDevice – 实现使用SDL库的视频设备

   

• PXML – 实现一个对使用Expat库的XML的解析器

   

• PVXMLChannel – 为VXML语言实现一个解析器

   

• PTextToSpeech – 实现一个文本至语音的转换器

   

ASN.1原语支持类

 

• PASN_Array

   

• PASN_BitString

   

• PASN_BMPString

   

• PASN_Boolean

   

• PASN_Choice

   

• PASN_ConstrainedObject

   

• PASN_ConstrainedString

   

• PASN_Enumeration

   

• PASN_GeneralisedTime

   

• PASN_Integer

   

• PASN_Null

   

• PASN_Object

   

• PASN_ObjectId

   

• PASN_OctetString

   

• PASN_Real

   

• PASN_Sequence

   

• PASN_Set

   

• PASN_Stream

   

• PASN_UniversalTime