com.groiss.server
Interface Admin

public interface Admin

Interface for administrative actions. Use ServiceLocator.getAdmin() to create an instance of this interface.

Method Summary

void	executeTimer(String id) Execute the timer with the given id
String	exportXML(List objects, String clustername, String description, Set<String> skipclasses, OutputStream os, PrintWriter pw) Perform an XML Export.
String	exportXML(String mainclass, String condition, List params, String clustername, String description, Set<String> skipclasses, OutputStream os, PrintWriter pw) Perform an XML Export.
void	generateFormClass(FormType ft) Generate the classes for the given form type.
String	getServerURL() returns the url to the web server, the information is maintained in the server object in the administration.
String	importXML(String resource) Perform an XML-Import.
void	initLogFile() Initialize the log file (start writing a new one)
boolean	isLoginAllowed() Is login ot @ep allowed?
void	refreshWorklistCacheInstances() Refresh the activities in the worklist cache
void	refreshWorklistCacheOrgData() Refresh the organizational data in the worklist cache
void	reloadDBConnections() Marks all Database Connections as old.
void	removeFieldModes(ProcessDefinition pd, String steplabel, String formid, String subformids) Remove the field modes of a form in a process.
void	replaceHTML(FormType ft, String htmlpage) Regenerate a form.
void	restartServer() Restart the @enterprise server
String	serverInfo() Print out the server information.
void	setFieldModes(ProcessDefinition pd, String steplabel, String formid, String subformids, Map<String,Short> modes) Set the field mode for a step in a process.
void	setLoginAllowed(String nodeid, boolean allowed, String message) Allow or deny the login on the given node.
void	setLoginAllowed(String nodeid, boolean allowed, String message, int currentSessions, String successorNodeId) Allow or deny the login on the given node.
URL	showClassLocation(String cl) Search the resource in the classpath.
void	stopServer() Stop the @enterprise server
String	viewLogFile() View the current log file

Method Detail

stopServer

void stopServer()

Stop the @enterprise server

restartServer

void restartServer()

Restart the @enterprise server

generateFormClass

void generateFormClass(FormType ft)
                       throws Exception

Generate the classes for the given form type.

Throws:

Exception

replaceHTML

void replaceHTML(FormType ft,
                 String htmlpage)
                 throws Exception

Regenerate a form. In case of HTML forms the second argument contains the HTML text for this form, in case of XHTML forms the second argument is ignored. The functions recreates the form classes and adds or drop fields to the form table if necessary. Note that the type of new form fields must be provided in the html text (attributes dbtype and dblength). NOTE: Import/Export functionality should be used instead of this method for transporting ALL aspects of form types.
NOTE 2: The method MAY make an implicit commit of the database transaction, when an alter table statement is executed. Be careful using this method in one transaction with other database operations.

Throws:

Exception

serverInfo

String serverInfo()
                  throws Exception

Print out the server information.

Throws:

Exception

executeTimer

void executeTimer(String id)
                  throws Exception

Execute the timer with the given id

Throws:

Exception

refreshWorklistCacheOrgData

void refreshWorklistCacheOrgData()

Refresh the organizational data in the worklist cache

refreshWorklistCacheInstances

void refreshWorklistCacheInstances()

Refresh the activities in the worklist cache

initLogFile

void initLogFile()

Initialize the log file (start writing a new one)

viewLogFile

String viewLogFile()
                   throws IOException

View the current log file

Throws:

IOException

isLoginAllowed

boolean isLoginAllowed()

Is login ot @ep allowed?

setLoginAllowed

void setLoginAllowed(String nodeid,
                     boolean allowed,
                     String message)
                     throws Exception

Allow or deny the login on the given node.

Parameters:

nodeid - id of cluster node, ignored in non-cluster mode

allowed - if true login is allowed

message - a message for the users trying to login.

Throws:

Exception

setLoginAllowed

void setLoginAllowed(String nodeid,
                     boolean allowed,
                     String message,
                     int currentSessions,
                     String successorNodeId)
                     throws Exception

Allow or deny the login on the given node.

Throws:

Exception

showClassLocation

URL showClassLocation(String cl)

Search the resource in the classpath.

importXML

String importXML(String resource)
                 throws Exception

Perform an XML-Import.

Parameters:

resource - a resource in the classpath

Returns:

the log information is returned

Throws:

Exception

exportXML

String exportXML(String mainclass,
                 String condition,
                 List params,
                 String clustername,
                 String description,
                 Set<String> skipclasses,
                 OutputStream os,
                 PrintWriter pw)
                 throws Exception

Perform an XML Export.

Parameters:

mainclass - export elements of this class

condition - restriction for mainclass

params - parameter of the condition

clustername - refers to a cluster in SchemaDescription contains a list of classes to export

description - description for export file

skipclasses - do not export member of these classes

os - write the export to this stream

pw - write the log to this writer

Returns:

a name of the export file

Throws:

Exception

exportXML

String exportXML(List objects,
                 String clustername,
                 String description,
                 Set<String> skipclasses,
                 OutputStream os,
                 PrintWriter pw)
                 throws Exception

Perform an XML Export.

Parameters:

objects - a homogenous list of objects of an exportable class

clustername - refers to a cluster in SchemaDescription contains a list of classes to export

description - description for export file

skipclasses - do not export member of these classes

os - write the export to this stream

pw - write the log to this writer

Returns:

a name of the export file

Throws:

Exception

getServerURL

String getServerURL()

returns the url to the web server, the information is maintained in the server object in the administration. The context path is taken from the configuration.

Returns:

an url string, for example: http://hostname:port/wf/

reloadDBConnections

void reloadDBConnections()

Marks all Database Connections as old. Old connections are refreshed before binding them to a thread. Refreshing means to close the connection and to open a new one. Can be used to redistribute database connections among nodes of a clustered DBMS.

setFieldModes

void setFieldModes(ProcessDefinition pd,
                   String steplabel,
                   String formid,
                   String subformids,
                   Map<String,Short> modes)

Set the field mode for a step in a process. The parameter subformids specifies the subform.

Parameters:

pd - the process definition object, mandatory

steplabel - the label of the step, mandatory

formid - the id of the form, mandatory

subformids - the key for subforms: If the modes of a subform are set, this parameter contains the subforms id(s) separated be a slash. Example: the form f has a subform g with id 1, g has a subform h with id 3, the parameter subformids should have the value "1/3" if setting the field values of form h. If the modes of a mainform are set the parameters is either "0" or may be null.

modes - The modes map is a map of fieldnames and mode values. See the constants in WfEngine for the value range. The field names are either the java field names of the form class of the classname and id of the subform, separated by a space.

removeFieldModes

void removeFieldModes(ProcessDefinition pd,
                      String steplabel,
                      String formid,
                      String subformids)

Remove the field modes of a form in a process.

Parameters:

pd - the process definition object, mandatory

steplabel - the steplabel, may be null

formid - id of the form in the process, mandatory

subformids - syntax as in setFieldModes, null means all form fields of the form (and step) are deleted.