在网上找了一下,并没有发现关于commons-lang的详细使用方法,最近也有空,所以仔细的学习了一下,发在网上,也可供大家参考。
builder包的作用主要是为了帮助程序员创建一致的equals(Object), toString(), hashCode(), compareTo(Object) 方法。说实话这些方法如果完全由程序员自己来实现的确有些困难,有很多细节需要注意,但现实通过builder包提供的帮助,实现起来要容易得多。它包括以下几个类:
CompareToBuilder
EqualsBuilder
HashCodeBuilder
ReflectionToStringBuilder
StandardToStringStyle
ToStringBuilder
ToStringStyle
最后四个都与toString()有关,前面三个通过名字就知道它们对什么方法提供帮助。下面将一一介绍。
首先来看CompareToBuilder的用法,要明白这个方法的用法,首先要知道compareTo是用来做什么的。compareTo(T o)是Comparable接口的一个方法,此方法的作用是比较元素。如果只从单一的方法上来看,并没有看出它有什么用。然而它与其它类结合起来使用,则会提供相当强大的功能,JDK内部的许多类都与它相关,特别是集合类与数组。只要一个类实现了Comparable接口,它的实例就存在内部的排序关系。如果一个数组内部的对象实现了Comparable接口,就可以直接对它排序:
Arrays.sort(a);
Java 类库的所有具有值的类都实现了Comparable接口,这很重要。如TreeSet,它是一个保持次序的Set,但内部的元素必须实现Comparable接口。
明白了Comparable是做什么的以后,就需要明白该怎么编写实现了Comparable接口的CompareTo方法。具体编写规则比较多,详细过程可参考effective Java 第二版,上面说得比较详细,而这也正是CompareToBuilder该上场的时候了。
CompareToBuilder主要有两种方法
append(arg1,arg2):append方法用于添加需要比较的字段,反回CompareToBuilder对象,这很重要,这样就可以通过连缀的方式来使用方法,显得更加的优雅紧凑。
reflectionCompare(arg1,arg2):通过反射的方式来比较字段,这个方法有个好处就是一次性解决问题,append需要一个一个的添加需要比较的字段。但是也有一个缺点,那就是反射会牺牲一部分性能,虽然新版本的JDK对反射进行过优化。用法如下:
public int compareTo(Object o) {
return CompareToBuilder.reflectionCompare(this, o);
}
下面通过一个例子来说明:
class Number implements Comparable<Number> {
private int n1;
private int n2;
private String[] array;
public Number(){
}
public Number(int n1, int n2,String[] array) {
this.n1 = n1;
this.n2 = n2;
this.array = array;
}
public int getN1() {
return n1;
}
public void setN1(int n1) {
this.n1 = n1;
}
public int getN2() {
return n2;
}
public void setN2(int n2) {
this.n2 = n2;
}
public String[] getArray() {
return array;
}
public void setArray(String[] array) {
this.array = array;
}
public int compareTo(Number number) {
return new CompareToBuilder()
.append(this.n1, number.n1).append(this.n2, number.n2)
.append(this.array, number.array)
.toComparison();
}
public String toString(){
return "n1="+n1+" n2="+n2+" array="+Arrays.toString(array)+"======";
}
上面这个类实现Comparable接口,也实现了它的compareTo方法。它在compareTo方法中就用到了CompareToBuilder类,toComparison表示返回比较的结果,负数表示小于,0表示等于,正数表示大于。上面短短几行代码就完成了compareTo的编写,如果程序员手动去实现会复杂得多。
通过下面的代码来测试一下:
@Test
public void appendTest() {
String[] s1 = {"asd","fsd"};
String[] s2 = {"asd","fsd"};
String[] s3 = {"asd","asd"};
Number[] n = {new Number(2,4,s1),
new Number(4,6,s2),new Number(2,3,s3)
,new Number(4,5,s2),new Number(4,5,s3)
};
System.out.println(Arrays.toString(n));
Arrays.sort(n);
System.out.println(Arrays.toString(n));
}
默认的排序方式是由低到高,由大到小,可通过输出结果对比,的确实现了排序。但上面的toString()的实现则并不优雅。众所周知,大多数时候我们都应该实现自己的toString(),让所有的对象都有统一格式的toString(),这样阅读与解析就更加的容易。编写toString()方法并没有什么特别的限制,但基本要求是应该返回所有值得关注的信息。上面的方法中,如果用ToStringBuilder来完成,会相对优雅一些:
public String toString(){
return new ToStringBuilder(this,ToStringStyle.SHORT_PREFIX_STYLE).
append("n1", n1).
append("n2", n2).
append("array", array).
toString();
}
输出为:
[Number[n1=2,n2=4,array={asd,fsd}]..................
其中ToStringStyle指定输出显示的格式,个人感觉ToStringStyle预定义的字段已经够用了,如果对所有预定义的格式都不满意,也可以手动设置自己的风格。由于ToStringStyle只是一个抽象的类,所以可以继承此类实现自己的风格。当然builder包也提供了一种实现了此接口的标准风格类StandardToStringStyle。其实StandardToStringStyle本身什么也没做,用的仍然是ToStringStyle提供的方法,只是把一些ToStringStyle通过protected保护起来的方法用public把它公开了而已。StandardToStringStyle的用法其实也很简单:
System.out.println(standard.getArrayEnd());
standard.setArrayEnd("]");
System.out.println(standard.getArrayEnd());
通过get查看系统预定义属性,通过set修改预定定义属性。
ToStringBuilder还提供类似其它类的reflectionToString,作用也大同小异,用法如下:
public String toString() {
return ToStringBuilder.reflectionToString(this);
}
至于ReflectionToStringBuilder,其实就是为ToStringBuilder的reflectionToString提供具体的实现,在ToStringBuilder有如下这样的代码:
public static String reflectionToString(Object object) {
return ReflectionToStringBuilder.toString(object);
}
剩下的EqualBuilder与HashCodeBuilder用法与ComparableToBuilder的用法完全相似。
总结:虽然在新版本的JDK中,已经有实现或替代commons-lang组件的一些类库,但还是有一些JDK无法替代的类库,个人认为这是整个commons-lang包最有用的几个子包之一,能用到的场合也相当的广泛,可以说大多数时候都会用到,因此每个人都应该好好掌握这些基础的类库。
分享到:
相关推荐
org.apache.commons.lang.builder.ToStringStyle$ShortPrefixToStringStyle.class org.apache.commons.lang.builder.ToStringStyle$SimpleToStringStyle.class org.apache.commons.lang.builder.ToStringStyle....
java包。 import org.apache.commons.lang3.builder.EqualsBuilder; import org.apache.commons.lang3.builder.HashCodeBuilder;
org.apache.commons.lang.builder.ToStringStyle$NoFieldNameToStringStyle.class org.apache.commons.lang.builder.ToStringStyle$ShortPrefixToStringStyle.class org.apache.commons.lang.builder.ToStringStyle$...
org.apache.commons.lang.builder.ToStringStyle$ShortPrefixToStringStyle.class org.apache.commons.lang.builder.ToStringStyle$SimpleToStringStyle.class org.apache.commons.lang.builder.ToStringStyle....
org.apache.commons.lang.builder org.apache.commons.lang.enum org.apache.commons.lang.enums org.apache.commons.lang.exception org.apache.commons.lang.math org.apache.commons.lang.mutable org....
fileupload-1.2.1 commons-httpclient-3.1 commons-io-1.4-javadoc commons-io-1.4-sources commons-io-1.4 commons-lang-2.4-javadoc commons-lang-2.4-sources commons-lang-2.4 commons-logging-1.0.4 commons-...
commons-lang-2.4-javadoc.jar commons-lang-2.4-sources.jar commons-logging-1.0.4.jar commons-logging-1.1.1.jar commons-logging-1.1.jar commons-net-1.4.1.jar cpdetector_1.0.7.jar http-2.2.1.jar ...
org.apache.commons.lang jar包
开发httpclient需要用到的jar文件commons-codec-1.3.jar,commons-httpclient-3.0.1.jar,commons-lang.jar,commons-logging-1.1.jar,commons-logging-adapters-1.1.jar,commons-logging-api-1.1.jar,filterbuilder....
import org.apache.commons.lang.builder.EqualsBuilder; import org.apache.commons.lang.builder.HashCodeBuilder;
maven-repository-builder-1.0-alpha-2.jar maven-repository-metadata-2.0.4.jar maven-repository-metadata-2.0.5.jar maven-repository-metadata-2.0.8.jar maven-repository-metadata-2.0.9.jar maven-...
builder-0.6.2.jar, classworlds-1.1.jar, commons-beanutils-1.8.0.jar, commons-chain-1.2.jar, commons-collections-3.2.2.jar, commons-digester-2.0.jar, commons-fileupload-1.3.2.jar, commons-io-2.2.jar, ...
activation-1.1.jar ...builder-0.6.2.jar c3p0-0.9.1.2.jar cglib-2.2.2.jar cglib-2.2.jar classworlds-1.1.jar com.springsource.com.mchange.v2.c3p0-0.9.1.2.jar com.springsource.net.sf.cglib-2.2.0.jar ...
jarjar-maven-settings-builder-3.0.4.jar jarjar-plexus-cipher-1.7.jar jarjar-plexus-classworlds-2.4.jar jarjar-plexus-component-annotations-1.5.5.jar jarjar-plexus-container-default-1.5.5.jar jar...
有一些替代方案,例如commons-lang,guava或Object.equals,但是都存在相同的问题: @Overridepublic boolean equals(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if ...
│ │ │ frame-sourcefiles-org.apache.ibatis.logging.commons.html │ │ │ frame-sourcefiles-org.apache.ibatis.logging.html │ │ │ frame-sourcefiles-org.apache.ibatis.logging.jdbc.html │ │ │ ...
lang3.builder:协助构建一致的 equals(Object), toString(), hashCode(),compareTo(Object)方法 lang3.concurrent:多线程支持 lang3.event:提供一些基于事件的工具 lang3.exception lang3.math:扩展java.math lang3....
建筑商,母亲和工厂 生成器,母体和工厂测试模式,以及一个简单的测试驱动示例。 Java,Gradle,JUnit,Apache Commons Lang 3,Travis CI
import com.flong.commons.lang.exception.DaoAccessException; import com.flong.commons.persistence.Entity; import com.flong.commons.persistence.bean.DataStore; import ...
MyBatis 目录(?)[-] mybatis实战教程mybatis in action之一开发环境搭建 mybatis实战教程mybatis in action之二以接口的方式编程 mybatis实战教程mybatis in action之三实现数据的增删改查 mybatis实战教程mybatis ...