java编码规范和格式的要求,java编码规范有哪些?

以下是我整理的Java 编码标准。编写代码时,应遵循编码标准,以方便日常维护。

命名约定

类命名约定

类中每个单词的首字母必须大写(UserService、错误命名userService、userservice等)

测试用例以Test 结尾,例如UserServiceTest

如果术语缩写以缩写开头,则必须大写,例如HTMLEditor 拼写错误。

类名应包含英文字母或数字,不应包含特殊字符。

界面不以I 开头

方法命名约定

第一个单词的首字母小写,其他单词的首字母大写。

方法名称应该告诉您该方法的作用。

编码标准

代码缩进

该代码缩进一个制表符(四个空格)。 Eclipse 的默认长度是4 个空格。

范围

类内的属性必须设置为私有,外部类可以通过提供get 和set 方法来修改私有属性。

如果类中的方法仅供类内部使用,则应将其设置为私有。如果是public方法,如果可以被子类使用就应该设置为public。

注释规范

版权信息注释

版权信息注释在文件的开头,以声明代码的版权。使用/**/等注释。

/*

* 版权所有 2015 TIAMAES Inc. 保留所有权利。

*/

包com.tiamaes.gjds.das.controller;

评论模板为:窗口-首选项-Java-代码样式-注释-文件

/*

* 版权所有 ${year} TIAMAES Inc. 保留所有权利。

*/

版权所有 2015 TIAMAES Inc. 保留所有权利。

版权所有2015 天麦科技有限公司保留所有权利。

– 有限公司根据公司法设立的股份公司。

– 有限公司

类注解规范

类注释信息必须包括类描述信息、作者信息和版本信息。

/**

* 类描述

*@作者王成宇

* @1.0 或更高版本

*参见@xxx

*/

公共类类型名称

评论模板为:窗口-首选项-Java-代码样式-注释-类型

/**

* ${待办事项}

*@作者王成宇

* @1.0 或更高版本

*/

类描述:直接用一行描述该类的功能。如果您需要多行,请使用它。

@author:多个作者使用多个@author

@since:表示这个类是从哪个版本开始的

@see:与该类相关的其他类或方法

请参阅org.springframework.stereotype.Controller 的类注释信息。

/**

* 表示带注释的类是“控制器”(例如,Web 控制器)。

*

* 此注释作为{@link Component @Component} 的特化。

* 允许通过类路径扫描自动发现实现类。

* 这通常与带注释的处理程序方法结合使用。

* {@link org.springframework.web.bind.annotation.RequestMapping}注释。

*

* @作者Arjen Poutsma

* @作者尤尔根·霍勒

* @2.5 或更高版本

* @seeComponent

*参见@org.springframework.web.bind.annotation.RequestMapping

*参见@org.springframework.context.annotation.ClassPathBeanDefinitionScanner

*/

方法注释

请使用下面的模板

/**

* ${待办事项}

* ${标签}

*/

${tags}:自动生成参数、异常、返回值等注解。

/**

*去做

* @参数请求

* @抛出IOException

*/

@RequestMapping(\\\’/ctx\\\’)public void test(HttpServletRequest request) 抛出IOException

如果类中的方法实现了抽象方法或重写了父类中的方法,则必须在该方法上添加@Override注解。如果想重写父类方法上的注解,可以使用/** */注解来重写父类方法上的注解。

org.springframework.core.io.Resource

/**

* 返回该资源的文件句柄。

* 如果资源不能被解析为绝对资源,则抛出IOException

* 如果文件路径(即资源)在文件系统中不可用

*/

文件getFile() 抛出IOException。

在实现的方法中使用/**.*/来覆盖父类方法的注解。

org.springframework.core.io.AbstractResource

/**

* 此实现抛出FileNotFoundException,如下所示:

* 资源无法解析为绝对文件路径。

*/

@Overridepublic File getFile() 抛出IOException {

throw new FileNotFoundException(getDescription() + \\\’ 无法解析为绝对文件路径\\\’);

}

对属性、变量和方法中的代码进行注释

