Cocos2d-x之数据的处理

|   版权声明：本文为博主原创文章，未经博主允许不得转载。

FileUtils

在游戏中，用户要保存自己的偏好设置和玩家的信息，都需要涉及到游戏数据的处理。首先要想处理数据，则要找到文件，创建文件，读写文件...;在Cocos2d-x中有一个类FileUtils，FileUtils是Cocos2d-x引擎中封装的一个简单的文件操作类，该类几乎实现了所有文件操作的功能，类FileUtils并不只是一个文件，也不是两个文件。在每个平台都会有一个FileUtils的头文件和实现文件。在游戏的开始阶段，游戏的文件资源一般都是存放在硬盘中，在游戏开始的时候，文件操作模块就会将硬盘中的资源转移到内存中。

在游戏中文件的读取分为三个部分：

1. 资源存放在硬盘中

2. 资源存放在内存中

3. 资源存放在缓存中

API常用函数介绍：

 /**  Gets the instance of FileUtils.获得文件模块的单例对象 */
 static FileUtils* getInstance();
 /**  Destroys the instance of FileUtils.释放文件模块*/
 static void destroyInstance();
 /**     清空缓存
 *  Purges full path caches.
 */
 virtual void purgeCachedEntries();
 /**     从文件中获取字符串。
 *  Gets string from a file.
 */
 virtual std::string getStringFromFile(const std::string& filename);
 /** 获得资源文件的内容
 *  Creates binary data from a file.
 *  @return A data object.
 */
 virtual Data getDataFromFile(const std::string& filename);
 /** 获取资源文件数据
 *  Gets resource file data
 *  @param[in]  filename The resource file name which contains the path.
 *  @param[in]  mode The read mode of the file.
 *  @param[out] size If the file read operation succeeds, it will be the data size, otherwise 0.
 *  @return Upon success, a pointer to the data is returned, otherwise NULL.
 *  @warning Recall: you are responsible for calling free() on any Non-NULL pointer returned.
 */
 CC_DEPRECATED_ATTRIBUTE virtual unsigned char* getFileData(const std::string& filename, const char* mode, ssize_t *size);
 /**     从zip文件中获得资源文件的内容
 *  Gets resource file data from a zip file.
 *  @param[in]  filename The resource file name which contains the relative path of the zip file.
 *  @param[out] size If the file read operation succeeds, it will be the data size, otherwise 0.
 *  @return Upon success, a pointer to the data is returned, otherwise nullptr.
 *  @warning Recall: you are responsible for calling free() on any Non-nullptr pointer returned.
 */
 virtual unsigned char* getFileDataFromZip(const std::string& zipFilePath, const std::string& filename, ssize_t *size);
 /** 获得一个文件的绝对路径，返回值为文件的绝对路径(通过文件名查找文件，并将它所在的路径返回)
 *       Returns the fullpath for a given filename.
 */
 virtual std::string fullPathForFilename(const std::string &filename) const;
 /** 通过一个文件名在字典容器中查找文件
 * Loads the filenameLookup dictionary from the contents of a filename.
 * @note The plist file name should follow the format below:
 */
 virtual void loadFilenameLookupDictionaryFromFile(const std::string &filename);
 /** 设置一个按文件名查找的字典。
 *  Sets the filenameLookup dictionary.
 *  @param pFilenameLookupDict The dictionary for replacing filename.
 */
 virtual void setFilenameLookupDictionary(const ValueMap& filenameLookupDict);
 /**     获得一个文件的绝对路径包含文件名
 *  Gets full path from a file name and the path of the relative file.
 */
 virtual std::string fullPathFromRelativeFile(const std::string &filename, const std::string &relativeFile);
 /**     设置数组容器内所包含的资源的搜索顺序。
 *  Sets the array that contains the search order of the resources.
 *  @param searchResolutionsOrder The source array that contains the search order of the resources.
 *  @see getSearchResolutionsOrder(), fullPathForFilename(const char*).
 */
 virtual void setSearchResolutionsOrder(const std::vector<std::string>& searchResolutionsOrder);
 /**     追加资源的搜索顺序。
 * Append search order of the resources.
 * @see setSearchResolutionsOrder(), fullPathForFilename().
 */
 virtual void addSearchResolutionsOrder(const std::string &order,const bool front=false);
 /**     获取数组中所包含的资源的搜索顺序
 *  Gets the array that contains the search order of the resources.
 *  @see setSearchResolutionsOrder(const std::vector<std::string>&), fullPathForFilename(const char*).
 */
 virtual const std::vector<std::string>& getSearchResolutionsOrder() const;
 /**     设置资源路径
 *  Sets the array of search paths.
 */
 virtual void setSearchPaths(const std::vector<std::string>& searchPaths);
 /**     设置默认资源的根路径。
 * Set default resource root path.
 */
 void setDefaultResourceRootPath(const std::string& path);
 /**     添加搜索路径。
 * Add search path.
 */
 void addSearchPath(const std::string & path, const bool front=false);
 /** 获取的搜索路径的数组。
 *  Gets the array of search paths.
 */
 virtual const std::vector<std::string>& getSearchPaths() const;
 /**     获取可写的路径。
 *  Gets the writable path.
 *  @return  The path that can be write/read a file in
 */
 virtual std::string getWritablePath() const = ;
 /**     设置可写的路径。
 *  Sets writable path.
 */
 virtual void setWritablePath(const std::string& writablePath);
 /**     设置在无法加载图像时候是否弹出一个消息框。
 *  Sets whether to pop-up a message box when failed to load an image.
 */
 virtual void setPopupNotify(bool notify);
 /** 检查在无法加载图像的时候是否弹出一个消息框。
 *       Checks whether to pop up a message box when failed to load an image.
 *  @return True if pop up a message box when failed to load an image, false if not.
 */
 virtual bool isPopupNotify() const;
 /**     文件到ValueMap的内容转换。(将文件中的内容转换成ValueMap类型)
 *  Converts the contents of a file to a ValueMap.
 *  @param filename The filename of the file to gets content.
 *  @return ValueMap of the file contents.
 *  @note This method is used internally.
 */
 virtual ValueMap getValueMapFromFile(const std::string& filename);
 /** Converts the contents of a file to a ValueMap.
 *  This method is used internally.
 */
 virtual ValueMap getValueMapFromData(const char* filedata, int filesize);
 /**     写一个内容为ValueMap类型的plist文件
 * write a ValueMap into a plist file
 *@param dict the ValueMap want to save
 *@param fullPath The full path to the file you want to save a string
 *@return bool
 */
 virtual bool writeToFile(ValueMap& dict, const std::string& fullPath);
 /** 写一个内容为String类型的.plist文件
 *  write a string into a file
 * @param dataStr the string want to save
 * @param fullPath The full path to the file you want to save a string
 * @return bool True if write success
 */
 virtual bool writeStringToFile(std::string dataStr, const std::string& fullPath);
 /**
 * write Data into a file
 *@param retData the data want to save
 *@param fullPath The full path to the file you want to save a string
 *@return bool
 */
 virtual bool writeDataToFile(Data retData, const std::string& fullPath);
 /**
 * write ValueMap into a plist file
 *@param dict the ValueMap want to save
 *@param fullPath The full path to the file you want to save a string
 *@return bool
 */
 virtual bool writeValueMapToFile(ValueMap& dict, const std::string& fullPath);
 /**
 * write ValueVector into a plist file
 *@param vecData the ValueVector want to save
 *@param fullPath The full path to the file you want to save a string
 *@return bool
 */
 virtual bool writeValueVectorToFile(ValueVector vecData, const std::string& fullPath);
 /**
 * Windows fopen can't support UTF-8 filename
 * Need convert all parameters fopen and other 3rd-party libs
 * @param filename std::string name file for conversion from utf-8
 * @return std::string ansi filename in current locale
 */
 virtual std::string getSuitableFOpen(const std::string& filenameUtf8) const;
 // Converts the contents of a file to a ValueVector.
 // This method is used internally.
 virtual ValueVector getValueVectorFromFile(const std::string& filename);
 /**     判断文件是否存在
 *  Checks whether a file exists.
 *  @note If a relative path was passed in, it will be inserted a default root path at the beginning.
 *  @param filename The path of the file, it could be a relative or absolute path.
 *  @return True if the file exists, false if not.
 */
 virtual bool isFileExist(const std::string& filename) const;
 /** 获取文件的扩展名是在较低的情况下的后缀（由点从基本文件名隔开）。
 *  Gets filename extension is a suffix (separated from the base filename by a dot) in lower case.
 *  Examples of filename extensions are .png, .jpeg, .exe, .dmg and .txt.
 *  @param filePath The path of the file, it could be a relative or absolute path.
 *  @return suffix for filename in lower case or empty if a dot not found.
 */
 virtual std::string getFileExtension(const std::string& filePath) const;
 /**     检查路径是否是绝对路径。
 *  Checks whether the path is an absolute path.t.
 */
 virtual bool isAbsolutePath(const std::string& path) const;
 /**检查路径是否是一个目录。
 *  Checks whether the path is a directory.
 *  @param dirPath The path of the directory, it could be a relative or an absolute path.
 *  @return True if the directory exists, false if not.
 */
 virtual bool isDirectoryExist(const std::string& dirPath) const;
 /**     创建一个字典目录
 *  Creates a directory.
 *  @param dirPath The path of the directory, it must be an absolute path.
 *  @return True if the directory have been created successfully, false if not.
 */
 virtual bool createDirectory(const std::string& dirPath);
 /**     移除一个目录
 *  Removes a directory.
 *  @param dirPath  The full path of the directory, it must be an absolute path.
 *  @return True if the directory have been removed successfully, false if not.
 */
 virtual bool removeDirectory(const std::string& dirPath);
 /**     移除一个文件
 *  Removes a file.
 *  @param filepath The full path of the file, it must be an absolute path.
 *  @return True if the file have been removed successfully, false if not.
 */
 virtual bool removeFile(const std::string &filepath);
 /**     给指定目录下的文件重命名
 *  Renames a file under the given directory.
 *  @param path     The parent directory path of the file, it must be an absolute path.
 *  @param oldname  The current name of the file.
 *  @param name     The new name of the file.
 *  @return True if the file have been renamed successfully, false if not.
 */
 virtual bool renameFile(const std::string &path, const std::string &oldname, const std::string &name);
 /** 给指定目录下的文件重命名
 *  Renames a file under the given directory.
 *  @param oldfullpath  The current fullpath of the file. Includes path and name.
 *  @param newfullpath  The new fullpath of the file. Includes path and name.
 *  @return True if the file have been renamed successfully, false if not.
 */

 virtual bool renameFile(const std::string &oldfullpath, const std::string &newfullpath);
 /**     检索文件的大小
 *  Retrieve the file size.
 *  @note If a relative path was passed in, it will be inserted a default root path at the beginning.
 *  @param filepath The path of the file, it could be a relative or absolute path.
 *  @return The file size.
 */
 virtual long getFileSize(const std::string &filepath);
 /** 返回的完整路径缓存。
 *       Returns the full path cache.
 */
 const std::unordered_map<std::string, std::string>& getFullPathCache() const { return _fullPathCache; }

 protected CONUT:

 /** 在字典中使用一个文件的密钥来查找文件名
 *       Dictionary used to lookup filenames based on a key.
 *  It is used internally by the following methods:基于下面的方法在内部使用
 *  std::string fullPathForFilename(const char*);
 */
 ValueMap _filenameLookupDict;
 /** 该Vector容器包含有分辨率文件夹。元素在此向量的低指数，该决议目录优先级越高。
 *  The vector contains resolution folders.
 *  The lower index of the element in this vector, the higher priority for this resolution directory.
  */
 std::vector<std::string> _searchResolutionsOrderArray;
 /**Vector容器包含的搜索路径。
 * The vector contains search paths.
 * The lower index of the element in this vector, the higher priority for this search path.
 */
 std::vector<std::string> _searchPathArray;
 /**     资源的默认根路径。
 *  The default root path of resources.
 *  If the default root path of resources needs to be changed, do it in the `init` method of FileUtils's subclass.
 *  For instance:
 *  On Android, the default root path of resources will be assigned with "assets/" in FileUtilsAndroid::init().
 *  Similarly on Blackberry, we assign "app/native/Resources/" to this variable in FileUtilsBlackberry::init().
 */
 std::string _defaultResRootPath;
 /**     完整路径缓存。当一个文件被发现，它将被添加到该高速缓存。
 *  The full path cache. When a file is found, it will be added into this cache.
 *  This variable is used for improving the performance of file search.
 */
 mutable std::unordered_map<std::string, std::string> _fullPathCache;
 /**可写路径。
 * Writable path.
 */
 std::string _writablePath;
 /**     文件实用的单指针。
 *  The singleton pointer of FileUtils.
 */
 static FileUtils* s_sharedFileUtils;

