java 提供高精度的运算支持 BigDecimal 备忘笔记

package com.util;

import java.math.BigDecimal;

/**
 * 提供高精度的运算支持.
 * 所以函数以double为参数类型，兼容 int 与 float.
 * @author dylan_xu
 * @date Mar 11, 2012
 * @since JDK1.6
 * @see com.util.NumericUtils
 */
public class NumericUtils {

	private NumericUtils() {

	}
	/**
	 * 判断是否是大于零的Integer整数
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param obj
	 * @return
	 */
	public static boolean isGTIntegerZero(Object obj){
		return ((obj!=null)&&(obj instanceof Integer)&&(((Integer)obj).intValue()>0));
	}
	
	/**
	 * 判断是否是大于零的Long整数
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param obj
	 * @return
	 */
	public static boolean isGTLongZero(Object obj){
		return ((obj!=null)&&(obj instanceof Long)&&(((Long)obj).longValue()>0));
	}
	
	/**
	 * 精确的加法运算
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1
	 * @param v2
	 * @return
	 */
	public static double add(double v1, double v2) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.add(b2).doubleValue();
	}
	
	/**
	 * 精确的减法运算
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1 被减数
	 * @param v2 减数
	 * @return
	 */
	public static double subtract(double v1, double v2) {
		BigDecimal b1 = new BigDecimal(Double.toString(v1));
		BigDecimal b2 = new BigDecimal(Double.toString(v2));
		return b1.subtract(b2).doubleValue();
	}
	
	/**
	 * 提供精确的乘法运算
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1
	 * @param v2
	 * @return
	 */
	public static double multiply(double v1, double v2) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.multiply(b2).doubleValue();
	}
	
	/**
	 * 提供精确的乘法运算，并对运算结果截位.
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1
	 * @param v2
	 * @param scale 运算结果小数后精确的位数
	 * @return
	 */
	public static double multiply(double v1, double v2, int scale) {
		if (scale < 0) {
			throw new IllegalArgumentException("The scale must be a positive integer or zero");
		}
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.multiply(b2).setScale(scale,BigDecimal.ROUND_HALF_UP).doubleValue();
	}

	/**
	 * 提供（相对）精确的除法运算
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1
	 * @param v2
	 * @return
	 */
	public static double divide(double v1, double v2) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.divide(b2).doubleValue();
	}

	/**
	 * 提供（相对）精确的除法运算.
	 * 由scale参数指定精度，以后的数字四舍五入.
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1 被除数
	 * @param v2 除数
	 * @param scale 表示表示需要精确到小数点以后几位
	 * @return
	 */
	public static double divide(double v1, double v2, int scale) {
		if (scale < 0) {
			throw new IllegalArgumentException("The scale must be a positive integer or zero");
		}

		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.divide(b2, scale, BigDecimal.ROUND_HALF_UP).doubleValue();
	}
	
	/**
	 * 提供精确的小数位四舍五入处理.
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v 需要四舍五入的数字
	 * @param scale 小数点后保留几位
	 * @return
	 */
	public static double round(double v, int scale) {
		if (scale < 0) {
			throw new IllegalArgumentException("The scale must be a positive integer or zero");
		}
		BigDecimal b = new BigDecimal(v);
		return b.setScale(scale, BigDecimal.ROUND_HALF_UP).doubleValue();
	}
	
	/**
	 * 提供精确的类型转换(Float) 
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v 需要被转换的数字
	 * @return 返回转换结果 
	*/
	public static float convertsToFloat(double v){
		BigDecimal b = new BigDecimal(v);
		return b.floatValue();
	}
	
	/**
	 * 提供精确的类型转换(Int)不进行四舍五入
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v需要被转换的数字
	 * @return 返回转换结果
	 */
	public static int convertsToInt(double v){
		BigDecimal b = new BigDecimal(v);
		return b.intValue();
	}
	
	/**
	 * 提供精确的类型转换(Long) 
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v 需要被转换的数字
	 * @return 返回转换结果
	 */
	public static long convertsToLong(double v){
		BigDecimal b = new BigDecimal(v);
		return b.longValue();
	}
	/**
	 * 返回两个数中大的一个值
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1 需要被对比的第一个数 
	 * @param v2 需要被对比的第二个数 
	 * @return 返回两个数中大的一个值
	 */
	public static double returnMax(double v1,double v2){
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return b1.max(b2).doubleValue();
	}
	/**
	 * 返回两个数中大的一个值
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1 需要被对比的第一个数 
	 * @param v2 需要被对比的第二个数 
	 * @return 返回两个数中小的一个值
	 */
	public static double returnMin(double v1,double v2){
		BigDecimal b1= new BigDecimal(v1);
		BigDecimal b2= new BigDecimal(v2);
		return b1.min(b2).doubleValue();
	}
	
	/**
	 * 精确对比两个数字 
	 * @author dylan_xu
	 * @date Mar 11, 2012
	 * @param v1 需要被对比的第一个数 
	 * @param v2 需要被对比的第二个数 
	 * @return 如果两个数一样则返回0，如果第一个数比第二个数大则返回1，反之返回-1 
	 */
	public static int compareTo(double v1,double v2){
		BigDecimal b1= new BigDecimal(v1);
		BigDecimal b2= new BigDecimal(v2);
		return b1.compareTo(b2);
	}
	
	public static void main(String[] args) {
		double v1 = 3.565;
		double v2 = 5.345;
		
		System.out.println(convertsToLong(v1));
		System.out.println(convertsToFloat(v2));
		System.out.println(convertsToInt(v1));
		System.out.println(round(v1, 1));
		System.out.println(NumericUtils.multiply(v1, v2));
	}
	
}