tarilabs / jsr223-powerfx

A JSR-223 implementation for evaluating Power Fx formulas (expression) by making use of a server implemented on F# and .NET platform

This is an Open Source community project.

JSR-223 Power Fx

A JSR-223 implementation for evaluating Power Fx formulas (expression) by making use of a server implemented on F# and .NET platform.

sequenceDiagram
    participant J as Your Java App
    participant I as <<interface>><br/>JDK JSR-223
    participant E as This JSR-223<br/>ScriptEngine
    participant S as This .NET server<br/>(Docker image)
    link I: Guide @ https://docs.oracle.com/en/java/javase/14/scripting/java-scripting-api.html
    link I: JavaDoc @ https://docs.oracle.com/en/java/javase/17/docs/api/java.scripting/javax/script/package-summary.html
    J->>I: 
    I->>E: 
    E->>S: POST /eval<br/>(JSON)
    S-->>E: Power Fx eval result<br/>(JSON)
    E->>I: 
    I->>J: 

How to use

Run docker image with:

docker run -p 80:5000 jsr223-powerfx-server

Include this dependency in your Java project.

Using Maven:

<dependency>
    <groupId>com.matteomortari</groupId>
    <artifactId>jsr223-powerfx</artifactId>
    <version>0.1</version>
    <scope>runtime</scope>
</dependency>

Example usage:

ScriptEngineManager MANAGER = new ScriptEngineManager();
ScriptEngine engine = MANAGER.getEngineByName("powerfx");
Bindings bindings = engine.createBindings();
bindings.put("a", 1);
bindings.put("b", 2);
Object result = engine.eval("a+b", bindings); // result = 3

FAQ

Q: Why F# ?
A: No particular reason, I've always been looking for an excuse to experiment using it; luck is being prepared when the opportunity comes :)

Q: Is it "production-ready"?
A: This is a chabuduo MVP working-PoC

Q: I have a feedback/question?
A: Feel free to contact me!

References

Helpful references I've used while building this experiment

• Wu, C. (2010). Dynamic Languages on JVM. In: Pro DLR in .NET 4. Apress, Berkeley, CA. https://doi.org/10.1007/978-1-4302-3067-0_12
• microsoft/power-fx-host-samples#10
• Web Development with F# on .NET Core https://www.youtube.com/watch?v=W8qAUJIVj8c
• https://www.codesuji.com/2020/03/08/F-and-Docker/
• https://docs.microsoft.com/en-us/dotnet/core/docker/build-container?tabs=linux
• https://stackoverflow.com/a/60132230/893991