← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to www/dispatch/__init__.py

  • Committer: mattgiuca
  • Date: 2008-08-18 09:32:03 UTC
  • Revision ID: svn-v3-trunk0:2b9c9e99-6f39-0410-b283-7f802c844ae2:trunk:1023
tutorialservice: Removed 'run' action from tutorialservice (wasn't actually
    being used -- was just a dummy, then run was implemented a different way).

Show diffs side-by-side

added added

removed removed

Lines of Context:
www/dispatch/__init__.py
27
27
# Then passes the request along to the appropriate ivle app.
28
28
 
29
29
import mod_python
30
 
from mod_python import apache
 
30
from mod_python import apache, Cookie
31
31
 
 
32
import sys
32
33
import os
33
34
import os.path
 
35
import urllib
 
36
 
34
37
import conf
35
38
import conf.apps
 
39
import conf.conf
36
40
import apps
37
41
 
38
42
from request import Request
39
43
import html
 
44
import cgi
40
45
import login
41
 
from common import util
 
46
from common import (util, forumutil)
 
47
import traceback
 
48
import plugins.console
 
49
import logging
 
50
import socket
 
51
import time
 
52
 
 
53
# List of cookies that IVLE uses (to be removed at logout)
 
54
ivle_cookies = ["ivleforumcookie", "clipboard"]
42
55
 
43
56
def handler(req):
44
57
    """Handles a request which may be to anywhere in the site except media.
48
61
    """
49
62
    # Make the request object into an IVLE request which can be passed to apps
50
63
    apachereq = req
51
 
    req = Request(req, html.write_html_head)
 
64
    try:
 
65
        req = Request(req, html.write_html_head)
 
66
    except Exception:
 
67
        # Pass the apachereq to error reporter, since ivle req isn't created
 
68
        # yet.
 
69
        handle_unknown_exception(apachereq, *sys.exc_info())
 
70
        # Tell Apache not to generate its own errors as well
 
71
        return apache.OK
 
72
 
 
73
    # Run the main handler, and catch all exceptions
 
74
    try:
 
75
        return handler_(req, apachereq)
 
76
    except mod_python.apache.SERVER_RETURN:
 
77
        # An apache error. We discourage these, but they might still happen.
 
78
        # Just raise up.
 
79
        raise
 
80
    except Exception:
 
81
        handle_unknown_exception(req, *sys.exc_info())
 
82
        # Tell Apache not to generate its own errors as well
 
83
        return apache.OK
 
84
 
 
85
def handler_(req, apachereq):
 
86
    """
 
87
    Nested handler function. May raise exceptions. The top-level handler is
 
88
    just used to catch exceptions.
 
89
    Takes both an IVLE request and an Apache req.
 
90
    """
 
91
    # Hack? Try and get the user login early just in case we throw an error
 
92
    # (most likely 404) to stop us seeing not logged in even when we are.
 
93
    if not req.publicmode:
 
94
        req.user = login.get_user_details(req)
52
95
 
53
96
    # Check req.app to see if it is valid. 404 if not.
54
97
    if req.app is not None and req.app not in conf.apps.app_url:
56
99
        if req.app == 'logout':
57
100
            logout(req)
58
101
        else:
59
 
            # TODO: Nicer 404 message?
60
 
            req.throw_error(Request.HTTP_NOT_FOUND)
 
102
            req.throw_error(Request.HTTP_NOT_FOUND,
 
103
                "There is no application called %s." % repr(req.app))
61
104
 
62
 
    # Special handling for public mode - just call public app and get out
 
105
    # Special handling for public mode - only allow the public app, call it
 
106
    # and get out.
63
107
    # NOTE: This will not behave correctly if the public app uses
64
108
    # write_html_head_foot, but "serve" does not.
65
109
    if req.publicmode:
 
110
        if req.app != conf.apps.public_app:
 
111
            req.throw_error(Request.HTTP_FORBIDDEN,
 
112
                "This application is not available on the public site.")
66
113
        app = conf.apps.app_url[conf.apps.public_app]
67
114
        apps.call_app(app.dir, req)
68
115
        return req.OK
74
121
        app = conf.apps.app_url[req.app]
75
122
 
76
123
    # Check if app requires auth. If so, perform authentication and login.
 
124
    # This will either return a User object, None, or perform a redirect
 
125
    # which we will not catch here.
77
126
    if app.requireauth:
78
 
        req.username = login.login(req)
