1 概述
在写代码的时候,有两类bean:一类是专门承载数据而无业务逻辑的bean,如DTO;另外一类是业务模型bean,其既要承载数据也要提供业务逻辑,在DDD中它们就对应于领域模型对象和值对象。这些bean里面可能要提供getter、setter、equals、hashCode、toString,甚至构造方法,这些代码写起来比较无聊,基本都是根据字段来的,属于非常机械化而无技术含量的操作,而这些操作还相当多,增加一个字段或者改一个字段也得响应地进行调整,耗时耗力的。即使定义相关规范,强制要写这些方法,也很容易遗忘掉。遗忘掉toString()方法还会导致打印到日志里的对象没有详细信息,对定位问题毫无帮助。
为了解决这个问题,像IDEA这类IDE,都提供了生成方法的手段,帮助快速生成。但更快的方法就是连生成都不需要,只有个注解就解决问题,这正是Lombok提供的方法。
2 Lombok的使用
2.1 引入依赖
在pom.xml中引入lombok包的依赖:
<properties>
<lombok.version>1.18.30</lombok.version>
</properties>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>${lombok.version}</version>
<scope>provided</scope>
</dependency>
2.2 使用Lombok的注解
加上注解@Data
import lombok.Data;
@Data
public class Member {
private Long groupId;
private String name;
private Integer age;
private GroupMemberGender gender;
}
Lombok会帮助生成:
public class Member {
private Long groupId;
private String name;
private Integer age;
private GroupMemberGender gender;
// 生成getter/setter
public Long getGroupId() {
return this.groupId;
}
public void setGroupId(Long groupId) {
this.groupId = groupId;
}
public String getName() {
return this.name;
}
public Integer getAge() {
return this.age;
}
public void setName(String name) {
this.name = name;
}
public void setAge(Integer age) {
this.age = age;
}
public GroupMemberGender getGender() {
return this.gender;
}
public void setGender(GroupMemberGender gender) {
this.gender = gender;
}
// 生成equals()方法
public boolean equals(Object o) {
if (o == this) return true;
if (!(o instanceof Member)) return false;
Member other = (Member) o;
if (!other.canEqual(this)) return false;
Object this$groupId = getGroupId(), other$groupId = other.getGroupId();
if ((this$groupId == null) ? (other$groupId != null) : !this$groupId.equals(other$groupId)) return false;
Object this$name = getName(), other$name = other.getName();
if ((this$name == null) ? (other$name != null) : !this$name.equals(other$name)) return false;
Object this$age = getAge(), other$age = other.getAge();
if ((this$age == null) ? (other$age != null) : !this$age.equals(other$age)) return false;
Object this$gender = getGender(), other$gender = other.getGender();
return !((this$gender == null) ? (other$gender != null) : !this$gender.equals(other$gender));
}
protected boolean canEqual(Object other) {
return other instanceof Member;
}
// 生成hashCode()方法
public int hashCode() {
int PRIME = 59;
result = 1;
Object $groupId = getGroupId();
result = result * 59 + (($groupId == null) ? 43 : $groupId.hashCode());
Object $name = getName();
result = result * 59 + (($name == null) ? 43 : $name.hashCode());
Object $age = getAge();
result = result * 59 + (($age == null) ? 43 : $age.hashCode());
Object $gender = getGender();
return result * 59 + (($gender == null) ? 43 : $gender.hashCode());
}
// 生成toString()方法
public String toString() {
return "Member(groupId=" + getGroupId() + ", name=" + getName() + ", age=" + getAge() + ", gender=" + getGender() + ")";
}
}
- @Data注解:它相当于组合了@ToString、@EqualsAndHashCode、@Getter、@Setter这四个注解,注意对于final的字段不会生成setter方法。适用于那种仅传输数据的对象(如DTO)场景,注意暴露尽量少数据。
- @Value注解:它相当于组合了@ToString、@EqualsAndHashCode、@Getter这三个注解,也就是没有setter方法。适用于那种既承载数据又带业务逻辑的业务对象,不带任何的setter方法,所有写逻辑都需要用表意的方法代替。
@Getter and @Setter
@FieldNameConstants
@ToString
@EqualsAndHashCode
@AllArgsConstructor
@RequiredArgsConstructor
@NoArgsConstructor
@Log
@Log4j
@Log4j2
@Slf4j
@XSlf4j
@CommonsLog
@JBossLog
@Flogger
@CustomLog
@Data
@Builder
@SuperBuilder
@Singular
@Delegate
@Value
@Accessors
@Wither
@With
@SneakyThrows
@StandardException
@val
@var
@UtilityClass
2.3 编译
上面的依赖只会使得编译能够不报错,但如果是打包或者在IDEA中运行,可能会找不到对应的生成方法。
2.3.1 IDEA配置
由于Lombok的原理还是生成静态的Java代码,并不是在运行期动态提供,所以在IDEA中使用的时候,需要安装Lombok插件,IDEA才能够在编译的时候触发Lombok把注解转成代码。
在IDEA中:File -> Setting... -> Plugins -> 搜索Lombok -> 安装插件
在新版的IDEA使用Lombok时,有可能报错:
java: You aren't using a compiler supported by lombok, so lombok will not work and has been disabled.
Your processor is: com.sun.proxy.$Proxy25
Lombok supports: sun/apple javac 1.6, ECJ
参考 https://github.com/projectlombok/lombok/issues/2592 里的定位,大致原因是:IDEA在编译的时候把ProcessingEnvironement 包到一个代理里了,Lombok使用javac编译注解的方式就失效了。
解决办法:到IDEA的 File -> Setting... -> Build, Execution, Deployment -> Complier -> Shared build process VM options 里填上:-Djps.track.ap.dependencies=false
2.3.2 maven编译
IDEA中虽然能够编译运行了,但实际用的时候需要打成jar包到服务器运行,直接使用spring-boot-maven-plugin插件是否能够支持Lombok呢?答案是可以支持的。
1、spring-boot-maven-plugin间接依赖了maven-compiler-plugin,可以不显式指定maven-compiler-plugin:
<!-- pom.xml中用的是spring-boot-maven-plugin插件:-->
<build>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</build>
<!-- spring-boot-maven-plugin插件依赖plexus-build-api包:-->
<dependency>
<groupId>org.sonatype.plexus</groupId>
<artifactId>plexus-build-api</artifactId>
<version>0.0.7</version>
<scope>runtime</scope>
</dependency>
<!-- plexus-build-api包依赖maven-compiler-plugin插件包:-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>1.4</source>
<target>1.4</target>
</configuration>
</plugin>
2、 Lombok 通过 META-INF/services/javax.annotation.processing.Processor 文件实现自动注册
# lombok-1.18.30.jar!/META-INF/services/javax.annotation.processing.Processor
lombok.launch.AnnotationProcessorHider$AnnotationProcessor
lombok.launch.AnnotationProcessorHider$ClaimingProcessor
3、当项目依赖 Lombok 时,Maven 会扫描所有 jar 中的 META-INF/services/javax.annotation.processing.Processor。
4、Lombok执行Processor按注解生成代码。
3 架构一小步
1、引入Lombok工具,减少数据bean的getter/setter/toString的机械代码;
2、规范:在纯数据bean中使用@Data注解;
3、规范:在领域模型bean中使用@String注解,符合最小暴露的属性自行写getter,不能写setter方法,需要用表意方法代替所有写操作方法。