实例：

.h files

#ifndef _FILEUTILSTEST_SCENE_H_
#define _FILEUTILSTEST_SCENE_H_
#include "cocos2d.h"
class fileUtil : public cocos2d::Layer
{
private:
public:
        static cocos2d::Scene* createScene();
        virtual bool init();
        void fileUtil::testResolutionDirectories(Ref* sender);
        void fileUtil::testSearchPath(Ref* sender);
        void fileUtil::testFilenameLookup(Ref* sender);
        void fileUtil::testIsFileExist(Ref* sender);
        void fileUtil::testWritePlist(Ref* sender);
        CREATE_FUNC(fileUtil);
};
#endif // _FILEUTILSTEST_SCENE_H_

.cpp files

#include "fileUtilsTest.h"

USING_NS_CC;

Scene* fileUtil::createScene()
{
        auto scene = Scene::create();
        auto layer = fileUtil::create();
        scene->addChild(layer);
        return scene;
}

bool fileUtil::init()
{
        if (!Layer::init())
        {
               return false;
        }

        Size visibleSize = Director::getInstance()->getVisibleSize();
        Vec2 origin = Director::getInstance()->getVisibleOrigin();

        auto item1 = MenuItemFont::create("testResolutionDirectories", CC_CALLBACK_1(fileUtil::testResolutionDirectories, this));
        auto item2 = MenuItemFont::create("testSearchPath", CC_CALLBACK_1(fileUtil::testSearchPath, this));
        auto item3 = MenuItemFont::create("testFilenameLookup", CC_CALLBACK_1(fileUtil::testFilenameLookup, this));
        auto item4 = MenuItemFont::create("testIsFileExist", CC_CALLBACK_1(fileUtil::testIsFileExist, this));
        auto item5 = MenuItemFont::create("testWritePlist", CC_CALLBACK_1(fileUtil::testWritePlist, this));

        auto menu = Menu::create(item1, item2, item3, item4, item5, NULL);
        menu->setPosition(Vec2(250, visibleSize.height - 200));
        menu->alignItemsVerticallyWithPadding(20);
        this->addChild(menu);

        return true;
}

