编码指导原则

一般说来,服务器行为代码应当紧凑、可靠。Web 应用程序开发人员对添加到他们页面中的代码非常敏感。请遵照广泛接受的文档类型语言(ColdFusion、ASP.NET、JavaScript、VBScript、PHP、Visual Basic 或 Java)的编码惯例。在编写注释时,请考虑可能需要理解代码的不同技术用户,如 Web 和交互程序的设计者或者其他 Web 应用程序开发人员。请包含正确描述代码目的的注释以及有关将其包含在页面内的任何特殊说明。

在创建服务器行为时,请牢记下列编码指导原则:

错误检查是一项重要的要求。服务器行为代码应当妥善处理错误情况。尝试预见所有可能性。例如,如果参数请求失败怎么办?如果查询没有返回记录怎么办?

唯一名称帮助确保代码清楚标识并且避免与现有代码的名称冲突。例如,如果页面包含一个名为 hideLayer() 的函数和名为 ERROR_STRING 的全局变量,而服务器行为插入的代码也使用了这两个名称,则该服务器行为可能与现有代码冲突。

代码前缀允许您在页面中标识您自己的运行时函数和全局变量。约定之一就是使用首字母大写。请不要使用 MM_ 前缀,因为它是仅为 Macromedia 使用而保留的。Macromedia 会在所有函数和全局变量之前添加前缀 MM_,以避免与您编写的代码冲突。

var MM_ERROR_STRING = "...";
function MM_hideLayer() {

避免相似的代码块以便您编写的代码不与其它代码块中的代码太相似。如果某代码块看起来与页面上的另一个代码块非常类似,"服务器行为"面板可能会错误地将第一个代码块标识为第二个代码块的实例(或反之)。一个简单的解决方法是给代码块添加注释,使它更具有唯一性。

相关主题




未找到评论

 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://www.ecnnl.com/doc/dreamweaver/8_cn/using/40_usi10.htm

 

E中荷|荷兰华人电子商务