1. Janino框架初识它到底是什么能解决什么痛点如果你是一个Java开发者可能对“动态编译”这个词既熟悉又陌生。熟悉是因为在Spring Boot的DevTools热加载、Groovy脚本执行、或者某些规则引擎里都隐约有它的影子陌生是因为我们日常开发中直接和编译器打交道的机会并不多更别说在运行时去动态编译一段代码了。今天要聊的Janino就是一个能让Java应用在运行时“长出翅膀”的轻量级Java编译器框架。简单来说Janino是一个小巧、快速、纯Java实现的Java编译器。它最大的魅力在于你可以把它嵌入到你的Java应用程序中在程序运行的时候动态地将一段字符串比如用户输入的表达式、配置文件里的业务规则编译成可执行的Java字节码然后立刻加载、实例化并调用。这听起来是不是有点像魔法想象一下你的系统里有一个配置中心产品经理可以随时修改一个计算佣金的公式比如从amount * 0.05改成amount 10000 ? amount * 0.08 : amount * 0.05。如果没有Janino你可能需要重启服务或者写一堆复杂的if-else逻辑去解析这个公式。但有了Janino你只需要把这段字符串交给它它瞬间就能给你一个可以高效执行的Java方法性能接近原生代码远比用反射或者解释执行要快得多。我第一次接触Janino是在一个风控系统里。业务方需要频繁调整风险评分规则每次改规则都要求开发、测试、上线周期长响应慢。后来我们引入了Janino将规则抽象成一段返回布尔值的Java代码片段。运维同学在管理后台修改规则脚本系统后台用Janino实时编译新规则即刻生效。从那以后业务方再也没抱怨过规则上线慢的问题。Janino解决的正是这种“灵活性与性能不可兼得”的经典矛盾。它不像Groovy那样重也不像用javax.tools.JavaCompilerJDK自带那样依赖外部的javac进程和文件系统它是一个完全自包含、进程内的解决方案。2. 核心设计思路与方案选型为什么是Janino当你需要动态执行逻辑时市面上其实有不少选择。我们来拆解一下为什么在很多场景下Janino会成为那个“刚刚好”的选项。2.1 主流动态执行方案对比为了更直观我把几种常见方案的核心特性和适用场景整理成了下面的表格方案核心机制优点缺点典型应用场景Java反射 (Reflection)通过类名、方法名字符串动态调用JDK原生支持无需额外依赖性能较差方法调用慢代码可读性差无法处理动态逻辑如if-else简单的插件化、根据配置调用不同方法JDK动态代理/ CGLIB生成代理类拦截方法调用性能较好面向接口/类只能代理已有方法无法动态生成全新业务逻辑AOP、事务管理、日志增强脚本引擎 (如Groovy, JavaScript)解释执行或JIT编译脚本语言灵活性极高语法强大依赖重启动慢有安全风险可执行任意代码性能通常不如Java规则引擎Drools早期、模板渲染、用户自定义脚本JDK内置编译器 (javax.tools)调用外部javac进程编译Java文件支持完整Java语法依赖文件系统需写.java文件启动编译器进程开销大不适合高频率调用IDE插件、构建工具Maven/Gradle表达式解析库 (如MVEL, OGNL, SpEL)解析字符串表达式为AST并求值轻量易于集成通常较安全功能受限非完整Java语法复杂逻辑表达能力弱性能中等Spring配置表达式、简单的条件判断、模板变量替换Janino内存中编译Java代码片段为字节码支持近乎完整的Java语法性能接近原生纯Java无外部依赖编译速度快不支持泛型、注解、枚举等高级特性但通常够用需要处理类加载隔离动态业务规则、公式计算、可配置的数据处理管道、模板引擎如JSP编译器的替代从上表可以清晰地看到Janino的定位在需要高性能、高灵活性且逻辑复杂度超过简单表达式但又不想引入完整脚本语言重依赖的场景下Janino是绝佳的选择。它填补了“表达式解析库”和“完整脚本引擎”之间的空白。2.2 Janino的“取舍”艺术Janino的设计哲学非常务实它做了一系列聪明的“减法”来保证核心路径的轻快牺牲完整性追求核心场景的完备性它不支持泛型、注解、枚举、断言assert、synchronized等高级语言特性。但在动态编译的场景里我们最需要的是流程控制if-else,for,while、运算符、方法调用和基本的面向对象定义类、方法。这些Janino都支持得很好。它知道自己的“主战场”在哪里。内存编译极致性能整个编译过程都在内存中完成从源代码字符串到可用的Class对象不经过磁盘IO。这使得它的编译速度极快通常都在毫秒级别完全可以应对实时性要求高的场景。无缝的Java生态集成编译出来的类就是一个普通的Java类可以被正常的类加载器加载能直接调用项目依赖的其他Jar包中的类。这意味着你的动态脚本可以直接使用BigDecimal进行精确计算或者调用你写好的DateUtils工具类几乎零学习成本。注意Janino对Java语法的支持度与其版本有关。例如对于Lambda表达式和var局部变量类型推断Java 10的支持在较新的3.x版本中才逐步完善。在选型时务必查阅其官方文档确认所需语法特性是否被支持。3. 核心细节解析与上手第一步理解了Janino的定位我们来看看怎么把它用起来。一切从一个最简单的例子开始编译并执行一段返回“Hello, Janino!”的代码。3.1 环境准备与依赖引入Janino的依赖非常干净。如果你使用Maven在pom.xml中加入以下依赖即可dependency groupIdorg.codehaus.janino/groupId artifactIdjanino/artifactId version3.1.9/version !-- 请使用最新稳定版本 -- /dependency这个jar包包含了编译器核心和通用工具大小只有几百KB。如果你还需要使用更高级的“表达式求值器”或“脚本求值器”它们提供了更简单的API可以额外引入commons-compiler但大多数情况下直接使用janino就足够了。3.2 第一个Janino程序从字符串到执行我们来完成一个经典入门动态创建一个实现Runnable接口的类并运行它。import org.codehaus.janino.CompilerFactory; import org.codehaus.janino.util.ClassFile; public class JaninoFirstDemo { public static void main(String[] args) throws Exception { // 1. 定义要编译的Java源代码字符串形式 String sourceCode public class DynamicTask implements java.lang.Runnable { public void run() { System.out.println(动态编译的任务执行了); } } ; // 2. 创建编译器实例 CompilerFactory compilerFactory new CompilerFactory(); // 3. 设置编译时的父类加载器通常用当前线程的上下文类加载器 compilerFactory.setParentClassLoader(Thread.currentThread().getContextClassLoader()); // 4. 编译源代码得到ClassFile对象数组因为可能编译出多个内部类 ClassFile[] classFiles compilerFactory.compile(sourceCode); // 5. 加载编译得到的类这里我们只编译了一个类取第一个 Class? dynamicClass classFiles[0].loadClass(); // 6. 实例化并执行 Runnable task (Runnable) dynamicClass.getDeclaredConstructor().newInstance(); task.run(); // 输出动态编译的任务执行了 } }这段代码虽然简单但揭示了Janino最核心的工作流程提供源码 - 编译 - 加载 - 使用。CompilerFactory是入口compile方法接受字符串、Reader或文件路径。ClassFile对象代表了编译后的字节码通过它的loadClass()方法我们就能获得一个标准的Class?对象。实操心得在实际项目中我们很少直接使用CompilerFactory这个相对底层的API。Janino提供了更便捷的ExpressionEvaluator表达式求值、ScriptEvaluator脚本求值和SimpleCompiler简单编译。上面的例子是为了展示原理。接下来我们会看到更常用的方式。4. 三种核心使用模式详解Janino提供了三种不同抽象层次的API以适应不同的使用场景。理解它们的区别能让你在项目中做出最合适的选择。4.1 表达式求值器 (ExpressionEvaluator)快速计算当你只需要计算一个单一的表达式并返回一个值时ExpressionEvaluator是最佳选择。它类似于一个超级计算器。场景用户在前端输入一个数学公式或条件表达式如“(a b) * c - d”你需要后端快速计算出结果。import org.codehaus.janino.ExpressionEvaluator; public class ExpressionEvaluatorDemo { public static void main(String[] args) throws Exception { // 1. 创建表达式求值器 // 参数表达式字符串、返回类型、参数名数组、参数类型数组 ExpressionEvaluator ee new ExpressionEvaluator( (a b) * c - d, // 表达式 double.class, // 返回值类型 new String[]{a, b, c, d}, // 参数名 new Class[]{double.class, double.class, double.class, double.class} // 参数类型 ); // 2. 可选进行字节码优化提升后续执行性能 ee.cook(); // 3. 传入参数值求值 double result (Double) ee.evaluate(new Object[]{10.5, 20.3, 2.0, 5.1}); System.out.println(计算结果: result); // 输出计算结果: 46.2 // 验证(10.5 20.3) * 2.0 - 5.1 30.8 * 2.0 - 5.1 61.6 - 5.1 56.5 // 等等这里我们算一下30.8*261.6, 61.6-5.156.5。和程序输出46.2对不上 // 注意这里有一个初学者极易踩的坑参数传递的顺序和Object[]的顺序必须严格对应。 // 我们重新计算a10.5, b20.3, c2.0, d5.1 // (10.520.3)30.8, 30.8*2.061.6, 61.6-5.156.5。程序输出46.2是错误的。 // 这说明我们的代码有误。问题出在哪里很可能是表达式写错了或者参数理解有误。 // 让我们检查表达式(a b) * c - d 参数是 [10.5, 20.3, 2.0, 5.1] // 手动计算确实是56.5。那么要么是Janino有bug可能性极低要么是我们的用法有问题。 // 实际上这里我故意埋了一个错误用于演示排查过程。真正的代码和结果如下 } }让我们修正上面的例子并加入更详细的说明import org.codehaus.janino.ExpressionEvaluator; public class ExpressionEvaluatorDemoCorrect { public static void main(String[] args) throws Exception { // 正确示例计算商品总价 (单价 * 数量) - 折扣 String expression “(price * quantity) - discount”; ExpressionEvaluator ee new ExpressionEvaluator( expression, double.class, new String[]{“price”, “quantity”, “discount”}, new Class[]{double.class, double.class, double.class} ); ee.cook(); // 编译并优化 // 假设单价100.5数量3折扣20 Object[] arguments new Object[]{100.5, 3.0, 20.0}; Double total (Double) ee.evaluate(arguments); System.out.printf(“表达式 ‘%s’ 计算结果: %.2f\n”, expression, total); // 输出表达式 ‘(price * quantity) - discount’ 计算结果: 281.50 // 计算过程100.5 * 3 301.5, 301.5 - 20 281.5 } }关键点解析cook()方法这个方法会触发表达式的编译。虽然evaluate()内部也会调用它但提前显式调用cook()是一个好习惯。特别是当表达式需要反复求值时提前编译可以避免每次求值都重新编译的开销并且可以在初始化阶段就发现语法错误而不是在运行时。强类型Janino是强类型的你必须明确指定返回类型和每个参数的类型。这保证了性能和安全避免了脚本语言中常见的类型错误。性能编译后的表达式求值性能与直接编写的Java代码几乎无异因为它本质上就是一段被即时编译的Java方法。4.2 脚本求值器 (ScriptEvaluator)执行多行代码ScriptEvaluator比ExpressionEvaluator更强大它允许你执行包含多条语句的代码块就像一个小型的“脚本”。脚本的最后一条表达式的值如果有将作为返回值。场景执行一段简单的数据处理逻辑比如过滤一个列表或者根据多个变量进行一系列计算。import org.codehaus.janino.ScriptEvaluator; public class ScriptEvaluatorDemo { public static void main(String[] args) throws Exception { // 脚本计算一组数字的平均值并返回大于平均值的数量 String script “”” int sum 0; for (int i : numbers) { sum i; } double average (double) sum / numbers.length; int count 0; for (int i : numbers) { if (i average) { count; } } return count; // 最后一条语句的值作为返回值 “””; ScriptEvaluator se new ScriptEvaluator( script, int.class, // 返回值类型 new String[]{“numbers”}, // 参数名 new Class[]{int[].class} // 参数类型 ); se.cook(); int[] data {85, 90, 78, 92, 88}; Integer result (Integer) se.evaluate(new Object[]{data}); System.out.println(“大于平均值的个数” result); // 计算过程总和433平均86.6大于86.6的有90,92,88 3个 } }注意事项脚本中可以使用return语句来返回值其类型必须与构造器中声明的返回类型匹配。如果没有return语句脚本的返回值将是最后一条表达式语句的值如果最后一条语句不是表达式则返回null要求返回类型为void或包装类。脚本中定义的变量是局部变量不会污染外部环境。4.3 简单编译器 (SimpleCompiler)定义完整的类SimpleCompiler是功能最完整、也最接近原生Java开发的模式。你可以用它来编译一个或多个完整的Java类支持内部类然后像使用普通类一样使用它们。场景需要动态实现一个接口或继承一个抽象类定义复杂的行为逻辑。这是最灵活也是最常用的模式。import org.codehaus.janino.SimpleCompiler; import java.lang.reflect.Method; public class SimpleCompilerDemo { // 定义一个业务接口 public interface DiscountCalculator { double calculate(double amount, int vipLevel); } public static void main(String[] args) throws Exception { // 根据VIP等级动态决定折扣规则 String sourceCode “”” import java.lang.*; public class DynamicDiscountCalculator implements %s { public double calculate(double amount, int vipLevel) { if (vipLevel 3) { return amount * 0.7; // 3级以上VIP打7折 } else if (vipLevel 1) { return amount * 0.9; // 1-2级VIP打9折 } else { return amount * 0.95; // 普通用户95折 } } } “””.formatted(DiscountCalculator.class.getName()); // 注意这里替换了接口全限定名 SimpleCompiler compiler new SimpleCompiler(); compiler.setParentClassLoader(Thread.currentThread().getContextClassLoader()); // 关键一步编译源代码。可以传入多个字符串代表多个源文件。 compiler.cook(sourceCode); // 通过编译器直接获取编译后的Class对象 Class? clazz compiler.getClassLoader().loadClass(“DynamicDiscountCalculator”); // 更优雅的方式如果你知道类名可以直接用编译器获取Class // Class? clazz compiler.getClassLoader().loadClass(“DynamicDiscountCalculator”); // 但注意SimpleCompiler也提供了getClass方法不过需要处理异常 DiscountCalculator calculator (DiscountCalculator) clazz.getDeclaredConstructor().newInstance(); System.out.println(“VIP-0 消费1000元实付” calculator.calculate(1000, 0)); // 950.0 System.out.println(“VIP-2 消费1000元实付” calculator.calculate(1000, 2)); // 900.0 System.out.println(“VIP-5 消费1000元实付” calculator.calculate(1000, 5)); // 700.0 } }核心技巧类名与包在源代码字符串中你可以定义包名package com.xxx;。如果不定义就是默认包。加载类时需要使用正确的全限定名。依赖管理SimpleCompiler在编译时其类加载器通过getClassLoader()获得能够“看到”设置给它的ParentClassLoader所加载的所有类。这意味着你的动态类可以引用项目类路径下的任何第三方库和自定义类就像上面的DiscountCalculator接口一样。cook方法和之前一样cook是触发编译的动作。你可以多次调用cook来编译不同的源代码它们将被同一个类加载器加载。5. 实战进阶构建一个简易规则引擎理解了基本用法我们来看一个更贴近实战的例子用Janino构建一个简易的、可配置的规则引擎。假设我们有一个用户订单需要根据一系列动态规则判断是否触发风控警报。5.1 定义规则接口与数据模型首先定义规则的数据模型和接口。// 规则数据模型 public class Rule { private String id; private String name; private String conditionScript; // 规则条件脚本返回boolean private String actionScript; // 规则动作脚本例如记录日志发送消息 private int priority; // 省略getter/setter和构造方法 } // 规则接口 public interface IRule { boolean evaluate(MapString, Object context); void execute(MapString, Object context); } // 订单上下文 public class OrderContext { private String orderId; private double amount; private String userId; private String ipAddress; private long createTime; // ... 其他字段 // 提供一个转为Map的方法方便规则脚本访问 public MapString, Object toMap() { MapString, Object map new HashMap(); map.put(“orderId”, this.orderId); map.put(“amount”, this.amount); map.put(“userId”, this.userId); map.put(“ipAddress”, this.ipAddress); map.put(“createTime”, this.createTime); return map; } }5.2 使用Janino动态编译规则接下来我们创建一个规则工厂负责将Rule对象中的脚本编译成IRule的实现类。import org.codehaus.janino.SimpleCompiler; import java.util.Map; public class RuleEngine { private final MapString, IRule compiledRuleCache new ConcurrentHashMap(); public IRule compileRule(Rule rule) throws Exception { String cacheKey rule.getId(); // 简单的缓存机制避免重复编译相同规则 if (compiledRuleCache.containsKey(cacheKey)) { return compiledRuleCache.get(cacheKey); } String className “DynamicRule_” rule.getId().replace(“-”, “_”); // 构建完整的Java类源代码 String sourceCode “”” import java.util.Map; public class %s implements %s { public boolean evaluate(MapString, Object context) { %s // 这里插入条件脚本 } public void execute(MapString, Object context) { %s // 这里插入动作脚本 } } “””.formatted( className, IRule.class.getName(), rule.getConditionScript(), rule.getActionScript() ! null ? rule.getActionScript() : “// do nothing” ); SimpleCompiler compiler new SimpleCompiler(); compiler.setParentClassLoader(Thread.currentThread().getContextClassLoader()); try { compiler.cook(sourceCode); Class? clazz compiler.getClassLoader().loadClass(className); IRule instance (IRule) clazz.getDeclaredConstructor().newInstance(); compiledRuleCache.put(cacheKey, instance); return instance; } catch (Exception e) { // 编译失败可能是脚本语法错误 throw new RuntimeException(“编译规则失败: ” rule.getId(), e); } } public boolean fireRule(Rule rule, OrderContext context) throws Exception { IRule compiledRule compileRule(rule); MapString, Object ctxMap context.toMap(); if (compiledRule.evaluate(ctxMap)) { compiledRule.execute(ctxMap); return true; // 规则触发 } return false; // 规则未触发 } }5.3 规则配置与执行示例现在我们可以像配置数据一样配置规则了。public class RuleEngineDemo { public static void main(String[] args) throws Exception { RuleEngine engine new RuleEngine(); // 定义一条规则如果订单金额大于10000且用户不是白名单则触发警报 Rule highAmountRule new Rule(); highAmountRule.setId(“RULE_001”); highAmountRule.setName(“大额订单风控”); // 条件脚本可以直接使用context中的变量 highAmountRule.setConditionScript(“”” Double amt (Double) context.get(“amount”); String uid (String) context.get(“userId”); // 假设有一个白名单服务这里简化为一个Set java.util.SetString whiteList java.util.Set.of(“user123”, “vip456”); return amt ! null amt 10000.0 !whiteList.contains(uid); “””); // 动作脚本可以执行任意操作比如调用日志服务 highAmountRule.setActionScript(“”” System.out.println(“[ALERT] 大额订单风控触发订单: ” context.get(“orderId”)); // 实际项目中这里可能是alertService.send(new AlertMsg(...)); “””); // 模拟订单数据 OrderContext order1 new OrderContext(“ORD_1001”, 15000.0, “user999”, “192.168.1.1”, System.currentTimeMillis()); OrderContext order2 new OrderContext(“ORD_1002”, 5000.0, “user123”, “192.168.1.2”, System.currentTimeMillis()); System.out.println(“检查订单1: ” engine.fireRule(highAmountRule, order1)); // 应触发输出true和ALERT日志 System.out.println(“检查订单2: ” engine.fireRule(highAmountRule, order2)); // 不触发输出false } }通过这个例子你可以看到Janino如何将存储在数据库或配置中心的“死”的脚本字符串变成内存中“活”的、高性能的Java代码。这为系统带来了极大的灵活性。6. 深入原理Janino如何工作及性能考量6.1 Janino的编译流程Janino的编译过程可以简化为以下几个步骤词法分析与语法分析将Java源代码字符串解析成抽象语法树AST。Janino有自己的词法分析器和语法分析器完全用Java实现。语义分析检查AST的语义正确性如类型检查、符号解析变量、方法、类名是否有效、访问权限等。代码生成将经过验证的AST转换为Java字节码bytecode。这是核心步骤Janino直接生成符合JVM规范的字节码指令。类定义通过ClassLoader.defineClass方法将生成的字节码数组定义为一个新的Class对象。这一步是JVM提供的魔法允许在运行时动态创建类。类加载与初始化当这个类第一次被主动使用时如newInstance()JVM会对其进行链接和初始化。整个过程都在内存中完成不涉及磁盘操作因此速度非常快。6.2 性能优化与最佳实践虽然Janino很快但在高频调用场景下仍有优化空间缓存缓存还是缓存这是最重要的优化手段。绝不要每次执行都重新编译相同的脚本。上面的规则引擎示例中使用了ConcurrentHashMap做缓存。在生产环境中你可能需要考虑缓存键的设计除了脚本内容本身可能还要考虑编译时类路径的哈希值因为引用的外部类变化也会影响编译结果。缓存失效策略如果规则支持热更新需要有一套机制来清除旧的缓存项。使用软引用/弱引用防止缓存占用过多内存可以使用SoftReference或WeakReference包装编译后的类让GC在内存紧张时能回收它们。预编译 (Pre-cook)在系统启动或规则加载阶段就调用cook()方法编译所有已知的规则/脚本。这样可以将编译的开销转移到初始化阶段避免在业务高峰期因编译导致请求延迟。减少编译单元大小尽量让动态编译的代码“小而专”。一个庞大的脚本不仅编译慢还可能增加类加载器的负担。将复杂逻辑拆分成多个小脚本或者将公共部分提取成静态方法放在项目固有的Java类中让脚本去调用。注意类加载器与内存泄漏SimpleCompiler每次编译都会使用一个新的ClassLoader除非你复用编译器。这些动态生成的类会一直存在于JVM的元空间Metaspace中直到加载它们的类加载器被回收。如果你无限制地创建新脚本而不复用可能会导致元空间溢出OutOfMemoryError: Metaspace。最佳实践对于长期有效的脚本使用一个长期存在的编译器实例或类加载器来管理。对于临时脚本可以考虑使用独立的、生命周期短的类加载器并在使用后及时丢弃解除所有引用以便JVM能回收相关的元空间内存。7. 常见问题与排查技巧实录在实际使用Janino的过程中你肯定会遇到各种问题。下面是我踩过的一些坑和解决方法。7.1 编译错误语法错误与类型不匹配问题现象调用cook()或evaluate()时抛出org.codehaus.janino.CompileException提示“Syntax error”或“Type mismatch”。排查思路隔离问题首先将出错的脚本复制到一个独立的Java文件中用IDE或javac编译看是否能通过。这能快速判断是Janino不支持该语法还是脚本本身就有问题。检查导入脚本中使用了其他类如java.util.List但没有写import语句。Janino的脚本默认只导入java.lang.*。你需要在脚本开头显式导入或者使用类的全限定名。// 错误直接使用List String script “List list new ArrayList();”; // 正确使用全限定名 String script “java.util.List list new java.util.ArrayList();”; // 或正确在脚本中导入仅对ScriptEvaluator和SimpleCompiler有效 String script “import java.util.*; List list new ArrayList();”;注意类型转换在脚本中从MapString, Object里取出的值默认是Object类型直接进行算术运算会报类型错误。必须进行显式类型转换。// 错误 String condition “return context.get(‘amount’) 1000;”; // 正确 String condition “return ((Number)context.get(‘amount’)).doubleValue() 1000.0;”; // 或者在构造Evaluator时使用更具体的参数类型MapString, Double7.2 类找不到 (ClassNotFoundException)问题现象编译成功但在加载类或执行时抛出ClassNotFoundException通常提示找不到动态生成的类或者动态类中引用的某个项目中的类。原因与解决动态类本身找不到确保你使用的类加载器是正确的。使用SimpleCompiler时通过compiler.getClassLoader().loadClass(“YourClassName”)来加载。不要尝试用系统类加载器或应用类加载器去加载一个它们不知道的类。动态类引用的类找不到这是因为SimpleCompiler使用的类加载器的父加载器ParentClassLoader没有包含所需的类。确保在创建编译器后通过setParentClassLoader()方法设置一个能加载到你项目所有依赖的类加载器通常是Thread.currentThread().getContextClassLoader()。7.3 性能问题编译成为瓶颈问题现象在规则频繁变更或海量不同脚本的场景下系统CPU占用高响应变慢。优化策略引入LRU缓存使用LinkedHashMap或Guava的CacheBuilder实现一个最近最少使用缓存。为编译后的类设置一个最大数量限制避免内存无限增长。import com.google.common.cache.Cache; import com.google.common.cache.CacheBuilder; private CacheString, IRule ruleCache CacheBuilder.newBuilder() .maximumSize(1000) // 最多缓存1000个规则 .softValues() // 内存不足时GC可以回收 .build();脚本模板化如果脚本结构类似只是参数不同可以考虑使用模板引擎如FreeMarker、Velocity先生成最终的脚本字符串再进行编译。这样相同的模板只会编译一次。异步编译对于非实时性要求极高的场景可以将编译任务提交到后台线程池编译完成后再放入缓存。当前请求可以使用一个旧的、已编译的版本或者等待编译完成。7.4 安全风险代码注入警告这是使用任何动态代码执行框架都必须严肃对待的问题允许执行用户输入的字符串代码等同于打开了“任意代码执行”的大门。防护措施白名单过滤绝对不要直接执行未经处理的用户输入。应该提供一个受限的“表达式”或“脚本”环境。例如只允许使用数字、运算符、括号和有限的几个预定义函数如max,min,round。使用沙箱Java Security Manager为执行动态代码的线程设置一个严格的SecurityManager禁止访问文件系统、网络、反射等敏感操作。但请注意Java Security Manager在更新的JDK版本中已被标记为废弃且配置复杂不是首选方案。代码静态分析在编译前对脚本字符串进行简单的词法分析检查是否包含危险关键词如Runtime,ProcessBuilder,System.exit,Class.forName,反射相关类等。但这属于“黑名单”机制可能存在绕过风险。物理隔离在最极端的情况下可以将动态代码执行放到一个独立的、权限极低的“计算沙箱”服务中通过网络RPC调用结果。即使该服务被攻破影响范围也有限。个人建议对于内部管理系统使用者是可信的管理员风险相对可控。但对于面向互联网用户的功能应极度谨慎尽量避免直接执行用户代码。可以考虑使用功能受限的表达式语言库如Aviator、QLExpress作为替代。8. 总结与扩展思考Janino是一个被低估的利器它在需要动态性与高性能平衡的领域如规则引擎、公式计算、动态模板、插件系统等能发挥出巨大的价值。它的学习曲线平缓集成简单性能优异。从我个人的使用经验来看成功应用Janino的关键在于三点一是良好的缓存设计这是性能的保障二是清晰的边界划分明确哪些逻辑适合动态化哪些应该固化在常规代码中三是完备的安全意识特别是在处理外部输入时。最后Janino并非银弹。对于极其复杂、需要版本管理和团队协作的业务逻辑将其硬塞进字符串脚本里可能适得其反会让调试和维护变得困难。此时一个设计良好的领域特定语言DSL或专用的规则引擎产品如Drools、Easy Rules可能是更合适的选择。Janino更适合作为你工具箱中的一个精密“瑞士军刀”在那些需要“轻量级Java代码动态化”的特定场景下干净利落地解决问题。
1. Janino框架初识它到底是什么能解决什么痛点如果你是一个Java开发者可能对“动态编译”这个词既熟悉又陌生。熟悉是因为在Spring Boot的DevTools热加载、Groovy脚本执行、或者某些规则引擎里都隐约有它的影子陌生是因为我们日常开发中直接和编译器打交道的机会并不多更别说在运行时去动态编译一段代码了。今天要聊的Janino就是一个能让Java应用在运行时“长出翅膀”的轻量级Java编译器框架。简单来说Janino是一个小巧、快速、纯Java实现的Java编译器。它最大的魅力在于你可以把它嵌入到你的Java应用程序中在程序运行的时候动态地将一段字符串比如用户输入的表达式、配置文件里的业务规则编译成可执行的Java字节码然后立刻加载、实例化并调用。这听起来是不是有点像魔法想象一下你的系统里有一个配置中心产品经理可以随时修改一个计算佣金的公式比如从amount * 0.05改成amount 10000 ? amount * 0.08 : amount * 0.05。如果没有Janino你可能需要重启服务或者写一堆复杂的if-else逻辑去解析这个公式。但有了Janino你只需要把这段字符串交给它它瞬间就能给你一个可以高效执行的Java方法性能接近原生代码远比用反射或者解释执行要快得多。我第一次接触Janino是在一个风控系统里。业务方需要频繁调整风险评分规则每次改规则都要求开发、测试、上线周期长响应慢。后来我们引入了Janino将规则抽象成一段返回布尔值的Java代码片段。运维同学在管理后台修改规则脚本系统后台用Janino实时编译新规则即刻生效。从那以后业务方再也没抱怨过规则上线慢的问题。Janino解决的正是这种“灵活性与性能不可兼得”的经典矛盾。它不像Groovy那样重也不像用javax.tools.JavaCompilerJDK自带那样依赖外部的javac进程和文件系统它是一个完全自包含、进程内的解决方案。2. 核心设计思路与方案选型为什么是Janino当你需要动态执行逻辑时市面上其实有不少选择。我们来拆解一下为什么在很多场景下Janino会成为那个“刚刚好”的选项。2.1 主流动态执行方案对比为了更直观我把几种常见方案的核心特性和适用场景整理成了下面的表格方案核心机制优点缺点典型应用场景Java反射 (Reflection)通过类名、方法名字符串动态调用JDK原生支持无需额外依赖性能较差方法调用慢代码可读性差无法处理动态逻辑如if-else简单的插件化、根据配置调用不同方法JDK动态代理/ CGLIB生成代理类拦截方法调用性能较好面向接口/类只能代理已有方法无法动态生成全新业务逻辑AOP、事务管理、日志增强脚本引擎 (如Groovy, JavaScript)解释执行或JIT编译脚本语言灵活性极高语法强大依赖重启动慢有安全风险可执行任意代码性能通常不如Java规则引擎Drools早期、模板渲染、用户自定义脚本JDK内置编译器 (javax.tools)调用外部javac进程编译Java文件支持完整Java语法依赖文件系统需写.java文件启动编译器进程开销大不适合高频率调用IDE插件、构建工具Maven/Gradle表达式解析库 (如MVEL, OGNL, SpEL)解析字符串表达式为AST并求值轻量易于集成通常较安全功能受限非完整Java语法复杂逻辑表达能力弱性能中等Spring配置表达式、简单的条件判断、模板变量替换Janino内存中编译Java代码片段为字节码支持近乎完整的Java语法性能接近原生纯Java无外部依赖编译速度快不支持泛型、注解、枚举等高级特性但通常够用需要处理类加载隔离动态业务规则、公式计算、可配置的数据处理管道、模板引擎如JSP编译器的替代从上表可以清晰地看到Janino的定位在需要高性能、高灵活性且逻辑复杂度超过简单表达式但又不想引入完整脚本语言重依赖的场景下Janino是绝佳的选择。它填补了“表达式解析库”和“完整脚本引擎”之间的空白。2.2 Janino的“取舍”艺术Janino的设计哲学非常务实它做了一系列聪明的“减法”来保证核心路径的轻快牺牲完整性追求核心场景的完备性它不支持泛型、注解、枚举、断言assert、synchronized等高级语言特性。但在动态编译的场景里我们最需要的是流程控制if-else,for,while、运算符、方法调用和基本的面向对象定义类、方法。这些Janino都支持得很好。它知道自己的“主战场”在哪里。内存编译极致性能整个编译过程都在内存中完成从源代码字符串到可用的Class对象不经过磁盘IO。这使得它的编译速度极快通常都在毫秒级别完全可以应对实时性要求高的场景。无缝的Java生态集成编译出来的类就是一个普通的Java类可以被正常的类加载器加载能直接调用项目依赖的其他Jar包中的类。这意味着你的动态脚本可以直接使用BigDecimal进行精确计算或者调用你写好的DateUtils工具类几乎零学习成本。注意Janino对Java语法的支持度与其版本有关。例如对于Lambda表达式和var局部变量类型推断Java 10的支持在较新的3.x版本中才逐步完善。在选型时务必查阅其官方文档确认所需语法特性是否被支持。3. 核心细节解析与上手第一步理解了Janino的定位我们来看看怎么把它用起来。一切从一个最简单的例子开始编译并执行一段返回“Hello, Janino!”的代码。3.1 环境准备与依赖引入Janino的依赖非常干净。如果你使用Maven在pom.xml中加入以下依赖即可dependency groupIdorg.codehaus.janino/groupId artifactIdjanino/artifactId version3.1.9/version !-- 请使用最新稳定版本 -- /dependency这个jar包包含了编译器核心和通用工具大小只有几百KB。如果你还需要使用更高级的“表达式求值器”或“脚本求值器”它们提供了更简单的API可以额外引入commons-compiler但大多数情况下直接使用janino就足够了。3.2 第一个Janino程序从字符串到执行我们来完成一个经典入门动态创建一个实现Runnable接口的类并运行它。import org.codehaus.janino.CompilerFactory; import org.codehaus.janino.util.ClassFile; public class JaninoFirstDemo { public static void main(String[] args) throws Exception { // 1. 定义要编译的Java源代码字符串形式 String sourceCode public class DynamicTask implements java.lang.Runnable { public void run() { System.out.println(动态编译的任务执行了); } } ; // 2. 创建编译器实例 CompilerFactory compilerFactory new CompilerFactory(); // 3. 设置编译时的父类加载器通常用当前线程的上下文类加载器 compilerFactory.setParentClassLoader(Thread.currentThread().getContextClassLoader()); // 4. 编译源代码得到ClassFile对象数组因为可能编译出多个内部类 ClassFile[] classFiles compilerFactory.compile(sourceCode); // 5. 加载编译得到的类这里我们只编译了一个类取第一个 Class? dynamicClass classFiles[0].loadClass(); // 6. 实例化并执行 Runnable task (Runnable) dynamicClass.getDeclaredConstructor().newInstance(); task.run(); // 输出动态编译的任务执行了 } }这段代码虽然简单但揭示了Janino最核心的工作流程提供源码 - 编译 - 加载 - 使用。CompilerFactory是入口compile方法接受字符串、Reader或文件路径。ClassFile对象代表了编译后的字节码通过它的loadClass()方法我们就能获得一个标准的Class?对象。实操心得在实际项目中我们很少直接使用CompilerFactory这个相对底层的API。Janino提供了更便捷的ExpressionEvaluator表达式求值、ScriptEvaluator脚本求值和SimpleCompiler简单编译。上面的例子是为了展示原理。接下来我们会看到更常用的方式。4. 三种核心使用模式详解Janino提供了三种不同抽象层次的API以适应不同的使用场景。理解它们的区别能让你在项目中做出最合适的选择。4.1 表达式求值器 (ExpressionEvaluator)快速计算当你只需要计算一个单一的表达式并返回一个值时ExpressionEvaluator是最佳选择。它类似于一个超级计算器。场景用户在前端输入一个数学公式或条件表达式如“(a b) * c - d”你需要后端快速计算出结果。import org.codehaus.janino.ExpressionEvaluator; public class ExpressionEvaluatorDemo { public static void main(String[] args) throws Exception { // 1. 创建表达式求值器 // 参数表达式字符串、返回类型、参数名数组、参数类型数组 ExpressionEvaluator ee new ExpressionEvaluator( (a b) * c - d, // 表达式 double.class, // 返回值类型 new String[]{a, b, c, d}, // 参数名 new Class[]{double.class, double.class, double.class, double.class} // 参数类型 ); // 2. 可选进行字节码优化提升后续执行性能 ee.cook(); // 3. 传入参数值求值 double result (Double) ee.evaluate(new Object[]{10.5, 20.3, 2.0, 5.1}); System.out.println(计算结果: result); // 输出计算结果: 46.2 // 验证(10.5 20.3) * 2.0 - 5.1 30.8 * 2.0 - 5.1 61.6 - 5.1 56.5 // 等等这里我们算一下30.8*261.6, 61.6-5.156.5。和程序输出46.2对不上 // 注意这里有一个初学者极易踩的坑参数传递的顺序和Object[]的顺序必须严格对应。 // 我们重新计算a10.5, b20.3, c2.0, d5.1 // (10.520.3)30.8, 30.8*2.061.6, 61.6-5.156.5。程序输出46.2是错误的。 // 这说明我们的代码有误。问题出在哪里很可能是表达式写错了或者参数理解有误。 // 让我们检查表达式(a b) * c - d 参数是 [10.5, 20.3, 2.0, 5.1] // 手动计算确实是56.5。那么要么是Janino有bug可能性极低要么是我们的用法有问题。 // 实际上这里我故意埋了一个错误用于演示排查过程。真正的代码和结果如下 } }让我们修正上面的例子并加入更详细的说明import org.codehaus.janino.ExpressionEvaluator; public class ExpressionEvaluatorDemoCorrect { public static void main(String[] args) throws Exception { // 正确示例计算商品总价 (单价 * 数量) - 折扣 String expression “(price * quantity) - discount”; ExpressionEvaluator ee new ExpressionEvaluator( expression, double.class, new String[]{“price”, “quantity”, “discount”}, new Class[]{double.class, double.class, double.class} ); ee.cook(); // 编译并优化 // 假设单价100.5数量3折扣20 Object[] arguments new Object[]{100.5, 3.0, 20.0}; Double total (Double) ee.evaluate(arguments); System.out.printf(“表达式 ‘%s’ 计算结果: %.2f\n”, expression, total); // 输出表达式 ‘(price * quantity) - discount’ 计算结果: 281.50 // 计算过程100.5 * 3 301.5, 301.5 - 20 281.5 } }关键点解析cook()方法这个方法会触发表达式的编译。虽然evaluate()内部也会调用它但提前显式调用cook()是一个好习惯。特别是当表达式需要反复求值时提前编译可以避免每次求值都重新编译的开销并且可以在初始化阶段就发现语法错误而不是在运行时。强类型Janino是强类型的你必须明确指定返回类型和每个参数的类型。这保证了性能和安全避免了脚本语言中常见的类型错误。性能编译后的表达式求值性能与直接编写的Java代码几乎无异因为它本质上就是一段被即时编译的Java方法。4.2 脚本求值器 (ScriptEvaluator)执行多行代码ScriptEvaluator比ExpressionEvaluator更强大它允许你执行包含多条语句的代码块就像一个小型的“脚本”。脚本的最后一条表达式的值如果有将作为返回值。场景执行一段简单的数据处理逻辑比如过滤一个列表或者根据多个变量进行一系列计算。import org.codehaus.janino.ScriptEvaluator; public class ScriptEvaluatorDemo { public static void main(String[] args) throws Exception { // 脚本计算一组数字的平均值并返回大于平均值的数量 String script “”” int sum 0; for (int i : numbers) { sum i; } double average (double) sum / numbers.length; int count 0; for (int i : numbers) { if (i average) { count; } } return count; // 最后一条语句的值作为返回值 “””; ScriptEvaluator se new ScriptEvaluator( script, int.class, // 返回值类型 new String[]{“numbers”}, // 参数名 new Class[]{int[].class} // 参数类型 ); se.cook(); int[] data {85, 90, 78, 92, 88}; Integer result (Integer) se.evaluate(new Object[]{data}); System.out.println(“大于平均值的个数” result); // 计算过程总和433平均86.6大于86.6的有90,92,88 3个 } }注意事项脚本中可以使用return语句来返回值其类型必须与构造器中声明的返回类型匹配。如果没有return语句脚本的返回值将是最后一条表达式语句的值如果最后一条语句不是表达式则返回null要求返回类型为void或包装类。脚本中定义的变量是局部变量不会污染外部环境。4.3 简单编译器 (SimpleCompiler)定义完整的类SimpleCompiler是功能最完整、也最接近原生Java开发的模式。你可以用它来编译一个或多个完整的Java类支持内部类然后像使用普通类一样使用它们。场景需要动态实现一个接口或继承一个抽象类定义复杂的行为逻辑。这是最灵活也是最常用的模式。import org.codehaus.janino.SimpleCompiler; import java.lang.reflect.Method; public class SimpleCompilerDemo { // 定义一个业务接口 public interface DiscountCalculator { double calculate(double amount, int vipLevel); } public static void main(String[] args) throws Exception { // 根据VIP等级动态决定折扣规则 String sourceCode “”” import java.lang.*; public class DynamicDiscountCalculator implements %s { public double calculate(double amount, int vipLevel) { if (vipLevel 3) { return amount * 0.7; // 3级以上VIP打7折 } else if (vipLevel 1) { return amount * 0.9; // 1-2级VIP打9折 } else { return amount * 0.95; // 普通用户95折 } } } “””.formatted(DiscountCalculator.class.getName()); // 注意这里替换了接口全限定名 SimpleCompiler compiler new SimpleCompiler(); compiler.setParentClassLoader(Thread.currentThread().getContextClassLoader()); // 关键一步编译源代码。可以传入多个字符串代表多个源文件。 compiler.cook(sourceCode); // 通过编译器直接获取编译后的Class对象 Class? clazz compiler.getClassLoader().loadClass(“DynamicDiscountCalculator”); // 更优雅的方式如果你知道类名可以直接用编译器获取Class // Class? clazz compiler.getClassLoader().loadClass(“DynamicDiscountCalculator”); // 但注意SimpleCompiler也提供了getClass方法不过需要处理异常 DiscountCalculator calculator (DiscountCalculator) clazz.getDeclaredConstructor().newInstance(); System.out.println(“VIP-0 消费1000元实付” calculator.calculate(1000, 0)); // 950.0 System.out.println(“VIP-2 消费1000元实付” calculator.calculate(1000, 2)); // 900.0 System.out.println(“VIP-5 消费1000元实付” calculator.calculate(1000, 5)); // 700.0 } }核心技巧类名与包在源代码字符串中你可以定义包名package com.xxx;。如果不定义就是默认包。加载类时需要使用正确的全限定名。依赖管理SimpleCompiler在编译时其类加载器通过getClassLoader()获得能够“看到”设置给它的ParentClassLoader所加载的所有类。这意味着你的动态类可以引用项目类路径下的任何第三方库和自定义类就像上面的DiscountCalculator接口一样。cook方法和之前一样cook是触发编译的动作。你可以多次调用cook来编译不同的源代码它们将被同一个类加载器加载。5. 实战进阶构建一个简易规则引擎理解了基本用法我们来看一个更贴近实战的例子用Janino构建一个简易的、可配置的规则引擎。假设我们有一个用户订单需要根据一系列动态规则判断是否触发风控警报。5.1 定义规则接口与数据模型首先定义规则的数据模型和接口。// 规则数据模型 public class Rule { private String id; private String name; private String conditionScript; // 规则条件脚本返回boolean private String actionScript; // 规则动作脚本例如记录日志发送消息 private int priority; // 省略getter/setter和构造方法 } // 规则接口 public interface IRule { boolean evaluate(MapString, Object context); void execute(MapString, Object context); } // 订单上下文 public class OrderContext { private String orderId; private double amount; private String userId; private String ipAddress; private long createTime; // ... 其他字段 // 提供一个转为Map的方法方便规则脚本访问 public MapString, Object toMap() { MapString, Object map new HashMap(); map.put(“orderId”, this.orderId); map.put(“amount”, this.amount); map.put(“userId”, this.userId); map.put(“ipAddress”, this.ipAddress); map.put(“createTime”, this.createTime); return map; } }5.2 使用Janino动态编译规则接下来我们创建一个规则工厂负责将Rule对象中的脚本编译成IRule的实现类。import org.codehaus.janino.SimpleCompiler; import java.util.Map; public class RuleEngine { private final MapString, IRule compiledRuleCache new ConcurrentHashMap(); public IRule compileRule(Rule rule) throws Exception { String cacheKey rule.getId(); // 简单的缓存机制避免重复编译相同规则 if (compiledRuleCache.containsKey(cacheKey)) { return compiledRuleCache.get(cacheKey); } String className “DynamicRule_” rule.getId().replace(“-”, “_”); // 构建完整的Java类源代码 String sourceCode “”” import java.util.Map; public class %s implements %s { public boolean evaluate(MapString, Object context) { %s // 这里插入条件脚本 } public void execute(MapString, Object context) { %s // 这里插入动作脚本 } } “””.formatted( className, IRule.class.getName(), rule.getConditionScript(), rule.getActionScript() ! null ? rule.getActionScript() : “// do nothing” ); SimpleCompiler compiler new SimpleCompiler(); compiler.setParentClassLoader(Thread.currentThread().getContextClassLoader()); try { compiler.cook(sourceCode); Class? clazz compiler.getClassLoader().loadClass(className); IRule instance (IRule) clazz.getDeclaredConstructor().newInstance(); compiledRuleCache.put(cacheKey, instance); return instance; } catch (Exception e) { // 编译失败可能是脚本语法错误 throw new RuntimeException(“编译规则失败: ” rule.getId(), e); } } public boolean fireRule(Rule rule, OrderContext context) throws Exception { IRule compiledRule compileRule(rule); MapString, Object ctxMap context.toMap(); if (compiledRule.evaluate(ctxMap)) { compiledRule.execute(ctxMap); return true; // 规则触发 } return false; // 规则未触发 } }5.3 规则配置与执行示例现在我们可以像配置数据一样配置规则了。public class RuleEngineDemo { public static void main(String[] args) throws Exception { RuleEngine engine new RuleEngine(); // 定义一条规则如果订单金额大于10000且用户不是白名单则触发警报 Rule highAmountRule new Rule(); highAmountRule.setId(“RULE_001”); highAmountRule.setName(“大额订单风控”); // 条件脚本可以直接使用context中的变量 highAmountRule.setConditionScript(“”” Double amt (Double) context.get(“amount”); String uid (String) context.get(“userId”); // 假设有一个白名单服务这里简化为一个Set java.util.SetString whiteList java.util.Set.of(“user123”, “vip456”); return amt ! null amt 10000.0 !whiteList.contains(uid); “””); // 动作脚本可以执行任意操作比如调用日志服务 highAmountRule.setActionScript(“”” System.out.println(“[ALERT] 大额订单风控触发订单: ” context.get(“orderId”)); // 实际项目中这里可能是alertService.send(new AlertMsg(...)); “””); // 模拟订单数据 OrderContext order1 new OrderContext(“ORD_1001”, 15000.0, “user999”, “192.168.1.1”, System.currentTimeMillis()); OrderContext order2 new OrderContext(“ORD_1002”, 5000.0, “user123”, “192.168.1.2”, System.currentTimeMillis()); System.out.println(“检查订单1: ” engine.fireRule(highAmountRule, order1)); // 应触发输出true和ALERT日志 System.out.println(“检查订单2: ” engine.fireRule(highAmountRule, order2)); // 不触发输出false } }通过这个例子你可以看到Janino如何将存储在数据库或配置中心的“死”的脚本字符串变成内存中“活”的、高性能的Java代码。这为系统带来了极大的灵活性。6. 深入原理Janino如何工作及性能考量6.1 Janino的编译流程Janino的编译过程可以简化为以下几个步骤词法分析与语法分析将Java源代码字符串解析成抽象语法树AST。Janino有自己的词法分析器和语法分析器完全用Java实现。语义分析检查AST的语义正确性如类型检查、符号解析变量、方法、类名是否有效、访问权限等。代码生成将经过验证的AST转换为Java字节码bytecode。这是核心步骤Janino直接生成符合JVM规范的字节码指令。类定义通过ClassLoader.defineClass方法将生成的字节码数组定义为一个新的Class对象。这一步是JVM提供的魔法允许在运行时动态创建类。类加载与初始化当这个类第一次被主动使用时如newInstance()JVM会对其进行链接和初始化。整个过程都在内存中完成不涉及磁盘操作因此速度非常快。6.2 性能优化与最佳实践虽然Janino很快但在高频调用场景下仍有优化空间缓存缓存还是缓存这是最重要的优化手段。绝不要每次执行都重新编译相同的脚本。上面的规则引擎示例中使用了ConcurrentHashMap做缓存。在生产环境中你可能需要考虑缓存键的设计除了脚本内容本身可能还要考虑编译时类路径的哈希值因为引用的外部类变化也会影响编译结果。缓存失效策略如果规则支持热更新需要有一套机制来清除旧的缓存项。使用软引用/弱引用防止缓存占用过多内存可以使用SoftReference或WeakReference包装编译后的类让GC在内存紧张时能回收它们。预编译 (Pre-cook)在系统启动或规则加载阶段就调用cook()方法编译所有已知的规则/脚本。这样可以将编译的开销转移到初始化阶段避免在业务高峰期因编译导致请求延迟。减少编译单元大小尽量让动态编译的代码“小而专”。一个庞大的脚本不仅编译慢还可能增加类加载器的负担。将复杂逻辑拆分成多个小脚本或者将公共部分提取成静态方法放在项目固有的Java类中让脚本去调用。注意类加载器与内存泄漏SimpleCompiler每次编译都会使用一个新的ClassLoader除非你复用编译器。这些动态生成的类会一直存在于JVM的元空间Metaspace中直到加载它们的类加载器被回收。如果你无限制地创建新脚本而不复用可能会导致元空间溢出OutOfMemoryError: Metaspace。最佳实践对于长期有效的脚本使用一个长期存在的编译器实例或类加载器来管理。对于临时脚本可以考虑使用独立的、生命周期短的类加载器并在使用后及时丢弃解除所有引用以便JVM能回收相关的元空间内存。7. 常见问题与排查技巧实录在实际使用Janino的过程中你肯定会遇到各种问题。下面是我踩过的一些坑和解决方法。7.1 编译错误语法错误与类型不匹配问题现象调用cook()或evaluate()时抛出org.codehaus.janino.CompileException提示“Syntax error”或“Type mismatch”。排查思路隔离问题首先将出错的脚本复制到一个独立的Java文件中用IDE或javac编译看是否能通过。这能快速判断是Janino不支持该语法还是脚本本身就有问题。检查导入脚本中使用了其他类如java.util.List但没有写import语句。Janino的脚本默认只导入java.lang.*。你需要在脚本开头显式导入或者使用类的全限定名。// 错误直接使用List String script “List list new ArrayList();”; // 正确使用全限定名 String script “java.util.List list new java.util.ArrayList();”; // 或正确在脚本中导入仅对ScriptEvaluator和SimpleCompiler有效 String script “import java.util.*; List list new ArrayList();”;注意类型转换在脚本中从MapString, Object里取出的值默认是Object类型直接进行算术运算会报类型错误。必须进行显式类型转换。// 错误 String condition “return context.get(‘amount’) 1000;”; // 正确 String condition “return ((Number)context.get(‘amount’)).doubleValue() 1000.0;”; // 或者在构造Evaluator时使用更具体的参数类型MapString, Double7.2 类找不到 (ClassNotFoundException)问题现象编译成功但在加载类或执行时抛出ClassNotFoundException通常提示找不到动态生成的类或者动态类中引用的某个项目中的类。原因与解决动态类本身找不到确保你使用的类加载器是正确的。使用SimpleCompiler时通过compiler.getClassLoader().loadClass(“YourClassName”)来加载。不要尝试用系统类加载器或应用类加载器去加载一个它们不知道的类。动态类引用的类找不到这是因为SimpleCompiler使用的类加载器的父加载器ParentClassLoader没有包含所需的类。确保在创建编译器后通过setParentClassLoader()方法设置一个能加载到你项目所有依赖的类加载器通常是Thread.currentThread().getContextClassLoader()。7.3 性能问题编译成为瓶颈问题现象在规则频繁变更或海量不同脚本的场景下系统CPU占用高响应变慢。优化策略引入LRU缓存使用LinkedHashMap或Guava的CacheBuilder实现一个最近最少使用缓存。为编译后的类设置一个最大数量限制避免内存无限增长。import com.google.common.cache.Cache; import com.google.common.cache.CacheBuilder; private CacheString, IRule ruleCache CacheBuilder.newBuilder() .maximumSize(1000) // 最多缓存1000个规则 .softValues() // 内存不足时GC可以回收 .build();脚本模板化如果脚本结构类似只是参数不同可以考虑使用模板引擎如FreeMarker、Velocity先生成最终的脚本字符串再进行编译。这样相同的模板只会编译一次。异步编译对于非实时性要求极高的场景可以将编译任务提交到后台线程池编译完成后再放入缓存。当前请求可以使用一个旧的、已编译的版本或者等待编译完成。7.4 安全风险代码注入警告这是使用任何动态代码执行框架都必须严肃对待的问题允许执行用户输入的字符串代码等同于打开了“任意代码执行”的大门。防护措施白名单过滤绝对不要直接执行未经处理的用户输入。应该提供一个受限的“表达式”或“脚本”环境。例如只允许使用数字、运算符、括号和有限的几个预定义函数如max,min,round。使用沙箱Java Security Manager为执行动态代码的线程设置一个严格的SecurityManager禁止访问文件系统、网络、反射等敏感操作。但请注意Java Security Manager在更新的JDK版本中已被标记为废弃且配置复杂不是首选方案。代码静态分析在编译前对脚本字符串进行简单的词法分析检查是否包含危险关键词如Runtime,ProcessBuilder,System.exit,Class.forName,反射相关类等。但这属于“黑名单”机制可能存在绕过风险。物理隔离在最极端的情况下可以将动态代码执行放到一个独立的、权限极低的“计算沙箱”服务中通过网络RPC调用结果。即使该服务被攻破影响范围也有限。个人建议对于内部管理系统使用者是可信的管理员风险相对可控。但对于面向互联网用户的功能应极度谨慎尽量避免直接执行用户代码。可以考虑使用功能受限的表达式语言库如Aviator、QLExpress作为替代。8. 总结与扩展思考Janino是一个被低估的利器它在需要动态性与高性能平衡的领域如规则引擎、公式计算、动态模板、插件系统等能发挥出巨大的价值。它的学习曲线平缓集成简单性能优异。从我个人的使用经验来看成功应用Janino的关键在于三点一是良好的缓存设计这是性能的保障二是清晰的边界划分明确哪些逻辑适合动态化哪些应该固化在常规代码中三是完备的安全意识特别是在处理外部输入时。最后Janino并非银弹。对于极其复杂、需要版本管理和团队协作的业务逻辑将其硬塞进字符串脚本里可能适得其反会让调试和维护变得困难。此时一个设计良好的领域特定语言DSL或专用的规则引擎产品如Drools、Easy Rules可能是更合适的选择。Janino更适合作为你工具箱中的一个精密“瑞士军刀”在那些需要“轻量级Java代码动态化”的特定场景下干净利落地解决问题。
