Casting JavaScript from .NET Framework DLL

This article provides an introduction to cross-technology handling of casting mechanism. Casting is necessary in statically-typed languages like C, C++, Java, and C#, where the data type of a variable is known at compile time. In these languages, if you want to assign a value of one type to a variable of another type, you need to perform a cast.

For example, if you have an integer and you want to use it as a float, you would need to cast it to a float. This is done because different data types may be represented differently in memory, and casting ensures that the data is interpreted correctly.

In contrast, dynamically-typed languages like Python or JavaScript perform most of the casting automatically, and explicit casting is less common.

Javonet allows you to reference and use modules or packages written in (Java/Kotlin/Groovy/Clojure, C#/VB.NET, Ruby, Perl, Python, JavaScript/TypeScript) like they were created in your technology. If have not yet created your first project check Javonet overview and quick start guides for your technology.

With Javonet you can interact with objects and methods from .NET Framework DLL like they were available in JavaScript but invocation must be performed through Javonet SDK API.

Custom JavaScript showing .NET Framework DLL casting

With Javonet it is possible to reference any custom .NET Framework DLL and interact with its methods declared on types defined within that module almost the same as with any other JavaScript library.

Snippet below represents the sample code from .NET Framework DLL which contains a few methods with the same name but different parameter type. Each of these methods can perform different logic so it is necessary to invoke intended method.

namespace TestClass
{
	public class TestClass
	{
		public TestClass() { }

		public static string CastSampleMethod(System.UInt32 value)
		{
			return "CastSampleMethod with System.UInt32 called";
		}
		
		public static string CastSampleMethod(System.Single value)
		{
			return "CastSampleMethod with System.Single called";
		}
		
		public static string CastSampleMethod(System.Double[] value)
		{
			return "CastSampleMethod with System.Double[] called";
		}
	}
}
public static string CastSampleMethod(System.UInt32 value)
{
	return "CastSampleMethod with System.UInt32 called";
}

public static string CastSampleMethod(System.Single value)
{
	return "CastSampleMethod with System.Single called";
}

public static string CastSampleMethod(System.Double[] value)
{
	return "CastSampleMethod with System.Double[] called";
}

It is possible to invoke each of these methods by casting the value from javascript to proper type specified in .NET Framework DLL.

const { Javonet } = require('javonet-nodejs-sdk/lib/sdk/Javonet')

let resourcesDirectory = '.'

// use Activate only once in your app
Javonet.activate("your-license-key")

// create called runtime context
let calledRuntime = Javonet.inMemory().clr()

// set up variables
let libraryPath = resourcesDirectory + '/TestClass.dll'
let className = 'TestClass.TestClass'

// load custom library
calledRuntime.loadLibrary(libraryPath)

// get type from the runtime
let calledRuntimeType = calledRuntime.getType(className).execute()

// get type for casting
let targetType = calledRuntime.getType("System.UInt32")

// invoke type's static method
let response = calledRuntimeType.invokeStaticMethod("CastSampleMethod", calledRuntime.cast(targetType, 5.2)).execute()

// get value from response
let result = response.getValue()

// write result to console
console.log(result)
namespace TestClass
{
	public class TestClass
	{
		public TestClass() { }

		public static string CastSampleMethod(System.UInt32 value)
		{
			return "CastSampleMethod with System.UInt32 called";
		}
		
		public static string CastSampleMethod(System.Single value)
		{
			return "CastSampleMethod with System.Single called";
		}
		
		public static string CastSampleMethod(System.Double[] value)
		{
			return "CastSampleMethod with System.Double[] called";
		}
	}
}
// use Activate only once in your app
Javonet.activate("your-license-key")

// create called runtime context
let calledRuntime = Javonet.inMemory().clr()

// set up variables
let libraryPath = resourcesDirectory + '/TestClass.dll'
let className = 'TestClass.TestClass'

// load custom library
calledRuntime.loadLibrary(libraryPath)

// get type from the runtime
let calledRuntimeType = calledRuntime.getType(className).execute()

// get type for casting
let targetType = calledRuntime.getType("System.UInt32")

// invoke type's static method
let response = calledRuntimeType.invokeStaticMethod("CastSampleMethod", calledRuntime.cast(targetType, 5.2)).execute()

// get value from response
let result = response.getValue()

// write result to console
console.log(result)

In the snippet above, user intended to invoke CastSampleMethod with argument of specific type. Value from javascript has been casted to proper type and passed to CastSampleMethod. Second example shows the same steps but for different parameter type.

const { Javonet } = require('javonet-nodejs-sdk/lib/sdk/Javonet')

let resourcesDirectory = '.'

// use Activate only once in your app
Javonet.activate("your-license-key")

// create called runtime context
let calledRuntime = Javonet.inMemory().clr()

// set up variables
let libraryPath = resourcesDirectory + '/TestClass.dll'
let className = 'TestClass.TestClass'

// load custom library
calledRuntime.loadLibrary(libraryPath)

// get type from the runtime
let calledRuntimeType = calledRuntime.getType(className).execute()

// get type for casting
let targetType = calledRuntime.getType("System.Single")

// invoke type's static method
let response = calledRuntimeType.invokeStaticMethod("CastSampleMethod", calledRuntime.cast(targetType, 5)).execute()

// get value from response
let result = response.getValue()

// write result to console
console.log(result)
namespace TestClass
{
	public class TestClass
	{
		public TestClass() { }

		public static string CastSampleMethod(System.UInt32 value)
		{
			return "CastSampleMethod with System.UInt32 called";
		}
		
		public static string CastSampleMethod(System.Single value)
		{
			return "CastSampleMethod with System.Single called";
		}
		
		public static string CastSampleMethod(System.Double[] value)
		{
			return "CastSampleMethod with System.Double[] called";
		}
	}
}
// use Activate only once in your app
Javonet.activate("your-license-key")

// create called runtime context
let calledRuntime = Javonet.inMemory().clr()

// set up variables
let libraryPath = resourcesDirectory + '/TestClass.dll'
let className = 'TestClass.TestClass'

// load custom library
calledRuntime.loadLibrary(libraryPath)

// get type from the runtime
let calledRuntimeType = calledRuntime.getType(className).execute()

// get type for casting
let targetType = calledRuntime.getType("System.Single")

// invoke type's static method
let response = calledRuntimeType.invokeStaticMethod("CastSampleMethod", calledRuntime.cast(targetType, 5)).execute()

// get value from response
let result = response.getValue()

// write result to console
console.log(result)

In the snippet above, user intended to invoke CastSampleMethod with argument of specific type. Value from javascript has been casted to proper type and passed to CastSampleMethod.

The same operation can be performed remotely by just changing the new Runtime Context invocation from in memory to tcp that will create and interact with your .NET Framework DLL objects on any remote node, container or service that hosts Javonet Code Gateway. This way you can preserve the same logic in your application and instantly switch between monolithic and microservices architecture without the need to implement the integration layer based on web services or other remote invocation methods.

Read more about use cases and software architecture scenarios where Javonet runtime bridging technology can support your development process.