【iOS-cocos2d-X 游戏开发之九】Cocos2dx利用CCSAXParser解析xml数据&CCMutableDictionary使用与注意！

　　　　　　　　　　☞ 点击订阅 ☜ 本博客最新动态!及时将最新博文通知您！

本章Himi给大家分享如何在Cocos2dX中解析xml数据；对于数据存取有很多方式，流文件，plist，xml等，那么为了跨平台更好的支持，Himi想到之前写的CCUserDefault 存储数据一节，Cocos2dx自带的存储类，一旦存入数据都会以xml格式进行保存，适用于iOS、Android等平台，所以这里Himi使用xml进行游戏的一些数据录入  = =.. 另外一方面Himi本章节也是基于Cocos2dx引擎代码进行的一次简单对xml数据解析的封装；

为了更保险的去考虑跨平台，所以对于xml存储这块的解析，也做了些搜索，最后发现王哥(王哲-cocos2dx引擎作者)也有给我们提示过，内容如下：

1

2

3

cocos2dx里面集成了libxml2，ios上会调用sdk里面内置的，

android和win32上则带了已经编译好的静态/动态库。

你可以参考CCSAXParser里面的代码来使用libxml2

那么既然如此，就对Cocos2dx引擎源码的CCSAXParser类进行了剖析，那么这里Himi，先给出代码，然后再详细讲解下：

Himi封装的HXmlParse类:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

HXmlParse.h

 

//

//  HXmlParse.h

//  HAnimation

//

//  Created by Himi on 12-3-22.

//  Copyright (c) 2012年 Augustimpression. All rights reserved.

//

 

#ifndef HAnimation_HXmlParse_h

#define HAnimation_HXmlParse_h

 

#include "cocos2d.h"

#include "CCSAXParser.h"

#include "CCObject.h"

#include "CCMutableDictionary.h"

 

usingnamespace cocos2d;

 

classCC_DLL HXmlParse :publicCCObject, publicCCSAXDelegator

{

 

public:

 

    staticHXmlParse * parserWithFile(constchar *tmxFile);

 

    boolinitHXmlParse(constchar* xmlName);

 

    //  使用 CCSAXDelegator 重写3个回调函数

 

    voidstartElement(void*ctx, constchar *name, constchar **atts);

 

    voidendElement(void*ctx, constchar *name);

 

    voidtextHandler(void*ctx, constchar *ch, intlen);

 

    std::string root_name;

 

    boolisJumpHeadData;

 

    CCMutableDictionary<std::string,CCString*> *mDic;

 

private:

 

    std::string startXmlElement;//用来记录每个key前字段

 

    std::string endXmlElement;//用来记录每个key后字段

 

    std::string currString;//记录每个value的值

 

};

 

#endif

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

HXmlParse.cpp

 

//

//  HXmlParse.cpp

//  HAnimation

//

//  Created by Himi on 12-3-22.

//  Copyright (c) 2012年 Augustimpression. All rights reserved.

//

 

#include "HXmlParse.h"

#include "CCSAXParser.h"

 

HXmlParse * HXmlParse::parserWithFile(constchar *tmxFile)

{

    HXmlParse *pRet = newHXmlParse();

    if(pRet->initHXmlParse(tmxFile))

    {

        pRet->autorelease();

        returnpRet;

    }

    CC_SAFE_DELETE(pRet);

    returnNULL;

}

 

boolHXmlParse::initHXmlParse(constchar* xmlName)

 

{

 

    mDic = newCCMutableDictionary<std::string,CCString*>();

 

    CCSAXParser _par; 

 

    if(false== _par.init("UTF-8") )

 

    {

        CCLog("-----请使用utf-8格式!");

        returnfalse;

    }

    _par.setDelegator(this);

    constchar* _path =CCFileUtils::fullPathFromRelativePath(xmlName);

    return_par.parse(_path);

 

}

 

//回调函数

 

voidHXmlParse::startElement(void*ctx, constchar *name, constchar **atts)

 

{  

 

    CC_UNUSED_PARAM(ctx);

 

    startXmlElement = (char*)name;

    if(!isJumpHeadData){//跳过数据头

        CCLog("------跳过root name");

        isJumpHeadData=true;

        root_name=startXmlElement;

        return;

    }

 

//    CCLog("-startElement----%s",startXmlElement.c_str());

 

}

 

voidHXmlParse::endElement(void*ctx, constchar *name)

 

{

    CC_UNUSED_PARAM(ctx);

 

    endXmlElement = (char*)name;

    if(endXmlElement==root_name){//数据尾

        CCLog("读取xml结束");

        isJumpHeadData=false;

        root_name="";

        return;

    }

 

//    CCLog("-endElement----%s",endXmlElement.c_str());

}

