com.deepoove.poi.config.Configure Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of poi-tl Show documentation
Show all versions of poi-tl Show documentation
Generate word(docx) with template
/*
* Copyright 2014-2020 Sayi
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.deepoove.poi.config;
import java.lang.reflect.Method;
import java.util.EnumMap;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import org.apache.commons.lang3.tuple.Pair;
import org.apache.poi.xddf.usermodel.chart.ChartTypes;
import com.deepoove.poi.exception.RenderException;
import com.deepoove.poi.policy.DocxRenderPolicy;
import com.deepoove.poi.policy.MiniTableRenderPolicy;
import com.deepoove.poi.policy.NumbericRenderPolicy;
import com.deepoove.poi.policy.PictureRenderPolicy;
import com.deepoove.poi.policy.RenderPolicy;
import com.deepoove.poi.policy.TextRenderPolicy;
import com.deepoove.poi.policy.reference.DefaultChartTemplateRenderPolicy;
import com.deepoove.poi.policy.reference.DefaultPictureTemplateRenderPolicy;
import com.deepoove.poi.policy.reference.MultiSeriesChartTemplateRenderPolicy;
import com.deepoove.poi.policy.reference.SingleSeriesChartTemplateRenderPolicy;
import com.deepoove.poi.render.RenderContext;
import com.deepoove.poi.render.compute.DefaultRenderDataComputeFactory;
import com.deepoove.poi.render.compute.RenderDataComputeFactory;
import com.deepoove.poi.resolver.DefaultElementTemplateFactory;
import com.deepoove.poi.resolver.ElementTemplateFactory;
import com.deepoove.poi.template.ChartTemplate;
import com.deepoove.poi.template.MetaTemplate;
import com.deepoove.poi.template.PictureTemplate;
import com.deepoove.poi.util.RegexUtils;
/**
* The config of template
*
* @author Sayi
* @version 1.0.0
*/
public class Configure implements Cloneable {
/**
* regular expression: Chinese, letters, numbers and underscores
*/
public static final String DEFAULT_GRAMER_REGEX = "((#)?[\\w\\u4e00-\\u9fa5]+(\\.[\\w\\u4e00-\\u9fa5]+)*)?";
/**
* template by bind: Highest priority
*/
private final Map CUSTOM_POLICYS = new HashMap();
/**
* template by xwpfRun: Medium priority
*/
private final Map DEFAULT_POLICYS = new HashMap();
/**
* template by xwpfchart: Medium priority
*/
private final Map DEFAULT_CHART_POLICYS = new EnumMap(
ChartTypes.class);
/**
* template by element template: Lowest priority
*/
private final Map, RenderPolicy> DEFAULT_TEMPLATE_POLICYS = new HashMap<>();
/**
* if & for each
*
* eg. {{?user}} Hello, World {{/user}}
*
*/
Pair iterable = Pair.of(GramerSymbol.ITERABLE_START.getSymbol(),
GramerSymbol.BLOCK_END.getSymbol());
/**
* tag prefix
*/
String gramerPrefix = "{{";
/**
* tag suffix
*/
String gramerSuffix = "}}";
/**
* tag regular expression
*/
String grammerRegex = DEFAULT_GRAMER_REGEX;
/**
* the mode of compute tag
*/
ELMode elMode = ELMode.POI_TL_STANDARD_MODE;
/**
* the factory of render data compute
*/
RenderDataComputeFactory renderDataComputeFactory = new DefaultRenderDataComputeFactory(this);
/**
* the factory of resovler run template
*/
ElementTemplateFactory elementTemplateFactory = new DefaultElementTemplateFactory(this);
/**
* the policy of process tag for valid render data error(null or illegal)
*/
ValidErrorHandler handler = new ClearHandler();
/**
* sp el custom static method
*/
Map spELFunction = new HashMap();
Configure() {
plugin(GramerSymbol.TEXT, new TextRenderPolicy());
plugin(GramerSymbol.TEXT_ALIAS, new TextRenderPolicy());
plugin(GramerSymbol.IMAGE, new PictureRenderPolicy());
plugin(GramerSymbol.TABLE, new MiniTableRenderPolicy());
plugin(GramerSymbol.NUMBERIC, new NumbericRenderPolicy());
plugin(GramerSymbol.DOCX_TEMPLATE, new DocxRenderPolicy());
RenderPolicy multiSeriesRenderPolicy = new MultiSeriesChartTemplateRenderPolicy();
plugin(ChartTypes.AREA, multiSeriesRenderPolicy);
plugin(ChartTypes.AREA3D, multiSeriesRenderPolicy);
plugin(ChartTypes.BAR, multiSeriesRenderPolicy);
plugin(ChartTypes.BAR3D, multiSeriesRenderPolicy);
plugin(ChartTypes.LINE, multiSeriesRenderPolicy);
plugin(ChartTypes.LINE3D, multiSeriesRenderPolicy);
plugin(ChartTypes.RADAR, multiSeriesRenderPolicy);
RenderPolicy singleSeriesRenderPolicy = new SingleSeriesChartTemplateRenderPolicy();
plugin(ChartTypes.PIE, singleSeriesRenderPolicy);
plugin(ChartTypes.PIE3D, singleSeriesRenderPolicy);
plugin(PictureTemplate.class, new DefaultPictureTemplateRenderPolicy());
plugin(ChartTemplate.class, new DefaultChartTemplateRenderPolicy());
}
/**
* 创建默认配置
*
* @return
*/
public static Configure createDefault() {
return newBuilder().build();
}
/**
* 构建器
*
* @return
*/
public static ConfigureBuilder newBuilder() {
return new ConfigureBuilder();
}
/**
* 新增或变更语法插件
*
* @param c
* 语法
* @param policy
* 策略
*/
public Configure plugin(char c, RenderPolicy policy) {
DEFAULT_POLICYS.put(Character.valueOf(c), policy);
return this;
}
/**
* 新增或变更语法插件
*
* @param symbol
* 语法
* @param policy
* 策略
* @return
*/
Configure plugin(GramerSymbol symbol, RenderPolicy policy) {
DEFAULT_POLICYS.put(symbol.getSymbol(), policy);
return this;
}
/**
* 新增或者变更对象模板插件
*
* @param clazz
* 对象模板类型
* @param policy
* 策略
* @return
*/
Configure plugin(Class clazz, RenderPolicy policy) {
DEFAULT_TEMPLATE_POLICYS.put(clazz, policy);
return this;
}
/**
* 新增或者变更图表插件
*
* @param chartType
* 图表类型
* @param policy
* 策略
* @return
*/
Configure plugin(ChartTypes chartType, RenderPolicy policy) {
DEFAULT_CHART_POLICYS.put(chartType, policy);
return this;
}
/**
* 自定义模板和策略
*
* @param tagName
* 模板名称
* @param policy
* 策略
*/
public void customPolicy(String tagName, RenderPolicy policy) {
CUSTOM_POLICYS.put(tagName, policy);
}
public RenderPolicy getTemplatePolicy(Class clazz) {
return DEFAULT_TEMPLATE_POLICYS.get(clazz);
}
public RenderPolicy getCustomPolicy(String tagName) {
return CUSTOM_POLICYS.get(tagName);
}
public RenderPolicy getDefaultPolicy(Character sign) {
return DEFAULT_POLICYS.get(sign);
}
public RenderPolicy getChartPolicy(ChartTypes type) {
return DEFAULT_CHART_POLICYS.get(type);
}
public Map getDefaultPolicys() {
return DEFAULT_POLICYS;
}
public Map getCustomPolicys() {
return CUSTOM_POLICYS;
}
public Map getChartPolicys() {
return DEFAULT_CHART_POLICYS;
}
public Set getGramerChars() {
Set ret = new HashSet(DEFAULT_POLICYS.keySet());
// ? /
ret.add(iterable.getKey());
ret.add(iterable.getValue());
return ret;
}
public String getGramerPrefix() {
return gramerPrefix;
}
public String getGramerSuffix() {
return gramerSuffix;
}
public String getGrammerRegex() {
return grammerRegex;
}
public ELMode getElMode() {
return elMode;
}
public ValidErrorHandler getValidErrorHandler() {
return handler;
}
public RenderDataComputeFactory getRenderDataComputeFactory() {
return renderDataComputeFactory;
}
public ElementTemplateFactory getElementTemplateFactory() {
return elementTemplateFactory;
}
public Pair getIterable() {
return iterable;
}
public Map getSpELFunction() {
return spELFunction;
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("Configure Info").append(":\n");
sb.append(" Basic gramer: ").append(gramerPrefix).append(gramerSuffix).append("\n");
sb.append(" If and foreach gramer: ").append(gramerPrefix).append(iterable.getLeft()).append(gramerSuffix);
sb.append(gramerPrefix).append(iterable.getRight()).append(gramerSuffix).append("\n");
sb.append(" EL Mode: ").append(elMode).append("\n");
sb.append(" Regex:").append(grammerRegex).append("\n");
sb.append(" Valid Error Handler: ").append(handler.getClass().getSimpleName()).append("\n");
sb.append(" Default Plugin: ").append("\n");
DEFAULT_POLICYS.forEach((chara, policy) -> {
sb.append(" ").append(gramerPrefix).append(chara.charValue()).append(gramerSuffix);
sb.append("->").append(policy.getClass().getSimpleName()).append("\n");
});
sb.append(" Bind Plugin: ").append("\n");
CUSTOM_POLICYS.forEach((str, policy) -> {
sb.append(" ").append(gramerPrefix).append(str).append(gramerSuffix);
sb.append("->").append(policy.getClass().getSimpleName()).append("\n");
});
sb.append(" Chart Plugin: ").append("\n");
DEFAULT_CHART_POLICYS.forEach((type, policy) -> {
sb.append(" ").append(type);
sb.append("->").append(policy.getClass().getSimpleName()).append("\n");
});
sb.append(" Template Plugin: ").append("\n");
DEFAULT_TEMPLATE_POLICYS.forEach((clazz, policy) -> {
sb.append(" ").append(clazz.getSimpleName());
sb.append("->").append(policy.getClass().getSimpleName()).append("\n");
});
sb.append(" SpELFunction: ").append("\n");
spELFunction.forEach((str, method) -> {
sb.append(" ").append(str);
sb.append("->").append(method.toString()).append("\n");
});
return sb.toString();
}
@Override
protected Configure clone() throws CloneNotSupportedException {
// shallow clone
return (Configure) super.clone();
}
public Configure clone(String prefix, String suffix) throws CloneNotSupportedException {
Configure clone = clone();
clone.gramerPrefix = prefix;
clone.gramerSuffix = suffix;
if (clone.elMode == ELMode.SPEL_MODE) {
clone.grammerRegex = RegexUtils.createGeneral(clone.gramerPrefix, clone.gramerSuffix);
}
return clone;
}
public enum ELMode {
/**
* 标准模式：无法计算表达式时，RenderData默认为null值
*/
POI_TL_STANDARD_MODE,
/**
* 严格模式：无法计算表达式直接抛出异常
*/
POI_TL_STICT_MODE,
/**
* Spring EL模式
*/
SPEL_MODE;
}
public interface ValidErrorHandler {
void handler(RenderContext context);
}
public static class DiscardHandler implements ValidErrorHandler {
@Override
public void handler(RenderContext context) {
// no-op
}
}
public static class ClearHandler implements ValidErrorHandler {
@Override
public void handler(RenderContext context) {
context.getRun().setText("", 0);
}
}
public static class AbortHandler implements ValidErrorHandler {
@Override
public void handler(RenderContext context) {
throw new RenderException("Non-existent variable and a variable with illegal value for "
+ context.getTagSource() + ", data: " + context.getData());
}
}
}