Vnano Engine の主な機能と用例

import org.vcssl.nano.VnanoEngine;
import org.vcssl.nano.VnanoException;
import java.util.Map;
import java.util.HashMap;
import java.util.Scanner;

public class ExampleApp2 {
	public static void main(String[] args) throws VnanoException {

		// Vnano Engine のインスタンスを生成
		VnanoEngine engine = new VnanoEngine();

		// 整数リテラルを float (=double) 型と見なすオプションを有効化
		// (式の計算用途に便利ですが、スクリプトの実行用途には適しません)
		Map<String, Object< optionMap = new HashMap<String, Object>();
		optionMap.put("EVAL_INT_LITERAL_AS_FLOAT", true);
		engine.setOptionMap(optionMap);

		// ユーザーに式を入力してもらう
		System.out.println("Input an expression, e.g.:  1.2 + 3.4 * 5.6");
		Scanner scanner = new Scanner(System.in);
		String expression = scanner.nextLine();

		// 入力内容が「 ; 」で終わっていない場合は、末尾に付ける
		if (!expression.trim().endsWith(";")) {
			expression += ";";
		}

		// Vnano Engine で式の値を計算し、結果を表示
		double result = (Double)engine.executeScript(expression);
		System.out.println("result: " + result);
	}
}

...
public static class AnyClass {

	// Vnano Engine 上で実行される式やスクリプト内から
	// アクセスしたいフィールド/メソッド
	public double x = 3.4;
	public double f(double arg) {
		return arg * 5.6;
	}
}

public static void main(String[] args)
		throws VnanoException, NoSuchFieldException, NoSuchMethodException {

	// Vnano Engine のインスタンスを生成
	VnanoEngine engine = new VnanoEngine();

	// 任意のクラス（ここでは上のAnyClass）のフィールド/メソッドを Vnano Engine に接続
	Field field = AnyClass.class.getField("x");
	Method method = AnyClass.class.getMethod("f", double.class);
	AnyClass anyClassInstance = new AnyClass();
	engine.connectPlugin("x", new Object[]{ field, anyClassInstance });
	engine.connectPlugin("f", new Object[]{ method, anyClassInstance });

	// staric なフィールド/メソッドは、以下のようにインスタンスなしで接続できます
	// Field field = AnyClass.class.getField("x");
	// Method method = AnyClass.class.getMethod("f", double.class);
	// engine.connectPlugin("x", field);
	// engine.connectPlugin("f", method);

	...
	(後は ExampleApp2.java と同じです)
}

...
VnanoEngine engine = new VnanoEngine();

AnyClass anyClassInstance = new AnyClass();
engine.connectPlugin("AnyNamespace", anyClassInstance);
...

package anypackage;
public class AnyClass {

    // Vnano Engine 上で実行される式やスクリプト内から
    // アクセスしたいフィールド/メソッド
    public double x = 3.4;
    public double f(double arg) {
        return arg * 5.6;
    }
}

import anypackage.AnyClass;

...
VnanoEngine engine = new VnanoEngine();

AnyClass anyClassInstance = new AnyClass();
engine.connectPlugin("AnyNamespace", anyClassInstance);
...

public class ExamplePlugin1 {
    
	// Vnano Engine 上で実行される式やスクリプト内から
	// アクセスしたいフィールド/メソッド
	public double x = 3.4;
	public double f(double arg) {
		return arg * 5.6;
	}
}

import org.vcssl.nano.interconnect.PluginLoader;

...
public static void main(String[] args) throws VnanoException {

		// Vnano Engine のインスタンスを生成
		VnanoEngine engine = new VnanoEngine();

		// プラグインを動的に読み込んで Vnano Engine に接続
		PluginLoader pluginLoader = new PluginLoader("UTF-8");
		pluginLoader.setPluginListPath("./plugin/VnanoPluginList.txt");
		pluginLoader.load();
		for (Object plugin: pluginLoader.getPluginInstances()) {
			engine.connectPlugin("___VNANO_AUTO_KEY", plugin);
		}

		...
		(後は ExampleApp2.java と同じです)
	}
}

...
public static void main(String[] args) throws VnanoException {

	// Vnano Engine のインスタンスを生成
	VnanoEngine engine = new VnanoEngine();

	// 実行するスクリプトの内容を用意
	String script =

		" int sum = 0;                 " +
		" for (int i=1; i<=100; i++) { " +
		"     sum += i;                " +
		" }                            " +
		" sum;                         " ;

	// Vnano Engine でスクリプトを実行
	long result = (Long)engine.executeScript(script);
	System.out.println("result: " + result);
}

float x = 3.4;

float f(float arg) {
	return arg * 5.6;
}

import org.vcssl.nano.interconnect.ScriptLoader;

...
public static void main(String[] args) throws VnanoException {

	// Vnano Engine のインスタンスを生成
	VnanoEngine engine = new VnanoEngine();

	// ライブラ リスクリプトをファイルから読み込む
	ScriptLoader scriptLoader = new ScriptLoader("UTF-8");
	scriptLoader.setLibraryScriptListPath("./lib/VnanoLibraryList.txt");
	scriptLoader.load();

	// 読み込んだライブラリ スクリプトを VnanoEngine に登録
	String[] libPaths = scriptLoader.getLibraryScriptPaths(true);
	String[] libScripts = scriptLoader.getLibraryScriptContents();
	int libCount = libScripts.length;
	for (int ilib=0; ilib<libCount; ilib++) {
		engine.registerLibraryScript(libPaths[ilib], libScripts[ilib]);
	}

	// 実行するスクリプトの内容を用意
	String script =

		" float value = 1.2 + f(x); " +
		" value;                      " ;

	// Vnano Engine でスクリプトを実行
	double result = (Double)engine.executeScript(script);
	System.out.println("result: " + result);
}

