Package com.pnfsoftware.jeb.core
Class JebCoreService
java.lang.Object
com.pnfsoftware.jeb.core.JebCoreService
Service class used to create or retrieve a reference to the JEB core context. The core context
provides verified access to the engines.
Typically, it is the responsibility of client implementations (eg, the official RCP client), not plugins, to instantiate the core and a single engines context.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic IEnginesContext
Convenience method used to retrieve the primary (default) engines context managed by an initialized JEB core back-end.static ICoreContext
Retrieve an existing core context (= JEB back-end) if one exists.static ICoreContext
Retrieve an instance of the previously instantiated core.static ICoreContext
getInstance
(String licenseKey) Retrieve or create an instance of a core.static ICoreContext
getInstance
(String licenseKey, CoreOptions options) Retrieve or create an instance of a core.static void
notifyExceptionToClient
(Throwable throwable) static void
Convenience method to "forward" (via an event) a throwable to the client for processing.static void
notifySilentExceptionToClient
(Throwable throwable) static void
notifySilentExceptionToClient
(Throwable throwable, IUnit unit) static void
notifySilentExceptionToClient
(Throwable throwable, Map<String, Object> extradata) static void
notifyTelemetryToClient
(String eventName) static void
notifyTelemetryToClient
(String eventName, String key0, String value0) static void
static void
notifyTelemetryToClient
(String eventName, Map<String, String> properties) static void
silentExcept
(Throwable throwable) Internal method reserved for debug builds.
-
Constructor Details
-
JebCoreService
public JebCoreService()
-
-
Method Details
-
getExistingInstance
Retrieve an existing core context (= JEB back-end) if one exists. If none exist, null is returned.- Returns:
- the core context or null
-
getInstance
Retrieve an instance of the previously instantiated core.- Returns:
- the core context
- Throws:
JebException
- on error
-
getInstance
Retrieve or create an instance of a core.- Parameters:
licenseKey
- a valid JEB license key- Returns:
- the context
- Throws:
JebException
- on error
-
getInstance
Retrieve or create an instance of a core.- Parameters:
licenseKey
- a valid JEB license keyoptions
- core options- Returns:
- the context
- Throws:
JebException
- on error
-
getDefaultEnginesContext
Convenience method used to retrieve the primary (default) engines context managed by an initialized JEB core back-end.- Returns:
-
notifyExceptionToClient
public static void notifyExceptionToClient(Throwable throwable, int flags, Map<String, Object> extradata, IUnit unit) Convenience method to "forward" (via an event) a throwable to the client for processing. The client may decide to ignore, display, or further process (eg, report or log) the exception.- Parameters:
throwable
- an error or exceptionflags
- internal flagsextradata
- optionalunit
- optional unit object from which the exception originated
-
notifyExceptionToClient
- Parameters:
throwable
- an error or exception
-
notifySilentExceptionToClient
- Parameters:
throwable
- an error or exception
-
notifySilentExceptionToClient
- Parameters:
throwable
- an error or exceptionunit
- optional unit object from which the exception originated
-
notifySilentExceptionToClient
- Parameters:
throwable
- an error or exceptionextradata
- optional
-
silentExcept
Internal method reserved for debug builds.- Parameters:
throwable
-
-
notifyTelemetryToClient
-
notifyTelemetryToClient
-
notifyTelemetryToClient
-
notifyTelemetryToClient
-