public interface

ICoreContext

implements IEventSource
com.pnfsoftware.jeb.core.ICoreContext

Class Overview

A core context. A core is the highest-level object of the JEB back-end architecture. The main responsibility of a core is to manager engine contexts.

There must be at most one core context running within a JVM. Use JebCoreService to retrieve or create the core context.

The first thing a client does is instantiate or retrieve a context to the core.

See Also

Summary

Public Methods
abstract void close()
Terminate this core context.
abstract void closeEnginesContext(IEnginesContext context)
Close an engines context
abstract IEnginesContext createEnginesContext(IDataProvider dataProvider, JebClientInformation clientInformation)
Create an engines context.
abstract IEnginesContext getDefaultEnginesContexts()
Retrieve the first, aka default, JEB engines context.
abstract CoreOptions getOptions()
Retrieve the core options.
abstract Version getVersion()
Get the version of this core.
abstract List<? extends IEnginesContext> listEnginesContexts()
Retrieve the list of engines contexts managed by the core.
[Expand]
Inherited Methods
From interface com.pnfsoftware.jeb.util.events.IEventSource

Public Methods

public abstract void close ()

Terminate this core context.

public abstract void closeEnginesContext (IEnginesContext context)

Close an engines context

Parameters
context the engines context

public abstract IEnginesContext createEnginesContext (IDataProvider dataProvider, JebClientInformation clientInformation)

Create an engines context.

When an engines context is created, all unit identifiers are enabled. Currently, the implementation of engines context uses a static pool for identifiers; that means that creating an engine context will impact previously created ones: identifiers that may have been disabled will be re-enable. In production code, this limitation is theoretical since only a single engines context instance should instance at any given point.

Parameters
dataProvider mandatory data provider
clientInformation client information
Returns
  • the engines context
Throws
JebException on error

public abstract IEnginesContext getDefaultEnginesContexts ()

Retrieve the first, aka default, JEB engines context.

If JEB has not initialized properly, this method will return null, as there may not be any engines context. JEB core back-end normally manages a single engines context, even though there may be (in exceptional circumstances) more than a single.

public abstract CoreOptions getOptions ()

Retrieve the core options.

public abstract Version getVersion ()

Get the version of this core.

Returns
  • the version, never null

public abstract List<? extends IEnginesContext> listEnginesContexts ()

Retrieve the list of engines contexts managed by the core.

Returns
  • the engines context