Exceptions from Ruby package in C++

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 C++ 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 Ruby package withe exception handling in C++

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

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

def self.divide_by(x, y)
  return self.divide_by_second(x, y)

def self.divide_by_second(x, y)
  return self.divide_by_third(x, y)

def self.divide_by_third(x, y)
  return x / y

To invoke these methods in C++:

// use Activate only once in your app

// create called runtime context
auto calledRuntime = Javonet::InMemory()->Ruby();

// set up variables
auto libraryPath = resourcesDirectory + "/TestClass.rb";
auto className = "TestClass::TestClass";

// load custom library

// get type from the runtime
auto calledRuntimeType = calledRuntime->GetType(className)->Execute();

// invoke type's static method which throws exception 
try {
	calledRuntimeType->InvokeStaticMethod("divide_by", { 10, 0 })->Execute();
catch (std::exception& e) {
	// write exception to console
	std::cout << e.what() << std::endl;

The last method throws exception which is handled and rethrown in C++. 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 Ruby 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.