HLJJFT 101-2017标准规范下载简介
HLJJFT 101-2017 应用软件开发编码规范（黑龙江省交通运输信息化建设项目标准规范）7.3【强制】异常跟踪方面，应对重要代码或关键步骤进行异常捕获，系统捕获到相应的内容后应将异 常信息写入异常日志，异常日志信息包括异常位置、异常内容、异常原因三个方面。 异常位置信息、异常内容信息和异常原因信息的内容如下： a）异常位置信息应包括：时间（精确到毫秒）、文件名、出现异常的代码位置（精确到行数）、 出现异常的方法或接口名称等：
应用软件开发编码规范
b）异常内容信息应对异常类型、异常影响程度、异常描还进行说明； c）异常原因信息应对导致异常发生的方法或接口的参数进行说明，以便于还原异常发生现场，同 时应提出该异常的解决方案或故障恢复方案。 d）应定义异常信息代码表GB／T 51347-2019 农村生活污水处理工程技术标准（完整正版扫描），便于快速定位及解决异常。
8.3【强制】URL外部重定向传入的目标地址必须执行白名单过滤。
应用软件开发编码规范
A. 1 JAVA 格式
应用软件开发编码规范
JAVA开发编码规范
1.1程序块要采用缩进风格编写，缩进的空格数为4个。对于由开发工具自动生成的代码可以不一致。 1.2分界符（如大括号“{”和"}”）应各独占一行并且位于同一列，同时与引用它们的语句左对齐。 在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用 如上的缩进方式，
应用软件开发编码规范
LogFilenamethat=n
1.5if，for，do，while，case，switch，default等语句自占一行，且if，for，do，while等语句的 执行语句无论多少都要加括号价。
1.6相对独立的程序块之间、变
LogWriter writer lint index:
应用软件开发编码规范
2.1源程序有效注释量必须在20%左右。说明：注释的原则是有助于对程序的阅读理解，注释不宜太多 也不能太少，注释语言必须准确、易懂、简洁。 2.2包的注释内容：简述本包的作用、详细描述本包的内容、产品模块名称和版本、公司版权。说明： 在详细描述中应该说明这个包的作用以及在整个项目中的位置。 2.3文件注释：文件注释写入文件头部，包名之前的位置。说明：注意以/*开始避免被JavaDoc收 集。文件注释内容：版权说明、描述信息、生成日期、修改历史。 2.4类和接口的注释：该注释放在package关键字之后，class或者interface关键字之前。说明 方便JavaDoc收集。
应用软件开发编码规范
8公有和保护方法注释内容：列出方法的一句话功能简述、功能详细描述、输入参数、输出参娄 值、违例等。
例: /** *《一句话功能简述） *《功能详细描述》 *【参数]] [参数1说明] *【参数2] [参数2说明] *【返回类型说明] *【违例类型］【违例说明］ *【类、类#方法、类#成员］ */ 2.9对于方法内部用throw语句抛出的异常，必须在方法的注释中标明，对于所调用的其他方法所抛出 的异常，选择主要的在注释中说明。对于非RuntimeException，即throws子句声明会抛出的异常， 必须在方法的注释中标明。 2.10注释应与其描述的代码相近，对代码的注释应放在其上方或右方（对单条语句的注释）相邻位置， 不可放在下面，如放于上方则需与其上面的代码用空行隔开。 2.11注释与所描述内容进行同样的缩排。说明：可使程序排版整齐，并方便注释的阅读与理解。 例: public void example() //注释 CodeBlock One 飞江 //注释 CodeBlock Two 2.12将注释与其上面的代码用空行隔开。 例： //注释 program code one //注释 program code two 2.13对变量的定义和分支语句（条件分支、循环语句等）必须编写注释。说明：这些语句往往是程序 实现某一特定功能的关键，对于维护人员来说，良好的注释帮助更好的理解程序，有时甚至优于看设计 文档。 2.14对于switch语句下的case语句，如果因为特殊情况需要处理完一个case后进入下一个case处 理，必须在该case语句处理完、下一个case语句前加上明确的注释。说明：这样比较清楚程序编写者
实现某一特定功能的关键，对于维护人员来说，良好的注释帮助更好的理解程序，有时甚至优于看设计 文档。 2.14对于switch语句下的case语句，如果因为特殊情况需要处理完一个case后进入下一个case处 理，必须在该case语句处理完、下一个case语句前加上明确的注释。说明：这样比较清楚程序编写者 的意图，有效防止无故遗漏break语句
应用软件开发编码规范
2.15边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。不再有用的注释 要删除。 2.16注释的内容要清楚、明了，含义准确，防止注释二义性。说明：错误的注释不但无益反而有害。 2.17避免在注释中使用缩写，特别是不常用缩写。说明：在使用缩写时或之前，应对缩写进行必要的 说明。
3.1包名采用域后缀倒置的加上自定义的包名，采用小写学母。在部门内部应该规划好包名的范围，防 止产生冲突。部门内部产品使用部门的名称加上模块名称。产品线的产品使用产品的名称加上模块的名 称。
应用软件开发编码规范
5属性名使用意义完整的英文描述：第一个单词的学母使用小写、剩余单词首学母天写其余学母 大小写混合法。属性名不能与方法名相同
数据类不能包含数据处理的逻辑。 通信类不能包含显示处理的逻辑
数据类不能包含数据处理的逻辑。
应用软件开发编码规范
4所有的数据类必须重载toString（方法，返回该类有意义的内容。说明：父类如果实现了比 的 toString ，子类可以继承不必再重写。
6异常捕获后，如果不对该异常进行处理，则应该纪录日志或者ex.printStackTraceO。说明 特殊原因必须用注释加以说明，
应用软件开发编码规范
4.7自己抛出的异常必须要填写详细的描述信息。说明：便于问题定位。 4.8运行期异常使用RuntimeException的子类来表示，不用在可能抛出异常的方法声明上加throws子 句。非运行期异常是从Exception继承而来，必须在方法声明上加throws子句。说明：非运行期异常 是由外界运行环境决定异常抛出条件的异常，例如文件操作，可能受权限、磁盘空间大小的影响而失败， 这种异常是程序本身无法避免的，需要调用者明确考虑该异常出现时该如何处理方法，因此非运行期异 常必须有throws子句标出，不标出或者调用者不捕获该类型异常都会导致编译失败，从而防止程序员 本身疏忽。运行期异常是程序在运行过程中本身考虑不周导致的异常，例如传入错误的参数等。抛出运 行期异常的目的是防止异常扩散，导致定位困难。因此在做异常体系设计时要根据错误的性质合理选择 自定义异常的继承关系。还有一种异常是Error继承而来的，这种异常由虚拟机自己维护，表示发生 了致命错误，程序无法继续运行例如内存不足。我们自已的程序不应该捕获这种异常，并且也不应该创 建该种类型的异常。 4.9在程序中使用异常处理还是使用错误返回码处理，根据是否有利于程序结构来确定，并且异常和错 误码不应该混合使用，推荐使用异常。说明：一个系统或者模块应该统一规划异常类型和返回码的含义。 但是不能用异常来做一般流程处理的方式，不要过多地使用异常，异常的处理效率比条件分支低，而且 异常的跳转流程难以预测。 4.10注意运算符的优先级，并用括号明确表达式的操作顺序，避免使用默认优先级。说明：防止阅读 程序时产生误解，防止因默认的优先级与设计思想不符而导致程序出错。 4.11避免使用不易理解的数字，用有意义的标识来替代。涉及物理状态或者含有物理意义的常量，不 应直接使用数字，必须用有意义的静态变量来代替
应用软件开发编码规范
12数组声明的时候使用int[」index，而不要使用intindex[」。说明：使用intindex[ 程序的可读性较差
例： 如下程序可读性差： public int getIndexO[] 如下程序可读性好： public int[J getIndex 13调试代码的时候，不要使用System.out和System.err进行打印，应该使用一个包含统一开关 测试类进行统一打印。说明：代码发布的时候可以统一关闭调试代码，定位问题的时候又可以打开开 14用调测开关来切换软件的DEBUG版和正式版，而不要同时存在正式版本和DEBUG版本的不同源文 ，以减少维护的难度。
应用软件开发编码规范
行库（CLR）支持区分大小写和不区分大小写的语言
1.3标识符的大小写规则
1.4首字母缩写词的大小写规则
首字母缩写词是由术语或短语中各单词的首字母构成的单词。例如，HTML是HypertextMarkup Language 的首字母缩写。只有在公众广为认知和理解的情况下，才应在标识符中使用首字母缩写词。 首字母缩写词不同于缩写词，因为缩写词是一个单词的缩写。例如，ID是identifier的缩写。通常情 况下，库名不应使用缩写词。 首字母缩写词的大小写取决于首字母缩写词的长度。所有首字母缩写词应至少包含两个字符。为了 便于这些准则的实施，如果某一首字母缩写词恰好包含两个字符，则将其视为短型首字母缩写词。包含 三个或三个以上字符的首字母缩写词为长型首字母缩写词。 下列准则为短型和长型首字母缩写词指定了正确的大小写规则。标识符大小写规则优先于首字母缩 写词大小写规则。 a）两字符首字母缩写词的两个字符都要大写，但当首字母缩写词作为大小写混合格式的标识符的 首个单词时例外。例如，名为DBRate的属性是一个采用Pascal大小写格式的标识符，它使用 短型首字母缩写词(DB)作为首个单词。又如，名为ioChannel的参数是一个采用大小写混合格 式的标识符，它使用短型首字母缩写词（10）作为首个单词。
应用软件开发编码规范
b）包含三个或三个以上字符的首字母缩写词只有第一个字符大写，但当首字母缩写词作为大小写 混合格式的标识符的首个单词时例外。例如，名为XmlWriter的类是一个采用Pascal大小写 格式的标识符，它使用长型首字母缩写词作为首个单词。又如，名为htmlReader的参数是 个采用大小写混合格式的标识符，它使用长型首字母缩写词作为首个单词。 C 如果任何首字母缩写词位于采用大小写混合格式的标识符开头，则无论该首字母缩写词的长度 如何，都不大写其中的任何字符。例如，名为xmlStream的参数是一个采用大小写混合格式的 标识符，它使用长型首字母缩写词（xml)作为首个单词。又如，名为dbServerName的参数是 个采用大小写混合格式的标识符，它使用短型首字母缩写词（db）作为首个单词。
1.5首字母缩写词的大小写规则
不要将所谓的紧凑格式复合词中的每个单词都大写。这种复合词是指写作一个单词的复合词，如 “endpoint"。 例如，hashtable是一个紧凑格式的复合词，应将其视为一个单词并相应地确定大小写。如果采用 Pascal大小写格式，则该复合词为Hashtable：如果采用大小写混合格式，则该复合词为hashtable。 若要确定某个单词是否是紧格式的复合词，请查阅最新的词典 下表列出了不是紧凑格式复合词的一些常用术语。术语先以Pascal大小写格式显示，后面的括号 容 中的是其大小写混合格式。 a) BitFlag (bitFlag) b) FileName(fileName) c) Logoff(1logoff) d) LogOn(1ogOn) e) SignIn (signIn) f) SignOut (signOut) g) UserName (userName) h WhiteSpace (whiteSpace)
通用命名约定讨论的是如何为库元素选择最适当的名称。这些准则适用于所有标识符。后面各节讨 论特定元素（如命名空间或属性）的命名。 a) 可读性比简洁性更重要。属性名称CanScrollHorizontally比ScrollableX（指X轴，但意 义不明确）更好。 b) 不要使用下划线、连学符或任何其他非字母数字学符。 c) 不要使用匈牙利表示法。匈牙利表示法是在标识符中使用一个前缀对参数的某些元数据进行编 码，如标识符的数据类型。 d)i 避免使用与常用编程语言的关键字冲突的标识符。虽然符合CLS的语言必须提供将关键字用
应用软件开发编码规范
作普通字的方法，最佳做法不要求强制开发人员了解如何实现。 对于大多数编程语言，语言参 考文档都会提供语言所使用的关键字列表。
1.7程序集和DLL的名称
例如，System.Net.Sockets命名 间包含的类型允许开发人员使用套接字通过网络进行通信。命名空间名称的一般格式如下：
1.9类、结构和接口的名称
通常，类型名称应该是名词短语，其中名词是由类型表示的实体。例如，Button、Stack和Fi 有名称，用于标识由类型表示的实体。从开发人员的角度选择标识实体的名称：名称应反映使用场
应用软件开发编码规范
应用软件开发编码规范
不要在标志枚举的名称中添加Flags作为后缀。 对枚举使用单数名称，除非枚举值是位域。 w）对使用位域值的枚举（也称为标志枚举）使用复数名称。
1.10类型成员的名称
选择适当的参数名称可极大改善库的可用性。适当的参数名称应指示该参数会影响的数据或功能 a）对参数名称使用Camel大小写。 b）使用描述性参数名称。在大多数情况下，参数名称及其类型应足以确定参数的用法
应用软件开发编码规范
a）在资源键中使用Pascal大小写格式。 b) 提供描述性标识符，而不要提供短标识符。尽量保持标识符的简洁性，但不要牺牲可读性。 c) 不要使用公共语言运行库（CLR）编程语言中特定于语言的关键字 d) 在命名资源中只能使用字母数字字符和下划线。 e) 使用点分隔符（“.”）以清晰的层次结构表示标识符。 f) 对异常消息资源使用下面的命名约定。资源标识符应由异常类型名称加上异常的短标识符构成 二者之间以点分隔。例如，ArgumentException。 g）BadEnumValue符合此准则
应用软件开发编码规范
b）cref属性可以附加到任意标记，以提供对代码元素的参考。文档生成器必须验证此代码元素 是否存在。如果验证失败，文档生成器将发出警告。查找在cref属性中描述的名称时，文档 生成器必须根据源代码中出现的using语句来考虑命名空间的可见性。 C
文档生成器必须接受和处理任何根据XML规则有效的标记。下列标记提供了用户文档中常用 （当然，也可能有其他标记。）
应用软件开发编码规范
应用软件开发编码规范
vaScript开发编码规范
GB／T 12085.1-2022 光学和光子学 环境试验方法 第1部分：术语、试验范围.pdfC.2 script布局
应用软件开发编码规范
应用软件开发编码规范
应用软件开发编码规范
函数名应该以一个小写学母开头T／CCMA0063-2018 盾构机操作、使用规范.pdf，紧接着的第二个单词的第一个学母大写，函数的名学必须对 行为进行描述并以一个动词开头。 JavaScript简单的把函数分为以下几种类型：
应用软件开发编码规范