PeerCast 分析报告

目录

/------------------------------------------------------------------------

1. 程序基本结构

1.1 Simpel工程分析

    1.1.1 Simple工程的主要功能函数模块

    1.1.2 WinMain函数分析

    1.1.3 WndProc函数分析

    1.1.4 ChanInfoProc函数分析

2. Corelib内部分析

3．主程序说明

 

/------------------------------------------------------------------------

函数名

类或者结构体

注释

变量或者对象

关键字

//---------------------------代表程序段开始处

//***************************代表程序段结束处

1.程序基本结构

 

本报告分析方法是从PeerCast的主程序开始，然后跟进到LIB函数说明其功能。PeerCast是一个支持多平台SDK开发包，因此源码里可以看到Win32和Unix两种版本。

整个WorkSpace（工作区）包含3个Projects(工程)，包括corelib、Simple、winamp2。

 

u       PeerCast的主要功能都由Corelib实现，它通过peercast.h导出两个类PeercastInstance和PeercastApplication

u       winamp2是程序响应后调用的播放插件

u       Simple工程是程序的主体实现，通过继承peercast.h导出的两个类实现程序功能

   

1.1 Simple工程分析

 

   1.1.1 Simple工程的主要功能函数模块：

 

//注册程序窗体

ATOMMyRegisterClass(HINSTANCE hInstance);

//初始化程序窗体

BOOL InitInstance(HINSTANCE, int);

//负责传递消息到程序窗口

LRESULT CALLBACK  WndProc(HWND, UINT, WPARAM, LPARAM);

//负责传递信息到接收频道后的频道信息窗口

LRESULT CALLBACK      ChanInfoProc(HWND, UINT, WPARAM, LPARAM);

//显示任务栏图标

void setTrayIcon(int type, const char *,const char *,bool);

//显示频道信息窗口信息

void flipNotifyPopup(int id, ServMgr::NOTIFY_TYPE nt);

 

1.1.2 WinMain函数分析

 

程序的入口函数是 int  APIENTRY  WinMain(HINSTANCE hInstance,

                                               HINSTANCE  hPrevInstance,

                                               LPSTR      lpCmdLine,

                                               int           nCmdShow)

     其中第一个参数是程序实例句柄，第二个参数以被废弃，第四个参数是

InitInstance函数中用到的参数。第三个参数很重要，它是网页与程序交互的桥梁。

 

WinMain函数中lpCmdLine有五种可能值：-inifile、-zen、-multi、-kill、-url。

我们重点分析其值为-url的情况，当用户点击网页播放链接时，程序通过以下代码去掉了连接的协议头peercast://pls，得到了标准的media player播放文件名chanURL：

//-------------------------------------------------------

if (strnicmp(tmpURL,"peercast://",11)==0)

 {

         if (strnicmp(tmpURL+11,"pls/",4)==0)

                chanURL = tmpURL+11+4;

         else

                chanURL = tmpURL+11;

         showGUI = false;

 }

    //***************************************

 

     WinMain初始化了corelib的两个导出类的继承类对象：

    //----------------------------------------------------------

peercastInst = new MyPeercastInst();

        peercastApp = new MyPeercastApp();

//***************************************

 

下面的函数生成了新的ServMgr类和ChanMgr类对象，根据默认设置生成INI文件，生成了INI中的 SessionID和BroadcastID.。主要功能在ServMgr类的loadSettings函数实现。

//----------------------------------------------------------

peercastInst->Init();

//***************************************

 

下面的函数判断chanURL是否存在，也就是判断用户是否有点击链接

//----------------------------------------------------------

if (chanURL)

     {

            ChanInfo info;

            servMgr->procConnectArgs(chanURL,info);

            chanMgr->findAndPlayChannel(info,false);

     }

//***************************************

 

procConnectArgs函数的功能是：

l         sip - add network connection to client with channel

l         pip - add private network connection to client with channel

l         ip - add hit

l         tip - add tracker hit

findAndPlayChannel函数的功能是通过ChanInfo播放频道文件，主要功能在Channel类里的findAndPlayChannelProc函数实现。

 

//----------------------------------------------------------

peercastInst->saveSettings();

    peercastInst->quit();

//***************************************

saveSettings函数设置并保存INI文件，主要功能在ServMgr类的saveSettings函数实现。

 

1.1.3 WndProc函数分析

      //-----------------------------------------------------------

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)

      WndProc主要是响应自定义消息和系统消息。

      Message的可能值:

                      WM_SHOWGUI：             UI界面初始化

                      WM_TRAYICON：            发送左、右键点击下标消息

                      WM_COPYDATA：            Muti情况下播放

                WM_GETPORTNUMBER：     得到端口号

                WM_SHOWMENU：           检查PC新版本，响应左键、右键弹出菜单，判断是否有最近频道，有则加入到列表

                WM_CREATE：               同WM_CREATE

                WM_COMMAND：            主要判断wParam底四字节情况,响应弹出菜单消息和插入菜单的自定义消息(点击连接后增加菜单)

 WM_DESTROY：              系统退出

 

