[New Feature]: Runtime API to start the new Runtime and call ballerina function

[warunalakshitha]

Description

I have a ballerina program. I will compile it and generate a jar file. Then I will add that jar as dependency to another Java Project. Then I need to start the ballerina program from the external Java Project and call the functions.

Describe your problem(s)

No response

Describe your solution(s)

Provide an Runtime API as below.

import io.ballerina.runtime.api.Runtime;

Runtime balRuntime = Runtime.start(“org”, “module”, 1.0.0);
Object[] args = [];
balRuntime.invokeMethodAsync(“myFunction”, args, callback);
Runtime.stop(“org”, “module”, 1.0.0);

Runtime Class

Class initClass;

public static void start(String orgName, String moduleName, String version) {
String initClassName = orgNAme + “$” + moduleName + “$” + version
	initClass = Class.load(initClassName);
Scheduler s = new Scheduler();
s.schedule(moduleInitFunction);
	initClass.invoke(“moduleInit”); 
}


public static void stop(String orgName, String moduleName, String version) {
	initClass.invoke(“moduleStop”);
}

Related area

-> Runtime

Related issue(s) (optional)

No response

Suggested label(s) (optional)

No response

Suggested assignee(s) (optional)

No response

[gabilang]

Above proposed runtime APIs have been modified as follows,

    public static Runtime from(Module module) {
        return new BalRuntime(module);
    }

    public abstract void init();

    public abstract void start();

    public abstract void invokeMethodAsync(String functionName, Object[] args, Callback callback);

    public abstract void stop();

The above APIs can be used to create a Ballerina runtime instance and invoke init, start, function of interest and stop methods as follows,

    Runtime balRuntime = Runtime.from(new Module("orgName", "moduleName", "majorVersion"));
    balRuntime.init();
    balRuntime.start();
    Object[] args = [];
    balRuntime.invokeMethodAsync(“functionName”, args, callback);
    balRuntime.stop(“org”, “module”, 1.0.0);