//设置和获得分辨率的路径；获取某个文件的路径
void fileUtil::testResolutionDirectories(Ref* sender)
{
//不同的平台的不同的设备它们的分辨率也存在着某些差异
        //实例化
        auto fileUtil = FileUtils::getInstance();
        //清除缓存，清空所有的缓存
        fileUtil->purgeCachedEntries();

        //默认搜索路径，第一次的默认搜索路径是Resource那个文件夹
        std::vector<std::string> _defaultSearchPathArray;
        _defaultSearchPathArray = fileUtil->getSearchPaths();
        std::vector<std::string> searchPath = _defaultSearchPathArray;

        //在默认的搜索路径下在添加一个我们自己的搜索路径
        searchPath.insert(searchPath.begin(), "Misc");
        //设置新的搜索路径为"Misc"
        fileUtil->setSearchPaths(searchPath);

        //获得搜索分辨率资源路径
        std::vector<std::string> _defaultResolutionsOrderArray = fileUtil->getSearchResolutionsOrder();
        std::vector<std::string> resolutionsOrder = _defaultResolutionsOrderArray;

        //添加分辨率资源路径
        //在依次的在下面的文件名路径下依次的查找所要查找的内容
        resolutionsOrder.insert(resolutionsOrder.begin(), "resources-ipadhd");
        resolutionsOrder.insert(resolutionsOrder.begin() + 1, "resources-ipad");
        resolutionsOrder.insert(resolutionsOrder.begin() + 2, "resources-widehd");
        resolutionsOrder.insert(resolutionsOrder.begin() + 3, "resources-wide");
        resolutionsOrder.insert(resolutionsOrder.begin() + 4, "resources-hd");
        resolutionsOrder.insert(resolutionsOrder.begin() + 5, "resources-iphone");

        //重新设置路径
        fileUtil->setSearchResolutionsOrder(resolutionsOrder);

        for (int i = 1; i < 7; i++)
        {
               //创建6个文件名：text~.txt
               auto filename = String::createWithFormat("test%d.txt", i);
               //fullPathForFilename(filename->getCString())取得当前对象文件的一个绝对路径；如何查找，它会在上面所有设定好的文件名称下，依次的来查找
               std::string ret = fileUtil->fullPathForFilename(filename->getCString());
               log("%s --> %s", filename->getCString(), ret.c_str());
        }
}

