ePages 6.11.0 - DE_EPAGES/Core/API/InlineJavaServer.pm

Package DE_EPAGES::Core::API::InlineJavaServer

This package handles the connection with the Inline::Java server

@EXPORT_OK
ExistsRunningInlineJavaServer
StartInlineJavaServer
StopInlineJavaServer
RestartInlineJavaServer
GetInlineJavaConfig
CreateJavaObject

Functions

CreateJavaObject
ExistsRunningInlineJavaServer
GetInlineJavaConfig
RestartInlineJavaServer
StartInlineJavaServer
StopInlineJavaServer

CreateJavaObject

Creates an object from a java class. Starts the java server unless it running.

Syntax
my $Object = CreateJavaObject($hOptions);
Example
my $PDFConverter = CreateJavaObject({
    'ClassName' => 'PdfConverter',
    'ClassPath' => $ENV{'EPAGES_CARTRIDGES'}. '/DE_EPAGES/Core/API/JavaLib/Xhtml2Pdf.jar',
    'Params'    => []
});
Input
$hOptions (ref.hash)
keys are:
  • ClassName - name of java class - string
  • ClassPath - path to class package - string
  • Params - list of params for class contructor (optional) - ref.array
Return
$Object (Object)
perl mapped java object

ExistsRunningInlineJavaServer

This function tests if the JVM is running.

Syntax
my $isRunning = ExistsRunningInlineJavaServer();
Return
$isRunning (boolean)
result of test

GetInlineJavaConfig

This function returns config values for the JVM, its ClassPath entries and Classes to load.

Syntax
my $hInlineJavaConfig = GetInlineJavaConfig();
Return
$hInlineJavaConfig (ref.hash)
configuration params

RestartInlineJavaServer

This procedure restarts the JVM by calling the procedures StopInlineJavaServer and StartInlineJavaServer

Syntax
RestartInlineJavaServer();

StartInlineJavaServer

This procedure starts the JVM. If it fails, it tries to start a second time.

Syntax
StartInlineJavaServer();

StopInlineJavaServer

This procedure stops the JVM.

Syntax
StopInlineJavaServer();