BlogJava-最爱Java-随笔分类-Jakarta Commons笔记

org.apache.commons.lang.math学习笔记

Brian — Thu, 08 Jan 2009 11:43:00 GMT

    在org.apache.commons.lang.math包中，一共有11个类。可以分成四组：
    1. 处理分数的Fraction类；
    2.处理数值的NumberUtils和IEEE754rUtils类，这里IEEE745r代表的是IEEE 754的标准，是一种浮点数的处理标准。
    3.处理随机数的JVMRandom和RandomUtils类。
    4.处理数值范围的Range, DoubleRange, FloatRange, IntRange, LangRange, NumberRange类。

    Fraction类能很方便地处理分数，并能进行分数的约分，加减乘除和指数运算以及求相对值。如：

    private void FractionDemo() {
        Fraction fraction = Fraction.getFraction(0.5);
        System.out.println(fraction.getNumerator());
        System.out.println(fraction.getDenominator());

        fraction = Fraction.getFraction("1/2");
        System.out.println(fraction.doubleValue());

        fraction = Fraction.getFraction(1, 2);
        System.out.println(fraction.doubleValue());

        fraction = Fraction.getFraction(1, 1, 2);
        System.out.println(fraction.doubleValue());

        fraction = Fraction.getFraction(2, 4);
        System.out.println(fraction.doubleValue());
        fraction = Fraction.getReducedFraction(2, 4);
        System.out.println(fraction.doubleValue());

        System.out.println(Fraction.getFraction(-1, 2).abs());
        System.out.println(Fraction.getFraction(1, -2).abs());
        System.out.println(Fraction.getFraction(1, 2).add(
                Fraction.getFraction(1, 2)));
        System.out.println(Fraction.getFraction(1, 2).subtract(
                Fraction.getFraction(1, 2)));
        System.out.println(Fraction.getFraction(1, 2).multiplyBy(
                Fraction.getFraction(1, 2)));
        System.out.println(Fraction.getFraction(1, 2).divideBy(
                Fraction.getFraction(1, 2)));
        System.out.println(Fraction.getFraction(1, 2).pow(2));
    }

NumberUtils的功能相对来说就有点鸡肋了，他能通过createXXX(String str)创建各种类型的数值，即使你传入的参数是0X123这样代表16进制的数，它也能正确解析出来。同时它还具有获取数组最大最小数的功能。

    private void NumberUtilsDemo() {
        System.out.println("Is 0x3F a number? " + NumberUtils.isNumber("0x3F"));
        double[] array = { 1.0, 3.4, 0.8, 7.1, 4.6 };
        double max = NumberUtils.max(array);
        double min = NumberUtils.min(array);
        System.out.println("Max of array is: " + max);
        System.out.println("Min of array is: " + min);
        System.out.println();
    }

JVMRandom继承了java.util.Random类，其功能和Random差不多，只不过封装了返回不同数据类型的方法而已。而RandomUtils则把JVMRandom的方法静态化了。

    private void RandomUtilsDemo() {
        for (int i = 0; i < 5; i++) {
            System.out.println(RandomUtils.nextInt(100));
        }
        System.out.println();
    }

Range是一个abstract类，主要处理数值范围的。DoubleRange, FloatRange, IntRange, LangRange和NumberRange都继承了Range类，它们差不多，只是处理的数据类型不同而已。所以看一个类的使用方法就等于看了所有类的使用方法。

    private void NumberRangeDemo() {
        Range normalScoreRange = new DoubleRange(90, 120);
        double score1 = 102.5;
        double score2 = 79.9;
        System.out.println("Normal score range is: " + normalScoreRange);
        System.out.println("Is " + score1 + " a normal score? " + normalScoreRange.containsDouble(score1));
        System.out.println("Is " + score2 + " a normal score? " + normalScoreRange.containsDouble(score2));
        System.out.println(normalScoreRange.overlapsRange(new IntRange(92,119)));
    }

Brian 2009-01-08 19:43 发表评论

org.apache.commons.lang.enums学习笔记

Brian — Mon, 05 Jan 2009 06:00:00 GMT

    在org.apache.commons.lang.enums包中只有3个类，主要是实现了枚举类的操作。
    Enum - 用于实现枚举；
    EnumUtils - 用于简化枚举类的操作；
    ValuedEnum - 另一种带有int值的枚举类型，主要用于switch语句。
    虽然JDK 1.5以上已经自带了Enums类型，但这两者还是有些区别的：标准的Enums是一个内置的数据类型，不是一个超类；因为不是一个超类，所以不能继承，也没有Lang包中Enum类的方法；Lang包中的enum名字可以通过getName()获得，而标准的Enums则只返回其类的名字。当然，Apache组织还是希望没必要的情况下，不要使用Lang包下的Enum类，因为Enum类是单独实现枚举用途的，和标准的Enums没有任何关系，所以两者之间将无法转换。
    Enum类和ValuedEnum类的使用方法很简单，在APIDOC中有详细的例子。就不再这里重复了。但需要说一下EnumUtils这个类，这个类个人认为在jdk 1.5以后是一个无效类。我们看下面的例子：

package test.org.apache.commons.lang.enums;

import java.util.Iterator;
import java.util.List;

import org.apache.commons.lang.enums.EnumUtils;

public class EnumsTest {
    public static void main(String[] args) {
        System.out.println("start");
        Iterator it = EnumUtils.iterator(StudentEnum.class);
        while (it.hasNext()) {
            System.out.println(it.next());
        }

        it = StudentEnum.iterator();
        while (it.hasNext()) {
            System.out.println(it.next());
        }

        it = EnumUtils.iterator(StudentEnum.class);
        while (it.hasNext()) {
            System.out.println(it.next());
        }
        System.out.println("end");
    }
}

从设计角度，应该打印出三遍StudentEnum中的数据，但实际上只打印出了两遍。第一次调用EnumUtils.iterator()方法的时候，返回的是空Iterator。这主要是jdk 1.5以后类的加载机制发生了变化，也就是static字段的加载时机改变了。在例子中，到StudentEnum.iterator()语句时，StudentEnum类才被加载，StudentEnum的static字段才被初始化。而EnumUtils所有方法都是访问static字段的，所以在被访问的类没有实际加载之前，是访问不到任何数据的。这个问题在Apache的论坛上已经被提及。

Brian 2009-01-05 14:00 发表评论

org.apache.commons.lang.builder学习笔记

Brian — Sun, 04 Jan 2009 09:34:00 GMT

摘要: 在org.apache.commons.lang.builder包中一共有7个类，用于帮助实现Java对象的一些基础的方法，如compareTo(), equals(), hashCode(), toString()等。他们分别是： CompareToBuil... 阅读全文

Brian 2009-01-04 17:34 发表评论