/**
* This class provides switch yarn for weaving into objects. In this manner, it provides aspect-oriented programming services
* for objects and classes in JavaScript.
*
* Ellen Hudson-Snyder,
* Elvin Vedar,
* Christopher M. Balz.
*
CVS Version Info:
* $Id: SwitchYarn.js,v 1.3 2005/11/27 16:31:28 cbalz Exp $
*
* @object-prop strTargetFunctionName string The name of the target method on its object.
* @object-prop funTarget function The target method itself.
* @object-prop strfunYarn function OR string The code, as string or as
* function, to
* be woven into a the target method. If
* the code is in
* function form, the top
* ('function . . . {') and
* bottom (including any final 'return')
* will be removed.
* @object-prop pStrCase string A string with the code for the case statement to be
* inserted into: i.e., " case \"plate\" : ". Note that
* the existence of this parameter allows the matched case
* statement to be changed by the aspect weave operation.
* @object-prop pRxpCase RegExp A regular expression that matches the case statement to be
* inserted into: i.e., /case "plate"\s?:/.
* @object-prop pStrSwitch string A string with the code for the switch statement to be
* inserted into: i.e., " switch (pStrEventType) {". This
* switch statement currently must exist directly below and
* nested within the case statement listed above. Note that
* the existence of this parameter allows the matched switch
* statement to be changed by the aspect weave operation.
* @object-prop pRxpCase RegExp A regular expression that matches the switch statement to be
* inserted into: i.e., /switch\s*\(pStrEventType\)\s*\{/. This
* switch statement currently must exist directly below and
* nested within the case statement listed above.
*/
/**
* Create a ball of switch statement yarn for an aspect to weave.
* An aspect is the central element
* of a software engineering paradigm, Aspect Oriented Programming, which complements object-oriented
* software engineering.
* @param strTargetFunctionName string The name of the target method on its object.
* @param funTarget function The target method itself.
* @param strfunYarn function OR string The code, as string or as
* function, to
* be woven into a the target method. If
* the code is in
* function form, the top
* ('function . . . {') and
* bottom (including any final 'return')
* will be removed.
* @param pStrCase string A string with the code for the case statement to be
* inserted into: i.e., " case \"plate\" : ". Note that
* the existence of this parameter allows the matched case
* statement to be changed by the aspect weave operation.
* @param pRxpCase RegExp A regular expression that matches the case statement to be
* inserted into: i.e., /case "plate"\s?:/.
* @param pStrSwitch string A string with the code for the switch statement to be
* inserted into: i.e., " switch (pStrEventType) {". This
* switch statement currently must exist directly below and
* nested within the case statement listed above. Note that
* the existence of this parameter allows the matched switch
* statement to be changed by the aspect weave operation.
* @param pRxpCase RegExp A regular expression that matches the switch statement to be
* inserted into: i.e., /switch\s*\(pStrEventType\)\s*\{/. This
* switch statement currently must exist directly below and
* nested within the case statement listed above.
*/
function SwitchYarn(strTargetFunctionName, funTarget, strFunYarn, pStrCase, pRxpCase, pStrSwitch, pRxpSwitch) {
this.strTargetFunctionName = strTargetFunctionName;
this.funTarget = funTarget;
this.strFunYarn = strFunYarn;
this.strCase = pStrCase;
this.rxpCase = pRxpCase;
this.strSwitch = pStrSwitch;
this.rxpSwitch = pRxpSwitch;
}