/**
 * 進行BigDecimal對象的加減乘除，四舍五入等運算的工具類
 * 
 * @author Marydon
 * @createTime 2017年12月1日上午11:39:15
 * @updateTime
 * @Email:Marydon20170307@163.com
 * @description 由于Java的簡單類型不能夠精確的對浮點數(shù)進行運算，這個工具類提供了精確的浮點數(shù)運算，包括加減乘除和四舍五入。
 * @version:1.0.0
 */
public class ArithmeticUtiles {

  /**
   * 進行BigDecimal對象的加減乘除，四舍五入等運算的工具類
   * 
   * @author wupenghui 由于Java的簡單類型不能夠精確的對浮點數(shù)進行運算，這個工具類提供精 確的浮點數(shù)運算，包括加減乘除和四舍五入。
   */
  // 默認除法運算精度
  private static final int DEF_DIV_SCALE = 10;

  // 這個類不能實例化
  private ArithmeticUtiles() {
  }

  /**
   * 提供精確的加法運算
   * 
   * @param v1
   *      被加數(shù)
   * @param v2
   *      加數(shù)
   * @return 兩個參數(shù)的和
   */
  public static double add(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(Double.toString(v1));
    BigDecimal b2 = new BigDecimal(Double.toString(v2));
    return b1.add(b2).doubleValue();
  }

  /**
   * 提供精確的減法運算
   * 
   * @param v1
   *      被減數(shù)
   * @param v2
   *      減數(shù)
   * @return 兩個參數(shù)的差
   */
  public static double sub(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(Double.toString(v1));
    BigDecimal b2 = new BigDecimal(Double.toString(v2));
    return b1.subtract(b2).doubleValue();
  }

  /**
   * 提供精確的乘法運算
   * 
   * @param v1
   *      被乘數(shù)
   * @param v2
   *      乘數(shù)
   * @return 兩個參數(shù)的積
   */
  public static double mul(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(Double.toString(v1));
    BigDecimal b2 = new BigDecimal(Double.toString(v2));
    return b1.multiply(b2).doubleValue();
  }

  /**
   * 提供（相對）精確的除法運算，當發(fā)生除不盡的情況時，精確到 小數(shù)點以后10位，以后的數(shù)字四舍五入
   * 
   * @param v1
   *      被除數(shù)
   * @param v2
   *      除數(shù)
   * @return 兩個參數(shù)的商
   */
  public static double div(double v1, double v2) {
    return div(v1, v2, DEF_DIV_SCALE);
  }

  /**
   * 提供（相對）精確的除法運算。當發(fā)生除不盡的情況時，由scale參數(shù)指定精度，以后的數(shù)字四舍五入。
   * 
   * @param v1
   *      被除數(shù)
   * @param v2
   *      除數(shù)
   * @param scale
   *      表示表示需要精確到小數(shù)點以后幾位。
   * @return 兩個參數(shù)的商
   */
  public static double div(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(Double.toString(v1));
    BigDecimal b2 = new BigDecimal(Double.toString(v2));
    return b1.divide(b2, scale, BigDecimal.ROUND_HALF_UP).doubleValue();
  }

  /**
   * 提供精確的小數(shù)位四舍五入處理。
   * 
   * @param v
   *      需要四舍五入的數(shù)字
   * @param scale
   *      小數(shù)點后保留幾位
   * @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(Double.toString(v));
    BigDecimal one = new BigDecimal("1");
    return b.divide(one, scale, BigDecimal.ROUND_HALF_UP).doubleValue();
  }

  /**
   * 提供精確的類型轉換(Float)
   * 
   * @param v
   *      需要被轉換的數(shù)字
   * @return 返回轉換結果
   */
  public static float convertsToFloat(double v) {
    BigDecimal b = new BigDecimal(v);
    return b.floatValue();
  }

  /**
   * 提供精確的類型轉換(Int)不進行四舍五入
   * 
   * @param v
   *      需要被轉換的數(shù)字
   * @return 返回轉換結果
   */
  public static int convertsToInt(double v) {
    BigDecimal b = new BigDecimal(v);
    return b.intValue();
  }

  /**
   * 提供精確的類型轉換(Long)
   * 
   * @param v
   *      需要被轉換的數(shù)字
   * @return 返回轉換結果
   */
  public static long convertsToLong(double v) {
    BigDecimal b = new BigDecimal(v);
    return b.longValue();
  }

  /**
   * 返回兩個數(shù)中大的一個值
   * 
   * @param v1
   *      需要被對比的第一個數(shù)
   * @param v2
   *      需要被對比的第二個數(shù)
   * @return 返回兩個數(shù)中大的一個值
   */
  public static double returnMax(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(v1);
    BigDecimal b2 = new BigDecimal(v2);
    return b1.max(b2).doubleValue();
  }

  /**
   * 返回兩個數(shù)中小的一個值
   * 
   * @param v1
   *      需要被對比的第一個數(shù)
   * @param v2
   *      需要被對比的第二個數(shù)
   * @return 返回兩個數(shù)中小的一個值
   */
  public static double returnMin(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(v1);
    BigDecimal b2 = new BigDecimal(v2);
    return b1.min(b2).doubleValue();
  }

  /**
   * 精確對比兩個數(shù)字
   * 
   * @param v1
   *      需要被對比的第一個數(shù)
   * @param v2
   *      需要被對比的第二個數(shù)
   * 
   * @return 如果兩個數(shù)一樣則返回0，如果第一個數(shù)比第二個數(shù)大則返回1，反之返回-1
   */
  public static int compareTo(double v1, double v2) {
    BigDecimal b1 = new BigDecimal(v1);
    BigDecimal b2 = new BigDecimal(v2);
    return b1.compareTo(b2);
  }

}