ilog.tgo.util

Class IltSystemInitializer

java.lang.Object

ilog.tgo.util.IltSystemInitializer

public class IltSystemInitializer
extends Object

This utility class is intended to parallelize the JViews TGO static library initialization through the use of a worker thread, replacing the mandatory call to IltSystem.Init(). It also forces the TGO graphic components (Tree, Table, Network and Equipment) instantiation, which yields faster display whey they are first made visible.

This is particularly useful on applications performing time consuming tasks during startup and/or initialization (network connections, user authentication, etc).

Usage example:

• Start the initialization. It should be done before a given time consuming activity such as establishing a network connection

           // Start initialization on a worker thread
           IltSystemInitializer.Init("my/deployment/file.xml");
           ...
         

• Wait for the initialization to complete (blocking method). It should be done before invoking initialization-dependent methods such as IltSystem.GetDefaultContext() or before instantiating TGO components such as IlpNetwork and IlpTable.

           IltSystemInitializer.WaitInitialization();
           if (null != IlpSystemInitializer.GetError()) {
             // Error!
           }
           _context = IltSystem.GetDefaultContext();
           _tree = new IlpTree(_context);
           ...
         

  Please note that it is not recommended to invoke this API from the AWT Event Dispatch Thread (EDT) as it will block it.

You can extend and/or customize the initialization behavior by extending abstract inner class Initializer and passing it to the static method Init(ilog.tgo.util.IltSystemInitializer.Initializer). With a custom Initializer you can implement custom initialization routines for your own resources, and also enabling/disabling the time consuming forced component instantiation.

Since:

JViews 8.5

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	IltSystemInitializer.Initializer Abstract internal implementation of Runnable that initializes all TGO resources in a dedicated thread.

Constructor Summary

Constructors

Constructor and Description
IltSystemInitializer()

Method Summary

Modifier and Type	Method and Description
static Throwable	GetError() Accesses the captured exception or error data, in case of problems.
static void	Init() Initializes JViews TGO on a working thread, creating a default context using a deployment descriptor.
static void	Init(Applet applet) Deprecated. since 9.0 : Applet will be deprecated with JDK 9
static void	Init(Applet applet, String deploymentDescriptorName) Deprecated. since 9.0 : Applet will be deprecated with JDK 9
static void	Init(IlpContext defaultContext) Initializes JViews TGO on a working thread using a given service context.
static void	Init(IltSystemInitializer.Initializer initializer) Initializes JViews TGO on a working thread using a given customized initializer object.
static void	Init(String deploymentDescriptorName) Initializes JViews TGO on a working thread, creating a default context using a deployment descriptor specified by a file name.
static boolean	IsInitialized() Returns whether or not the initialization is complete.
static void	WaitInitialization() This method will block the caller thread until the initialization is complete.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IltSystemInitializer

public IltSystemInitializer()

Method Detail

WaitInitialization

public static void WaitInitialization()

This method will block the caller thread until the initialization is complete. It should be invoked before instantiating TGO graphic components or other initialization-dependent methods.

Usage example:

   public void initUI() {
     IltSystemInitializer.WaitInitialization();
     if (null != IlpSystemInitializer.GetError()) {
       // Error!
     }
     IlpNetwork myNetwork = new IlpNetwork();
     ...
   }
 

In case of InterruptedException, method GetError() will hold a reference to the exception.

IsInitialized

public static boolean IsInitialized()

Returns whether or not the initialization is complete.

Returns:

true if the initialization is complete; false otherwise.

GetError

public static Throwable GetError()

Accesses the captured exception or error data, in case of problems.

Once the error is returned, the static reference is set to null.

Returns:

The first captured Throwable, if any, or null.

Init

public static void Init()

Initializes JViews TGO on a working thread, creating a default context using a deployment descriptor.

See Also:

IltSystem.Init()

Init

public static void Init(String deploymentDescriptorName)

Initializes JViews TGO on a working thread, creating a default context using a deployment descriptor specified by a file name.

Parameters:

deploymentDescriptorName - absolute or relative file name

See Also:

IltSystem.Init(IlpContext)

Init

public static void Init(Applet applet)

Deprecated. since 9.0 : Applet will be deprecated with JDK 9

Initializes JViews TGO applet on a working thread, creating a default context using a deployment descriptor.

See Also:

IltSystem.Init(Applet)

Init

public static void Init(Applet applet,
                        String deploymentDescriptorName)

Deprecated. since 9.0 : Applet will be deprecated with JDK 9

Initializes JViews TGO applet on a working thread, creating a default context using a deployment descriptor specified by a relative file name.

See Also:

IltSystem.Init(Applet, String)

Init

public static void Init(IlpContext defaultContext)

Initializes JViews TGO on a working thread using a given service context.

The user should ensure that the context is properly configured for subsequent use.

Parameters:

defaultContext - The default service context used in the application

See Also:

IltSystem.Init(IlpContext)

Init

public static void Init(IltSystemInitializer.Initializer initializer)

Initializes JViews TGO on a working thread using a given customized initializer object.

Parameters:

initializer - The Initializer implementation that customizes how TGO will be initialized according to user needs.

See Also:

IltSystemInitializer.Initializer