BlogJava-borball-随笔分类-java基础

1.11 DateUtils.truncate()

borball的程序生涯 — Wed, 08 Mar 2006 07:17:00 GMT

Truncating Date Objects(不知如何翻译,)，使用 DateUtils.truncate()
直接看例子吧

import org.apache.commons.lang.time.DateUtils;
import org.apache.commons.lang.time.FastDateFormat;
import org.apache.commons.lang.time.DateFormatUtils;

FastDateFormat dtFormat = DateFormatUtils.ISO_DATETIME_FORMAT;

Date now = new Date( );

Date truncatedMonth = DateUtils.truncate( now, Calendar.MONTH );
Date truncatedHour = DateUtils.truncate( now, Calendar.HOUR );

System.out.println( "Now: " + dtFormat.format( now ) );
System.out.println( "Truncated Month: "
+ dtFormat.format( truncatedMonth ) );
System.out.println( "Truncated Hour: "
+ dtFormat.format( truncatedHour ) );

输出为：Now: 2006-03-08T15:19:23
Truncated Month: 2006-03-01T00:00:00
Truncated Hour: 2006-03-08T15:00:00

由例子可以得知DateUtils.truncate()相当于舍弃我们不关心的Date fields。如某Date需要truncate到hour，则hour以后的fields如Calender.MINUTE,Calender.SECOND和Calender.MILLISECOND都将被舍弃。

borball的程序生涯 2006-03-08 15:17 发表评论

1.10 DateUtils.round()

borball的程序生涯 — Wed, 08 Mar 2006 06:55:00 GMT

日期取整（日期精度调节，如调节至秒/分等）
问题提出：日期取整
解决方法：使用DateUtils。DateUtils.round() can round to almost every Calender field, 包括Calender.YEAR,Calendar.SECOND,Calendar.MINUTE,Calendar.HOUR,Calendar.DAY_OF_MONTH,Calendar.MONTH.
使用举例：

import org.apache.commons.lang.time.FastDateFormat;
import org.apache.commons.lang.time.DateFormatUtils;
import org.apache.commons.lang.time.DateUtils;

FastDateFormat dtFormat = DateFormatUtils.ISO_DATETIME_FORMAT;

Date now = new Date( );

Date nearestHour = DateUtils.round( now, Calendar.HOUR );
Date nearestDay = DateUtils.round( now, Calendar.DAY_OF_MONTH );
Date nearestYear = DateUtils.round( now, Calendar.YEAR );

System.out.println( "Now: " + dtFormat.format( now ) );
System.out.println( "Nearest Hour: " + dtFormat.format( nearestHour ) );
System.out.println( "Nearest Day: " + dtFormat.format( nearestDay ) );
System.out.println( "Nearest Year: " + dtFormat.format( nearestYear ) );

DateUtils.round()相当于数学中的四舍五入法取整，而DateUtils.truncate()相当与去余法取整。

borball的程序生涯 2006-03-08 14:55 发表评论

1.9 FastDateFormat,DateFormatUtils

borball的程序生涯 — Wed, 08 Mar 2006 03:38:00 GMT

格式化日期
问题提出：SimpleDateFormat是非线程安全的，而您又需要一个ISO格式的日期。
解决方法：使用FastDateFormat或者使用DateFormatUtils提供的静态FastDateFormat实例，它提供了一些格式化日期的线程安全的方法。
使用举例：

    Date now = new Date();
    String isoDT = DateFormatUtils.ISO_DATETIME_TIME_ZONE_FORMAT.format(now);
    System.out.println("It is currently: " + isoDT);

结果为It is currently: 2006-03-08T10:44:29+08:00
如果您想使用传统的格式化类型，可以用FastDateFormat来代替SimpleDateFormat，

// create a formatter that simply prints the year and month

FastDateFormat formatter =
    new FastDateFormat( "yyyy-mm",
                         TimeZone.getDefault( ),
                         Locale.getDefault( ) );

