1. new in this version
2. build a web 2.0 app in happstack
3. why happstack is cool
4. getting started with happstack
5. prerequisites
6. cabal install me
7. first shot at happstack
8. url handling
9. basic HTML inclusion
10. templates
11. stringtemplate basics
12. debugging
13. form data: get and post
14. form data: file uploads
15. cookies
16. introduction to macid
17. first steps with macid
18. scaling with multimaster
19. using macid safely
20. macid dummy data
21. changing the data model
22. macid stress test
23. limitations of macid
24. foreign characters
25. IxSets
26. cron jobs
27. thanks
28. appendix (floundering in ghci)

Basic Request Handling in Happstack

One of the most basic functions of a web framework is to give you a way of controlling what happens when a web browser makes an http request.

Let's look at some simple examples.

1. Read the source code of the simpleHandlers function in ControllerBasic.hs to see how urls are handled in Happstack. The comments contain the bulk of the information in this chapter.
2. Follow the urls below by clicking on them. Match what happens when you click on a link with the code in ControllerBasic.hs.
• introduction to handlers: hello world
• exactdir (subdirectories of the path argument do not match): exactdir ... exactdir/subdir ...
• introduction to dir -- subdirectories *do* match: dir ... dir/subdir
• gluing handlers together / handlers as monoids: handleraddition1 ... handleraddition2 ... handleraddition3 ... handleraddition4 ... handleraddition5
• the "empty" handler: nohandle1
• IO in the response: IO Response ... Another IO Response
• Formatted html: First attempt at formatted html (wrong)
• Second attempt at formatted html (right)
• Foreign characters in formatted html
• Serving static files: Using dir and fileserve "templates", we can view templates ... The template that was used to generate this page
• redirection with seeOther

The static file serving example above hints at the templating system used by this tutorial to put together web pages behind the scenes.

We learn about ways to conveniently include HTML next.