收益率计算年利率以及每期租金

前提

在我们上个版本迭代中、有个需求是通过给定的收益率计算年利率以及租金、本息拆分的需求、如果是财务人员或者相关的业务同事、
直接拿EXCEL会比较轻松的算出结果、但我们不一样啊、我们是写代码的、要根据他们的需求通过代码的方式实现、首先我用百度查、
百分之九十九不符合我们的业务场景、大多数的博客以及论坛都是直接拿年利率去计算租金、然后通过期利率再进行本息拆分、然后
科学搜索奇奇怪怪的方法很多、但是这其中我还去了github以及stack overflow查找相关的demo或者问答、也都没有相符合的、
最后也只是在Apache官网找到了一个比较官方的通过年利率计算租金的公式、在一筹莫展之际、我们PM给出了思路、目前已知收益
率和还款时间、采用二分法分解年利率、计算出每期租金、然后通过计算出的租金以及还款时间根据XIRR公式计算出的收益率与已知
的收益率相一致、可以认定计算结果是正确的。
最终根据PM的思路以及帮助、完成了代码的实现、财务验收的时候、没有发现问题。以下是实现的代码。

代码

计算逻辑类

package com.songod;

import java.math.BigDecimal;
import java.math.MathContext;
import java.math.RoundingMode;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.time.LocalDate;
import java.util.ArrayList;
import java.util.Date;
import java.util.LinkedList;
import java.util.List;

import org.apache.commons.collections4.CollectionUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.poi.ss.formula.functions.FinanceLib;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

/**
 *@author Accelerator
 *@date 2020年7月25日 
 *@description 
*/
@Component
public class Calculate {
	
	//求解执行最大尝试次数
	public static final int maxLimit = 5000;
	
	//日志
	private static final Logger LOG = LoggerFactory.getLogger(Calculate.class);
	
	/**
	 * 
	 * @author Accelerator
	 * @date 2020年7月25日 下午2:10:34
	 * @param target		目标值
	 * @param max			变量初始化最大值
	 * @param min			变量初始化最小值
	 * @param errorRange	误差
	 * @param obj			测算所有其他数据
	 * @return
	 * @throws ParseException 
	 * @description 		通过对年利率二分法算出租金、再算出XIRR与目标值做对比
	 */
	public BigDecimal getResult(BigDecimal target,BigDecimal max,BigDecimal min,BigDecimal errorRange,CalculateBean obj) throws ParseException {
		
		BigDecimal temp = new BigDecimal(0);
		BigDecimal result = new BigDecimal(0);
		BigDecimal stepNum = new BigDecimal(2);
		//遍历
		for (int i = 1; i <= maxLimit; i++) {
			temp = max.add(min).divide(stepNum,MathContext.DECIMAL128);
			result = calculateDetail(temp,obj);
			//如果(目标值-函数值)的绝对值 - 差误值<=零 则认定计算正确
			if(result.subtract(target).abs().compareTo(errorRange) <= 0) {
				LOG.info("单变量求解执行结果小于误差: target:{} - max:{} - min:{} - errorRange:{} - 执行次数:{}",target,max,min,errorRange,i);
				break;
			} else if(result.compareTo(target) > 0) {
				max = temp;
			} else if(result.compareTo(target) < 0) {
				min = temp;
			} else if(result.compareTo(target) == 0) {
				//如果计算值 = 目标值 则认定计算正确
				LOG.info("单变量求解执行结果没有误差: target:{} - max:{} - min:{} - errorRange:{} - 执行次数:{}",target,max,min,errorRange,i);
				break;
			}
			
			//如果上方两个条件均未满足、则以执行最大次数结果为终值
			if(i == maxLimit) {
				LOG.info("单变量求解执行结果执行最大次数: target:{} - max:{} - min:{} - errorRange:{} - 执行次数:{}",target,max,min,errorRange,i);
			}
		}
		
		return temp;
		
	}

	/**
	 * 
	 * @author Accelerator
	 * @date 2020年7月25日 下午2:40:03
	 * @param temp 		二分年利率值
	 * @param obj		测算对象数据
	 * @return
	 * @throws ParseException 
	 * @description 
	 */
	public BigDecimal calculateDetail(BigDecimal temp,CalculateBean calculateBean) throws ParseException {