//键值对的结束字段

voidHXmlParse::textHandler(void*ctx, constchar *ch, intlen)

{

 

    CC_UNUSED_PARAM(ctx);

    currString=string((char*)ch,0,len);

    CCString *ccStr =newCCString();//备注3

    ccStr->m_sString=currString;

    if(root_name!=""){

         mDic->setObject(ccStr,startXmlElement);

        CCLog("-----key:%s, value:%s",startXmlElement.c_str(),mDic->objectForKey(startXmlElement)->m_sString.c_str());

    }

 

//    CCLog("-textHandler----%s",currString.c_str());

 

}

OK，代码呢我们先从.h中来说，首先我们使用CCSAXDelegator，为了让CCSAXParser解析数据后将数据回调给如下三个函数：

1

2

3

4

5

6

7

//  使用 CCSAXDelegator 重写3个回调函数

 

   voidstartElement(void*ctx, constchar *name, constchar **atts);

 

   voidendElement(void*ctx, constchar *name);

 

   voidtextHandler(void*ctx, constchar *ch, intlen);

startElement   函数解析的是xml的每个key前字段

textHandler  函数解析出来的是xml每个key对应的value值

endElement   函数解析出来的是xml的每个key后字段

这里Himi随便写了一个xml来做测试，himi.xml，如下：

1

<?xml version="1.0"encoding="utf-8"?><himiTestData><key1>1000</key1><key2>娃哈哈</key2><key3>82.3</key3><key4>4000</key4><key5>himi</key5><key6>true</key6></himiTestData>

那么CCSAXParser类解析第一次回调 startElement 是读取的是root name（xml数据头标识名称->“<himiTestData>”），然后才读取正式数据key和value，最后读取的也是xml数据尾标识名称“</himiTestData>”

当然在Himi封装的HXmlParse类中对于数据标识的读取都跳过了，使用变量isJumpHeadData来处理的；

其他的都很容易没有什么可说的，主要要说还有一点就是关于CCMutableDictionary的使用，对于此类主要结构是形成map&NSMutableDictionary类似是个键值对容器，key-value；那么使用时候要注意4点：

1.  比如Himi解析数据后都会默认将key和value数据存放在CCMutableDictionary中，那么这里我肯定传入的是两个string，但是细心的童鞋会发现代码中第二个并不是std::string,而是CCString对象，嗯 没错，CCMutableDictionary要求传入的是CCObject对象而不是基本类型！CCString中有m_sString这个属性，所以转换起来也是很方便的；

2. 使用CCMutableDictionary进行添加数据setObject的时候要注意此函数的两个参数：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

boolsetObject(_ValueT pObject, const_KeyT& key)

    {

        pair<CCObjectMapIter,bool> pr;

 

        pr = m_Map.insert( Int_Pair(key, pObject) );

 

        if(pr.second == true)

        {

            pObject->retain();

            returntrue;

        }

 

        returnfalse;

    }

上面这个是cocos2dx引擎中源码中setObject函数实现代码，这里可以很清晰的看到，第一个参数表示《CCObject》，第二个参数才是《Key》!这点对于之前做过java开发的我来说比较郁闷，因为一般都是key在第一个参数。。。。。

3. 请大家仔细看HXmlParse.cpp类中的备注3 ，当你使用CCMutableDictionary的setObject函数的时候，务必要注意，此函数的存入的CCObject参数，引擎中实现代码是对你这个CCObject进行retain()的一个内存地址引用！也就是说这里不要使用一个成员变量来使用，否则你从CCMutableDictionary取出来的数据全部是你最后一个CCObject数据！

4. CCMutableDictionary是cocos2d-x自己封装的类，功能类似NSMutableDictionary。但是Himi通过测试发现！它有一点和NSMutableDictionary是不一样的。NSMutableDictionary的setObjectForKey方法是：如果发现这个key已经存在于字典中的时候，它会自动用新的object覆盖掉原有的object。而CCMutableDictionary由于它是使用map实现的字典功能，而在map里面，如果key已存在，是不会用新的object覆盖掉原有object的。在使用CCMutableDictionary的时候需要特别注意这一点。

HXmlParse解析xml类使用方法很简单：

1

2

3

#include "HXmlParse.h"

 

HXmlParse::parserWithFile("himi.xml");

然后Himi为了证实此解析类在Android也可以正常运行，那么这里Himi将读出的数据展示在画面上，iOS运行截图如下：