欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

一篇文章带你入门Java之编程规范

程序员文章站 2022-03-10 20:57:32
目录java注释引言♀ 小ad:小明哥,之前你教我的helloworld实例我写完了,超级简单呢,我一下子就搞定了♂ 明世隐:是吗,那不错哦。♀ 小ad:我还举一反三、*发挥了一波♂ 明世隐:这波怎...

引言

♀ 小ad:小明哥,之前你教我的helloworld实例我写完了,超级简单呢,我一下子就搞定了
♂ 明世隐:是吗,那不错哦。
♀ 小ad:我还举一反三、*发挥了一波
♂ 明世隐:这波怎么说?
♀ 小ad:怎么说?我说我在第5层,你信不
♂ 明世隐:我信,你举的什么、反的什么?
♀ 小ad:我写了个小鲁班连招类,可以顺序释放连招,好玩。
♂ 明世隐:挖槽,你这波是要在大气层吗?上头了吧你。
♀ 小ad:明哥别这样说,我就觉得好玩
♂ 明世隐:好,我觉得你脑子转的挺快,来给明哥看看。
♀ 小ad:好的,代码给你看看

package learnjava;
public class 鲁班连招类 {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");system.out.println("平a1");system.out.println("平a2");
system.out.println("平a3");system.out.println("平a4");
			system.out.println("释放1技能");
			system.out.println("平a1");system.out.println("平a2");system.out.println("平a3");system.out.println("平a4");
system.out.println("释放2技能");system.out.println("平a1");system.out.println("平a2");
			system.out.println("平a3");system.out.println("平a4");
			system.out.println("敌人已经被消灭");}}

运行代码

一篇文章带你入门Java之编程规范

♀ 小ad:明哥,咋样?我这连招,ko敌人,刺客突脸我可以把2技能先放
♂ 明世隐:很(yao)好(lao)耶(ming)
♀ 小ad:那可不!我觉得我可以统治下路了。
♂ 明世隐:你的为啥放技能后要平a4下。
♀ 小ad:因为这个平a 4下我用来代表的是小鲁班的被动扫射效果,表示攻击速度很快。
♂ 明世隐:嗯嗯,真不错,有编程的天赋,看来我选对了徒弟哈,但是,还是让我来说说你的问题。
♀ 小ad:???
♂ 明世隐:我说让我来说说你的问题。
♀ 小ad:有什么问题,我这连招不好吗?你上次教我的,你是不是藏了什么?
♂ 明世隐:你耗子未汁吧你!
♀ 小ad:明哥,直接说吧,别这样
♂ 明世隐:我说你代码写的乱七八糟。
♀ 小ad:没问题啊,你看我不是运行给你看了吗?结果犀利
♂ 明世隐:确实犀利,我说的是代码很乱。
♀ 小ad:我不懂你的意思
♂ 明世隐:就是不规范。
♀ 小ad:哦,我不知道哦,那你给我讲讲呗
♂ 明世隐:来,下次写这样的代码,别在朋友圈发说你认识我,我老脸往哪里放。
♀ 小ad:(大写的尴尬)
一篇文章带你入门Java之编程规范

命名规则

类名首字母应该大写。字段、方法以及对象(句柄)的首字母应小写。对于所有标识符,其中包含的所有单词都应紧靠在一起,而且大写中间单词的首字母。例如:

thisisaclassname

thisismethodorfieldname

命名规则必须遵循以下规则:

1)、名称只能由字母、数字、下划线、$符号组成

2)、命名时不能以数字开头

3)、在命名是绝对不能出现java关键字。

4)、见名识意—看到名字就知道是什么。

当然这些都不是硬性规定,你可以按照自己的想法去命名。但那样的代码可读性很差。

public class 鲁班连招类 {

♀ 小ad:你是说我这个类的命名不满足上面的第一条是吗
♂ 明世隐:可以这么说。
♀ 小ad:那eclipse为什么没有报错。
♂ 明世隐:其实是可以用中文命名的,类名和方法名用中文其实也是可以成功运行的,因为只要是unicode字符,就符合规范,不过这里的规范指的是标识符规范,代码规范是不提倡用中文的。
♀ 小ad:这样啊,那我把类名改成lz
♂ 明世隐:你这是什么意思?
♀ 小ad:lz就是连招的意思啊
♂ 明世隐:可是我看不懂诶!
♀ 小ad:那改lianzhao
♂ 明世隐:类开头用大写,然后采用驼峰命名。
♀ 小ad:那改成lianzhao就可以撒
♂ 明世隐:你为什么不用英文来命名,用拼音感觉不舒服。
♀ 小ad:那连招的英语是什么?
♂ 明世隐:你问我干嘛?我不会
♀ 小ad:哈哈,明哥你都不会啊,我也不会。
♂ 明世隐:那说好了,就这样命名了,嘿嘿。

代码排版

1.程序块要采用缩进风格编写,缩进的空格数为4个。

2.在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。

3.较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。

4.if, for, do, while, case, switch, default 等语句自占一行,且if, for, do, while等语句的执行语句无论多少都要加括号{}。

5.相对独立的程序块之间、变量说明之后必须加空行。

6.出现分号尽量换行。

♀ 小ad:哥,那么多那么麻烦,我都看不明白.
♂ 明世隐:其实也不用刻意去记,我帮你把代码编辑一下你就很容易看明白。
♀ 小ad:好

针对你的代码分4步

1.代码缩进对齐

一篇文章带你入门Java之编程规范

修改后:

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");system.out.println("平a1");system.out.println("平a2");
		system.out.println("平a3");system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");system.out.println("平a2");system.out.println("平a3");system.out.println("平a4");
		system.out.println("释放2技能");system.out.println("平a1");system.out.println("平a2");
		system.out.println("平a3");system.out.println("平a4");
		system.out.println("敌人已经被消灭");}}