//搜索路径
void fileUtil::testSearchPath(Ref* sender)
{
//实例化
        auto fileUtil = FileUtils::getInstance();
        std::string ret;
        //清除缓存，清空所有的缓存
        fileUtil->purgeCachedEntries();
        std::vector<std::string> _defaultSearchPathArray = fileUtil->getSearchPaths();
        std::vector<std::string> searchPaths = _defaultSearchPathArray;
        //getWritablePath();获得一个可写的路径
        std::string writablePath = fileUtil->getWritablePath();

        std::string fileName = writablePath + "external.txt";
        char szBuf[100] = "Hello Cocos2d-x!";
        FILE* fp = fopen(fileName.c_str(), "wb");
        if (fp)
        {
               size_t ret = fwrite(szBuf, 1, strlen(szBuf), fp);
               CCASSERT(ret != 0, "fwrite function returned zero value");
               fclose(fp);
               if (ret != 0)
                       log("Writing file to writable path succeed");
        }
//下面是设置或者添加几个可写分辨路径
        searchPaths.insert(searchPaths.begin(), writablePath);
        searchPaths.insert(searchPaths.begin() + 1, "Misc/searchpath1");
        searchPaths.insert(searchPaths.begin() + 2, "Misc/searchpath2");
        fileUtil->setSearchPaths(searchPaths);
//取得分辨路径
        std::vector<std::string> _defaultResolutionsOrderArray = fileUtil->getSearchResolutionsOrder();
        std::vector<std::string> resolutionsOrder = _defaultResolutionsOrderArray;
//添加一个路径resources-ipad
        resolutionsOrder.insert(resolutionsOrder.begin(), "resources-ipad");
        fileUtil->setSearchResolutionsOrder(resolutionsOrder);

        for (int i = 1; i<3; i++)
        {
               auto filename = String::createWithFormat("file%d.txt", i);
               ret = fileUtil->fullPathForFilename(filename->getCString());
               log("%s --> %s", filename->getCString(), ret.c_str());
        }

        // Gets external.txt from writable path
        std::string fullPath = fileUtil->fullPathForFilename("external.txt");
        log("external file path = %s", fullPath.c_str());
        if (fullPath.length()>0)
        {//rb是一个只读的权限
               fp = fopen(fullPath.c_str(), "rb");
               if (fp)
               {
                       char szReadBuf[100] = { 0 };
                       int read = fread(szReadBuf, 1, strlen(szBuf), fp);
                       if (read>0)
                       {
                               log("The content of file from writable path: %s", szReadBuf);
                       }
                       fclose(fp);
               }
        }
}

