[重新认识cocos2dx---工具篇] 一 cocos命令行之语言包MultiLanguage

多语言对于游戏程序的设计来说是很必要的，很意外的是在cocos命令行项目中也发现了这个，就试着分析一下，不喜勿喷。

主体程序是/bin/目录下的MultiLanguage.py和string.json

一 . 用法

#设置语言类型，本例中时'en','zh','zh_tr' 对应英语，简体，台湾
MultiLanguage.set_language('zh')
#获取相应的字符串
MultiLanguage.get_string('COCOS_PARSE_PLUGIN_WARNING_FMT', classname)

二.  分析

首先应该区分在python中的 类方法和 实例方法（详情链接）

第一个初始化的方法是不能少的，读取语言的配置信息

    def __init__(self):
        # 获取配置文件的路径
        cfg_file_path = os.path.join(get_current_path(), MultiLanguage.CONFIG_FILE_NAME)

        try:
            # 获取语言和编码方式
            sys_lang, self.encoding = locale.getdefaultlocale()
        except:
            sys_lang = None
            self.encoding = None
            pass

        if self.encoding is None:
            self.encoding = 'utf-8'

        if sys_lang is None:
            cur_lang_key = MultiLanguage.DEFAULT_LANGUAGE
        else:
            cur_lang_key = self.get_lang_key(sys_lang)

        # 读取json文档
        if os.path.isfile(cfg_file_path):
            f = open(cfg_file_path)
            self.cfg_info = json.load(f, encoding='utf-8')
            f.close()

            if self.cfg_info.has_key(cur_lang_key):
                self.cur_lang_strings = self.cfg_info[cur_lang_key]
            else:
                self.cur_lang_strings = None

            if self.cfg_info.has_key(MultiLanguage.DEFAULT_LANGUAGE):
                self.default_lang_strings = self.cfg_info[MultiLanguage.DEFAULT_LANGUAGE]
            else:
                self.default_lang_strings = None
        else:
            self.cfg_info = None
            self.cur_lang_strings = None
            self.default_lang_strings = None
	

	def get_current_path():
		if getattr(sys, 'frozen', None):
			# 获取安装目录
			ret = os.path.realpath(os.path.dirname(sys.executable))
		else:
			# 获取当前文件的目录
			ret = os.path.realpath(os.path.dirname(__file__))

		return ret		
			
		
	def get_lang_key(self, sys_lang):
		# 将系统的语言编号变为自定义的编号 
		sys_lang_info = sys_lang.split('_')
		lang = sys_lang_info[0]
		lang = lang.lower()
		region = None
		if len(sys_lang_info) > 1:
			region = sys_lang_info[1]
			region = region.lower()

		if lang == 'zh':
			if (region is None) or (region == 'cn'):
				ret = lang
			else:
				ret = 'zh_tr'
		else:
			ret = lang

		return ret	

第二个 set_language

@classmethod
def set_language(cls, lang):
	'''
		挺常用的设计思路 单体类，调用实例方法设置当前的语言
	'''
	cls.get_instance().set_current_language(lang)		

@classmethod
def get_instance(cls):
	if cls.instance is None:
		cls.instance = MultiLanguage()

	return cls.instance
	
def set_current_language(self, lang):
	if (self.cfg_info is not None) and (self.cfg_info.has_key(lang)):
		self.cur_lang_strings = self.cfg_info[lang]
	else:
		cocos.Logging.warning(MultiLanguage.get_string('COCOS_WARNING_LANG_NOT_SUPPORT_FMT', lang))

第三个： get_string()

    @classmethod
    def get_string(cls, key, fmt_value=None):
        '''
            获取指定key的字符，或是返回默认值
        '''
        fmt = cls.get_instance().get_current_string(key)

        if fmt_value is None:
            ret = fmt
        else:
         # 拼凑字段 eg: ("%s,%s") %("name","nID") == "name,nID"           
            if isinstance(fmt_value, tuple):
                dst_values = []
                for value in fmt_value:
                    # 转换编码方式
                    if isinstance(value, unicode):
                        dst_values.append(value.encode(cls.get_instance().get_encoding()))
                    else:
                        dst_values.append(value)
                ret = fmt % tuple(dst_values)
            elif isinstance(fmt_value, unicode):
                ret = fmt % fmt_value.encode(cls.get_instance().get_encoding())
            else:
                ret = fmt % fmt_value

        return ret

    def get_current_string(self, key):
        if self.has_key(key, self.cur_lang_strings):
            # 查询到含有所需的字段
            ret = self.cur_lang_strings[key]
        elif self.has_key(key, self.default_lang_strings):
            # 查询到默认表中含有所需的字段
            ret = self.default_lang_strings[key]
        else:
            ret= key
        # 转换编码方式
        if isinstance(ret, unicode):
            ret = ret.encode(self.encoding)

        return ret

    def has_key(self, key, strings_info):
        ret = False
        if strings_info is not None and strings_info.has_key(key):
            ret = True

        return ret

三.  总结

该类的核心方法MultiLanguage.get_string().设计思路也是多语言实现的可行方法之一，值得借鉴。另外类中对编码的转换值得注意

有些方法还是值得借鉴的：

#判读表中是否含有键值key
def has_key(self, key, strings_info):
	ret = False
	if strings_info is not None and strings_info.has_key(key):
		ret = True

	return ret	
	
# 转换编码方式
if isinstance(ret, unicode):
	ret = ret.encode(self.encoding)

# 获取当前文件的目录	
def get_current_path():
    if getattr(sys, 'frozen', None):
        # 获取安装目录
        ret = os.path.realpath(os.path.dirname(sys.executable))
    else:
        # 获取当前文件的目录
        ret = os.path.realpath(os.path.dirname(__file__))

    return ret	
	
# 获取语言和编码方式	
try:
	sys_lang, self.encoding = locale.getdefaultlocale()
except:
	sys_lang = None
	self.encoding = None
	pass

回见
end