lombok guide
lombok是什么
lombok是一款用于減少重復(fù)代碼（或模板類代碼）的開源框架。
相信大家都用過jdbc操作數(shù)據(jù)庫，過程很麻煩胧砰，而且千篇一律……
同理舅世，項目中最常見的代碼set/get旦委、toString、equals雏亚、hashCode缨硝、Logger……
lombok怎么用
這里不談原理，不講性能罢低，只談使用查辩。
這里只說比較常用的胖笛，其他偏門的查API
lombok內(nèi)置很多注解，這些注解可以幫我們減少重復(fù)代碼
@Getter宜岛、@Setter
@Getter @Setter private boolean employed = true;
@Setter(AccessLevel.PROTECTED) private String name;
------------------------------------------------------
private boolean employed = true;
private String name;
public boolean isEmployed() {
return employed;
}
public void setEmployed(final boolean employed) {
this.employed = employed;
}
protected void setName(final String name) {
this.name = name;
}
分隔線上是lombok注解的使用例子长踊，分割線下是lombok為我們生成的或者我們以前就是那么干的
@NonNull
public class Family{
@Getter @Setter @NonNull
private List<Person> members;
}
------------------------------------------------------
@NonNull
private List<Person> members;
public Family(@NonNull final List<Person> members) {
if (members == null) throw new java.lang.NullPointerException("members");
this.members = members;
}
@NonNull
public List<Person> getMembers() {
return members;
}
public void setMembers(@NonNull final List<Person> members) {
if (members == null) throw new java.lang.NullPointerException("members");
this.members = members;
}
非null校驗
@ToString
@ToString(callSuper=true,exclude="someExcludedField")
public class Foo extends Bar {
private boolean someBoolean = true;
private String someStringField;
private float someExcludedField;
}
------------------------------------------------------
public class Foo extends Bar {
private boolean someBoolean = true;
private String someStringField;
private float someExcludedField;
@java.lang.Override
public java.lang.String toString() {
return "Foo(super=" + super.toString() +
", someBoolean=" + someBoolean +
", someStringField=" + someStringField + ")";
}
}
toString，可以排除某個字段萍倡，其他的可以看API
@EqualsAndHashCode
@EqualsAndHashCode(callSuper=true,exclude={"address","city","state","zip"})
public class Person extends SentientBeing {
enum Gender { Male, Female }
@NonNull private String name;
@NonNull private Gender gender;
private String ssn;
private String address;
private String city;
private String state;
private String zip;
}
------------------------------------------------------
public class Person extends SentientBeing {
enum Gender {
/*public static final*/ Male /* = new Gender() */,
/*public static final*/ Female /* = new Gender() */;
}
@NonNull
private String name;
@NonNull
private Gender gender;
private String ssn;
private String address;
private String city;
private String state;
private String zip;
@java.lang.Override
public boolean equals(final java.lang.Object o) {
if (o == this) return true;
if (o == null) return false;
if (o.getClass() != this.getClass()) return false;
if (!super.equals(o)) return false;
final Person other = (Person)o;
if (this.name == null ? other.name != null : !this.name.equals(other.name)) return false;
if (this.gender == null ? other.gender != null : !this.gender.equals(other.gender)) return false;
if (this.ssn == null ? other.ssn != null : !this.ssn.equals(other.ssn)) return false;
return true;
}
@java.lang.Override
public int hashCode() {
final int PRIME = 31;
int result = 1;
result = result * PRIME + super.hashCode();
result = result * PRIME + (this.name == null ? 0 : this.name.hashCode());
result = result * PRIME + (this.gender == null ? 0 : this.gender.hashCode());
result = result * PRIME + (this.ssn == null ? 0 : this.ssn.hashCode());
return result;
}
}
同樣可以exclude特定字段
@Data
@Data是lombok的工具集身弊，包含了@ToString、@EqualsAndHashCode列敲、@Getter和@Setter
@Data(staticConstructor="of")
public class Company {
private final Person founder;
private String name;
private List<Person> employees;
}
------------------------------------------------------
public class Company {
private final Person founder;
private String name;
private List<Person> employees;
private Company(final Person founder) {
this.founder = founder;
}
public static Company of(final Person founder) {
return new Company(founder);
}
public Person getFounder() {
return founder;
}
public String getName() {
return name;
}
public void setName(final String name) {
this.name = name;
}
public List<Person> getEmployees() {
return employees;
}
public void setEmployees(final List<Person> employees) {
this.employees = employees;
}
@java.lang.Override
public boolean equals(final java.lang.Object o) {
if (o == this) return true;
if (o == null) return false;
if (o.getClass() != this.getClass()) return false;
final Company other = (Company)o;
if (this.founder == null ? other.founder != null : !this.founder.equals(other.founder)) return false;
if (this.name == null ? other.name != null : !this.name.equals(other.name)) return false;
if (this.employees == null ? other.employees != null : !this.employees.equals(other.employees)) return false;
return true;
}
@java.lang.Override
public int hashCode() {
final int PRIME = 31;
int result = 1;
result = result * PRIME + (this.founder == null ? 0 : this.founder.hashCode());
result = result * PRIME + (this.name == null ? 0 : this.name.hashCode());
result = result * PRIME + (this.employees == null ? 0 : this.employees.hashCode());
return result;
}
@java.lang.Override
public java.lang.String toString() {
return "Company(founder=" + founder + ", name=" + name + ", employees=" + employees + ")";
}
}
@NoArgsConstructor阱佛、@AllArgsConstructor
無參構(gòu)造和全參構(gòu)造
@Builder
@Builder
class Example {
private int foo;
private final String bar;
}
------------------------------------------------------
class Example<T> {
private T foo;
private final String bar;
private Example(T foo, String bar) {
this.foo = foo;
this.bar = bar;
}
public static <T> ExampleBuilder<T> builder() {
return new ExampleBuilder<T>();
}
public static class ExampleBuilder<T> {
private T foo;
private String bar;
private ExampleBuilder() {}
public ExampleBuilder foo(T foo) {
this.foo = foo;
return this;
}
public ExampleBuilder bar(String bar) {
this.bar = bar;
return this;
}
@java.lang.Override public String toString() {
return "ExampleBuilder(foo = " + foo + ", bar = " + bar + ")";
}
public Example build() {
return new Example(foo, bar);
}
}
}
builder模式需要注意一點，因為builder生成的構(gòu)造是private的戴而，會引起一些框架的反射裝配問題凑术，所以一般與@ NoArgsConstructor一起使用
各種日志
包括apache、jdk logging所意、jboss log淮逊、log4j、slf4j扶踊。這里只講@Slf4j
@Slf4j
public class LogExample {
}
------------------------------------------------------
public class LogExample {
private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(LogExample.class);
}
利與弊
使用任何框架都有兩面性
利：
1.減少重復(fù)代碼
2.減少維護成本壮莹、增強可讀性、減少基礎(chǔ)性bug
弊：
1.降低性能
2.其他
