velocity 截取字符串

### 如何在 Velocity 模板中截取字符串 Velocity 是一种基于 Java 的模板引擎，广泛用于动态网页开发和其他文本生成场景。虽然其功能相对 Freemarker 较为简单，但在某些情况下仍然可以实现复杂的操作，比如字符串截取。 #### 使用内置工具类 Velocity 自身并不直接提供类似于 `substring` 或其他高级字符串处理方法的内置支持[^1]。然而，可以通过引入外部工具类或者利用 `$stringTool` 提供的一些基本功能来完成字符串截取的任务。以下是具体实现方式： 1. **借助 Apache Commons Lang 工具库** 如果项目允许依赖第三方库，则可以使用 Apache Commons Lang 中的 `StringUtils` 类来进行字符串操作。将该工具类注册到 Velocity 上下文中即可调用其中的方法。 ```java import org.apache.commons.lang3.StringUtils; public class Main { public static void main(String[] args) throws Exception { VelocityEngine ve = new VelocityEngine(); ve.init(); VelocityContext context = new VelocityContext(); String str = "HelloWorld"; context.put("str", str); context.put("stringUtil", StringUtils.class); // 注册 StringUtils Template t = ve.getTemplate("template.vm"); StringWriter writer = new StringWriter(); t.merge(context, writer); System.out.println(writer.toString()); } } ``` 对应的 Velocity 模板文件 (`template.vm`) 可以如下编写： ```vm $stringUtil.substring($str, 0, 5) ``` 输出结果将是： ``` Hello ``` 2. **自定义工具类** 若不想引入额外的依赖项，还可以创建自己的工具类并将其注入上下文环境。例如： ```java public class CustomStringUtil { public static String substring(String input, int start, int end) { if (input != null && !input.isEmpty()) { return input.substring(start, Math.min(end, input.length())); } return ""; } } ``` 随后，在初始化阶段将此工具类实例化并放入上下文中： ```java context.put("customString", new CustomStringUtil()); ``` 在模板中可以直接调用： ```vm $customString.substring($str, 0, 5) ``` 3. **纯 Velocity 实现（有限制）** 如果既不希望增加任何外部依赖也不愿扩展代码逻辑，仅依靠 Velocity 原生语法的话，可以选择通过循环手动构建子串的方式达成目标。不过这种方式效率较低且不够优雅。 示例代码片段： ```vm #set( $result = "" ) #foreach ($i in [0..4]) #if( $i < $str.length() ) #set( $result = "$result${str.charAt($i)}" ) #end #end $result ``` 此处假设要提取前五个字符作为新字符串的结果。 --- ### 总结 尽管 Velocity 不像 FreeMarker 那样具备丰富的内建函数集，但通过合理运用辅助工具或适当调整架构设计思路，依然能够灵活应对大多数实际需求中的字符串处理任务[^1]。 ```python def example_velocity_substring(input_str, start_index, end_index): """ A Python function simulating string slicing similar to what can be done with custom tools in Velocity. Args: input_str (str): The original string from which a portion will be extracted. start_index (int): Starting index of the slice operation inclusive. end_index (int): Ending index exclusive. Returns: str: Extracted part of the given string based on indices provided. """ result = "" for i in range(max(0, min(len(input_str), start_index)), max(0, min(len(input_str), end_index))): result += input_str[i] return result ```