《json,命名规范》由会员分享，可在线阅读，更多相关《json,命名规范（10页珍藏版）》请在金锄头文库上搜索。
1、竭诚为您提供优质文档 /双击可除json,命名规范篇一：Restful接口规则(完整)Restful接口设计规范一、Restful 简介Rest 是“ Representationalstatetransfer ”的缩写， 可以翻译成“表现状态转换”，但是在绝大多数场合中我们 只说Rest或者Restful。为什么会起这么一个奇怪的名字呢？ 我们可以从上述这篇论文中找到答案。Fielding 在论文中将Rest定位为“分布式超媒体应用(distributedhypermediasystem )” 的架构风格，它在文中 提到一个名为“ hateoas(hypermediaastheengineo
2、fapplicationstate)” 的概念。我们利用一个面向最终用户的web应用来对这个概念进行简单阐述：这里所谓的应用状态( applicationstate )表 示web应用的客户端的状态，简单起见可以理解为会话状态。 资源在浏览器中以超媒体的形式呈现，通过点击超媒体中的 链接可以获取其它相关的资源或者对当前资源进行相应的 处理，获取的资源或者针对资源处理的响应同样以超媒体的第1页共16页形式再次呈现在浏览器上。由此可见，超媒体成为了驱动客 户端会话状态的转换的引擎。借助于超媒体这种特殊的资源呈现方式，应用状态的转换体现为浏览器中呈现资源的转换。如果将超媒体进一步抽象成一般意义上的资
3、源呈现(Representation )方式，那么应用状态变成了可被呈现的状态( Representationalstate )。应用状态之间的转换就成了可被呈现的状态装换(Representationalstatetransfer )，这就是 Rest。二、运管平台/烽行平台Restful接口标准1.接口命名规则ip :服务器ip地址端口： Restful端口号V2:版本号(2)接口名：命名规则：现有接口方法去第一个单词后，全小写命名，如：用户余额信息实时查询能力，原接口名：querybalanceRealsingle(stringmsisdn)Restful接口 :2. 参数规则参数提交方
4、式： application/www-form-urlencoded 参数命名：单词采取小写，复合词采取下划线分开的全小写命名。参数规贝批量查询需有page_size 以及page_num参数，避免一次性查询，部分参数需有默认值设定。附录：运管平台部分 api规则用户状态查询:status:0,message:ok,result: status: 00 短信失败记录历史查询：有list传递待定(+5. employee:+6. +7. firstname:john,+8astname:doe,+9. employeenumber:123,+10. title:accountant+11. +1
5、2. )13. );14. /现在我们可以使用 e这个对象了，还可以以点的 访问形式来访问对象的属性15. alert(e.employee.firstname);16. alert(e.employee.lastname);17. alert(e.employee.employeenumber);18. alert(e.employee.title);19.看完上述后我们来对比它们。xml与json 比对经过一番快速浏览后如何？感觉到没有json的设计上比xml更轻巧简洁？先前就说过了，正是它符合javascript语言对象本身特点，这使得如果服务器传来的文本是符合javascript语法定
6、义语句的字符串，那岂不是一条eval方法就能解析了？的确如此从上面两者的表示来看，json表示法在语法上要比 xml要简洁的多，由于不需要使用关闭标签来呼应开始标签，因此许多多余的信息不再出现了，相对xml而言基本上不存在数据冗余，这在传输与响应速度上大在提高了。另外，json不只是在表现形式上有如此的优势，最重要的是可以丢弃以前弄得我们晕头转向的dom解析了（客户端的javascript的 xmldom解析，月艮务器端的 dom sax、dom4j、jdom等）。json 与xml相比对 javascript 有着更好的通用性，一段json格式数据经过javascript 一个简单的方法（e
7、val）即可转换成javascript对象供程序调用，转换方法是浏览器的javascript内部定义好的无需再手工编写。而一段xml格式的数据需要调用浏览器内部的 xml解 析器工具进行解析后才可以使用。而对于不同内核的浏览器（如ie、netscape等）xml解析的方法是有差别的，因此需要针对不同浏览器内核做不同的方法封装，从而给客户端开发带来一定的复杂度。相比之下json被浏览器解析的速度更快。在服务器端不同的语言也有不同的json解析器，可以很方便的解析客户端传过来的字符串，而不像为了读取 xml还是借助于这样或那样的 api工具。json优缺点优点：乍看上去，使用json的数据分隔符的
8、优点可能并不那 么明显，但存在一个根本性的缘由：它们简化了数据访问。 使用这些数据分隔符时，javascript 引擎对数据结构（如字 符串、数组、对象）的内部表示恰好与这些符号相同。json的另一个优点是它的非冗长性。在xml中，打开和关闭标记是必需的， 这样才能满足标记的依从性；而在json中，所有这些要求只需通过一个简单的括号即可满足。在包 含有数以百计字段的数据交换中，传统的xml标记将会延长数据交换时间此外，json受到了擅长不同编程语言的开发人员的青睐。这是因为无论在haskell中或lisp中，还是在更为主流的 c#和java中，开发都可以方便地生成json。不足：和许多好东西都
9、具有两面性一样，json的非冗长性也不 例外，为此json丢失了 xml具有的一些特性。命名空间允 许不同上下文中的相同的信息段彼此混合，然而，显然在 json中已经找不到了命名空间。json与xml的另一个差别 是属性的差异，由于json采用冒号赋值，这将导致当 xml转化为json时，在标识符(xmlcdata )与实际属性值之间 很难区分谁应该被当作文本考虑。另外，json片段的创建和验证过程比一般的xml稍显复杂。从这一点来看，xml在开发工具方面领先于json。json 实践预备知识动态脚本函数eval()在进一步学习之前，我们有必要讲解一下eval方法的用法，懂的同学可以跳过。ev
10、al()函数可计算某个字符串，并执行其中的的 javascript代码。它接收一个参数s，如果s不是字符串，则直接返回s。否则执行s语句。如果s语句执行结果是一 个值，则直接返回此值，否则返回undefined。另外，该方法只接受原始字符串作为参数，如果string参数不是原始字符串，那么该方法将不作任何改变地返回。 因此请不要为eval()函数传递string 对象来作为参数：js代码1. varstr=newstring(alert(msg);2. /请不要传递string 对象，否则直接返回 string 对 象了3. alert(eval(str)=str);/true4.第#页共16
11、页4. /应该传递原始string字符串，这样才看作javascript脚本并执行5. eval(alert(msg);msg最后，需要特别注意的是对象声明语法“ ”并不能返回一个值，需要用括号括起来才会返回值(括号里的脚本是表达式，有返回值，而不是无返回值的逻辑式，因为大括号 里的脚本又可能是表达式，又可能是普通的逻辑表达，所以用小括号括起来后明确的说明是值表达式)：js代码1.varstr=;/花括号内没属性时2. alert(eval (+str+);3. alert(eval(str);4.4. str=name:jzj;弹出：objectobject弹出：undefined花括号内有
12、一个属性6. alert(typeofeval(+str+);弹出：object，以对象方式返回7. alert(eval(str);弹出：jzj8. alert(eval(+str+).name);/弹出：jzj9. alert(eval(str).name);弹出：undefined10.篇三：程序编码规范02.编码规范一、数据库5个基础字段命名类型长度tinyint2说明no.12345yn状态，默认值为-1创建时间修改时间createpinvarchar40 创建人createdatedatemodifydatedatemodifypinvarchar40 修改人主键id :使用int类型，长度为字段不要用特殊符号，因为要和model做关联二、model 层实体类需继承basedomain必须重写serialVersionuid切勿生成1l生成父类构造函数生成该类构造函数生成每个属性get方法与set方法!描述：活动详细内容model类zhangjingxuan20xx年9月22日上午9:21:22第#页共16页
