com.bmc.arsys.pluginsvr.plugins
Class ARPlugin

java.lang.Object
  com.bmc.arsys.pluginsvr.plugins.ARPlugin

All Implemented Interfaces:

ARPluggable

Direct Known Subclasses:

ARDBCPlugin, AREAPlugin, ARFilterAPIPlugin

public abstract class ARPlugin
extends Object
implements ARPluggable

Default implementation for the ARPluggable interface. All plugins can implement a public void static init(ARPluginContext context) method to do all intialization for this class. This will be invoked once for each class that implements one of the ARPluggable interfaces on plugin server startup. This same thing can be accomplished using a static block of code in the class. The only advantage in implementing this method is that it gets access to the ARPluginContext object that can be used for the following purposes. 1. Logging any initialization messages 2. Fetching configuration file entries for this plugin from pluginsvr_config.xml file. 3. Get AR System configuration entries from the ar.cfg file. For all instance initialization, the public initialize(ARPluginContext context) should be used. The initialize method is invoked once for each thread instance in plugin server.

Constructor Summary

ARPlugin()

Method Summary

void	initialize(ARPluginContext context) An initialization routine called once at startup load time for each plugin that is loaded.
void	onEvent(ARPluginContext context, int pEventID) Methods to handle events from the AR Server.
void	terminate(ARPluginContext context) A clean up method called on a plugin unload or plugin server termination for the plugin to cleanup after itself.

Methods inherited from class java.lang.Object

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

Constructor Detail

ARPlugin

public ARPlugin()

Method Detail

onEvent

public void onEvent(ARPluginContext context,
                    int pEventID)
             throws com.bmc.arsys.api.ARException

Description copied from interface: ARPluggable

Methods to handle events from the AR Server. Events could include change in configuration file etc. Called every time any such event occurs.

Specified by:

onEvent in interface ARPluggable

Parameters:

context - Current context for this plugin call, like username etc.

pEventID - the ID for the event that occured

Throws:

com.bmc.arsys.api.ARException

initialize

public void initialize(ARPluginContext context)
                throws com.bmc.arsys.api.ARException

Description copied from interface: ARPluggable

An initialization routine called once at startup load time for each plugin that is loaded. The plugin can do all its initialization and setup in this method.

Specified by:

initialize in interface ARPluggable

Parameters:

context - Current context for this plugin call, like username etc.

Throws:

com.bmc.arsys.api.ARException

terminate

public void terminate(ARPluginContext context)
               throws com.bmc.arsys.api.ARException

Description copied from interface: ARPluggable

A clean up method called on a plugin unload or plugin server termination for the plugin to cleanup after itself.

Specified by:

terminate in interface ARPluggable

Parameters:

context - Current context for this plugin call, like username etc.

Throws:

com.bmc.arsys.api.ARException