Getting started for Perl

Javonet allows you to reference and use modules or packages written in (Java/Kotlin/Groovy/Clojure, C#/VB.NET, Ruby, Python, JavaScript/TypeScript) like they were created in your technology.

To use the guides both interacting technologies needs to be selected from left-side dropdown lists. Developer's technology is named "I code in" and technology to be called is named "I want to use".

Prerequisites

To call library/package/module from another technology, corresponding runtime has to be installed. See Prerequisites for details about installing called technology runtime.
Javonet is available as a JavonetPerlSdk CPAN package which can be downloaded from CPAN public repository or from My Javonet Portal.
Package can be installed with CLI:

cpanm Javonet::Javonet

Get activation key

Use register or log in page to get license key, which is necessary to activate Javonet.

First sample application

Javonet needs to be imported as any other dependency.

use aliased 'Javonet::Javonet' => 'Javonet';

Javonet needs to be activated first. Activation must be called only once at the start-up of an application. More about activation in Activating Javonet section.

Javonet->activate("your-license-key");

As a second step, Runtime Context of the called technology needs to be created. RuntimeContext refers to single instance of the called runtime. Once it is created it is used to interact with called runtime.

my $python_runtime = Javonet->in_memory()->python();

The simplest use case is to get from target technology a type from a built-in library:

my $python_type = $python_runtime->get_type("math")->execute();

And then get static field from the type:

my $response = $python_type->get_static_field("pi")->execute();

The returned value needs to be cast to calling technology type and can be used as any other variable:

my $result = $response->get_value();
print("$result\n");

To sum up, the whole code snippet looks like:

use strict;
use warnings;
# <Import>
use aliased 'Javonet::Javonet' => 'Javonet';
# </Import>

# <Activation>
Javonet->activate("your-license-key");
# </Activation>

# <RuntimeContextCreation>
my $python_runtime = Javonet->in_memory()->python();
# </RuntimeContextCreation>

# <GetType>
my $python_type = $python_runtime->get_type("math")->execute();
# </GetType>

# <GetStaticField>
my $response = $python_type->get_static_field("pi")->execute();
# </GetStaticField>

# <GetValue>
my $result = $response->get_value();
print("$result\n");
# </GetValue>

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 Python 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.

Additional references