String output = formatter.format( new Date( ) );

System.out.println(output);

在最新的版本中FastDateFormat的构造函数已经改为protected，统一使用getInstance()来获取FastDateFormat实例,上述的输出为2006-03.
Discussion:In fact, you should be aware that none of the Sun formatting classes are thread-safe. 以下是DateFormatUtils里面提供的Static date/time formats。

Name	Format
`ISO_DATE_FORMAT`	`yyyy-MM-dd"2004-01-02`"
`ISO_DATE_TIME_ZONE_FORMAT`	`yyyy-MM-ddZZ"2004-01-02-07:00`"
`ISO_DATETIME_FORMAT`	`yyyy-MM-dd'T'HH:mm:ss"2004-01-02T23:22:12`"
`ISO_DATETIME_TIME_ZONE_FORMAT`	`yyyy-MM-dd'T'HH:mm:ssZZ"2004-01-02T21:13:45-07:00`"
`ISO_TIME_FORMAT`	'`T'HH:mm:ss"T04:23:22`"
`ISO_TIME_NO_T_FORMAT`	`HH:mm:ss"05:12:34`"
`ISO_TIME_NO_T_TIME_ZONE_FORMAT`	`HH:mm:ssZZ"12:32:22-07:00`"
`ISO_TIME_TIME_ZONE_FORMAT`	'`T'HH:mm:ssZZ"T18:23:22-07:00`"
`SMTP_DATETIME_FORMAT`	`EEE, dd MMM yyyy HH:mm:ss Z"Wed, 01 Feb 2004 20:03:01 CST`"

borball的程序生涯 2006-03-08 11:38 发表评论

1.8 ArrayUtils.toMap()

borball的程序生涯 — Wed, 08 Mar 2006 02:05:00 GMT

从多维数组里构造一个map
问题提出：需要构造一个和数组等价的map
解决方法：使用ArrayUtils.toMap() 方法构造一个和二维数组(object[])等价的map。
使用举例：

import org.apache.commons.lang.ArrayUtils;

Object[] weightArray =
    new Object[][] { {"H" , new Double( 1.007)},
                     {"He", new Double( 4.002)},
                     {"Li", new Double( 6.941)},
                     {"Be", new Double( 9.012)},
                     {"B",  new Double(10.811)},
                     {"C",  new Double(12.010)},
                     {"N",  new Double(14.007)},
                     {"O",  new Double(15.999)},
                     {"F",  new Double(18.998)},
                     {"Ne", new Double(20.180)} };

// Create a Map mapping colors.
Map weights = ArrayUtils.toMap( weightArray );

Double hydrogenWeight = map.get( "H" );

Discussion：ArrayUtils.toMap() 避免了反复调用put()方法去实现一个map，ArrayUtils.toMap() 会把object[][]中每个元素(object[])的第一个元素当成key，第二个元素当成value.

borball的程序生涯 2006-03-08 10:05 发表评论

1.7 ArrayUtils.contains() ,lastIndexOf(),lastIndexOf()

borball的程序生涯 — Wed, 08 Mar 2006 01:47:00 GMT

数组中查找一个元素
问题提出：需要确定一个数组中是否含有某个元素并给出元素所在位置
解决方法：使用ArrayUtils.contains() 来确认是否含有，使用ArrayUtils.lastIndexOf()和ArrayUtils.lastIndexOf()来确定该元素第一个出现的位置和最后一个出现的位置。

Discussion：ArrayUtils可以应用到所有的数组类型，如：boolean[]，byte[],char[],long[],double[],short[],int[]和object[].当是基本类型时ArrayUtils会比较各个元素的值。当时object[]时会调用equals()方法来找出以各匹配的对象。
ArrayUtils.lastIndexOf()和ArrayUtils.lastIndexOf()还提供了第三个参数用来指定查找的开始位。

borball的程序生涯 2006-03-08 09:47 发表评论

