`

Java源代码的折行规则(编码规范)

阅读更多
一些企业在招聘程序员的时候,总会特意提出一个要求,即“要求具有良好的编码规范”。确实现在程序开发人员已经不在是单枪匹马的单干,而是讲究团体作战。此时就要求团队内的乘员都可能够恪守代码的编写规范,这对于乘员之间共享代码、排错等作业都具有非常现实的意义。这在Java语言中当然也不例外。笔者借这次机会,就跟大家分享一下Java源代码的折行规则。虽然这基本不涉及到功能层面的内容,但是对于提高代码的阅读性却有不可替代的作用。

    一、代码的最大长度。

    虽然在Java的编译器中对于代码的最大长度没有硬性的规定。但是如果代码的长度太长,超过了编译器的最当行宽,显然阅读起来比较麻烦。为此根据笔者的经验,通常情况下Java源代码的行长度不应该大于80个字符。如果超过这个长度的话,在一些开发工具和编辑器上就无法很好的显示。如需要通过滚动条来显示后面部分的代码。当其他项目成员阅读这超长的代码时,就会看得眼花缭乱。当人的温饱问题解决了之后,就需要开始注意美观方面的问题。所以程序开发人员在开发应用程序的时候,要尽量避免书写长的代码。如果代码的每行长度确实需要超过80个字符的话(最好将每行代码的长度控制在70个字符左右),那么就需要对代码进行分行。

    二、在恰当的地方对代码进行分行。

    笔者建议将Java源代码每行的长度控制在70个字符、最大不超过80个字符。当超过这个字符长度的时候,开发人员就需要考虑在恰当的地方对他们进行分行处理。不过这个分行也不是说开发人员想在哪里进行分行就在哪里进行分行。这个分行是有一定技巧的。虽然这些技巧大部分并不是强制性的规定,但是都是一些专家们的经验总结,可以提高代码的阅读性。为此笔者希望各位程序开发能够严格的遵守。

    技巧一:高层折行优于低层折行。

    这个技巧是说,在考虑对代码进行折行处理的时候,需要注意代码的层次性。如某段代码涉及到混合四则运算,而四则运算又有明显的运算顺序,此时对代码进行折行时就最好能够在四则运算的关键顺序上进行折行处理。如现在有如下的一段代码:

    Mynum=mynum1*(mynum1+mynue2+mynum3-mynum4)+8*mynum5

    如果要对这段代码进行折行的话,该在哪个地方加入一个折行符号呢?如果是笔者处理的话,笔者会按如下的格式对代码进行折行处理。

    Mynum=mynum1*(mynum1+mynue2+mynum3-mynum4)

    +8*mynum5

    这主要是根据四则运算的运算层次来进行折行的。显然,*符号的优先级要比+符号要高。所以在+号前面对其进行折行处理,那么就可以一目了然的反应出代码的运算层次。可以大幅度的提高代码的阅读性。所以代码折行的第一个技巧就是高层折行优于低层折行。如此的话,可以使得应用程序的结构代码更加的清晰,更容易被团队成员所理解。

    技巧二:在运算符前面进行折行处理。

    其实在如上的折行技巧中,还隐藏着一个规则,即在运算符之前进行折行。如上例所示,笔者就是在+号前面进行折行,而不是在+号后面进行折行处理。这主要也是考虑到代码的可读性。如上面这个例子中,如果在+号后面进行折行处理的话,则下一行就会给人一种凭空多出来的感觉,显得代码很不连贯。跟这个规则类似,如果在折行处理的时候遇到逗号时,那么最好能够在逗号后面进行折行。如在一个方法中,需要传入5个参数。此时如果代码行比较长,那么就需要在几个参数之间进行折行处理。此时最理想的折行位置,就是在某个参数的逗号后面。注意,使在逗号后面进行折行,而不是在逗号前面。因为一个参数一个逗号是匹对的。而如果一个逗号加一个参数,则让人看起来很不舒服。

    技巧三:这行代码的对起方式。

    当不得已对代码进行折行处理时,下一行的代码应该与其同等级的代码行左对齐。如上例所示,在+号前面将某一段四则运算公式进行折行处理的时候,其+号符号已经采取缩进处理。其缩进后的效果就是要与其同等级的代码行左对齐。如此的话,明眼人一看就知道这段代码采取过折行处理;而且跟上一行代码的层次关系。当一段代码被分割成三行甚至跟更多行数的时候,这个规则会非常的有用。如果能够严格遵守这个规则,即使将代码分割成多行,看起来也不会觉得那么混乱。反而给人一种比较有层次的感觉。

    另外在采取缩进处理的时候,可以利用Tab键来提高缩进处理的效率。因为直接按空格的话,有可能空格字符数量不一致,会让人觉得层次不起,产生比较大的混乱。一般情况下,当代码行两侧距离页边的距离比较大,看其来不怎么舒服时,可以在代码行中通过插入TAB键(会在代码行中连续插入8个字符)来提高代码的阅读性,让代码的缩进实现统一。

    技巧四:为变量寻找一个合适的位置。

    在编写应用程序时,尽量将变量声明放置在一个代码块的开始处,也就是说{}花括号的开始位置。虽然说可以在需要使用变量的时候再对其进行声明。但是笔者不同义如此操作。因为如果在的呢感到使用变量的时候再来声明变量时,会降低代码的可读性。同理,也需要避免低层声明与高层声明重复,这样会引起代码混乱并可能引发程序功能性错误。而且这种错误在后续的排错中很难被发现。为此要在应用程序开发的时候就要尽量避免这种错误。

    在声明变量的时候,有时候可能代码很简单,生命变量的行总共加起来也不会超过十个字符。此时能否把多个变量的声明写在同一行呢?从就技术上来说,这是可行的。也就是说,Java编译器允许将多个变量定义在同一行上。但是从阅读性上来说,这并不是很好的做法。笔者的建议是,即使变量定义再简单,或者变量比较多,也最好分行进行变量的声明。也就是说,一行声明一个变量。这可以提高代码的可阅读性。而且有时候往往需要对变量加一个注释说明变量的用途,如果以行定义一个变量,添加行注释也相对简单许多。

    总之,以上的这些折行的规则基本上不会影响到代码的运行。但是,对于代码的维护与后续的排错、升级、二次开发等等具有不可忽视的作用。而且现在基本上应用程序开发式团队开发,故大家都遵守同样的代码编写规范是非常重要的。笔者在开发一个应用程序的时候,事先都会花一定的时间,跟项目成员强调这些折行的规则。目的只有一个,就是提高代码的可读性,便于后续代码的共享与维护。毕竟后续面对这些代码的,并不是客户,而是我们自己。我们程序员在编写代码的时候,不能够搬起石头砸自己的脚。笔者认为,现在一个合格的程序人员,不仅技术功底上要过得硬,而且还必须要遵守这些“无形规则”的约束。难怪现在这么多企业在挑选程序开发人员的时候,都会注明“良好的编码规范”。现在对于这些无形中的条条框框,项目经理已经开始重视起来。
分享到:
评论

相关推荐

    Java源代码编码规范-

    【Java源代码编码规范】 Java源代码编码规范是软件开发中的重要组成部分,它旨在提高代码的可读性、可维护性和一致性。规范的遵循能够帮助开发者更快地理解代码,减少错误,增强代码的健壮性。以下是规范的一些关键...

    华为JAVA编码规范.pdf

    华为JAVA编码规范.pdf是华为公司编写的JAVA编程语言编码规范,旨在提供一个统一的编程风格和代码组织方式,以提高代码的可读性、维护性和可重用性。该规范涵盖了编程语言的基本结构、命名规则、代码组织、注释、编程...

    Java源代码审查规范

    ### Java源代码审查规范知识点详解 #### 一、目的与范围 **目的:** - 统一编码习惯:确保所有开发人员遵循相同的编码规范,提高程序的质量和一致性。 - 提高可读性与可维护性:使代码更容易理解和维护,减少后期...

    JAVA编码规范试题

    以下是从给定的文件信息中提炼出的关键知识点,涵盖了JAVA编码规范的基本原则、文件管理、代码格式、变量命名规则、以及代码注释等方面。 ### 一、JAVA编码规范的重要性 JAVA编码规范的目的在于统一代码的编码风格...

    实验7 Java源代码分析程序

    【Java源代码分析程序】 Java源代码分析程序是一种用于理解、检查或操作Java源代码的工具,它通常涉及语法解析、语义分析以及代码质量检查等步骤。在本实验中,我们将探讨Java初级阶段如何创建一个简单的源代码分析...

    Java 编码规范 chm

    6. **代码组织**:遵循一定的目录结构,如src/main/java存放源代码,src/test/java存放测试代码。使用import语句引入所需的类,避免使用星号通配符导入。避免过多的全局变量,鼓励使用局部变量和方法参数。 7. **...

    编码规范 注释规范 代码风格 JAVA

    1. **编码规范**:编码规范是一组规则,规定了如何有效地编写源代码。它包括变量命名、函数命名、类结构、异常处理等方面。例如,JAVA编程规范通常建议使用驼峰命名法(CamelCase)为类和接口命名,使用下划线分隔符...

    JAVA源代码规范.doc

    这份名为"JAVA源代码规范.doc"的文档详细阐述了编写高效、可靠Java代码的规则、约定和指导原则。以下是这份规范的一些核心要点: 1. **版本更新管理**: - 文档的创建、维护和批准过程有明确的责任人,且有详细的...

    Java编码规范word文档

    Java编码规范是编程实践中的一项重要准则,它有助于提高代码的可读性、可维护性和团队间的协作效率。以下是对标题和描述中所述知识点的详细解释: 1. **命名规范** - **标识符规则**:标识符由ASCII字母、数字和...

    Java标准编码规范

    Java标准编码规范是Java开发中不可或缺的一部分,它旨在提高代码的可读性、可维护性和团队协作效率。本文将深入探讨这些规范,并提供一些实践建议。 1. **前言** - Java编码规范的制定是为了统一开发人员的编程...

    java小游戏连连看源代码

    10. **软件工程实践**:源代码组织清晰,注释充足,遵循一定的编码规范,这些都是优秀的软件工程实践。通过阅读源代码,我们可以学习到如何编写更易读、易维护的代码。 通过对Java连连看源代码的学习,不仅可以掌握...

    java编码规范.pdf

    ### Java编码规范详解 ...以上内容总结了Java编码规范的关键要点,涵盖了文件命名、组织结构、代码格式、命名规则以及编程实践等多个方面。遵循这些规范可以帮助开发团队编写出高质量、可维护的Java代码。

    公司使用的java编码规范

    - 文件后缀:所有Java源代码文件应以`.java`作为文件后缀。 - 通用的文件名:文件名应与其中定义的公共类名相同,且采用驼峰式命名法。例如,如果有一个公共类名为`MyClassName`,则文件名应为`MyClassName.java`...

    java画图工具的源代码

    - 遵循Java编码规范,如变量名、方法名的命名规则,以及适当的空格和缩进。 在分析压缩包中的`MyPaint_Code`文件时,我们可以逐行检查代码,理解每个类和方法的功能,查看如何实现上述的各个步骤。通过这种方式,...

    JAVA上百实例源码以及开源项目源代码

    Java源代码实现部分,比较有意思,也具参考性。像坐标控制、旋转矩阵、定时器、生成图像、数据初始化、矩阵乘法、坐标旋转、判断是否是顺时针方向排列、鼠标按下、放开时的动作等,都可在本源码中得以体现。 Java...

    JAVA编码规范

    总体而言,东软集团股份有限公司的JAVA编码规范通过制定一系列明确的编码规则和约定,为Java开发人员提供了一套完整的编程指南。这不仅有助于提高代码的规范性和可读性,也确保了代码质量,为团队协作和项目维护打下...

    Java编码规范(详细)

    - **范围**:这些规范适用于所有的Java源代码文件,包括类、接口、方法、变量等。 - **定义,首字母缩写词和缩略语**:在文档中,可能会使用特定的术语或缩写,需确保对它们有清晰的解释,以便于理解。 - **参考...

    java2实用教程,java编码规范及书中配套程序代码

    首先,Java编码规范是每个Java开发者必须遵循的指导原则,它包括了命名规则、注释标准、代码布局、错误处理等方面。例如,类名应使用驼峰式命名,变量名应具有描述性,常量名全大写且单词间用下划线分隔。此外,良好...

Global site tag (gtag.js) - Google Analytics