Exceptions from NodeJs package in Ruby

This article provides an introduction to cross-technology handling of exceptions. Exceptions in programming are events that occur during the execution of programs that disrupt the normal flow of instructions.

Any exception thrown by called technology is handled and thrown as any other exception in Ruby code. Details of exception depend on called technology, but in most cases final exception has all the information passed by called side.

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.

Custom NodeJs package withe exception handling in Ruby

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

Snippet below represents the sample code from NodeJs package which contains a chain of methods:

static divideBy(x, y) {
	return TestClass.divideBySecond(x, y)
}

static divideBySecond(x, y) {
	return TestClass.divideByThird(x, y)
}

static divideByThird(x, y) {
	if (y === 0) {
		throw new Error("ZeroDivisionException")
	} else {
		return x / y
	}
}

To invoke these methods in Ruby:

# use activate only once in your app
Javonet.activate('your-license-key')

# create called runtime context
called_runtime = Javonet.in_memory.nodejs

# set up variables
library_path = "#{resources_directory}/TestClass.js"
class_name = 'TestClass'

# load custom library
called_runtime.load_library(library_path)

# get type from the runtime
called_runtime_type = called_runtime.get_type(class_name).execute

# invoke type's static method
called_runtime_type.invoke_static_method('divideBy', 10, 0).execute
  rescue Exception => e
# write exception to console
puts e.full_message

The last method throws exception which is handled and rethrown in Ruby. Then the exception in catched and printed.

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 NodeJs package 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.