代码规范and《数学之美》读后感（算法设计与分析作业1）

20211003238 2022-09-04 14:08:01

代码规范

摘取自阿里巴巴《Java开发手册》泰山版，方便个人日常查阅
阿里云原文件下载地址https://developer.aliyun.com/topic/download?spm=a2c6h.13878518.J_2835833880.1.6dc72077lTLdmj&id=12

强制要求

代码格式

如果是大括号内为空，则简洁地写成{}即可，大括号中间无需换行和空格；如果是非空代码块则：

1）左大括号前不换行。

2）左大括号后换行。

3）右大括号前换行。

4）右大括号后还有 else 等代码则不换行；表示终止的右大括号后必须换行。
左小括号和右边相邻字符之间不出现空格；右小括号和左边相邻字符之间也不出现空

格；而左大括号前需要加空格。反例：if ( a == b )
if/for/while/switch/do 等保留字与括号之间都必须加空格。
任何二目、三目运算符的左右两边都需要加一个空格。（运算符左右都加空格，独立出来）
采用 4 个空格缩进，要使用tab键要设置tab键为4个空格
注释的双斜线与注释内容之间有且仅有一个空格。
在进行类型强制转换时，右括号与强制转换值之间不需要任何空格隔开。如：int a = (int)b;
单行字符数限制不超过 120 个，超出需要换行，换行时遵循如下原则：

1）第二行相对第一行缩进 4 个空格，从第三行开始，不再继续缩进

2）运算符与下文一起换行。

3）方法调用的点符号与下文一起换行。

4）方法调用中的多个参数需要换行时，在逗号后进行换行，在括号前不要换行
方法参数在定义和传入时，多个参数逗号后边必须加空格。如：method(String num1, String num2);
IDE 的 text file encoding 设置为 UTF-8; IDE 中文件的换行符使用 Unix 格式，不要使用 Windows 格式。

命名风格

编程相关命名不得使用拼音和英文混合的方式，更不能直接以中文命名
编程相关命名的开始和结束不能以下划线（_）或美元符号（$）
编程相关命名一定要具体清楚，让人能够望文知义，避免缩写
类名使用 UpperCamelCase 风格，每个单词第一个字母都大写，但以下情形例外：DO / BO / DTO / VO / AO / PO / UID 等
方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格，第一个单词开头小写，其他单词大写
常量命名全部大写，单词间用下划线隔开（为了增强代码的可读性，具体代码中应少出现具体数字，一些常量，如具体数字应进行命名并且命名要表达具体且清楚）
抽象类命名使用 Abstract 或 Base 开头；异常类命名使用 Exception 结尾；测试类命名以它要测试的类的名称开始，以 Test 结尾
暴露出来的服务一定是接口，接口的内部类要用impl的后缀与接口区别
类型与中括号紧挨相连来表示数组，如String args[]
POJO 类中的任何布尔类型的变量，都不要加 is 前缀，否则部分框架解析会引起序列化错误。反例：Boolean isDeleted
包名统一使用小写，点分隔符之间有且仅有一个自然语义的英语单词。包名统一使用单数形式，但是类名如果有复数含义，类名可以使用复数形式
避免在子父类的成员变量之间、或者不同代码块的局部变量之间采用完全相同的命名，使可读性降低

语句要求

在一个 switch 块内，每个 case通过 continue/break/return 等来终止；在一个 switch 块内，都必须包含一个 default语句并且放在最后，即使它什么代码也没有
当 switch 括号内的变量类型为 String 并且此变量为外部参数时，必须先进行 null(String变量为空的情况)判断
在 if/else/for/while/do 语句中必须使用大括号

注释规范

类、类属性、类方法的注释必须使用 Javadoc 规范，使用/**内容*/格式，不得使用// xxx 方式
所有的抽象方法（包括接口中的方法）必须要用 Javadoc 注释、除了返回值、参数、异常说明外，还必须指出该方法做什么事情，实现什么功能
所有的类都必须添加创建者和创建日期

    /**
     * @author www
     * @date 2022/09/04
     */

方法内部单行注释，在被注释语句上方另起一行，使用//注释。方法内部多行注释使用/* */注释，注意与代码对齐
所有的枚举类型字段必须要有注释，说明每个数据项的用途

《数学之美》读后感

这本书一开始介绍了文字、数学和语言的历史，让我了解到了人们为了满足计数需求而提出的不同的计数规则，当然这之中有使用起来很简单的计数规则，也有使用起来困难的计数规则，有使用起来的计数规则，也有使用起来麻烦的计数规则，但这些数学规则都无一例外都在推动着数学的发展，因为数学的基础就是数字。而在数学发展的同时也有文字的发展，文字在语文中的作用就相当于数字在数学中的作用，与此同时语言也在不断发展，语言就是供给人们进行交流的方式，这之中就包括了不同字的读法。

而后这本书则介绍了数学在具体方面的运用，比如统计方面的运用。数学在种种方面的运用则体现了数学的重要性。其实数学真的在我们身边随处可见，消费方面关于花费的运算，日期变化，自己的体重变化等等。当然高难度的数学在日常生活中并见不到，但并不代表着它就没用了，因为它在其他方面存在着作用，比如航天数据的运算等等。正是这样的数学才会让我觉得它具有美感。

很多人觉得学习这么难的数学没什么用，只要会基本计算就行了，但我并不这么认为，他们会这么认为完全是因为他们没有感受到数学之美。每次遇到数学难题我都会绞尽脑汁去独立思考和不断运算以求得结果，就在这样的不断尝试之中我感受到了数学之美，数学之美就是体现在让人从中获得成就感，同时在这个过程中也让我养成了独立和不轻言放弃的精神，这么多好处在我看来就是数学之美，也只有认识到这些作用才能体会到数学之美，毕竟数学在很多人的眼中仅仅只是数字和运算公式罢了。但数学实则凝结了千百年来古人智慧的结晶，数学很难但有没有人不会数学，这或许就是数学之美吧。

读完这本书之后让我感受到了数学的奥妙，体会到了数学之美，千变万化的数字搭配上有限变化的数字造就了如此美丽的数学，从中我收获了成功解开难题的喜悦并养成了许多优秀的品质，相信未来也能够在接触数学的同时继续感受数学之美并从中收获颇丰，也希望我身边的人都能同我一样在这本书中感受到数学之美。

...全文