Janino 2.7.6

An embedded Java compiler that compiles expressions or scripts on-the-fly
Janino is a compiler that reads a Java expression, block, or source file, and generates Java bytecode that is loaded and executed directly. It is not intended to be a development tool, but an embedded compiler for run-time compilation purposes, such as expression evaluators or "server pages" engines like JSP.

The major design goal was to keep the compiler small and simple, while partially sacrificing completeness. I don't like the idea of carrying around huge libraries for simple applications. See Parser for the list of implemented and missing language features. When do you need an efficient expression evaluator?

Say you build an e-commerce system, which computes the shipping cost for the items that the user put into his/her shopping cart. Because you don't know the merchant's shipping cost model at implementation time, you could implement a set of shipping cost models that come to mind (flat charge, by weight, by number of items, ...) and select one of those at run-time.

In practice, you will most certainly find that the shipping cost models you implemented will rarely match what the merchant wants, so you must add custom models, which are merchant-specific. If the merchant's model changes later, you must change your code, re-compile and re-distribute your software.
Because this is so unflexible, the shipping cost expression should be specified at run-time, not at compile-time. This implies that the expression must be scanned, parsed and evaluated at run-time, which is why you need an expression evaluator. A simple expression evaluator would parse an expression and create a "syntax tree".

The expression "a + b * c", for example, would compile into a "Sum" object who's first operand is parameter "a" and who's second operand is a "Product" object who's operands are parameters "b" and "c". Such a syntax tree can evaluated relatively quickly.

Main features:

  • package declaration, import declaration
  • class declaration, interface declaration
  • Inheritance (extends and implements)
  • Static member type declaration
  • Inner classes (member classes, local classes, anonymous classes)
  • Class initializer, Instance initializer
  • Field declaration, Method declaration
  • Local variable declaration
  • Class variable initializer, Instance variable initializer
  • Block statement ({ ... })
  • if ... else statement
  • for statement
  • while statement
  • do ... while statement
  • try ... catch ... finally statement
  • throw statement
  • return statement
  • break statement
  • continue statement
  • switch statement
  • synchronized statement
  • All primitive types (boolean, char, byte, short, int, long, float, double)
  • Assignment operator =
  • Assignment operators +=, -=, *=, /=, &=, |=, ^=, %=, =, >>>=
  • Conditional operators ?...:, &&, ||
  • Boolean logical operators &, ^, |
  • Integer bitwise operators &, ^, |
  • Numeric operators *, /, %, +, -, , >>>
  • String concatenation operator +
  • Operators ++ and --
  • Type comparison operator instanceof
  • Unary operators +, -, ~, !
  • Parenthesized expression
  • Field access (like System.out)
  • Superclass member access (super.meth();, super.field = x;
  • this (reference to current instance)
  • Alternate constructor invocation (like this(a, b, c))
  • Superclass constructor invocation (like super(a, b, c))
  • Method invocation (like System.out.println("Hello")) (partially)
  • Class instance creation (like new Foo())
  • Primitive array creation(like new int[10][5][])
  • Class or interface array creation(like new Foo[10][5][])
  • Array access (like args[0]) (currently read-only)
  • Local variable access
  • Integer, floating-point, boolean, character, string literal
  • null literal
  • Unary numeric conversion, binary numeric conversion, widening numeric conversion, narrowing numeric conversion
  • Widening reference conversion, narrowing reference conversion
  • Cast
  • Assignment conversion
  • String conversion (for string concatenation)
  • Constant expression
  • Block scope, method scope, class scope, global scope
  • throws clause
  • Array initializer (like String[] a = { "x", "y", "z" })
  • Primitive class literals, e.g. "int.class"
  • Non-primitive class literals, e.g. "String.class"
  • References between uncompiled compilation units
  • Line number tables a la "-g:lines"
  • Source file information a la "-g:source"
  • Handling of @deprecated doc comment tag
  • Accessibility checking (PUBLIC, PROTECTED, PRIVATE)

last updated on:
August 18th, 2014, 4:25 GMT
file size:
1 MB
developed by:
Arno Unkrig
license type:
operating system(s):
Windows All
C: \ Programming \ Other Programming Files


In a hurry? Add it to your Download Basket!

user rating



Rate it!
1 Screenshot
What's New in This Release:
  • 'IClass.findIMethod(name, parameterTypes)' now ignores synthetic bridge methods by picking the method with the most significant return type.
  • JANINO-180 NullPointerException with JDK8
  • Reclassification of 'empty package types' was forgotten (JLS7: 6.5.2.BL1.B3.1 and .2). This caused 'EvaluatorTests.testWideInstructions()' to fail.
  • JANINO-178 ConcurrentModificationException while compiling anonymous class
read full changelog

Add your review!