1.1.4 ChanInfoProc函数分析

 

ChanInfoProc函数主要在响应WM_COMMAND的四个自定义消息中的INFO_CMD消息，由DialogBox函数调用。

   

 

 

2. corelib内部分析

 

2.1 corlib内部各类功能调试心得

 

mms.cpp、 mp3.cpp、 nsv.cpp ogg.cpp都是读指定文件格式的读包协议，

jis.cpp是日文编码。

 

所有客户端必须向server交互自己的消息(通过xml),靠服务端来获得其它客

户的地址后在通过servhs类向其它客户握手，通过gnutella里的gnupacket

通信。

 

settings.html页,save按钮响应ServMgr::saveSettings函数。利用

inifile.cpp里的inifile类重写ini文件。inifile类封装了stream.cpp里的stream类,stream类主要通过CFile的fopen()和fread、fwrite、fseek打开、读写ini文件 。本质就是通过CFile类读写文件。

 

         brocast.html页，Create Relay按钮响应url.cpp中的stream函数，这个函数调用streamURL函数提交播放地址，并把地址按照一定规则转换，得到ID。

 

         Peercast右键菜单的advanced里通过showHTML函数打开explorer，具体过程为: showHTML----à sys->callLocalURL ----à ShellExecute(mainWindow, NULL, cmd, NULL, NULL, SW_SHOWNORMAL);

  

         当点击YP上的连接后，响应channel.cpp里的ChanHitList类的构造函数，接着响应Channnel类的构造函数。PC会在左键菜单加入频道，频道包含play和info选项，点击play按钮，PC响应

sys->executeFile(fname)---à ShellExecute(NULL,"open",fname,NULL,NULL,SW_SHOWNORMAL)

这时的fname为play.pls。

 

如果直接在网页里输入网址，会响应程序的wm_copydata消息，channel.cpp

中函数响应过程:                                                     

findandPlayChannel--àfindAndPlayChannelProc--àfindChannelByNameID--àfindAndRelay--àfindChannelByNameID---àCreateChannel--àfindChannelByNameID---àwhile(ch)这时候有值了---àreturn ch；得到channel了。

 

 

servMgr::start是程序运行时候就自动启动的

在corelib里的构造函数加断点

响应顺序是:

Sys::Sys()

servMgr::servMgr()

ChanMgr::ChanMgr()

ServMgr::Start()

GnuIDList::GunIDList(int max)

然后点击pc的brocast.html链接按钮，响应handshakeHTTP

接下来是HTML::HTML

进入yp页面点击连接后响应

ChanHitList::ChanHitList()

然后是Channel::Channel()

 

servent类执行顺序:

Servent::serverProc

Servent::initIncoming

Servent::incomingProc

Servent::givProc

Servent::handshakeIncoming()

Servent::handshakeHTTP

PCPStream::procAtom

Corlib里的类

 

Xml类里嵌套了Node类。

Url里是URLSource类。

Sys里String类，Radom类，Sys类，WEvent类，Wlock类，Threadinfo类，LogBuffer类

Stream里Stream类，FileStream类，MemoryStream类，IndirectStream类

Stats里Stats类

ServMgr里BCID类，ServHost类，ServFilter类，ServMgr类

Servent里Servent类

Http里HTTPException类，Cookie类，CookieList类HTTP类

Html里Html类

Gnutella里GnuPacket类里嵌套了Hash类，GnuPacketBuffer类，GnuStream类

cstream里ChanPacket类，ChanPacketBuffer类ChannelStream类

Common里各种EXCEPTION，GnuID类，GnuIDList类，

Channel里TrackInfo类，ChanInfo类，ChanHit类，ChanHitList类，ChanHitSearch类

ChanMeta类，RawStream类，PeercastStream类，ChannelSource类，PeercastSource类

Channel类，ChanMgr类PlayList类

Atom里AtomSteam类

 

==================接口=========================

peercast.h 中定义了PeercastInstance是外部应用给corelib的接口,peercast.h中只有定义有部分实现,外部调用者可以实现该接口,通过对在 peercast.cpp中定义的全局变量PeercastInstance* peercastInst重新赋值,来实现这一点.

 

peercast.h 中定义的PeercastApplication *peercastApp是core给应用程序的接口,其中包括增加和减少频道,启动和停止频道.还有一个test方法!待调查是做什么的.

 ==================http server=====================

servhs.cpp中实现了对http的一些指令的处理.每一个http访问都通过handshakeHTTP函数来处理.

handshakeCMD函数包含对各种形式为/admin?cmd=的http请求的处理