//文件查找
//测试文件名查找
void fileUtil::testFilenameLookup(Ref* sender)
{
//实例化
        auto sharedFileUtils = FileUtils::getInstance();
        ValueMap dict;
        dict["grossini.bmp"] = Value("Images/grossini.png");
        dict["grossini.xcf"] = Value("Images/grossini.png");
//设置一个按文件名查找的字典
        sharedFileUtils->setFilenameLookupDictionary(dict);

        // Instead of loading carlitos.xcf, it will load grossini.png
        auto sprite = Sprite::create("grossini.png");
        this->addChild(sprite);

        auto s = Director::getInstance()->getWinSize();
        sprite->setPosition(Vec2(s.width / 2, s.height / 2));
}

//判断文件是否存在
//测试文件是否存在
void fileUtil::testIsFileExist(Ref* sender)
{
        auto s = Director::getInstance()->getWinSize();
        auto sharedFileUtils = FileUtils::getInstance();

        Label* pTTF = nullptr;
        bool isExist = false;

        isExist = sharedFileUtils->isFileExist("Images/grossini.png");

        pTTF = Label::createWithSystemFont(isExist ? "Images/grossini.png exists" : "Images/grossini.png doesn't exist", "", 20);
        pTTF->setPosition(Vec2(s.width / 2, s.height / 3));
        this->addChild(pTTF);
}

