%3 ::xotcl::Class ::xotcl::Class → __unknown __class_configureparameter ad_instforward ad_instproc allinstances extend_slot extend_slot_default instfilter instforward instinvar instmixin instparametercmd instproc method parameter slots superclass unknown uses ::xotcl::Object ::xotcl::Object → getExitHandler → setExitHandler → unsetExitHandler __object_configureparameter __timediff abstract ad_doc ad_forward ad_proc asHTML check class db_0or1row db_1row debug destroy_on_cleanup ds extractConfigureArg filter filtersearch forward hasclass init invar isclass ismetaclass ismixin isobject istype log method mixin mset msg parametercmd proc procsearch qn self serialize set_instance_vars_defaults unknown vwait www-show-object ::xotcl::Class->::xotcl::Object ::xotcl::RecreationClass ::xotcl::RecreationClass → recreate recreate ::xotcl::RecreationClass->::xotcl::Class

Class ::xotcl::RecreationClass

::xotcl::RecreationClass[i] create ... \
           [ -instreconfigure (default "1") ] \
           [ -instrecreate instrecreate ] \
           [ -instreinit instreinit ] \
           [ -reconfigure (default "1") ] \
           [ -reinit reinit ]

This meta-class controls the behavior of classes (and optionally their instances), when the classes (or their instances) are overwritten by same named new objects; we call this situation a recreate of an object.

Normally, when files with e.g. class definitions are sourced, the classes and objects are newly defined. When e.g. class definitions exists already in this file, these classes are deleted first before they are newly created. When a class is deleted, the instances of this class are changed into instances of class ::xotcl::Object.

This can be a problem when the class instances are not reloaded and when they should survife the redefinition with the same class relationships. Therefore, we define a meta class RecreationClass, which can be used to parameterize the behavior on redefinitions. Alternatively, Classes or objects could provide their own recreate methods.

Per default, this meta-class handles only the class redefinition case and does only a reconfigure on the class object (in order to get e.g. ad_doc updated).

The following parameters are defined:
  • reconfigure: reconfigure class (default 1)
  • reinit: run init after configure for this class (default unset)
  • instrecreate: handle recreate of class instances (default unset) When this flag is set to 0, instreconfigure and instreinit are ignored.
  • instreconfigure: reconfigure instances of this class (default 1)
  • instreinit: re-init instances of this class (default unset)
Defined in /var/www/openacs.org/packages/xotcl-core/tcl/10-recreation-procs.tcl

Class Relations

  • class: ::xotcl::Class[i]
  • superclass: ::xotcl::Class[i]

Methods (to be applied on the object)

  • recreate (scripted)

Methods (to be applied on instances)

  • instreconfigure (setter)

  • instrecreate (setter)

  • instreinit (setter)

  • reconfigure (setter)

  • recreate (scripted)

  • reinit (setter)