79
 
        logged_in = req.username is not None
 
127
        req.user = login.login(req)
 
128
        logged_in = req.user is not None
80
129
    else:
81
 
        req.username = login.get_username(req)
 
130
        req.user = login.get_user_details(req)
82
131
        logged_in = True
83
132
 
84
133
    if logged_in:
 
134
        # Keep the user's session alive by writing to the session object.
 
135
        # req.get_session().save()
 
136
        # Well, it's a fine idea, but it creates considerable grief in the
 
137
        # concurrent update department, so instead, we'll just make the
 
138
        # sessions not time out.
 
139
        req.get_session().unlock()
 
140
 
85
141
        # If user did not specify an app, HTTP redirect to default app and
86
142
        # exit.
87
143
        if req.app is None:
96
152
 
97
153
        # Call the specified app with the request object
98
154
        apps.call_app(app.dir, req)
 
155
 
99
156
    # if not logged in, login.login will have written the login box.
100
157
    # Just clean up and exit.
101
158
 
106
163
 
107
164
    # When done, write out the HTML footer if the app has requested it
108
165
    if req.write_html_head_foot:
 
166
        # Show the console if required
 
167
        if logged_in and app.useconsole:
 
168
            plugins.console.present(req, windowpane=True)
109
169
        html.write_html_foot(req)
110
170
 
111
171
    # Note: Apache will not write custom HTML error messages here.
118
178
    session = req.get_session()
119
179
    session.invalidate()
120
180
    session.delete()
121
 
    req.throw_redirect(util.make_path(''))
 
181
    # Invalidates all IVLE cookies
 
182
    all_cookies = Cookie.get_cookies(req)
 
183
    for cookie in all_cookies:
 
184
        if cookie in ivle_cookies:
 
185
            req.add_cookie(Cookie.Cookie(cookie,'',expires=1,path='/'))
 
186
    req.throw_redirect(util.make_path('')) 
 
187
 
 
188
def handle_unknown_exception(req, exc_type, exc_value, exc_traceback):
 
189
    """
 
190
    Given an exception that has just been thrown from IVLE, print its details
 
191
    to the request.
 
192
    This is a full handler. It assumes nothing has been written, and writes a
 
193
    complete HTML page.
 
194
    req: May be EITHER an IVLE req or an Apache req.
 
195
    IVLE reqs may have the HTML head/foot written (on a 400 error), but
 
196
    the handler code may pass an apache req if an exception occurs before
 
197
    the IVLE request is created.
 
198
    """
 
199
    req.content_type = "text/html"
 
200
    logfile = os.path.join(conf.conf.log_path, 'ivle_error.log')
 
201
    logfail = False
 
202
    # For some reason, some versions of mod_python have "_server" instead of
 
203
    # "main_server". So we check for both.
 
204
    try:
 
205
        admin_email = apache.main_server.server_admin
 
206
    except AttributeError:
 
207
        try:
 
208
            admin_email = apache._server.server_admin
 
209
        except AttributeError:
 
210
            admin_email = ""
 
211
    try:
 
212
        httpcode = exc_value.httpcode
 
213
        req.status = httpcode
 
214
    except AttributeError:
 
215
        httpcode = None
 
216
        req.status = apache.HTTP_INTERNAL_SERVER_ERROR
 
217
    try:
 
218
        login = req.user.login
 
219
    except AttributeError:
 
220
        login = None
 
221
 
 
222
    # Log File
 
223
    try:
 
224
        logging.basicConfig(level=logging.INFO,
 
225
            format='%(asctime)s %(levelname)s: ' +
 
226
                '(HTTP: ' + str(req.status) +
 
227
                ', Ref: ' + str(login) + '@' +
 
228
                str(socket.gethostname()) + str(req.uri) +
 
229
                ') %(message)s',
 
230
            filename=logfile,
 
231
            filemode='a')
 
232
    except IOError:
 
233
        logfail = True
 
234
    logging.debug('Logging Unhandled Exception')
 
235
 
 
236
    # We handle 3 types of error.
 
237
    # IVLEErrors with 4xx response codes (client error).
 
238
    # IVLEErrors with 5xx response codes (handled server error).
 
239
    # Other exceptions (unhandled server error).
 
240
    # IVLEErrors should not have other response codes than 4xx or 5xx
 
241
    # (eg. throw_redirect should have been used for 3xx codes).
 
242
    # Therefore, that is treated as an unhandled error.
 