//写plist配置文件
//测试写plist文件
void fileUtil::testWritePlist(Ref* sender)
{
//创建一个字典
        auto root = Dictionary::create();
//设置字典的key-》String element value
        auto string = String::create("String element value");
        root->setObject(string, "string element key");
//创建一个数组
        auto array = Array::create();
//在数组里面添加一个字典
        auto dictInArray = Dictionary::create();
//往字典里面添加两个对象
        dictInArray->setObject(String::create("string in dictInArray value 0"), "string in dictInArray key 0");
        dictInArray->setObject(String::create("string in dictInArray value 1"), "string in dictInArray key 1");
//再将字典添加到数组里面去
        array->addObject(dictInArray);

        array->addObject(String::create("string in array"));
//在数组中在添加一个数组
        auto arrayInArray = Array::create();
        arrayInArray->addObject(String::create("string 0 in array"));
        arrayInArray->addObject(String::create("string 1 in array"));
        array->addObject(arrayInArray);

        root->setObject(array,"array");
//在字典中在嵌套字典
        auto dictInDict = Dictionary::create();
        dictInDict->setObject(String::create("string in dictInDict value"), "String in dictInDict key");

        //add booleans to the plist
        auto booleanObject = Bool::create(true);
        dictInDict->setObject(booleanObject, "bool");

        //add integer to the plist
        auto intObject = Integer::create(624);
        dictInDict->setObject(intObject, "integer");

        //add float to the plist
        auto floatObject = Float::create(524.2);
        dictInDict->setObject(floatObject, "float");

        //add double to the plist
        auto doubleObject = Double::create(524.2);
        dictInDict->setObject(doubleObject, "double");
        root->setObject(dictInDict, "dictInDict, hello world!");

        //end with
        //在拿到一个可写的路径getWritablePath();-——》writablePath
        std::string writablePath = FileUtils::getInstance()->getWritablePath();
        //在拿到的可写路径下添加一个text.plist文件
        std::string fullPath = writablePath + "text.plist";
        //调用writeToFile方法进行写操作
        if (root->writeToFile(fullPath.c_str()))
               log("see the plist file at %s", fullPath.c_str());
        else
               log("write plist file failed");

        auto label = LabelTTF::create(fullPath.c_str(), "Arial", 12);
        this->addChild(label);
        auto winsize = Director::getInstance()->getWinSize();
        label->setPosition(Vec2(winsize.width / 2, winsize.height / 3));
//根据文件的内容来创建一个字典
        auto loadDict = __Dictionary::createWithContentsOfFile(fullPath.c_str());
        auto loadDictInDict = (__Dictionary*)loadDict->objectForKey("dictInDict,hello world");
        auto boolValue = (__String*)loadDictInDict->objectForKey("bool");
        CCLOG("%s", boolValue->getCString());
        auto floatValue = (__String*)loadDictInDict->objectForKey("float");
        CCLOG("%s", floatValue->getCString());
        auto doubleValue = (__String*)loadDictInDict->objectForKey("double");
        CCLOG("%s", doubleValue->getCString());
        auto integerValue = (__String*)loadDictInDict->objectForKey("int");
        CCLOG("%s", integerValue->getCString());
}

UserDefault

在上面实现了数据的读写等一些操作，但是游戏的某些数据时要实现持久化的，因此Cocos2d-x引擎中有提供了一个类UserDefault来让我们来实现数据的持久化。UserDefault可以实现数据的存储，但是它不宜储存大量的数据，一般的情况下，用于保存一些游戏设置和玩家偏好设置；数据持久化就是数据能够存储起来，然后在需要的时候可以查找回来，即使设备从新启动也可以查找回来。在UserDefault提供了对int, double, bool和string等数据类型的读写。

UserDefault所支持的数据类型：

在Cocos2d-x中能够多种持久化的方式;

1. 普通文本文件的持久化。

2. UserDefault.可以设置用户的偏好设置等一些少量的数据

3. 属性列表。

4. SQL数据库

