谁说API必须用英文?中文API的Java库可以有!
是不是看惯了文档里的英文接口(API),也在 IDE 里看惯了自动补全里的英文接口?
现今的绝大多数 API 的确是英文命名没错,但绝非不能或者不应该实现和发布中文 API 的库。
这里用一个简单的汉字简繁转换库为例。在命名上,API 的方法名、参数名以及类名都用了中文。下面是 Eclipse 中的 Javadoc 弹窗:
中文 API 的 Java 库,实现汉字的简繁转换。演示在 Eclipse 中的 JavaDoc。
这个 Java 库已经发布到了 Maven 仓库,可以和其他英文 Java 库一样方便地调用。在 GitHub 上搜索"com.github.nobodxbodon"就可以看到不少 pom.xml 文件中依赖了这个库。
现在国内自研的 API 面向的主要用户群应该也是国内开发者。即便仍保留英文 API ,如果能另外提供一套中文的,必然更易于学习和使用,也可以吸引更多使用者。即使是额外维护一套中文 API,工作量也很有限,相比起为最终用户带来的益处,可说是相当值得的。
另外,这个库的实现代码中的标识符也都用了中文命名。原因很简单,这个库的使用者和潜在合作开发者应该都会中文。下面是其中的一段主要代码:
测试代码也都使用了中文命名。其中还引用了另一个中文 API 的库,而且那个库的功能非常通用,多半你的 Java 项目也用得到哦。
项目源码和库使用方法在:https://github.com/program-in-chinese/zhconverter
更多中文编程推广过程内情,请关注“用中文编程”微信公众号。

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
中文编程: 已经十多年了! 你知道Python3可以用中文命名变量吗?
Python3本身支持中文命名类/方法/变量 任何额外的库和工具都不需要, 不需要, 不需要! 重要的话三遍. Python3本身就可以正确运行下面的代码: 补一句, 不光是Python3支持中文命名哦, 以后一个一个语言讲过来, 九成九你用的编程语言也支持. 下面是一个Python实用小程序的代码片段: Python3为什么支持非ASCII码命名标识符 Python2并不支持非ASCII码标识符. 于2008年12月发布的Python3开始支持. 2008年! 也就是十多年前, 现在还不知道的话, 你就OUT大了. 创建于2007年5月的Python增强提案PEP 3131 -- Supporting Non-ASCII Identifiers阐述了支持非ASCII码命名标识符的缘由. Rationale (依据) 一节开篇明义, 指出很多Python开发者并不熟悉英语, 更希望用母语对类/方法进行命名, 而不是用经常有误的英文翻译. 对使用同样母语的开发者来说, 用母语命名的标识符可以提高代码清晰度和可维护性. Python code is written by many peop...
- 下一篇
python web框架漫谈
说到Web Framework,Ruby的世界Rails一统江湖,而Python则是一个百花齐放的世界,各种micro-framework、framework不可胜数,不完全列表见: http://wiki.python.org/moin/WebFrameworks 虽然另一大脚本语言PHP也有不少框架,但远没有Python这么夸张,也正是因为Python Web Framework(Python Web开发框架,以下简称Python框架)太多,所以在Python社区总有关于Python框架孰优孰劣的话题,讨论的时间跨度甚至长达3-5年。 Python这么多框架,能挨个玩个遍的人不多,坦白的说我也只用过其中的三个开发过项目,另外一些稍微接触过,所以这里只能浅谈一下,欢迎懂行的朋友们补充。 1. Django Python框架虽然说是百花齐放
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- CentOS6,7,8上安装Nginx,支持https2.0的开启
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- CentOS7设置SWAP分区,小内存服务器的救世主
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
- CentOS8编译安装MySQL8.0.19
- Hadoop3单机部署,实现最简伪集群
- SpringBoot2整合Redis,开启缓存,提高访问速度
- SpringBoot2初体验,简单认识spring boot2并且搭建基础工程
- Eclipse初始化配置,告别卡顿、闪退、编译时间过长
- CentOS7安装Docker,走上虚拟化容器引擎之路