2.遇到分号换行

一篇文章带你入门Java之编程规范

修改后:

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放2技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");}}

3.大括号、括号等成对出现

一篇文章带你入门Java之编程规范

修改后:

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放2技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

4.加上注释

♀ 小ad:明哥什么是注释啊
♂ 明世隐:注释就是说明
♀ 小ad:说明什么?
♂ 明世隐:说明这个类是用来做什么的,这个方法是什么功能等。
♀ 小ad:好像明白了一点
♂ 明世隐:给你举个例子,你就完全清楚了。

一篇文章带你入门Java之编程规范

一篇文章带你入门Java之编程规范

一篇文章带你入门Java之编程规范

♂ 明世隐:上面的图知道什么意思吧
♀ 小ad:当然啊,就是技能说明呗
♂ 明世隐:对啊 ,那你如果不熟悉技能的话,你不是可以看看这个技能干啥用的,有多少伤害、冷却时间多少、蓝耗多少吗?
♀ 小ad:是的,没有这个说明,除非对这个英雄比较熟悉,否则就不知道了。
♂ 明世隐:那你拿到一段代码的时候,如果没有说明,你可能搞不清楚这个代码是干嘛的吧。
♀ 小ad:嗯,但现在这个代码我知道 啊
♂ 明世隐:目前你当然是知道的,因为第一这个代码简单,容易看明白,如果逻辑复杂的呢?第二记忆都是一段时间的,如果过些时候你再看到某段代码,你也想不起来是干嘛的了,必须一行行的去看代码,然后你才能知道,这样不就很麻烦了吗?
♀ 小ad:好像是这个道理。
♂ 明世隐:所以说就跟这个技能描述一样的,我们也可以改代码加上说明,称之为注释。
♀ 小ad:原来是这个意思啊,那注释应该怎么加?
♂ 明世隐:那我们来加一下吧。

java注释

注释的作用

很多java新手在敲代码的时候都不会在意注释这个东西,但其实,注释在java编程中也是必不可少的。

在学习过程中,我们应该也发现要敲的代码越来越多,越来越繁琐,而且做编程本来就很需要思维逻辑,在碰到需要使用大量代码的时候,就需要在每个关键点做好注释,让我们明白这段代码的含义,同时,如果要请教别人的话,别人看你的代码更加方便。

而在以后的工作当中,肯定会有团队协作的,这种时候,也是非常需要注释的,不然在后期合并的时候是会非常麻烦的。

注释的3种类型

1.单行注释
//内容1
//内容2

2.多行注释
/*
内容1
内容2
*/

3.文档注释
/**
*内容1
*内容2
*/

给代码加上单行注释

public class lianzhao {
	//主函数
	public static void main(string[] args) {
		system.out.println("发现敌人");
		//释放3技能
		system.out.println("释放3技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放1技能
		system.out.println("释放1技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放2技能
		system.out.println("释放2技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

♀ 小ad:明哥,有句话我想说但不敢说?
♂ 明世隐:说吧,不喷你
♀ 小ad:我感觉你这个注释没什么用,你不加注释,我也知道这个写的是放技能、平a啊,你现在加这个注释也是多余的。
♂ 明世隐:。。。,是这样的,因为你这个代码是最基础的,就一句打印输出,并且输出的内容也写的很清楚,所以你感觉没必要,但在开发中,代码的逻辑就复杂的多,你不加注释别人可能就看不明白你 代码、或者说要花额外的时间去理解你的代码;甚至于你自己再次回过头来看的时候,没有注释,都要重新去阅读代码,才知道是干嘛的。
♀ 小ad:哦,这样啊,那我明白了

给代码加上多行注释

一篇文章带你入门Java之编程规范

给代码加上文档注释

一篇文章带你入门Java之编程规范

注释后完整的类代码

package learnjava;
/**
 * 模拟鲁班连招的类
 * @author 小ad
 * @date 2021-07-04
 */
public class lianzhao {
	/*
	 * 主函数
	 * 此函数模拟了鲁班的连招
	 * 3技能+扫射+1技能+扫射+2技能+扫射
	 */
	public static void main(string[] args) {
		system.out.println("发现敌人");
		//释放3技能
		system.out.println("释放3技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放1技能
		system.out.println("释放1技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放2技能
		system.out.println("释放2技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

♂ 明世隐:你看代码是不是比你开始的要好看、工整的多。
♀ 小ad:哇明哥,这样别人看到代码就知道是我写的呀。
♂ 明世隐:对啊 ,就知道你的大名了。
♀ 小ad:哇注释果然很有用。
♂ 明世隐:别光知道可以写上你的大名哈,其他的也很重要。
♀ 小ad:不会不会,我一下就明白怎么用这个注释了,谢谢明哥!

除了上述内容还要注意:如何编写良好的java代码

♀ 小ad:哇明哥,我觉得我好像学java很简单呢
♂ 明世隐:对啊,java本来就不难,关键看你自己愿意学不咯。
♀ 小ad:我当然愿意学,我就感觉跟明哥上分一样简单,紧紧跟着明哥就行。
♂ 明世隐:知道就好,要的就是上分如喝水、学java如张飞吃豆芽。
♀ 小ad:哥你说的什么?也不押韵啊。
♂ 明世隐:你重点是在这吗你?快打开游戏,先上几星再说,你连招不是很溜吗。
♀ 小ad:来,当然了,我边学java又边学连招,今天整爆他们。

总结

本篇文章就到这里了,希望能给你带来帮助,也希望您能够多多关注的更多内容!