org.mmbase.module.builders
Class Vwms

java.lang.Object
  |
  +--org.mmbase.module.core.MMTable
        |
        +--org.mmbase.module.core.MMObjectBuilder
              |
              +--org.mmbase.module.builders.Vwms

All Implemented Interfaces:

MMBaseObserver

public class Vwms

extends MMObjectBuilder

implements MMBaseObserver

Virtual WebMasterS (VWMS) are agents within MMBase. To be able to start a VWMS the following things have to be done:
- Create a VWMS that does the work
- Start the VWMS in the VWMS-Builder.
- Make a relation from the Vwm object to a MMserver.
- start the VWMS-Builder if it isn't already running.

In the Vwms builder you have to insert the following information:
Name: name of the Vwm
Machine: machine on which the VwmM is running (wanted_cpu)
Maintenance_Time: This is the interval time in which the Vwm is invoked
State: inactive means Vwm is off. active means Vwm is on.
Description: just a description
ClassName: the classname of the actual VWM that is performing the task.
Note that currently, vwms are only started during startup.

Version:

5-Apr-2001

Author:

Arjan Houtman, Rico Jansen, Pierre van Rooden (javadoc)

Field Summary

static int	STATUS_ACTIVE Status value for a VWM that it is active
static int	STATUS_INACTIVE Status value for a VWM that it is inactive
static int	STATUS_REFRESH Status value for a VWM that it is being refreshed (?)

Fields inherited from class org.mmbase.module.core.MMObjectBuilder

broadcastChanges, className, database, debug, description, descriptions, fields, NODE_MAX_SIZE, nodeCache, obj2type, OBJ2TYPE_MAX_SIZE, oType, replaceCache, searchAge, sortedDBLayout, TEMPNODE_DEFAULT_SIZE, TemporaryNodes, virtual

Fields inherited from class org.mmbase.module.core.MMTable

mmb, tableName

Constructor Summary

Vwms()

Method Summary

java.lang.String	getGUIIndicator(java.lang.String field, MMObjectNode node) Returns gui information for a field.
VwmInterface	getVwm(java.lang.String vwmname) Retrieve a currently active vwm by name.
boolean	init() Initializes the vwms builder.
boolean	nodeLocalChanged(java.lang.String machine, java.lang.String number, java.lang.String builder, java.lang.String ctype) Passes a local change of a vwms node to the appropriate (active) vwm.
boolean	nodeRemoteChanged(java.lang.String machine, java.lang.String number, java.lang.String builder, java.lang.String ctype) Passes a remote change of a vwms node to the appropriate (active) vwm.
boolean	putTask(java.lang.String vwmname, MMObjectNode node) Passes a task to a vwm.
boolean	sendMail(java.lang.String who, java.lang.String subject, java.lang.String msg) Send mail, using this builder's email settings.
boolean	sendMail(java.lang.String who, java.lang.String to, java.lang.String subject, java.lang.String msg) Send mail, using this builder's email settings.
void	startVwms() Starts all vwms whose 'entries are related to the current server (entry in mmservers), and that are marked as 'active'.
void	startVwmsByField() Deprecated. Unused. Use startVwms() instead.

Methods inherited from class org.mmbase.module.core.MMObjectBuilder

addField, addLocalObserver, addRemoteObserver, buildSet, checkAddTmpField, commit, convertMMNode2SQL, count, create, createAlias, created, debug, deleteNodeCache, executeFunction, fieldLocalChanged, getAge, getAliasedNode, getCacheNumbers, getCacheSize, getCacheSize, getClassName, getDBByte, getDBKey, getDBState, getDBText, getDBType, getDefaultTeaser, getDefaultUrl, getDescription, getDescriptions, getDutchSName, getEditFields, getField, getFieldNames, getFields, getFullTableName, getFunctionParameters, getGUIIndicator, getHardNode, getHTML, getInitParameter, getInitParameters, getList, getMachineName, getMaintainer, getNewNode, getNewTmpNode, getNextField, getNode, getNode, getNodeType, getNumberFromName, getPluralName, getPluralName, getPluralNames, getRelations_main, getSearchAge, getShort, getShortedByte, getShortedText, getSingularName, getSingularName, getSingularNames, getSmartPath, getSortedFields, getSortedListFields, getTableName, getTmpNode, getURLEncode, getValue, getVersion, getWAP, getXMLPath, getXMLSetup, hostname_function, init_obj2type, insert, insert, insertDone, isNodeCached, isVirtual, isXMLConfig, preCommit, preEdit, process, putTmpNode, readSearchResults, removeField, removeNode, removeRelations, removeTmpNode, replace, search, search, search, searchIn, searchIn, searchIn, searchNumbers, searchVector, searchVector, searchVector, searchVector, searchVectorIn, searchVectorIn, searchVectorIn, searchVectorIn, searchWithWhere, sendFieldChangeSignal, setClassName, setDBLayout_xml, setDBLayout, setDebug, setDefaults, setDescription, setDescriptions, setDutchSName, setInitParameter, setMaintainer, setMMBase, setPluralNames, setSearchAge, setSingularNames, setTableName, setValue, setVersion, setXmlConfig, setXMLPath, setXMLValues, signalNewObject, testValidData, toXML, waitUntilNodeChanged, wrap

