Latest 1.0.1
Homepage https://github.com/caobo56/GEBEncoding
License MIT
Platforms ios 8.0
Authors

GEBEncoding是一个 beencodeing 的OC 函数库。

Bencode

Bencode是BitTorrent用在传输数据结构的编码方式。

Bencode(发音为 Bee-Encode)这种编码方式支持四种数据型态:

  • 字元串
  • 整数
  • 串列
  • 字典表

Bencode 最常被用在.torrent文档中,文件里的元数据都是 Bencode 过的字典表。其也被用在tracker返回响应时使用。

虽然比用纯二进制编码效率低,但由于结构简单而且不受字节存储顺序影响(所有数字以十进制编码)——这对于跨平台性非常重要。而且具有较好的灵活性,即使存在故障的字典键,只要将其忽略并更换新的就能兼容补充。

使用方法

引入pod库

    pod 'GEBEncoding'

GEBEncoding 的 testCase


-(void)testCase{
    NSDictionary * dict = @{@"inputs.sourceType":@(1998),@"inputs.data":@(2000)};
    NSData * encodeData = [GEBEncoding encodedDataFromObject:dict];
    NSLog(@"encodeData = %@",encodeData);

    id decodeData = [GEBEncoding objectFromEncodedData:encodeData];

    NSLog(@"decodeData = %@",decodeData);
    NSLog(@"decodeData class = %@",[decodeData class]);
    NSLog(@"inputs.sourceType = %@",[decodeData objectAtIndex:1]);
}

运行结果

2018-06-11 17:50:45.990442+0800 GEBEncodingTest[5353:3486429] encodeData = <6431313a 696e7075 74732e64 61746169 32303030 6531373a 696e7075 74732e73 6f757263 65547970 65693139 39386565>
2018-06-11 17:50:45.990779+0800 GEBEncodingTest[5353:3486429] decodeData = {
    inputs.data = 2000;
    inputs.sourceType = 1998;
}
2018-06-11 17:50:45.990878+0800 GEBEncodingTest[5353:3486429] decodeData class = OrderedDictionary
2018-06-11 17:50:45.990952+0800 GEBEncodingTest[5353:3486429] inputs.sourceType = 1998

头文件函数列表

#import <Foundation/Foundation.h>
#import "OrderedDictionary.h"

typedef enum {
    GEBEncodedStringType = -1,
    GEBEncodedDataType = 0
} GEBEncodedType;

typedef GEBEncodedType (^GEBEncodedTypeAdvisor)(NSArray *keyStack);

//  BEncoding
//
//  This class is not intended to be instantiated. Its a 'utility' class, and
//  as such you simply call the class methods as required when you need them.
//
//  The BEncoding class can encode and decode data to and from bencoded byte
//  data as defined here: http://wiki.theory.org/BitTorrentSpecification

@interface GEBEncoding : NSObject { }

//  +(NSData *)encodeDataFromObject:(id)object
//
//  This method to returns an NSData object that contains the bencoded
//  representation of the object that you send. You can send complex structures
//  such as an NSDictionary that contains NSArrays, NSNumbers and NSStrings, and
//  the encoder will correctly serialise the data in the expected way.
//
//  Supports NSData, NSString, NSNumber, NSArray and NSDictionary objects.
//
//  NSStrings are encoded as NSData objects as there is no way to differentiate
//  between the two when decoding.
//
//  NSNumbers are encoded and decoded with their longLongValue.
//
//  NSDictionary keys must be NSStrings.

+(NSData *)encodedDataFromObject:(id)object;

//  +(id)objectFromEncodedData:(NSData *)sourceData;
//
//  This method returns an NSObject of the type that is serialised in the bencoded
//  sourceData.
//
//  Bad data should not cause any problems, however if it is unable to deserialise
//  anything from the source, it may return a nil, which you need to check for.

+(id)objectFromEncodedData:(NSData *)sourceData;

+(id)objectFromEncodedData:(NSData *)sourceData withTypeAdvisor:(GEBEncodedTypeAdvisor)typeAdvisor;

@end

Latest podspec

{
    "name": "GEBEncoding",
    "version": "1.0.1",
    "summary": "GEBEncoding u7684podu5e93u3002bencoding u7684 OC u5b9eu73b0u3002",
    "description": "GEBEncoding u7684podu5e93u3002bencoding u7684 OC u5b9eu73b0u3002",
    "homepage": "https://github.com/caobo56/GEBEncoding",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "caobo": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/caobo56/GEBEncoding.git",
        "tag": "1.0.1"
    },
    "source_files": [
        "src",
        "src/GEBEncoding/*.{h,m}"
    ],
    "requires_arc": false
}

Pin It on Pinterest

Share This