<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>6.1.2.1 Traversal</title>
<META NAME="description" CONTENT="6.1.2.1 Traversal">
<META NAME="keywords" CONTENT="modpython">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<link rel="STYLESHEET" href="modpython.css">
<link rel="first" href="modpython.html">
<link rel="contents" href="contents.html" title="Contents">
<link rel="index" href="genindex.html" title="Index">
<LINK REL="next" href="hand-pub-alg-args.html">
<LINK REL="previous" href="hand-pub-alg.html">
<LINK REL="up" href="hand-pub-alg.html">
<LINK REL="next" href="hand-pub-alg-args.html">
</head>
<body>
<DIV CLASS="navigation">
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="hand-pub-alg.html"><img src="icons/previous.png"
border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="hand-pub-alg.html"><img src="icons/up.png"
border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="hand-pub-alg-args.html"><img src="icons/next.png"
border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><A href="contents.html"><img src="icons/contents.png"
border="0" height="32"
alt="Contents" width="32"></A></td>
<td><img src="icons/blank.png"
border="0" height="32"
alt="" width="32"></td>
<td><A href="genindex.html"><img src="icons/index.png"
border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="hand-pub-alg.html">6.1.2 The Publishing Algorithm</A>
<b class="navlabel">Up:</b> <a class="sectref" href="hand-pub-alg.html">6.1.2 The Publishing Algorithm</A>
<b class="navlabel">Next:</b> <a class="sectref" href="hand-pub-alg-args.html">6.1.2.2 Argument Matching and</A>
<br><hr>
</DIV>
<!--End of Navigation Panel-->
<H3><A NAME="SECTION008121000000000000000"> </A>
<BR>
6.1.2.1 Traversal
</H3>
<P>
The Publisher handler locates and imports the module specified in the
URI. The module location is determined from the <tt class="class">req.filename</tt>
attribute. Before importing, the file extension, if any, is
discarded.
<P>
If <tt class="class">req.filename</tt> is empty, the module name defaults to
"<tt class="samp">index</tt>".
<P>
Once module is imported, the remaining part of the URI up to the
beginning of any query data (a.k.a. PATH_INFO) is used to find an
object within the module. The Publisher handler <i class="dfn">traverses</i> the
path, one element at a time from left to right, mapping the elements
to Python object within the module.
<P>
If no path_info was given in the URL, the Publisher handler will use
the default value of "<tt class="samp">index</tt>". If the last element is an object inside
a module, and the one immediately preceding it is a directory
(i.e. no module name is given), then the module name will also default
to "<tt class="samp">index</tt>".
<P>
The traversal will stop and <tt class="constant">HTTP_NOT_FOUND</tt> will be returned to
the client if:
<P>
<UL>
<LI>Any of the traversed object's names begin with an underscore
("<tt class="samp">_</tt>"). Use underscores to protect objects that should not be
accessible from the web.
<P>
</LI>
<LI>A module is encountered. Published objects cannot be modules for
security reasons.
<P>
</LI>
</UL>
<P>
If an object in the path could not be found, <tt class="constant">HTTP_NOT_FOUND</tt>
is returned to the client.
<P>
For example, given the following configuration:
<P>
<dl><dd><pre class="verbatim">
DocumentRoot /some/dir
<Directory /some/dir>
SetHandler mod_python
PythonHandler mod_python.publisher
</Directory>
</pre></dl>
<P>
And the following <span class="file">/some/dir/index.py</span> file:
<P>
<dl><dd><pre class="verbatim">
def index(req):
return "We are in index()"
def hello(req):
return "We are in hello()"
</pre></dl>
<P>
Then:
<P>
http://www.somehost/index/index will return "<tt class="samp">We are in index()</tt>"
<P>
http://www.somehost/index/ will return "<tt class="samp">We are in index()</tt>"
<P>
http://www.somehost/index/hello will return "<tt class="samp">We are in hello()</tt>"
<P>
http://www.somehost/hello will return "<tt class="samp">We are in hello()</tt>"
<P>
http://www.somehost/spam will return "<tt class="samp">404 Not Found</tt>"
<P>
<DIV CLASS="navigation">
<p><hr>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A href="hand-pub-alg.html"><img src="icons/previous.png"
border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A href="hand-pub-alg.html"><img src="icons/up.png"
border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A href="hand-pub-alg-args.html"><img src="icons/next.png"
border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><A href="contents.html"><img src="icons/contents.png"
border="0" height="32"
alt="Contents" width="32"></A></td>
<td><img src="icons/blank.png"
border="0" height="32"
alt="" width="32"></td>
<td><A href="genindex.html"><img src="icons/index.png"
border="0" height="32"
alt="Index" width="32"></A></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" href="hand-pub-alg.html">6.1.2 The Publishing Algorithm</A>
<b class="navlabel">Up:</b> <a class="sectref" href="hand-pub-alg.html">6.1.2 The Publishing Algorithm</A>
<b class="navlabel">Next:</b> <a class="sectref" href="hand-pub-alg-args.html">6.1.2.2 Argument Matching and</A>
<hr>
<span class="release-info">Release 3.1.0a, documentation updated on August 26, 2003.</span>
</DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
distrib
>
Mandriva
>
9.2
>
i586
>
media
>
contrib
>
by-pkgid
>
dddfd1c874d00a6a720179bd81bafd8d
>
files
>
58
