010_数字内建函数

最新推荐文章于 2024-09-09 13:13:39 发布

原创最新推荐文章于 2024-09-09 13:13:39 发布 · 640 阅读

0 ·

CC 4.0 BY-SA版权

FreeMarker学习专栏收录该内容

24 篇文章

订阅专栏

本文详细介绍了FreeMarker模板语言中用于数字处理的内建函数，包括`abs`、`c`、`lower_abc`、`upper_abc`、`round`、`floor`、`ceiling`和`string`等。这些函数用于获取数字的绝对值、转换数字为字符串、进行列标签转换、四舍五入、取整等操作。还给出了Java代码示例以及HTML模板的使用，展示了如何在实际项目中应用这些函数。

1. abs

1.1. 给出数字的绝对值。

2. c(当被用作是数字值时)

2.1. 该内建函数将"计算机语言"的数字转换成字符串, 这都是对计算机来说的, 而不是对用户。也就是说, 它根据程序语言的用法来进行格式化, 这对于FreeMarker的所有本地数字格式化设置来说是独立的。它通常使用点来作为小数分隔符, 而且它从来不用分组分隔符(像3,000,000)。

2.2. 它最多在小数点后打印16位。

2.3. 该内建函数非常严格, 因为作为默认(像${x}这样)数字被本地(语言, 国家)特定的数字格式转换为字符串, 这是让用户来看的(比如3000000可能会被打印为3,000,000)。

2.4. 中国本地显示

2.5. 德国本地显示(德国小数点使用逗号, 分隔符使用点号)

3. lower_abc

3.1. 将1, 2, 3等..., 转换为字符串"a", "b", "c"等...当到达"z"时, 那么会继续转换成如: "aa", "ab"等...这和电子表格应用程序(比如Excel或Calc)的列标签有着相同的逻辑。数字的最小值是1。没有上限值。如果数字是0或更小或它不是整数, 那么模板处理将会中止并发生错误。

4. upper_abc

4.1. 和lower_abc相同, 但是它转换成大写字母, 比如: "A", "B", "C", … , "AA", "AB", 等...

5. round

5.1. round: 返回最近的整数。如果数字以.5结尾, 那么它将进位(也就是向正无穷方向进位)。

6. floor

6.1. floor: 返回数字的舍掉小数后的整数(也就是向负无穷舍弃)。

7. ceiling

7.1. ceiling: 返回数字小数进位后的整数(也就是向正无穷进位)。

8. string(当用作是数字类型时)

8.1. 将一个数字转换成字符串。它使用程序员通过number_format和locale设置的默认格式。也可以明确地用这个内建函数再指定一个数字格式。

8.2. 有四种预定义的数字格式: computer, currency(货币), number和percent。这些格式的明确含义是本地化(国家)指定的, 受Java平台安装环境所控制, 而不是FreeMarker。

8.3. computer和c内建函数是相同的格式。

8.4. Java数字格式语法(java.text.DecimalFormat)

8.4.1. pattern="0", 这里的0代表数字, 如果number的位数大于等于pattern的0的个数, result=number。否则不够的位数以0填充。

8.4.2. #号和0的含义相同, 都是代表数字, 不同的是其不会用0填充, 不够位数就不显示。

8.4.3. E使用科学计数法。

8.4.4. 在金融和统计学实践中, 四舍五入都是根据所谓的一半原则, 这就意味着对最近的"邻居"进行四舍五入, 除非离两个邻居距离相等, 这种情况下, 它四舍五入到偶数的邻居。

9. 例子

9.1. 新建一个名为FMBuiltInsForNumber的动态Web工程, 同时添加相关jar包。

9.2. 编写FMFactory.java

package com.fm.util;

import java.util.Locale;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import freemarker.template.Configuration;
import freemarker.template.TemplateExceptionHandler;

public class FMFactory {
	private final static FMFactory instance = new FMFactory();
	private FMFactory() {}
	public static FMFactory getInstance() {
		return instance;
	}
	
	private Map<String, Configuration> map = new ConcurrentHashMap<String, Configuration>();
	