使用//注释变量和属性。另外,在方法内的代码中使用//注释。

如果不需要变量和属性,则不能添加注释。如果你的代码中有负责任的逻辑,你应该使用//注释来解释它。

public ServletContextResource(ServletContext servletContext, String path) { //检查ServletContext

Assert.notNull(servletContext, \\\’无法在没有ServletContext 的情况下解析ServletContextResource\\\’); this.servletContext=servletContext;

Assert.notNull(path, \\\’路径为必填项\\\’);

String pathToUse=StringUtils.cleanPath(path);

if (!pathToUse.startsWith(\\\’/\\\’))

{

使用路径=\\\’/\\\’ + 使用路径;

}

this.path=使用路径;

}

以上是我整理的一些Java编码标准。如果在以后的开发中严格遵循编码规则,日常维护会更加容易。

本文和图片来自网络,不代表火豚游戏立场,如若侵权请联系我们删除:https://www.huotun.com/game/669737.html

(0)
上一篇 2024年6月4日
下一篇 2024年6月4日

相关推荐

  • 头条号如何赚钱? 运营头条号如何赚钱?

    头条号如何赚钱? 今日头条赚钱方式如下 1、头条广告分成 你发表的作品获得平台广告,一万人读1-3元左右,开通原创的收益就更多了,一万人读10元左右。但是这个单价不是固定的,会有变动。 2、头条开通小店 具备相应经营资格的个人和企业可以申请开店,通过后可以自主销售商品获利,也可以流通商品获得佣金。 3、头条赞赏功能 优秀的用户可以打开赞扬功能。就像微信公众号…

    游戏快讯 1小时前
  • 和平精英没上王牌怎么有王牌印?

    和平精英没上王牌怎么有王牌印? 1 可能存在系统bug或者是数据同步延迟的情况。2 王牌印是根据一定的规则和算法计算的,可能在你还没有上王牌之前,你的战斗表现已经达到了王牌的标准,因此会出现王牌印。3 如果你确实没有上过王牌,但是出现了王牌印,可以联系游戏客服进行反馈,他们会帮助你解决问题。 和平精英怎么卡王牌印记? 关于这个问题,和平精英中,要卡王牌印记,…

    游戏快讯 2小时前
  • 和平精英限时活动怎么换皮肤?

    和平精英限时活动怎么换皮肤? 和平精英的重启未来活动只需要凑到60个时空碎片就可以在兑换商店里面兑换。 和平精英绿洲活动怎么领皮肤? 关于这个问题,要领取和平精英绿洲活动的皮肤,首先要参加活动并完成相关任务。具体操作如下: 1. 进入和平精英游戏,点击左下角的“活动”按钮。 2. 找到绿洲活动,并点击进入。 3. 完成活动任务,比如完成指定局数的游戏、分享活…

    游戏快讯 3小时前
  • 和平精英怎么闪枪? 和平精英怎么摇头闪枪?

    和平精英怎么闪枪? 通过在移动的过程中快速切换武器,达到闪枪的效果和平精英游戏中,是可以通过快速转换不同的武器来达成闪枪,即在使用枪械的过程中,很多玩家会在开枪射击时快速地更换到别的武器,比如手榴弹或冲锋枪等换完后,再切换回枪械,以达到秒杀敌人的效果这个操作需要玩家有良好的游戏经验和反应速度此外还可以结合游戏中的技能使用闪枪,游戏中有些角色的技能会提供加速、…

    游戏快讯 5小时前
  • 在和平精英里面买的皮肤从哪里找?

    在和平精英里面买的皮肤从哪里找? 查找方法是: 一首先登陆我们的游戏大区,在游戏的主页面找到右下角的军备的选项进入 二然后在这里我们可以看到有个军备库点击进入 三、最后玩家们就可以在此处查看自己的装备皮肤了 和平精英里面怎么抽皮肤? 点击军需再点击抽奖,有十连抽和单抽 和平精英里的和平人生怎么领皮肤? 和平精英里的和平人生没有办法免费领皮肤,但是可以自己买 …

    游戏快讯 8小时前