com.highqsoft.fwk

Class FwkApplicationBus

java.lang.Object

com.highqsoft.fwk.FwkApplicationBus

All Implemented Interfaces:

FwkApplicationBusInterface, java.io.Serializable

public class FwkApplicationBus
extends java.lang.Object
implements java.io.Serializable, FwkApplicationBusInterface

The FWK Application Bus object provides an easy-to-use access to the application bus.

Since:

$Date: 2017/04/28 08:47:40 $

Version:

$Revision: 1.14 $

Author:

HighQSoft GmbH

See Also:

, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BUSDEFAULTNAME FWK Application bus default name.
static java.lang.String	BUSNAME Application bus name.
static java.lang.String	BUSNAMEKEY FWK Application bus key.
static java.lang.String	version

Constructor Summary

Constructors

Constructor and Description
FwkApplicationBus()

Method Summary

Methods

Modifier and Type	Method and Description
static FwkApplicationInterface	fetchEternal(java.lang.String applName) Fetch an eternal application.
static FwkApplicationInterface	findApplication(java.lang.String applicationName) Get the application with the requested name.
static FwkApplicationInterface	findApplication(java.lang.String applicationName, java.awt.datatransfer.DataFlavor[] dataFlavor) Get the specified application from the application bus.
static java.lang.Object	findDataItem(java.lang.String applicationName) Get the application with the requested name.
static FwkApplicationInterface[]	findMultipleApplications(java.lang.String applicationName) find multiple applications with the requested name.
static FwkApplicationInterface[]	findMultipleApplications(java.lang.String applicationName, java.awt.datatransfer.DataFlavor[] dataFlavor) Find multiple application on the application bus.
static java.lang.Object	findMultipleDataItems(java.lang.String applicationName) Get the application with the requested name.
static java.lang.String	getUniqueName(java.lang.String applicationName) Get a unique registry name.
java.lang.String	getVersion()
static boolean	isEternal(java.lang.String applicationName) Returns a boolean whether or not the requested application is registered eternal.
static boolean	isRegistered(FwkApplicationInterface appl) Returns a boolean whether or not the requested application is already registered.
static boolean	isRegistered(java.lang.String applicationName) Returns a boolean whether or not the requested application is already registered.
static boolean	launch(java.lang.String resources) Start and interpret resources.
static java.lang.Object	loadClass(java.lang.String name) Load the class with the specified name and get an instance of that class.
static java.lang.String	register(FwkApplicationInterface application) Register a new application.
static java.lang.String	register(FwkApplicationInterface application, java.awt.datatransfer.DataFlavor[] dataFlavor) Register a new application under a special data flavor.
static void	unregister(FwkApplicationInterface application) Unregister the application and exit if the last application was unregistered.

Methods inherited from class java.lang.Object

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

Field Detail

version

public static final java.lang.String version

See Also:

Constant Field Values

BUSDEFAULTNAME

public static final java.lang.String BUSDEFAULTNAME

FWK Application bus default name.

See Also:

Constant Field Values

BUSNAMEKEY

public static final java.lang.String BUSNAMEKEY

FWK Application bus key.

See Also:

Constant Field Values

BUSNAME

public static java.lang.String BUSNAME

Application bus name.

Constructor Detail

FwkApplicationBus

public FwkApplicationBus()

Method Detail

getVersion

public java.lang.String getVersion()

findApplication

public static FwkApplicationInterface findApplication(java.lang.String applicationName)

Get the application with the requested name.

Parameters:

applicationName - The name of the requested application.

Returns:

The requested application.

findApplication

public static FwkApplicationInterface findApplication(java.lang.String applicationName,
                                      java.awt.datatransfer.DataFlavor[] dataFlavor)

Get the specified application from the application bus.

Parameters:

applicationName - The name of searched application.

dataFlavor - The data flavor of the requested application

Returns:

The requested application or null if not found.

See Also:

FwkApplicationProducer

findDataItem

public static java.lang.Object findDataItem(java.lang.String applicationName)

Get the application with the requested name.

Parameters:

applicationName - The name of the requested application.

Returns:

The requested application.

findMultipleApplications

public static FwkApplicationInterface[] findMultipleApplications(java.lang.String applicationName)

find multiple applications with the requested name.

Parameters:

applicationName - The name of the requested application.

Returns:

The requested application.

findMultipleApplications

public static FwkApplicationInterface[] findMultipleApplications(java.lang.String applicationName,
                                                 java.awt.datatransfer.DataFlavor[] dataFlavor)

Find multiple application on the application bus.

Parameters:

applicationName - The name of searched application.

dataFlavor - The data flavor of the requested application

Returns:

The requested application or null if not found.

See Also:

FwkApplicationProducer

findMultipleDataItems

public static java.lang.Object findMultipleDataItems(java.lang.String applicationName)

Get the application with the requested name.

Parameters:

applicationName - The name of the requested application.

Returns:

The requested application.

isEternal

public static boolean isEternal(java.lang.String applicationName)

Returns a boolean whether or not the requested application is registered eternal.

Parameters:

applicationName - The name of the application to be checked.

isRegistered

public static boolean isRegistered(java.lang.String applicationName)

Returns a boolean whether or not the requested application is already registered.

Parameters:

applicationName - The name of the application to be checked.

isRegistered

public static boolean isRegistered(FwkApplicationInterface appl)

Returns a boolean whether or not the requested application is already registered.

Parameters:

application - The application to be checked.

getUniqueName

public static java.lang.String getUniqueName(java.lang.String applicationName)

Get a unique registry name.

Parameters:

applicationName - The application base name.

Returns:

The unique name.

register

public static java.lang.String register(FwkApplicationInterface application)
                                 throws FwkException

Register a new application.

Parameters:

applicationName - The basic application name.

application - The application object.

Returns:

A unique application name.

Throws:

FwkException - if the application is eternal and already registered.

register

public static java.lang.String register(FwkApplicationInterface application,
                        java.awt.datatransfer.DataFlavor[] dataFlavor)
                                 throws FwkException

Register a new application under a special data flavor.

Parameters:

applicationName - The basic application name.

application - The application object.

dataFlavor - The data flavor array.

Returns:

A unique application name.

Throws:

FwkException

unregister

public static void unregister(FwkApplicationInterface application)

Unregister the application and exit if the last application was unregistered.

Parameters:

applicationName - The name of the application to be unregistered.

fetchEternal

public static FwkApplicationInterface fetchEternal(java.lang.String applName)

Fetch an eternal application. This is necessary whenever an eternal application has been unregistered.

Parameters:

applName - The name of the eternal application.

Throws:

FwkException - if the application isn't an eternal application.

loadClass

public static java.lang.Object loadClass(java.lang.String name)
                                  throws java.lang.Throwable

Load the class with the specified name and get an instance of that class.

Parameters:

name - The name of the class to be loaded.

Returns:

An instance of the requested class.

Throws:

FwkException - if not possible to get an instance.

java.lang.Throwable

launch

public static boolean launch(java.lang.String resources)
                      throws FwkException

Start and interpret resources.

Parameters:

resource - The comma or space separated list of resource to be interpreted and started.

Throws:

FwkException.

FwkException