我的未来编码规范

.Net

命名规范

  1. 文件夹、实体命名统一使用英文定义,以大驼峰命名法。不宜过长可简拼,具有可读性。
  2. 变量命名使用英文定义,以小驼峰命名法。不宜过长可简拼,具有可读性。

Student

  1. 增删改查方法命名统一规范。

a)         各种查询

  1. GetXXXX/GetXXByXX 获取XXXX信息。 例如GetUserList 获取用户信息集合(多条)/GetUserByName、GetUserListByAge等。
  2. FindByXX 查找 定义通用的查找方法时候使用。 例如FindByOID 通过主键获取信息。
  3. QueryByXXXX 查询 定义通用查询方法时候可使用。例如QueryBySql、QueryByHql 通过sql或者hql 查询数据信息等。

b)        SaveXXXX 保存XXX 例如:SaveUserInfo 保存用户信息。

c)         XXXXAdd 例如:TreeNodeAdd 树添加。

d)        XXXXUpdate  XXXX修改 TreeNodeUpdate 树修改、BatchUpdate批量修改。

e)         XXXXDelete   XXXX删除  TreeNodeDelete 树删除。

注明:By 通过XXX处理信息。关键字在前和后的统一,是根据现有.Net框架中规范定义,如果Java觉得不适应,可改为统一在前或者统一在后。

  1. 接口名称定义 以I开头。
  2. 禁止出现以包含数字命名和汉字拼音或者汉字命名。

框架层之间命名

实体层:Domain

数据访问层:DAL

业务逻辑层:BLL

通用层:Common

注释应用

  1. // 单行注释
  2. /**/ 块注释
  3. ///说明注释,注释以后可以自动生成说明文档
  1. #region  折叠注释,可以将 代码折叠,

    只是#region 所在行后面的文字是注释文字,而其它的#region和#endregion之内的行代码是有效的,仅仅起折叠作用

    #endregion

Web前端编码规范

命名及代码规范

1、变量、属性、方法名:小驼峰命名,不宜过长可简拼,具有可读性。

2、常量、类名:大驼峰命名,不宜过长可简拼,具有可读性。

3、引号默认使用单引号。

4、html页面名,css页面名,Js页面名使用大驼峰命名法。

5、class类名,id名,小驼峰命名法。

6、图片命名:如果是作为背景图片bg_图片名,其他图片为img_图片名。

7、图片有透明效果的用png格式,其他最好用jpg格式

8、非特殊情况下样式文件引用必须写在<head>…</head>之间,JavaScript文件引用必须写在页面底部。

9、尽可能减少div嵌套, 如<div><div
class=”welcome”>欢迎访问XXX, 您的用户名是<div class=”name”>用户名</div></div></div>完全可以用以下代码替代:
< div><p>欢迎访问XXX, 您的用户名是<span>用户名</span></p></div>;

10、在页面中尽量避免使用style属性,即style=”…”;,即html与css相互独立

11、能以背景形式呈现的图片, 尽量写入css样式中; 写样式时,如果所修饰标签有父级,则写类名时,把父级带上,例如:

<div class=”newsDiv”>

<div class=”newsTitle”>

</div>

</div>

. newsDiv  . newsTitle{}

12、制作页面时,要考虑用户体验,如Table标签中的td字数超长的要加上title属性

 

<table><td id =”c” title = “备注”
></td></table>

注释应用

块注释:

/* 代码块说明文字

* Create by Name 2017.01.03

* Edit by Name 2017.01.03

* 参数1:参数说明

* 参数2:参数说明

* return:返回值说明

*/

单行注释:

//注释说明文字

要求

  1. 在extframe 菜单中配置html权限的时候 路径必须小写。
  2. 所有页面a标签的url路径必须小写。
  3. 每一个页面的js,css,html 名称要一致。
  4. 后台方法必须要写明XML注释,GET方法需要写清楚每个参数的含义,POST方法需要将对象属性写清楚如“{OID:””,NAME:””,USER:{“OID”:””}}”
  5. 页面引用的路径都需要以”/Areas”层级为头。如:

“<a href=”/areas/zzicec/web/index.html”>”

  1. 6.        功能实现后要测试IE9,谷歌浏览器,火狐浏览器,360浏览器极速模式下的兼容性。
  2. Form表单验证输入框错误提示的时候一定要focus();光标定位,验证信息使用Bootstrap的Toolip显示。要求数据表单验证的一致性。
时间: 2024-12-24 03:10:31

我的未来编码规范的相关文章

web项目开发 之 前端规范 --- JavaScript编码规范

JavaScript编码规范 此文严格按照W3C规范和部分实际项目可读性,浏览器加载,性能等众多属性权衡,做出平时前端编码规范文档.供广大web工作者参考并实施,对维护和项目扩展升级都能省时省力. 场景:web前端开发中 一些Javascript的注意事项 和 规格建议: [参考百度资料 和个人一些总结] 1 前言 JavaScript 在百度一直有着广泛的应用,特别是在浏览器端的行为管理.本文档的目标是使 JavaScript 代码风格保持一致,容易被理解和被维护. 虽然本文档是针对 Java

