代码规范性 阿里开发手册
所有注释全都要将前面的@Param 参数 补上。 // 注释内容,注意在//和注释内容之间有一个空格
return 值也都要写上
常使用 ctrl+alt+o
ctrl+alt+m 修改为ctrl+s 比较方便
代码注释:idea设置这边要加上
/**
* @author : jhao
*/
controller层:
该层不做逻辑处理,只要两行代码
如果是查询 page 或者list就行
返回的jsonResult实体类要有具体的泛型 如果不知道写Object
service 层:
该层要做代码注释 ,方法名和controller层代码方法名可以相同,返回值可以做成jsonResult这种,然后controller层直接调接口后,直接返回就行。可以不做@Service 注解
impl 层:
该层 可以不做注释,如果做了注释就要保证和service 层的注释保持一致,如果不一致不如不做
这边的逻辑判断一定要注意对上送的参数做验证啊 !!!!!
特别是新增,修改的时候。
mapper:
该层代码需要特别注意如果是按id查直接写getById() 返回的一定是单个类型
如果查询的是list集合这种的,可以直接写listxxx()
pojo 分为dto,vo, entity ,query
其中 :entity实例是根据数据库的表字段信息构成,是直接影响到数据库的数据
query 实体是封装上送的参数,比如上送的参数实在太多,可以用query封装起来,封装过程中需要特别注意 是否可以为null ,如果不能为null 则需要添加@NotNull
controller层中参数用到了这个query 则需要加@Valid
mapper.xml层中,如果是xx包xxvo,那么返回的resultMap则是xxResultMap
1、entity里的每一个字段,与数据库相对应,
2、dto里的每一个字段,是和你前台页面相对应,
3、VO,这是用来转换从entity到dto,或者从dto到entity的中间的东西。