xboson-js-module-example

The xBoson JavaScript Extension Module example serves as a practical guide for developers looking to extend the functionality of the xBoson platform using Java. xBoson is a runtime environment that supports JavaScript execution, and this project illustrates how to bridge Java code with JavaScript scripts. Key features and workflows demonstrated include: 1. **Module Creation**: The example shows how to define a Java class (e.g., `org.xboson.example.Hello`) with public methods (e.g., `public String world()`) that will be exposed to the JavaScript environment. 2. **JavaScript Integration**: It demonstrates how to require and call these Java methods from a JavaScript script using the standard `require()` function, such as `var hello = require("example/hello");` followed by `hello.world();`. 3. **Compilation and Deployment**: The project includes instructions for compiling the Java code using Gradle. The resulting JAR file can be deployed to the xBoson platform's classpath or copied into a Docker container's library directory (`/app/lib/`) followed by a container restart. 4. **Service Registration**: It explains the mechanism for registering exported JavaScript modules via the `META-INF/services/com.xboson.exports.IJavaScriptModuleFactory` file, ensuring the xBoson runtime can discover and load the custom modules. 5. **Factory Pattern**: The example implements a factory class (`Factory.java`) that defines the module name, allowing the JavaScript engine to map the `require()` path to the correct Java implementation. This repository is useful for developers who need to integrate existing Java libraries or custom logic into xBoson-based applications, providing a clear template for building, packaging, and deploying such extensions.