PHP 高级程序设计(1) - 编码规范及文档编写

PHP 高级程序设计学习笔记20140612 软件开发中的一个重要环节就是文档编写.他可以帮助未来的程序维护人员和使用者理解你在开发时的思路.也便于日后重新查看代码时不至于无从下手.文档还有一个重要的作用,在不用了解要访问对象的细节情况下也能很好的在对象之间进行交互.文档的编写有一些成熟的行业标准格式,遵守这些行业标准将有助于创建易于阅读的代表,并使自动生成手册成为可能. 编码规范 编码规范可能很多开发人员都有各自的观点也意见,且大家不尽相同.其实只要团队成员之间达成一致,遵循同一个标准就好.

学习一份百度的JavaScript编码规范

JavaScript编码规范 1 前言 2 代码风格 2.1 文件 2.2 结构 2.2.1 缩进 2.2.2 空格 2.2.3 换行 2.2.4 语句 2.3 命名 2.4 注释 2.4.1 单行注释 2.4.2 多行注释 2.4.3 文档化注释 2.4.4 类型定义 2.4.5 文件注释 2.4.6 命名空间注释 2.4.7 类注释 2.4.8 函数/方法注释 2.4.9 事件注释 2.4.10 常量注释 2.4.11 复杂类型注释 2.4.12 AMD 模块注释 2.4.13 细节注释 3

最全面的 Android 编码规范指南

最全面的 Android 编码规范指南 本文word文档下载地址:http://pan.baidu.com/s/1bXT75O 1. 前言 这份文档参考了 Google Java 编程风格规范和 Google 官方 Android 编码风格规范.该文档仅供参考,只要形成一个统一的风格,见量知其意就可. 1.1 术语说明 在本文档中,除非另有说明: 术语 class 可表示一个普通类,枚举类,接口或是annotation类型(@interface) 术语 comment 只用来指代实现的注释(im

Java Script 编码规范

Java Script 编码规范 以下文档大多来自: Google JavaScript 编码规范指南 Idiomatic 风格 参考规范 ECMAScript 5.1 注解版 EcmaScript 语言规范, 5.1 版 基本原则: 无论有多少人在维护,所有在代码仓库中的代码理应看起来像同一个人写的. 前言 下面的章节描述的是一个 合理 的现代 JavaScript 开发风格指南,并非硬性规定.其想送出的核心理念是高度统一的代码风格(the law of code style consiste

【转】Python——编码规范

来自于 啄木鸟社区 Python Coding Rule --- hoxide 初译 dreamingk 校对发布 040724 --- xyb 重新排版 040915 --- ZoomQuiet MoinMoin 美化 050610 用Python进行开发时的编码风格约定 原文:PEP 008 <Style Guide for Python Code> 下载(中文pdf): PythonCodingRule.pdf 进一步的: Google Python Style Guide Python

编码规范&amp;读《数学之美》有感

编码规范 & 读<数学之美>感想 l  编码规范 一.排版 1.关键词和操作符之间加适当的空格. 2.相对独立的程序块与块之间加空行 3.较长的语句.表达式等要分成多行书写. 4.划分出的新行要进行适应的缩进,使排版整齐,语句可读. 5.长表达式要在低优先级操作符处划分新行,操作符放在新行之首. 6.循环.判断等语句中若有较长的表达式或语句,则要进行适应的划分. 7.若函数或过程中的参数较长,则要进行适当的划分. 8.不允许把多个短语句写在一行中,即一行只写一条语句. 9.函数或过程的

java编码规范

右括号") "与其后面的关键字之间,关键字与其后面的左括号"("或"{"之间,以及"}"与"{"之间,要以一个空格隔开:除". "外,所有二元操作符的前.后要加空格:在逗号后边加一个空格. 说明: 一个紧跟着括号的关键词应该被空格分开: 空白应该位于参数列表中逗号的后面: 所有的二元运算符,除了".",应该使用空格将之与操作数分开.一元操作符和操作数之间不应该加空格,

我也学php:编码规范/翻译自PSR

PHP社区百花齐放,拥有大量的函数库.框架和组件.PHP开发者通常会在自己的项目中使用若干个外部库,因而PHP代码遵循或尽量接近同一个代码风格就非常重要,可以让开发者方便地把多个代码库集成在自己的项目中. 框架互操作组(即PHP标准组)发布了一系列代码风格推荐标准,即PSR-0,PSR-1,PSR-2和PSR-3. 不要让这些名称所混淆,这些推荐仅是一些被其它项目所遵循的规则,如Drupal, Zend, Symfony, CakePHP, phpBB, AWS SDK, FuelPHP, Li