API中的常用函数：

 // get value methods
 /**根据键值取出布尔值
 * Get bool value by key, if the key doesn't exist, will return false.
 * You can set the default value, or it is false.
 * @param key The key to get value.
 * @return Bool value by `key`.
 */
 bool getBoolForKey(const char* key);
 /**根据键值取出布尔值，如果键不存在，返回defaultValue
 * Get bool value by key, if the key doesn't exist, will return passed default value.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 */
 virtual bool getBoolForKey(const char* key, bool defaultValue);
 /**根据键值取出int类型的数据
 * Get integer value by key, if the key doesn't exist, will return 0.
 * You can set the default value, or it is 0.
 * @param key The key to get value.
 * @return Integer value of the key.
 */
 int getIntegerForKey(const char* key);
 /**根据键值取出int类型的数据，如果键不存在，返回defaultValue
 * Get bool value by key, if the key doesn't exist, will return passed default value.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 * @return Integer value of the key.
 */
 virtual int getIntegerForKey(const char* key, int defaultValue);
 /**根据键值取出float类型的数据
 * Get float value by key, if the key doesn't exist, will return 0.0.
 * @param key The key to get value.
 * @return Float value of the key.
 */
 float getFloatForKey(const char* key);
 /**根据键值取出float类型的数据，如果键不存在，返回defaultValue
 * Get float value by key, if the key doesn't exist, will return passed default value.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 * @return Float value of the key.
 */
 virtual float getFloatForKey(const char* key, float defaultValue);
 /**根据键值取出double类型的数据
 * Get double value by key, if the key doesn't exist, will return 0.0.
 * @param key The key to get value.
 * @return Double value of the key.
 */
 double getDoubleForKey(const char* key);
 /**根据键值取出double类型的数据，如果键不存在，返回defaultValue
 * Get double value by key, if the key doesn't exist, will return passed default value.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 * @return Double value of the key.
 */
 virtual double getDoubleForKey(const char* key, double defaultValue);
 /**根据键值取出string类型的数据
 * Get string value by key, if the key doesn't exist, will return an empty string.
 * @param key The key to get value.
 * @return String value of the key.
 */
 std::string getStringForKey(const char* key);
 /**根据键值取出string类型的数据，如果键不存在，返回defaultValue
 * Get string value by key, if the key doesn't exist, will return passed default value.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 * @return String value of the key.
 */
 virtual std::string getStringForKey(const char* key, const std::string & defaultValue);
 /**根据键值取出Data类型的数据
 * Get Data value by key, if the key doesn't exist, will return an empty Data.
 * @param key The key to get value.
 * @return Data value of the key.
 */
 Data getDataForKey(const char* key);
 /**根据键值取出Data类型的数据，如果键不存在，返回defaultValue
 * Get Data value by key, if the key doesn't exist, will return an empty Data.
 * @param key The key to get value.
 * @param defaultValue The default value to return if the key doesn't exist.
 * @return Data value of the key.
 */
 virtual Data getDataForKey(const char* key, const Data& defaultValue);
 // set value methods
 /**根据键写入布尔值
 * Set bool value by key.
 * @param key The key to set.
 * @param value A bool value to set to the key.
 */
 virtual void setBoolForKey(const char* key, bool value);
 /**根据键写入int类型数据
 * Set integer value by key.
 * @param key The key to set.
 * @param value A integer value to set to the key.
 */
 virtual void setIntegerForKey(const char* key, int value);
 /**根据键写入float类型数据
 * Set float value by key.
 * @param key The key to set.
 * @param value A float value to set to the key.
 */
 virtual void setFloatForKey(const char* key, float value);
 /**根据键写入double类型数据
 * Set double value by key.
 * @param key The key to set.
 * @param value A double value to set to the key.
 */
 virtual void setDoubleForKey(const char* key, double value);
 /**根据键写入String类型数据
 * Set string value by key.
 * @param key The key to set.
 * @param value A string value to set to the key.
 */
 virtual void setStringForKey(const char* key, const std::string & value);
 /**根据键写入Data类型数据
 * Set Data value by key.
 * @param key The key to set.
 * @param value A Data value to set to the key.
 */
 virtual void setDataForKey(const char* key, const Data& value);
 /**调用此函数会将我们所改变的数据保存在.xml文件中去。
 * You should invoke this function to save values set by setXXXForKey().
 */
 virtual void flush();
 /**
 * delete any value by key,
 * @param key The key to delete value.
 */
 virtual void deleteValueForKey(const char* key);
 /**
 * Returns the singleton.
 */
 static UserDefault* getInstance();
 /**
 *
 */
 static void destroyInstance();
 /**
 * You can inherit from platform dependent implementation of UserDefault, such as UserDefaultAndroid,
 * and use this function to set delegate, then UserDefault will invoke delegate's implementation.
 * For example, your store native data base or other format store.
 * If you don't want to system default implementation after setting delegate, you can just pass nullptr
 * to this function.
 * @warm It will delete previous delegate
 */
 static void setDelegate(UserDefault *delegate);
 /** @deprecated Use getInstace() instead.
 */
 CC_DEPRECATED_ATTRIBUTE static UserDefault* sharedUserDefault();
 /**@deprecated Use destroyInstance() instead.
 */
 CC_DEPRECATED_ATTRIBUTE static void purgeSharedUserDefault();
 /** All supported platforms other iOS & Android use xml file to save values. This function is return the file path of the xml path.
 */
 static const std::string& getXMLFilePath();
 /** All supported platforms other iOS & Android and CC_PLATFORM_WINRT use xml file to save values. This function checks whether the xml file exists or not.
 * @return True if the xml file exists, false if not.
 */
 static bool isXMLFileExist();