Methods inherited from class org.mmbase.module.core.MMTable

size

Methods inherited from class java.lang.Object

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

Field Detail

STATUS_INACTIVE

public static final int STATUS_INACTIVE

Status value for a VWM that it is inactive

STATUS_ACTIVE

public static final int STATUS_ACTIVE

Status value for a VWM that it is active

STATUS_REFRESH

public static final int STATUS_REFRESH

Status value for a VWM that it is being refreshed (?)

Constructor Detail

Vwms

public Vwms()

Method Detail

init

public boolean init()

Initializes the vwms builder. Doesn't do anything, which is odd as you would expect it to read the emailXXX properties. This now happens in the sendMail(java.lang.String, java.lang.String, java.lang.String) method.

Overrides:

init in class MMObjectBuilder

Returns:

Always true.

getGUIIndicator

public java.lang.String getGUIIndicator(java.lang.String field,
                                        MMObjectNode node)

Returns gui information for a field. Returns a descriptive value in the case of the 'status' field.

Overrides:

getGUIIndicator in class MMObjectBuilder

Parameters:

node - The node to display

field - the name field of the field to display

Returns:

the display of the node's field as a String, null if not specified

startVwmsByField

public void startVwmsByField()

Deprecated. Unused. Use startVwms() instead.

Starts all vwms whose 'wanted_cpu' field indicates they want to be run on this machine (either this particular one or all machines), and that are marked as 'active'. The builder tries to load the class (which should implement the VwmInterface), instantiate a vwms using that class, and initialize it. The vwm is also referred to as a 'bot'.

startVwms

public void startVwms()

Starts all vwms whose 'entries are related to the current server (entry in mmservers), and that are marked as 'active'. The builder tries to load the class (which should implement the VwmInterface), instantiate a vwms using that class, and initialize it.

putTask

public boolean putTask(java.lang.String vwmname,
                       MMObjectNode node)

Passes a task to a vwm.

Parameters:

vwmname - the name of the vwm to pass the task

node - the node to apss as a task

Returns:

true if the task was passed, false if the vwm did not exist.

sendMail

public boolean sendMail(java.lang.String who,
                        java.lang.String subject,
                        java.lang.String msg)

Send mail, using this builder's email settings. Passes its parameters,a s well as the field emailTo to the method that actually sends the mail. The field emailTo can be null when passed the first time, which means that the first call would always fail (?)

Parameters:

who - email address (?) of the sender

subject - subject of the message

msg - the message itself

Returns:

true if the mail was send, false otherwise

sendMail

public boolean sendMail(java.lang.String who,
                        java.lang.String to,
                        java.lang.String subject,
                        java.lang.String msg)

Send mail, using this builder's email settings.

Parameters:

who - email address (?) of the sender

to - email address of the receiver

subject - subject of the message

msg - the message itself

Returns:

true if the mail was send, false otherwise

getVwm

public VwmInterface getVwm(java.lang.String vwmname)

Retrieve a currently active vwm by name.

Parameters:

vwmname - the name of the vwm to retrieve

Returns:

a VwmInterface object, or null if the vwm does not exist or is not active.

nodeRemoteChanged

public boolean nodeRemoteChanged(java.lang.String machine,
                                 java.lang.String number,
                                 java.lang.String builder,
                                 java.lang.String ctype)

Passes a remote change of a vwms node to the appropriate (active) vwm.

Specified by:

nodeRemoteChanged in interface MMBaseObserver

Overrides:

nodeRemoteChanged in class MMObjectBuilder

Parameters:

machine - Name of the machine that changed the node.

number - Number of the changed node as a String

builder - type of the changed node

ctype - command type, not very well documented

Returns:

always true

nodeLocalChanged

public boolean nodeLocalChanged(java.lang.String machine,
                                java.lang.String number,
                                java.lang.String builder,
                                java.lang.String ctype)

Passes a local change of a vwms node to the appropriate (active) vwm.

Specified by:

nodeLocalChanged in interface MMBaseObserver

Overrides:

nodeLocalChanged in class MMObjectBuilder

Parameters:

machine - Name of the machine that changed the node.

number - Number of the changed node as a String

builder - type of the changed node

ctype - command type, not very well documented

Returns:

always true