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工程的主要功能函数模块：
//注册程序窗体
ATOM
MyRegisterClass(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))
9573
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
