libtorrent库torrent_info接口.docVIP

研究了一段时间的libtorrent，苦于对boost和asio的了解很有限，一直都没研究它的核发心部分…… 为了增加士气，只好从外围好懂一点的模块着手研究…… torrent_info模块我觉得libtorrent做得很好。因为它可以方便地生成或者读取一个.torrent的信息，而不像bittorrent源码那些，读取.torrent是靠bencode/bdecode，生成.torrent却靠另外一个模块。在python读取bencode结构很方便，在C++中读取却很繁琐。torrent_info可以使libtorrent库用户无需了解太多相关的知识而可以实现BT协议，不知不说它真的做得比较好。还有将它们合并在一起，增加了模块的内聚性。另外它还提供了piece和文件位置的映射功能。 torrent_ifno接借了如下接口要说明一下的是entry，一个entry代表的是一个bencode的一个结点。 class torrent_info{public: torrent_info(); torrent_info(sha1_hash const info_hash); torrent_info(entry const torrent_file);//从一个文件取读数据后，经过bdecode函数转换成entry，之再转输入到这里 entry create_torrent() const;//根据本对象现存的信息，每成一个entry对象 void set_comment(char const* str);//设置注释 void set_piece_size(int size);//设置piece大小 void set_creator(char const* str);//设置创建程序名称 void set_hash(int index, sha1_hash const h);//设置某一piece的SHA-1 digest void add_tracker(std::string const url, int tier = 0);//添加tracker服务器，tier代表优先级，0最高 void add_file(boost::filesystem::path file, size_type size);//添加一个文件信息 void add_url_seed(std::string const url);//添加一个url seed地址 typedef std::vectorfile_entry::const_iterator file_iterator; typedef std::vectorfile_entry::const_reverse_iterator reverse_file_iterator; file_iterator begin_files() const;//返回文件信息的迭代器 file_iterator end_files() const; reverse_file_iterator rbegin_files() const;//返回文件信息的逆向迭代器 reverse_file_iterator rend_files() const; int num_files() const;//返回文件数量 file_entry const file_at(int index) const;//根据文件信息录入的序号返回文件信息 std::vectorfile_slice map_block(int piece, size_type offset , int size) const;//?? peer_request map_file(int file_index, size_type file_offset , int size) const;//?? std::vectorannounce_entry const trackers() const;//返回tracker列表 std::vectorstd::string const url_seeds() const;//返回url seed 列表