发布频道的过程:当发布一个频道的时候当调用请求的处理为/admin?,经过hadshakeHTTP的分派,转而调用 handshakeCMD(对应的cmd=fetch),先根据表单的内容(从url解析出来)填充一个新的ChanInfo,转而调用ChanMgr的 createChannel方法,该方法把新的频道加入到频道链表中,然后调用startUrl方法中启用了一个新的线程,该线程的执行函数是 stream方法,其中的主要的功能是调用了findHitList方法,如果找到那么调用addHitList

 =================core lib========================

ChanMgr 中包含频道的链,其中变量channel是频道链表的表头指针,

 

2.2 corlib总体分析

 

 2.2.1 stream.cpp分析

     

       Stream.cpp有三个类 FileStream String IndirectStream MemoryStream

 

       FileStream封装了File类

 

       FileStream::openReadOnly(const char *fn) 以只读二进制方式打开文件

       FileStream::openWriteReplace(const char *fn) 以可写二进制方式打开文件

       FileStream::openWriteAppend(const char *fn)   以附加二进制方式打开文件

       FileStream::close() 关闭文件

       FileStream::rewind() 让文件指针重新定位到头部

       FileStream::length() 返回文件长度

       FileStream::eof() 判断文件是否结束

       FileStream::read(void *ptr, int len) 在指定的文件指针位置读文件

       FileStream::write(const void *ptr, int len) 在指定的文件指针位置写文件

       FileStream::flush() 清空文件缓冲区

       FileStream::pos() 得到文件指针的位置

       FileStream::seekTo(int pos) 搜索文件到指定位置

     

2.2.2 wsocket.cpp分析

 

WSAClientSocket::init() //建立winsock2.0版本的套接字

ClientSocket::getHostname(char *str,unsigned int ip) //把IP转换为主机名

ClientSocket::getIP(char *name) //同过主机名得到IP

WSAClientSocket::setLinger(int sec) //socket延时等待未到达数据,sec为0时不设置延时

WSAClientSocket::setBlocking(bool yes) //设置socket为阻塞/非阻塞模式

WSAClientSocket::setNagle(bool on) //可以减轻TCP协议在传送小包上的问题.如果没有配置service nagle命令,在远程登录进程钟每个字符都需要占用CPU中断

(感觉层级SOL_SOCKET应该改成IPPROTO_TCP1)   

WSAClientSocket::setReuse(bool yes)// 可以让一个socket绑定正在使用的地址

WSAClientSocket::resolveHost(const char *hostName)// 通过主机名得到hostent结构体

WSAClientSocket::open(Host &rh) //建立TCP socket

WSAClientSocket::checkTimeout(bool r, bool w) //检查连接是否超时。多端口复用函数select在调用前要首先设置监听的端口数目，FD_ZERO是清空端口集，FD_SET    是设置端口集。select函数常常用在用一个进程监听多个服务器端socket。 

WSAClientSocket::getLocalHost() //得到主机IP

WSAClientSocket::connect() //连接远端地址，第一个参数怎么是unsigned int型，不是socket型？

WSAClientSocket::read(void *p, int l) //得到接收字节

WSAClientSocket::readUpto(void *p, int l) //和上面的函数完全一样- -!

WSAClientSocket::write(const void *p, int l) //发送数据

WSAClientSocket::bind(Host &h) //建立TCPsocket设置为非阻塞socket,设置为可重复绑定地址，绑定主机地址，并开始监听。

WSAClientSocket::accept() //接收连接请求,设置为非阻塞模式

WSAClientSocket::close() //关闭socket

WSAClientSocket::readReady() //判断是否在监听多个服务器端socket

 

2.2.3 xml.cpp分析

       

        XML::Node::add(Node *n) //可以看成XML::Node::    add(Node *n)添加兄弟结点或者子结点

       nibsToByte(char n1, char n2) //没用到

       XML::Node::getBinaryContent(void *ptr, int size) //没用到

       XML::Node::setBinaryContent(void *ptr, int size) //没用到

       XML::Node::setContent(const char *n) //复制字符串

       XML::Node::setAttributes(const char *n) //设置属性名和属性值的关联，判断并掉过\和=来读取属性？？？在XML::Node::构造函数里用

     XML::Node::init() //清空父、兄弟、子结点

      XML::Node::findAttrInt(const char *name) //通过属性名得到属性值，比如findAttrInt("bitrate")得到比特率的数值

      XML::Node::findAttrID(const char *name) //通过属性名得到属性ID

      XML::Node::findAttr(const char *name) //通过查找对比属性名得到属性值的ID

2.2.3 servhs.cpp分析

Servent::handshakeHTTP(HTTP &http, bool isHTTP)

       if (http.isRequest("GET /"))

       else if (http.isRequest("GIV"))

       else if (http.isRequest(PCX_PCP_CONNECT))

       else if (http.isRequest("PEERCAST CONNECT"))

else if (http.isRequest("SOURCE"))

else if (http.isRequest(servMgr->password))