annotate framework/env/request/add_variable.lua @ 259:41be09ce6aa3
Allow tables as sub-values of request variables (won't be cloned)
| author |
jbe |
| date |
Sun Mar 15 01:14:21 2015 +0100 (2015-03-15) |
| parents |
9e4be058959d |
| children |
|
| rev |
line source |
|
jbe@255
|
1 --[[--
|
|
jbe@255
|
2 request.add_variable(
|
|
jbe@255
|
3 tbl, -- table where the variable is stored
|
|
jbe@255
|
4 key, -- name of variable (key within the table)
|
|
jbe@255
|
5 value -- optional value for initialization
|
|
jbe@255
|
6 )
|
|
jbe@255
|
7
|
|
jbe@259
|
8 Marks a field of a table to be re-initialized for every request. If this variable (i.e. the field of the table) is modified before the first requst is being handled (e.g. during configuration or pre-/post-fork initializers), then the modified value will be used for re-initialization on every request. If the (modified) value is a table, the table will be cloned on every request to avoid side-effects between different requests. Note, however, that only the first level of the table is cloned. See env/request/__init.lua for examples.
|
|
jbe@255
|
9
|
|
jbe@255
|
10 --]]--
|
|
jbe@255
|
11
|
|
jbe@255
|
12 function request.add_variable(tbl, key, value)
|
|
jbe@259
|
13 local initval, istable
|
|
jbe@255
|
14 tbl[key] = value
|
|
jbe@255
|
15 request.add_initializer(function(first)
|
|
jbe@255
|
16 if first then
|
|
jbe@259
|
17 initval = tbl[key]
|
|
jbe@259
|
18 istable = type(initval) == "table"
|
|
jbe@255
|
19 else
|
|
jbe@259
|
20 if istable then
|
|
jbe@259
|
21 tbl[key] = table.new(initval)
|
|
jbe@259
|
22 else
|
|
jbe@259
|
23 tbl[key] = initval
|
|
jbe@259
|
24 end
|
|
jbe@255
|
25 end
|
|
jbe@255
|
26 end)
|
|
jbe@255
|
27 end
|