drcl.ruv
Class Shell

java.lang.Object
  drcl.DrclObj
      drcl.comp.Component
          drcl.ruv.Shell

All Implemented Interfaces:

java.lang.Cloneable, ObjectCloneable, ObjectDuplicable, java.io.Serializable, StackTraceFilter

Direct Known Subclasses:

ShellPython, ShellTcl

public abstract class Shell

extends Component

implements StackTraceFilter

The base class for all shell classes. Properties

• non-duplicable
• non-disposable

Ports (in addition to those defined in drcl.comp.Component):

• "file" port (input): receives the file name of a script (String) to execute.
• "result" port (output): sends out results of executions. At the end of execution, it sends a null.
• command port: all the other ports are considered as command ports; it receives commands (String) to execute and replies complete/incomplete (boolean).

The class defines a default "command" port to receives commands.

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class drcl.comp.Component

Component.Locks

Field Summary

Fields inherited from class drcl.comp.Component

FLAG_COMPONENT_NOTIFICATION, FLAG_DEBUG_ENABLED, FLAG_DIRECT_OUTPUT_ENABLED, FLAG_ENABLED, FLAG_ERROR_ENABLED, FLAG_EVENT_ENABLED, FLAG_GARBAGE_DISPLAY_ENABLED, FLAG_GARBAGE_ENABLED, FLAG_PORT_NOTIFICATION, FLAG_STARTED, FLAG_STOPPED, FLAG_TRACE_ENABLED, FLAG_UNDEFINED_START, id, infoPort, locks, name, parent, PortGroup_DEFAULT_GROUP, PortGroup_EVENT, PortGroup_SERVICE, Root, Trace_DATA, Trace_SEND

Constructor Summary

Shell()

Shell(java.lang.String id_)

Method Summary

void	duplicate(java.lang.Object source_) Duplicates the content of source_, including ID, name, child components and connections among them, to this component.
java.lang.Object	eval(java.io.BufferedReader r_)
java.lang.Object	evalFile(java.lang.String script_, java.lang.String[] args_)
void	evalResource(java.lang.String resource_) Script is from resource.
java.lang.String	filter(java.lang.Exception e_) Filters the stack trace in the exception and returns the result.
java.lang.String	info() Returns information regarding this component.
boolean	isResultAffirmative(java.lang.Object result_) Returns true if the result is affirmative for this shell language.
void	print(java.lang.String msg_)
void	println(java.lang.String msg_)
void	process(java.lang.Object data_, Port inPort_)
void	reset() Resets the component for being used anew.

Methods inherited from class drcl.comp.Component

addComponent, addComponent, addEventPort, addEventPort, addForkPort, addPort, addPort, addPort, addPort, addPort, addPort, addPort, addPort, addServerPort, addServerPort, cancelFork, connect, containsComponent, containsComponent, containsPort, debug, disconnectAll, disconnectAllPeers, disconnectAllPorts, drop, drop, error, error, expose, exposeEventPorts, exposePort, exposePort, exposePort, exposePort, exposePort, findAvailable, findAvailable, findAvailable, fork, forkAt, getAllComponents, getAllPorts, getAllPorts, getAllWiresInside, getAllWiresInsideOut, getAllWiresOut, getComponent, getComponentFlag, getComponentFlag, getContract, getContractHT, getContractHT, getDebugFlagsInBinary, getDebugLevelNames, getID, getName, getParent, getPort, getPort, getRoot, getTime, iduplicate, isAncestorOf, isContainer, isDebugEnabled, isDebugEnabledAt, isDirectlyRelatedTo, isDirectOutputEnabled, isEnabled, isErrorNoticeEnabled, isEventExportEnabled, isGarbageDisplayEnabled, isGarbageEnabled, isPortRemovable, isStarted, isStopped, isTraceEnabled, lock, notify, notifyAll, operate, reboot, removeAll, removeAllComponents, removeAllPorts, removeAllPorts, removeComponent, removeComponent, removePort, removePort, removePort, resume, run, sduplicate, send, sendAt, setComponentFlag, setComponentFlag, setDebugEnabled, setDebugEnabled, setDebugEnabledAt, setDebugEnabledAt, setDebugEnabledAt, setDirectOutputEnabled, setDirectOutputEnabled, setEnabled, setErrorNoticeEnabled, setErrorNoticeEnabled, setEventExportEnabled, setEventExportEnabled, setExecutionBoundary, setGarbageDisplayEnabled, setGarbageDisplayEnabled, setGarbageEnabled, setGarbageEnabled, setID, setID, setName, setPort, setPort, setTraceEnabled, setTraceEnabled, sleepFor, sleepUntil, stop, toString, unexpose, unlock, useLocalForkManager, useLocalForkManager, wait

Methods inherited from class drcl.DrclObj

clone

Methods inherited from class java.lang.Object

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

Constructor Detail

Shell

public Shell()
      throws java.lang.Exception

Shell

public Shell(java.lang.String id_)
      throws java.lang.Exception

Method Detail

reset

public void reset()

Description copied from class: Component

Resets the component for being used anew. All the internal variables must be set to the initial state. All the ports and child components are reset as well.

Overrides:

reset in class Component

info

public java.lang.String info()

Description copied from class: Component

Returns information regarding this component. Subclasses should override this method to provide useful information at run time.

Overrides:

info in class Component

process

public void process(java.lang.Object data_,
                    Port inPort_)

Parameters:

data_ - the arrival data.

inPort_ - the port where the data arrives.

duplicate

public void duplicate(java.lang.Object source_)

Description copied from class: Component

Duplicates the content of source_, including ID, name, child components and connections among them, to this component. Subclasses need to override this method to copy its own variables.

Specified by:

duplicate in interface ObjectDuplicable

Overrides:

duplicate in class Component

evalFile

public final java.lang.Object evalFile(java.lang.String script_,
                                       java.lang.String[] args_)
                                throws ShellEvalException,
                                       java.lang.InterruptedException

Throws:

ShellEvalException

java.lang.InterruptedException

evalResource

public final void evalResource(java.lang.String resource_)
                        throws ShellEvalException

Script is from resource.

Throws:

ShellEvalException

eval

public java.lang.Object eval(java.io.BufferedReader r_)
                      throws ShellEvalException,
                             java.lang.InterruptedException

Throws:

ShellEvalException

java.lang.InterruptedException

print

public void print(java.lang.String msg_)

println

public void println(java.lang.String msg_)

isResultAffirmative

public boolean isResultAffirmative(java.lang.Object result_)

Returns true if the result is affirmative for this shell language.

filter

public java.lang.String filter(java.lang.Exception e_)

Description copied from interface: StackTraceFilter

Filters the stack trace in the exception and returns the result.

Specified by:

filter in interface StackTraceFilter