1.6 ArrayUtils.toObject()和ArrayUtils.toPrimitive()

borball的程序生涯 — Wed, 08 Mar 2006 01:28:00 GMT

在对象数组(Object Arraysand )和基本类型数组(Primitive Arrays)间转换
问题提出：需要在对象数组和基本类型数组间进行转换
解决方法：使用ArrayUtils.toObject()和ArrayUtils.toPrimitive()方法。
使用举例：

import org.apache.commons.lang.ArrayUtils;

long[] primitiveArray = new long[] { 12, 100, 2929, 3323 };
Long[] objectArray = ArrayUtils.toObject( primitiveArray );

Double[] doubleObjects = new Double[] { new Double( 3.22, 5.222, 3.221 ) };

double[] doublePrimitives = ArrayUtils.toPrimitive( doubleObject );

Discussion：考虑以下场景：假设一个外部系统期望我们提供一个以Double对象为元素的List，而我们内部系统只有一个double[],以下代码可以使两者达到匹配。

// Assume that temps is a 4000 element double[]

double[] temps = readTemps( );

// Turn the double[] into an array of Double objects
Double[] objectArray = ArrayUtils.toObject( temps );
List inputList = Arrays.asList( objectArray );

// Assume that some process returns results as a List of Double

// objects
List outputList = externalLib.complexCalculation( inputList );

// Transform this List of doubles to an array of double primitives
Double[] resultObjArray =
(Double[]) outputList.toArray( new Double[0] );

double[] result =
ArrayUtils.toPrimitive( resultObjArray, Double.NaN );

ArrayUtils.toPrimitive()中对象数组可以为null,最后一句double[] result =
ArrayUtils.toPrimitive( resultObjArray, Double.NaN )指定当某元素为null的时候将用第二个参数代替。因为第二个参数是可选的，当不指定时将会抛出NullPointerException异常。

borball的程序生涯 2006-03-08 09:28 发表评论

1.5 ArrayUtils.clone() 和ArrayUtils.reverse()

borball的程序生涯 — Wed, 08 Mar 2006 01:01:00 GMT

clone并倒转一个数组
问题提出：需要clone并倒转一个数组中的内容
解决方法：使用ArrayUtils.clone() 和 ArrayUtils.reverse() 方法
使用举例：

import org.apache.commons.lang.ArrayUtils;

long[] array = { 1, 3, 2, 3, 5, 6 };
long[] reversed = ArrayUtils.clone( array );

ArrayUtils.reverse( reversed );

System.out.println( "Original: " + ArrayUtils.toString( array ) );

System.out.println( "Reversed: " + ArrayUtils.toString( reversed ) );

输出的结果为：Original: { 1, 3, 2, 3, 5, 6 } Reversed: { 6, 5, 3, 2, 3, 1 }
Discussion：在上述例子中ArrayUtils.clone()返回了一个新数组的引用，而ArrayUtils.reserve()方法会直接操作参数所指定的数组。除了基本类型外，这两个方法还支持对象数组。
如果没有这两个方法的帮助，我们可能会用以下方法实现倒转。

// readTemps returns a 1000 member double[]

double[] temperature = readTemps( );
double[] reversed = new double[temperature.length];

for( int i = 0; i < temperature.length; i++ ){
reversed[reversed.length - (i+1)] = temperature[i];
}

另外一种方法利用Collections.reverse()，该方法是对一个List对象进行操作，所有之前需要将数组转换成List对象，另外List里面不能含有基本类型，还需要将基本类型包装一下，以下是实现的源码：

double[] temps = readTemps( );

List tempList = new ArrayList( );
for( int i = 0; i < temps.length; i++ ){
    tempList.add( new Double[temps[i]] );
}

Collections.reverse( tempList );
double[] reversed = new double( tempList.size( ) );
Iterator i = tempList.iterator( );
int index = 0;
while( i.hasNext( ) ){
  reversed[index] = ((Double) i.next( )).doubleValue( );

    index++;
}