	// 创建单个Configuration实例
	public synchronized Configuration getCfg(Object servletContext, String path) {
		if(null != map.get(path)) {
			return map.get(path);
		}
		Configuration cfg = new Configuration(Configuration.VERSION_2_3_22);
		cfg.setServletContextForTemplateLoading(servletContext, path);
		cfg.setDefaultEncoding("utf-8");
		// 数值格式化模式
		cfg.setNumberFormat("computer");
		// 本地化设置, 中文中国
		cfg.setLocale(Locale.CHINA);
		cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
		map.put(path, cfg);
		
		return cfg;
	}
	
}

9.3. 编写FMBuiltInsForNumber.java

package com.fm.action;

import java.io.IOException;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.HashMap;
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.fm.util.FMFactory;
import freemarker.template.Configuration;
import freemarker.template.Template;
import freemarker.template.TemplateException;

public class FMBuiltInsForNumber extends HttpServlet {
	private static final long serialVersionUID = 1L;

	@Override
	protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		Configuration cfg = FMFactory.getInstance().getCfg(req.getServletContext(), "/WEB-INF/templates");
		Template template = cfg.getTemplate("builtinsfornumber.html");
		
		Map<String, Object> root = new HashMap<String, Object>();
		Writer out = new OutputStreamWriter(resp.getOutputStream());
		try {
			template.process(root, out);
		} catch (TemplateException e) {
			e.printStackTrace();
		}
	}
	
	@Override
	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		doGet(req, resp);
	}
}

9.4. 修改web.xml

9.5. 在/WEB-INF/templates下编写builtinsfornumber.html

<!DOCTYPE html>
<html>
	<head>
		<meta charset="UTF-8" />
		<title>数字内建函数</title>
	</head>
	<body>
		<h2>给出数字的绝对值</h2>
		${-5?abs}
		<h2>c(当被用作是数字值时)</h2>
		300000: ${300000}<br />
		0.333333333333333333355555555: ${0.333333333333333333355555555}<br />
		300000?c: ${300000?c}<br />
		0.333333333333333333355555555?c: ${0.333333333333333333355555555?c}
		<h2>将1, 2, 3等..., 转换为字符串"a", "b", "c"等</h2>
		<#list 1..30 as n>${n?lower_abc} </#list>
		<h2>将1, 2, 3等..., 转换为字符串"A", "B", "C"等</h2>
		<#list 1..30 as n>${n?upper_abc} </#list>
		<h2>返回最近的整数</h2>
		${3.1?round}<br />
		${3.5?round}<br />
		${3.9?round}
		<h2>返回数字的舍掉小数后的整数</h2>
		${3.1?floor}<br />
		${3.5?floor}<br />
		${3.9?floor}
		<h2>返回数字小数进位后的整数</h2>
		${3.1?ceiling}<br />
		${3.5?ceiling}<br />
		${3.9?ceiling}
		<h2>string(当用作是数字类型时)</h2>
		<#assign x=4200>
		${x}<br />
		<#-- the same as ${x} -->
		string: ${x?string}<br />  
		string.computer: ${x?string.computer}<br />
		<#-- string.currency货币格式 -->
		string.currency: ${x?string.currency}<br />
		string.number: ${x?string.number}<br />
		string.percent: ${x?string.percent}
		${x?string["0"]}<br /><br />
		1.234使用"0.#"模式: ${1.234?string["0.#"]}<br />
		1.234使用"0.##"模式: ${1.234?string["0.##"]}<br />
		1.234使用"0.###"模式: ${1.234?string["0.###"]}<br />
		1.234使用"0.####"模式: ${1.234?string["0.####"]}<br /><br />
		1使用"000.00"模式: ${1?string["000.00"]}<br />
		12.1使用"000.00"模式: ${12.1?string["000.00"]}<br />
		123.456使用"000.00"模式: ${123.456?string["000.00"]}<br /><br />
		1.2使用"0"模式: ${1.2?string["0"]}<br />
		1.8使用"0"模式: ${1.8?string["0"]}<br />
		1.5使用"0"模式: ${1.5?string["0"]}<br />
		2.5使用"0"模式: ${2.5?string["0"]}<br /><br />
		12345使用"0.##E0"模式: ${12345?string["0.##E0"]}
	</body>
</html>

9.6. 运行项目