import java.util.Map;
import java.util.HashMap;
...

( 以下、Vnano Engine を使うメソッド内 )

// オプションの項目名と設定値を格納する Map を作成（オプションマップ）
Map<String, Object> optionMap = new HashMap<String, Object>();

// 整数リテラルを浮動小数点数として解釈するオプションを有効化
optionMap.put("EVAL_INT_LITERAL_AS_FLOAT", true);

// 数値演算などに関して、浮動小数点数の値/変数のみ使用可能にするオプションを有効化
optionMap.put("EVAL_ONLY_FLOAT", true);

// 式のみ実行可能にするオプションを有効化
optionMap.put("EVAL_ONLY_EXPRESSION", true);

// Vnano Engine のインスタンスに設定
try {
	engine.setOptionMap(optionMap);
} catch (VnanoException e) {
	System.err.println("オプション設定内容に関するエラーが見つかりました。");
	e.printStackTrace();
}

import org.vcssl.connect.ConnectorPermissionName;
import org.vcssl.connect.ConnectorPermissionValue;
import java.util.Map;
import java.util.HashMap;
...

( 以下、Vnano Engine を使うメソッド内 )

// パーミッションの項目名と設定値を格納する Map を作成（パーミッションマップ）
Map<String, String> permissionMap = new HashMap<String, String>();

// デフォルトは拒否に設定（未設定項目に適用される）
permissionMap.put(ConnectorPermissionName.DEFAULT, ConnectorPermissionValue.DENY);

// ファイルの新規作成、（上書き以外の）書き込み、読み込みは許可する
permissionMap.put(ConnectorPermissionName.FILE_CREATE, ConnectorPermissionValue.ALLOW);
permissionMap.put(ConnectorPermissionName.FILE_WRITE, ConnectorPermissionValue.ALLOW);
permissionMap.put(ConnectorPermissionName.FILE_READ, ConnectorPermissionValue.ALLOW);

// ファイルの上書きは、実行時にユーザーに尋ねて決める
permissionMap.put(ConnectorPermissionName.FILE_OVERWRITE, ConnectorPermissionValue.ASK);

// Vnano Engine のインスタンスに設定
try {
	engine.setPermissionMap(permmissionMap);
} catch (VnanoException e) {
	System.err.println("パーミッション設定内容に関するエラーが見つかりました。");
	e.printStackTrace();
}

int sum = 0;
for (int i=1; i<=100; i++) {
    sum += i;
}
output(sum);

float value = mean(1.0, 2.0);  // 平均値を計算
print(value);                  // 端末上に表示

// result: 1.5

(in ExampleApp7.java)

import org.vcssl.nano.VnanoEngine;
import org.vcssl.nano.VnanoException;
import java.util.Map;
import java.util.HashMap;

public class ExampleApp7 {

    // 反復実行の回数
    static final int REPETITION_COUNT = 100000000;

    // 変数「x」を提供するプラグイン
    public static class VariablePlugin {
        public double x;
    }

    public static void main(String[] args) throws VnanoException {
        
        // Vnano Engine のインスタンスを生成
        VnanoEngine engine = new VnanoEngine();

        // 変数「x」を提供するプラグインを生成して接続
        VariablePlugin plugin = new VariablePlugin();
        engine.connectPlugin("VariablePlugin", plugin);

        // オーバーヘッドを削るため、自動アクティベーション機能を無効化する
        Map<String, Object> optionMap = new HashMap<String, Object>();
        optionMap.put("AUTOMATIC_ACTIVATION_ENABLED", false);

        // 反復的に処理する計算式（またはスクリプト）を用意
        String expression = " x * 0.5 + 3.2 ; " ;

        // 反復実行の各ターンでの結果を足し上げる変数
        double sum = 0.0;

        // 手動でエンジンをアクティベーション（実行スタンバイ状態に）する
        engine.activate();

        // 反復実行の開始時間を控える
        long beginTime = System.nanoTime();

        // 変数 x の値を小刻みに変えながら、計算式（またはスクリプト）を反復実行する
        for (int i=0; i<REPETITION_COUNT; i++) {
            plugin.x = i * 0.125;
            double valueOfExpression = (double)engine.executeScript(expression);
            sum += valueOfExpression;
        }

        // 反復実行の終了時間を控える
        long endTime = System.nanoTime();

        // エンジンのアクティベーションを解除する（何もせず待つ時の状態に戻す）
        engine.deactivate();

        // 結果を出力（所要時間や反復実行の速さなども）
        double requiredTime = ((endTime - beginTime) * 1.0E-9);
        double repetitionSpeed = REPETITION_COUNT / requiredTime;
	    System.out.println("result (sum): " + sum);
	    System.out.println("repetition couunt: " + REPETITION_COUNT);
	    System.out.println("required time: " + requiredTime + " [sec]");
	    System.out.println("repetition speed: " + repetitionSpeed + " [times/sec]");
    }
}

(in ExampleApp7.java)

...

// オーバーヘッドを削るため、自動アクティベーション機能を無効化する
Map<String, Object> optionMap = new HashMap<String, Object>();
optionMap.put("AUTOMATIC_ACTIVATION_ENABLED", false);

...

// 手動でエンジンをアクティベーションする（実行スタンバイ状態にする）
engine.activate();

...

// 変数 x の値を小刻みに変えながら、計算式（またはスクリプト）を反復実行する
for (int i=0; i<REPETITION_COUNT; i++) {
    plugin.x = i * 0.125;
    double valueOfExpression = (double)engine.executeScript(expression);
    sum += valueOfExpression;
}

...

// エンジンのアクティベーションを解除する（何もせず待つ時の状態に戻す）
engine.deactivate();