---

::xotcl::Class ::xo::Context

Class Hierarchy of ::xo::Context

• ::xotcl::Object

  Meta-class:

  ::xotcl::Class

  Methods for instances:

  __api_make_doc, __api_make_forward_doc, __timediff, abstract, ad_doc, ad_forward, ad_proc, append^C, array^C, asHTML, autoname^C, check, class^C, cleanup^C, configure^C, contains^C, copy^C, db_0or1row^C, db_1row^C, debug, defaultmethod^C, destroy^C, destroy_on_cleanup, ds, eval^C, exists^C, extractConfigureArg, filter^C, filterguard^C, filtersearch, forward, hasclass, incr^C, info^C, init, instvar^C, invar^C, isclass, ismetaclass, ismixin, isobject, istype, lappend^C, log, method, mixin^C, mixinguard^C, move^C, msg, noinit^C, objectparameter, parametercmd^C, proc, procsearch, qn, requireNamespace^C, residualargs^C, self, serialize, set^C, set_instance_vars_defaults, show-object, subst^C, trace^C, unknown, unset^C, uplevel^C, upvar^C, volatile^C, vwait

  Methods to be applied on the class (in addition to the methods provided by the meta-class):

  getExitHandler, setExitHandler, unsetExitHandler

• ::xo::Context

  Meta-class:

  ::xotcl::Class

  Parameter for instances:

  actual_query (default " "), locale, package_id (default "0"), parameter_declaration (default "")

  Methods for instances:

  exists_query_parameter, export_vars, get_all_query_parameter, get_parameters, initialize, original_url_and_query, process_query_parameter, query_parameter

  Methods to be applied on the class:

  Methods provided by the meta-class

This class provides a context for evaluation, somewhat similar to an activation record in programming languages. It combines the parameter declaration (e.g. of a page, an includelet) with the actual parameters (specified in an includelet) and the provided query values (from the url). The parameter decaration are actually XOTcl's non positional arguments.

Defined in packages/xotcl-core/tcl/context-procs.tcl

Class Relations

• superclass: ::xotcl::Object
• subclass: ::xo::ConnectionContext, ::xowiki::Includelet

::xotcl::Class create ::xo::Context \
     -superclass ::xotcl::Object \
     -parameter {{actual_query " "} locale {package_id 0} {parameter_declaration ""}}

Methods

• instproc export_vars (public)

  <instance of ::xo::Context> export_vars [ -level level ]

  Export the query variables

  Switches:

  -level (defaults to "1") (optional)

  target level

  ::xowiki::policy5 instproc export_vars {{-level 1}} {
      my instvar queryparm package_id
  
      foreach p [my array names queryparm] {
        regsub -all : $p _ varName
        uplevel $level [list set $varName [my set queryparm($p)]]
      }
      uplevel $level [list set package_id $package_id]
      #::xo::show_stack
    }
  

• instproc get_parameters (public)

  <instance of ::xo::Context> get_parameters

  Convenience routine for includelets. It combines the actual parameters from the call in the page (highest priority) wit the values from the url (second priority) and the default values from the signature

  ::xowiki::policy5 instproc get_parameters {} {
      set source [expr {[my exists __caller_parameters] ? 
                        [self] : [my info parent]}]
      $source instvar __caller_parameters
      
      if {![my exists __including_page]} {
        # a includelet is called from the toplevel. the actual_query might
        # be cached, so we reset it here.
        my actual_query [::xo::cc actual_query]
      }
  
      if {[info exists __caller_parameters]} {
        my process_query_parameter -all_from_query false -caller_parameters $__caller_parameters
      } else {
        my process_query_parameter -all_from_query false
      }
      my export_vars -level 2 
    }
  

---