实例：

.h files 

#ifndef _USERDEFAULTTEST_SCENE_H_
#define _USERDEFAULTTEST_SCENE_H_
#include "cocos2d.h"
class userDefault : public cocos2d::Layer
{
private:
public:
        static cocos2d::Scene* createScene();
        virtual bool init();
        void testUserDefault(Ref* sendef);
        CREATE_FUNC(userDefault);
};

#endif // _USERDEFAULTTEST_SCENE_H_

.cpp files

#include "UserDefaultTest.h"

USING_NS_CC;

Scene* userDefault::createScene()
{
        auto scene = Scene::create();
        auto layer = userDefault::create();
        scene->addChild(layer);
        return scene;
}

bool userDefault::init()
{
        if (!Layer::init())
        {
               return false;
        }

        Size visibleSize = Director::getInstance()->getVisibleSize();
        Vec2 origin = Director::getInstance()->getVisibleOrigin();

        auto item = MenuItemFont::create("Test", CC_CALLBACK_1(userDefault::testUserDefault, this));
        auto menu = Menu::create(item, NULL);
        this->addChild(menu);

        return true;
}

void userDefault::testUserDefault(Ref* sendef)
{
        //set default value
        UserDefault::getInstance()->setStringForKey("String", "value1");
        UserDefault::getInstance()->setIntegerForKey("Integer", 100);
        UserDefault::getInstance()->setFloatForKey("Float", 5.326f);
        UserDefault::getInstance()->setDoubleForKey("Double", 3.1415967);
        UserDefault::getInstance()->setBoolForKey("Bool", false);

        //printf value
        std::string ret = UserDefault::getInstance()->getStringForKey("String");
        CCLOG("string is %s", ret.c_str());

        int intValue = UserDefault::getInstance()->getIntegerForKey("Integer");
        CCLOG("Integer value is %d", intValue);

        float floValue = UserDefault::getInstance()->getFloatForKey("Float");
        CCLOG("Float value is %f", floValue);

        double douValue = UserDefault::getInstance()->getDoubleForKey("Double");
        CCLOG("Double value is %f", douValue);

        bool boolValue = UserDefault::getInstance()->getBoolForKey("Bool");
        if (boolValue)
               CCLOG("bool value is true");
        else
               CCLOG("bool value is false");

        //CCUserDefault::getInstance()->flush();
        CCLOG("改变后的数据：");
        UserDefault::getInstance()->setStringForKey("String", "value2");
        UserDefault::getInstance()->setIntegerForKey("Integer", 10);
        UserDefault::getInstance()->setFloatForKey("Float", 15.326f);
        UserDefault::getInstance()->setDoubleForKey("Double", 2 * 3.1415967);
        UserDefault::getInstance()->setBoolForKey("Bool", true);

        UserDefault::getInstance()->flush();

        //after change value
        ret = UserDefault::getInstance()->getStringForKey("String");
        CCLOG("string is %s", ret.c_str());

        intValue = UserDefault::getInstance()->getIntegerForKey("Integer");
        CCLOG("Integer value is %d", intValue);

        floValue = UserDefault::getInstance()->getFloatForKey("Float");
        CCLOG("Float value is %f", floValue);

        douValue = UserDefault::getInstance()->getDoubleForKey("Double");
        CCLOG("Double value is %f", douValue);

        boolValue = UserDefault::getInstance()->getBoolForKey("Bool");
        if (boolValue)
               CCLOG("bool value is true");
        else
               CCLOG("bool value is false");
}