243
 
 
244
    if (exc_type == util.IVLEError and httpcode >= 400
 
245
        and httpcode <= 499):
 
246
        # IVLEErrors with 4xx response codes are client errors.
 
247
        # Therefore, these have a "nice" response (we even coat it in the IVLE
 
248
        # HTML wrappers).
 
249
        
 
250
        req.write_html_head_foot = True
 
251
        req.write('<div id="ivle_padding">\n')
 
252
        try:
 
253
            codename, msg = req.get_http_codename(httpcode)
 
254
        except AttributeError:
 
255
            codename, msg = None, None
 
256
        # Override the default message with the supplied one,
 
257
        # if available.
 
258
        if exc_value.message is not None:
 
259
            msg = exc_value.message
 
260
        if codename is not None:
 
261
            req.write("<h1>Error: %s</h1>\n" % cgi.escape(codename))
 
262
        else:
 
263
            req.write("<h1>Error</h1>\n")
 
264
        if msg is not None:
 
265
            req.write("<p>%s</p>\n" % cgi.escape(msg))
 
266
        else:
 
267
            req.write("<p>An unknown error occured.</p>\n")
 
268
        
 
269
        # Logging
 
270
        logging.info(str(msg))
 
271
        
 
272
        req.write("<p>(HTTP error code %d)</p>\n" % httpcode)
 
273
        if logfail:
 
274
            req.write("<p>Warning: Could not open Error Log: '%s'</p>\n"
 
275
                %cgi.escape(logfile))
 
276
        req.write('</div>\n')
 
277
    else:
 
278
        # A "bad" error message. We shouldn't get here unless IVLE
 
279
        # misbehaves (which is currently very easy, if things aren't set up
 
280
        # correctly).
 
281
        # Write the traceback.
 
282
        # If this is a non-4xx IVLEError, get the message and httpcode and
 
283
        # make the error message a bit nicer (but still include the
 
284
        # traceback).
 
285
        # We also need to special-case IVLEJailError, as we can get another
 
286
        # almost-exception out of it.
 
287
 
 
288
        codename, msg = None, None
 
289
 
 
290
        if exc_type is util.IVLEJailError:
 
291
            msg = exc_value.type_str + ": " + exc_value.message
 
292
            tb = 'Exception information extracted from IVLEJailError:\n'
 
293
            tb += urllib.unquote(exc_value.info)
 
294
        else:
 
295
            try:
 
296
                codename, msg = req.get_http_codename(httpcode)
 
297
            except AttributeError:
 
298
                pass
 
299
            # Override the default message with the supplied one,
 
300
            # if available.
 
301
            if hasattr(exc_value, 'message') and exc_value.message is not None:
 
302
                msg = exc_value.message
 
303
                # Prepend the exception type
 
304
                if exc_type != util.IVLEError:
 
305
                    msg = exc_type.__name__ + ": " + msg
 
306
 
 
307
            tb = ''.join(traceback.format_exception(exc_type, exc_value,
 
308
                                                    exc_traceback))
 
309
 
 
310
        # Logging
 
311
        logging.error('%s\n%s'%(str(msg), tb))
 
312
 
 
313
        req.write("""<html>
 
314
<head><title>IVLE Internal Server Error</title></head>
 
315
<body>
 
316
<h1>IVLE Internal Server Error""")
 
317
        if (codename is not None
 
318
            and httpcode != apache.HTTP_INTERNAL_SERVER_ERROR):
 
319
            req.write(": %s" % cgi.escape(codename))
 
320
        req.write("""</h1>
 
321
<p>An error has occured which is the fault of the IVLE developers or
 
322
administration.</p>
 
323
""")
 
324
        if msg is not None:
 
325
            req.write("<p>%s</p>\n" % cgi.escape(msg))
 
326
        if httpcode is not None:
 
327
            req.write("<p>(HTTP error code %d)</p>\n" % httpcode)
 
328
        req.write("""
 
329
<p>Please report this to <a href="mailto:%s">%s</a> (the system
 
330
administrator). Include the following information:</p>
 
331
""" % (cgi.escape(admin_email), cgi.escape(admin_email)))
 
332
 
 
333
        req.write("<pre>\n%s\n</pre>\n"%cgi.escape(tb))
 
334
        if logfail:
 
335
            req.write("<p>Warning: Could not open Error Log: '%s'</p>\n"
 
336
                %cgi.escape(logfile))
 
337
        req.write("</body>")