Wapp

Check-in [2eac47dda7]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Documentation updates: improvements to the description of URL mapping and CGI variables.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 2eac47dda7d58fe2b19640ddc753131ae27cb65a577fefe9e3207bcb8a5be295
User & Date: drh 2019-03-07 13:34:03.137
Context
2019-03-07
14:37
Further documentation refinements. (check-in: 271766c541 user: drh tags: trunk)
13:34
Documentation updates: improvements to the description of URL mapping and CGI variables. (check-in: 2eac47dda7 user: drh tags: trunk)
2019-03-06
23:12
More documentation tweaks. (check-in: 7be9077b84 user: drh tags: trunk)
Changes
Side-by-Side Diff Ignore Whitespace Patch
Changes to docs/urlmapping.md.
︙
10
11
12
13
14
15
16
17

18
19
20
21
22
23



24

25





26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

10
11
12
13
14
15
16

17
18
19
20



21
22
23
24
25

26
27
28
29
30
31
32
33
34
35






36
37
38
39
40
41
42








-
+



-
-
-
+
+
+

+
-
+
+
+
+
+





-
-
-
-
-
-








    https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42
    \___/   \_________/ \______________________/ \__________/ \_____/
      |          |              |                     |          |
    scheme   authority        path                  query      fragment


Assuming that /demo/env.tcl is the script that implements the application,
tradition CGI and SCGI, and Wapp, break a URL down like this:
traditional CGI and SCGI provide the following breakdown:

>
    https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42
            \_________/ \__________/\__________/
                 |           |          |
             HTTP_HOST  SCRIPT_NAME  PATH_INFO
            \_________/ \__________/\__________/ \__________/
                 |           |          |             |
             HTTP_HOST  SCRIPT_NAME  PATH_INFO   QUERY_STRING

Wapp provides additional variables not found in traditional CGI:
>

>
                SELF_URL
     ______________|___________________
    /                                  \
    https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42
    \______________________________/ \_/ \_____/
                   |                  |     |
                BASE_URL         PATH_HEAD  '-- PATH_TAIL     

>
    https://wapp.tcl.tk/demo/env.tcl/abc/def/ghi?a=5&b=22.425#point42
    \__________________________________/         \__________/
                   |                                  |
                SELF_URL                         QUERY_STRING


2.0 URL Mapping
---------------

The URL Mapper is the function that determines which routine in the
application should handle an HTTP request based on the URL.  In Wapp,
the default URL Mapper simply looks at PATH\_HEAD and invokes the
︙