有些人会问道：不是所有的数组都有一个clone()方法吗?一种可能的解释是ArrayUtils.clone()使程序更具可读性，另外当一个数组引用使null时，ArrayUtils.clone()会返回一个null而不是抛出一个运行时异常。

borball的程序生涯 2006-03-08 09:01 发表评论

1.4 ArrayUtils.toString()

borball的程序生涯 — Tue, 07 Mar 2006 09:50:00 GMT

打印一个数组中的内容
问题提出：如果需要打印数组中的内容
解决方法：使用ArrayUtils.toString()方法。
使用举例：

int[] intArray = new int[] { 2, 3, 4, 5, 6 };

int[] multiDimension = new int[][] { { 1, 2, 3 }, { 2, 3 }, {5, 6, 7} };

System.out.println( "intArray: " + ArrayUtils.toString( intArray ) );
System.out.println( "multiDimension: " + ArrayUtils.
toString( multiDimension ) );

程序输出结果如下：
intArray: {2,3,4,5,6}
multiDimension: {{1,2,3},{2,3},{5,6,7}}

Discussion：下面例子可以用来打印一个Object[]数组的所有内容，包括null。

String[] strings = new String[] { "Blue", "Green", null, "Yellow" };

System.out.println( "Strings: " + ArrayUtils.toString( strings, "Unknown" );

当某一元素为null时，将会用ArrayUtils.toString( strings, "Unknown" )中第二个参数指定的String代替。

borball的程序生涯 2006-03-07 17:50 发表评论

1.3 CompareToBuilder

borball的程序生涯 — Tue, 07 Mar 2006 06:45:00 GMT

问题提出：需要快速实现compareTo()方法
解决方法：使用CompareToBuilder提供的compareTo()方法。同样的CompareToBuilder也使用了反射机制。以下代码提供了一个compareTo()方法，用于比较两个对象所有的非static和非transient成员变量。

import org.apache.commons.lang.builder.CompareToBuilder;

// Build a compareTo function from reflection
public int compareTo(Object o) {
return CompareToBuilder.reflectionCompare(this, obj);

}

Discussion：CompareToBuilder.reflectionCompare()提供了两个对象non-static和nontransient成员变量的方法。 reflectionCompare()方法不予理会static和transient变量，因此以下代码中的averageAge和fullName变量是不会进入比较表达式的。

public class PoliticalCandidate {
    // Static variable
    private static String averageAge;

    // Member variables
    private String firstName;
    private String lastName;

    private transient String fullName;
    // Constructors
    // get/set methods
    // Build a compareTo function from reflection
    public int compareTo(Object o) {
        return CompareToBuilder.reflectionCompare(this, obj);
    }

}

比较对象成员变量的时候应该有一个比较的次序存在，上述代码中默认的应该是先比较lastName,然后是firstName。调用append()方法可以把要比较的变量加入比较表达式中，并且遵循后加入的先比较的次序。
例如：

public int compareTo(Object o) {
    int compare = -1; // By default return less-than
    if( o != null && PoliticalCandidate.class.isAssignableFrom( o.getClass( ) ) ) {

            PoliticalCandidate pc = (PoliticalCandidate) o;
            compare = (new CompareToBuilder( )
                          .append(firstName, pc.firstName)
                          .append(lastName, pc.lastName)).toComparison( );
    }

    return compare;
}

在比较的时候会先比较lastName，只有在lastName相同的情况下才会比较firstName。
ps：实现compareTo()的时候应保证和equals()规则相同，即当compareTo()返回是0的时候equals()应该返回true。

borball的程序生涯 2006-03-07 14:45 发表评论

1.2 EqualsBuilder和HashCodeBuilder

borball的程序生涯 — Tue, 07 Mar 2006 03:37:00 GMT

2.自动化hashCode()和equals()
问题产生：当需要自动实现hashCode()和equals()方法
解决方法：使用EqualsBuilder和HashCodeBuilder
使用举例：

import org.apache.commons.lang.builder.HashCodeBuilder;
import org.apache.commons.lang.builder.EqualsBuilder;

public class PoliticalCandidate {
    // Member variables - omitted for brevity
    // Constructors - omitted for brevity
    // get/set methods - omitted for brevity
    // A hashCode which creates a hash from the two unique identifiers

    public int hashCode( ) {
        return new HashCodeBuilder(17, 37)
                       .append(firstName)
                       .append(lastName).toHashCode( );
    }

    // An equals which compares two unique identifiers
    public boolean equals(Object o) {
        boolean equals = false;
        if ( o != null &&PoliticalCandidate.class.isAssignableFrom(o) ) {
            PoliticalCandidate pc = (PoliticalCandidate) o;
            equals = (new EqualsBuilder( )
                       .append(firstName, ps.firstName)
                       .append(lastName, ps.lastName)).isEquals( );
        }
        return equals;
    }

}

Discussion：
1.在上述例子中，当有相同的firstname和lastname时,认为两个对象的hashCode相同，从而equals()返回true.
如果hashCode取决于该class的所有filed时需要使用反射机制来产生一个hashCode。

public int hashCode( ) {
return HashCodeBuilder.reflectionHashCode(this);
}

和ToStringBuilder 与 HashCodeBuilder一样 EqualsBuilder 也是使用append()方法进行配置，EqualsBuilder的append()方法可以接受基本类型、对象、数组作为参数。EqualsBuilder强大的地方在于可以直接把数组作为参数传入append()方法，EqualsBuilder会依次比较数组中的每个元素。
2.如果两个对象相等当且仅当每个属性值都相等这句话可以由以下代码实现：

public boolean equals(Object o) {
return EqualsBuilder.reflectionEquals(this, o);
}

borball的程序生涯 2006-03-07 11:37 发表评论

1.1 ReflectionToStringBuilder

borball的程序生涯 — Tue, 07 Mar 2006 02:51:00 GMT

本笔记是在阅读Jakarta Commons Cookbook时所留下的。
1.使用ReflectionToStringBuilder 或者ToStringBuilder 自动产生toString()的内容。
使用举例：假设有一个表征校长候选人信息的javabean－PoliticalCandidate。

public class PoliticalCandidate {
    private String lastName;
    private String firstName;
    private Date dateOfBirth;
    private BigDecimal moneyRaised;
    private State homeState;

    // get/set方法省略
    public void toString( ) {
        ReflectionToStringBuilder.toString( this );
    }
}

该bean里面有个toString()方法，假设有以下操作：

// Create a State
State va = new State( "VA", "Virginia");

// Create a Birth Date
Calendar calendar = new GregorianCalendar( );
calendar.set( Calendar.YEAR, 1743 );
calendar.set( Calendar.MONTH, Calendar.APRIL );
calendar.set( Calendar.DAY_OF_MONTH, 13 );
Date dob = calendar.getTime( );

BigDecimal moneyRaised = new BigDecimal( 293829292.93 );

// Create a Political Candidate
PoliticalCandidate candidate =
    new PoliticalCandidate( "Jefferson", "Thomas", dob, moneyRaised, va );

System.out.println( candidate );

假设State对象也是一个使用ReflectionToStringBuilder的javabean，上述程序一种可能的输出为com.discursive.jccook.lang.builders.PoliticalCandidate@187aeca
    [lastName=Jefferson,\firstName=Thomas,
     dateOfBirth=Sat Apr 13 22:38:42 CST 1743,
     moneyRaised=\293829292.930000007152557373046875,
     state=\com.discursive.jccook.lang.builders.State@87816d
         [abbreviation=VA,name=Virginia]]

borball的程序生涯 2006-03-07 10:51 发表评论