File: DirectoryMapper_8h-source.html

package info (click to toggle)
passenger 2.2.11debian-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 11,576 kB
  • ctags: 28,138
  • sloc: cpp: 66,323; ruby: 9,646; ansic: 2,425; python: 141; sh: 56; makefile: 29
file content (323 lines) | stat: -rw-r--r-- 30,355 bytes parent folder | download
1
2
3
4
5
6
7
8
9
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Passenger: DirectoryMapper.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.8 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
    </ul>
  </div>
<h1>DirectoryMapper.h</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> *  Phusion Passenger - http://www.modrails.com/</span>
<a name="l00003"></a>00003 <span class="comment"> *  Copyright (c) 2008, 2009 Phusion</span>
<a name="l00004"></a>00004 <span class="comment"> *</span>
<a name="l00005"></a>00005 <span class="comment"> *  "Phusion Passenger" is a trademark of Hongli Lai &amp; Ninh Bui.</span>
<a name="l00006"></a>00006 <span class="comment"> *</span>
<a name="l00007"></a>00007 <span class="comment"> *  Permission is hereby granted, free of charge, to any person obtaining a copy</span>
<a name="l00008"></a>00008 <span class="comment"> *  of this software and associated documentation files (the "Software"), to deal</span>
<a name="l00009"></a>00009 <span class="comment"> *  in the Software without restriction, including without limitation the rights</span>
<a name="l00010"></a>00010 <span class="comment"> *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell</span>
<a name="l00011"></a>00011 <span class="comment"> *  copies of the Software, and to permit persons to whom the Software is</span>
<a name="l00012"></a>00012 <span class="comment"> *  furnished to do so, subject to the following conditions:</span>
<a name="l00013"></a>00013 <span class="comment"> *</span>
<a name="l00014"></a>00014 <span class="comment"> *  The above copyright notice and this permission notice shall be included in</span>
<a name="l00015"></a>00015 <span class="comment"> *  all copies or substantial portions of the Software.</span>
<a name="l00016"></a>00016 <span class="comment"> *</span>
<a name="l00017"></a>00017 <span class="comment"> *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR</span>
<a name="l00018"></a>00018 <span class="comment"> *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,</span>
<a name="l00019"></a>00019 <span class="comment"> *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE</span>
<a name="l00020"></a>00020 <span class="comment"> *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER</span>
<a name="l00021"></a>00021 <span class="comment"> *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,</span>
<a name="l00022"></a>00022 <span class="comment"> *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN</span>
<a name="l00023"></a>00023 <span class="comment"> *  THE SOFTWARE.</span>
<a name="l00024"></a>00024 <span class="comment"> */</span>
<a name="l00025"></a>00025 <span class="preprocessor">#ifndef _PASSENGER_DIRECTORY_MAPPER_H_</span>
<a name="l00026"></a>00026 <span class="preprocessor"></span><span class="preprocessor">#define _PASSENGER_DIRECTORY_MAPPER_H_</span>
<a name="l00027"></a>00027 <span class="preprocessor"></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;string&gt;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &lt;set&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;cstring&gt;</span>
<a name="l00031"></a>00031 
<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;oxt/backtrace.hpp&gt;</span>
<a name="l00033"></a>00033 
<a name="l00034"></a>00034 <span class="preprocessor">#include "CachedFileStat.hpp"</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include "Configuration.h"</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include "Utils.h"</span>
<a name="l00037"></a>00037 
<a name="l00038"></a>00038 <span class="comment">// The Apache/APR headers *must* come after the Boost headers, otherwise</span>
<a name="l00039"></a>00039 <span class="comment">// compilation will fail on OpenBSD.</span>
<a name="l00040"></a>00040 <span class="preprocessor">#include &lt;httpd.h&gt;</span>
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;http_core.h&gt;</span>
<a name="l00042"></a>00042 
<a name="l00043"></a>00043 <span class="keyword">namespace </span>Passenger {
<a name="l00044"></a>00044 
<a name="l00045"></a>00045 <span class="keyword">using namespace </span>std;
<a name="l00046"></a>00046 <span class="keyword">using namespace </span>oxt;
<a name="l00047"></a>00047 <span class="comment"></span>
<a name="l00048"></a>00048 <span class="comment">/**</span>
<a name="l00049"></a>00049 <span class="comment"> * Utility class for determining URI-to-application directory mappings.</span>
<a name="l00050"></a>00050 <span class="comment"> * Given a URI, it will determine whether that URI belongs to a Phusion</span>
<a name="l00051"></a>00051 <span class="comment"> * Passenger-handled application, what the base URI of that application is,</span>
<a name="l00052"></a>00052 <span class="comment"> * and what the associated 'public' directory is.</span>
<a name="l00053"></a>00053 <span class="comment"> *</span>
<a name="l00054"></a>00054 <span class="comment"> * @note This class is not thread-safe, but is reentrant.</span>
<a name="l00055"></a>00055 <span class="comment"> * @ingroup Core</span>
<a name="l00056"></a>00056 <span class="comment"> */</span>
<a name="l00057"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html">00057</a> <span class="keyword">class </span><a class="code" href="classPassenger_1_1DirectoryMapper.html" title="Utility class for determining URI-to-application directory mappings.">DirectoryMapper</a> {
<a name="l00058"></a>00058 <span class="keyword">public</span>:
<a name="l00059"></a>00059         <span class="keyword">enum</span> ApplicationType {
<a name="l00060"></a>00060                 NONE,
<a name="l00061"></a>00061                 RAILS,
<a name="l00062"></a>00062                 RACK,
<a name="l00063"></a>00063                 WSGI
<a name="l00064"></a>00064         };
<a name="l00065"></a>00065 
<a name="l00066"></a>00066 <span class="keyword">private</span>:
<a name="l00067"></a>00067         DirConfig *config;
<a name="l00068"></a>00068         request_rec *r;
<a name="l00069"></a>00069         CachedFileStat *cstat;
<a name="l00070"></a>00070         <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate;
<a name="l00071"></a>00071         <span class="keywordtype">bool</span> baseURIKnown;
<a name="l00072"></a>00072         <span class="keyword">const</span> <span class="keywordtype">char</span> *baseURI;
<a name="l00073"></a>00073         ApplicationType appType;
<a name="l00074"></a>00074         
<a name="l00075"></a>00075         <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectRails() {
<a name="l00076"></a>00076                 <span class="keywordflow">return</span> config-&gt;autoDetectRails == DirConfig::ENABLED ||
<a name="l00077"></a>00077                         config-&gt;autoDetectRails == DirConfig::UNSET;
<a name="l00078"></a>00078         }
<a name="l00079"></a>00079         
<a name="l00080"></a>00080         <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectRack() {
<a name="l00081"></a>00081                 <span class="keywordflow">return</span> config-&gt;autoDetectRack == DirConfig::ENABLED ||
<a name="l00082"></a>00082                         config-&gt;autoDetectRack == DirConfig::UNSET;
<a name="l00083"></a>00083         }
<a name="l00084"></a>00084         
<a name="l00085"></a>00085         <span class="keyword">inline</span> <span class="keywordtype">bool</span> shouldAutoDetectWSGI() {
<a name="l00086"></a>00086                 <span class="keywordflow">return</span> config-&gt;autoDetectWSGI == DirConfig::ENABLED ||
<a name="l00087"></a>00087                         config-&gt;autoDetectWSGI == DirConfig::UNSET;
<a name="l00088"></a>00088         }
<a name="l00089"></a>00089         
<a name="l00090"></a>00090 <span class="keyword">public</span>:<span class="comment"></span>
<a name="l00091"></a>00091 <span class="comment">        /**</span>
<a name="l00092"></a>00092 <span class="comment">         * Create a new DirectoryMapper object.</span>
<a name="l00093"></a>00093 <span class="comment">         *</span>
<a name="l00094"></a>00094 <span class="comment">         * @param cstat A CachedFileStat object used for statting files.</span>
<a name="l00095"></a>00095 <span class="comment">         * @param throttleRate A throttling rate for cstat.</span>
<a name="l00096"></a>00096 <span class="comment">         * @warning Do not use this object after the destruction of &lt;tt&gt;r&lt;/tt&gt;,</span>
<a name="l00097"></a>00097 <span class="comment">         *          &lt;tt&gt;config&lt;/tt&gt; or &lt;tt&gt;cstat&lt;/tt&gt;.</span>
<a name="l00098"></a>00098 <span class="comment">         */</span>
<a name="l00099"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#eccfaf22dab9e78299309ea366b7447b">00099</a>         <a class="code" href="classPassenger_1_1DirectoryMapper.html#eccfaf22dab9e78299309ea366b7447b" title="Create a new DirectoryMapper object.">DirectoryMapper</a>(request_rec *r, DirConfig *config,
<a name="l00100"></a>00100                         CachedFileStat *cstat, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> throttleRate) {
<a name="l00101"></a>00101                 this-&gt;r = r;
<a name="l00102"></a>00102                 this-&gt;config = config;
<a name="l00103"></a>00103                 this-&gt;cstat = cstat;
<a name="l00104"></a>00104                 this-&gt;throttleRate = throttleRate;
<a name="l00105"></a>00105                 appType = NONE;
<a name="l00106"></a>00106                 baseURIKnown = <span class="keyword">false</span>;
<a name="l00107"></a>00107                 baseURI = NULL;
<a name="l00108"></a>00108         }
<a name="l00109"></a>00109         <span class="comment"></span>
<a name="l00110"></a>00110 <span class="comment">        /**</span>
<a name="l00111"></a>00111 <span class="comment">         * Determine whether the given HTTP request falls under one of the specified</span>
<a name="l00112"></a>00112 <span class="comment">         * RailsBaseURIs or RackBaseURIs. If yes, then the first matching base URI will</span>
<a name="l00113"></a>00113 <span class="comment">         * be returned.</span>
<a name="l00114"></a>00114 <span class="comment">         *</span>
<a name="l00115"></a>00115 <span class="comment">         * If Rails/Rack autodetection was enabled in the configuration, and the document</span>
<a name="l00116"></a>00116 <span class="comment">         * root seems to be a valid Rails/Rack 'public' folder, then this method will</span>
<a name="l00117"></a>00117 <span class="comment">         * return "/".</span>
<a name="l00118"></a>00118 <span class="comment">         *</span>
<a name="l00119"></a>00119 <span class="comment">         * Otherwise, NULL will be returned.</span>
<a name="l00120"></a>00120 <span class="comment">         *</span>
<a name="l00121"></a>00121 <span class="comment">         * @throws FileSystemException This method might also examine the filesystem in</span>
<a name="l00122"></a>00122 <span class="comment">         *            order to detect the application's type. During that process, a</span>
<a name="l00123"></a>00123 <span class="comment">         *            FileSystemException might be thrown.</span>
<a name="l00124"></a>00124 <span class="comment">         * @warning The return value may only be used as long as &lt;tt&gt;config&lt;/tt&gt;</span>
<a name="l00125"></a>00125 <span class="comment">         *          hasn't been destroyed.</span>
<a name="l00126"></a>00126 <span class="comment">         */</span>
<a name="l00127"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#2da887c077fc2460dea204783470e821">00127</a>         <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>() {
<a name="l00128"></a>00128                 TRACE_POINT();
<a name="l00129"></a>00129                 <span class="keywordflow">if</span> (baseURIKnown) {
<a name="l00130"></a>00130                         <span class="keywordflow">return</span> baseURI;
<a name="l00131"></a>00131                 }
<a name="l00132"></a>00132                 
<a name="l00133"></a>00133                 set&lt;string&gt;::const_iterator it;
<a name="l00134"></a>00134                 <span class="keyword">const</span> <span class="keywordtype">char</span> *uri = r-&gt;uri;
<a name="l00135"></a>00135                 <span class="keywordtype">size_t</span> uri_len = strlen(uri);
<a name="l00136"></a>00136                 
<a name="l00137"></a>00137                 <span class="keywordflow">if</span> (uri_len == 0 || uri[0] != <span class="charliteral">'/'</span>) {
<a name="l00138"></a>00138                         baseURIKnown = <span class="keyword">true</span>;
<a name="l00139"></a>00139                         <span class="keywordflow">return</span> NULL;
<a name="l00140"></a>00140                 }
<a name="l00141"></a>00141                 
<a name="l00142"></a>00142                 UPDATE_TRACE_POINT();
<a name="l00143"></a>00143                 <span class="keywordflow">for</span> (it = config-&gt;railsBaseURIs.begin(); it != config-&gt;railsBaseURIs.end(); it++) {
<a name="l00144"></a>00144                         <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;base(*it);
<a name="l00145"></a>00145                         <span class="keywordflow">if</span> (  base == <span class="stringliteral">"/"</span>
<a name="l00146"></a>00146                          || ( uri_len == base.size() &amp;&amp; memcmp(uri, base.c_str(), uri_len) == 0 )
<a name="l00147"></a>00147                          || ( uri_len  &gt; base.size() &amp;&amp; memcmp(uri, base.c_str(), base.size()) == 0
<a name="l00148"></a>00148                                                      &amp;&amp; uri[base.size()] == <span class="charliteral">'/'</span> )
<a name="l00149"></a>00149                         ) {
<a name="l00150"></a>00150                                 baseURIKnown = <span class="keyword">true</span>;
<a name="l00151"></a>00151                                 baseURI = base.c_str();
<a name="l00152"></a>00152                                 appType = RAILS;
<a name="l00153"></a>00153                                 <span class="keywordflow">return</span> baseURI;
<a name="l00154"></a>00154                         }
<a name="l00155"></a>00155                 }
<a name="l00156"></a>00156                 
<a name="l00157"></a>00157                 UPDATE_TRACE_POINT();
<a name="l00158"></a>00158                 <span class="keywordflow">for</span> (it = config-&gt;rackBaseURIs.begin(); it != config-&gt;rackBaseURIs.end(); it++) {
<a name="l00159"></a>00159                         <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;base(*it);
<a name="l00160"></a>00160                         <span class="keywordflow">if</span> (  base == <span class="stringliteral">"/"</span>
<a name="l00161"></a>00161                          || ( uri_len == base.size() &amp;&amp; memcmp(uri, base.c_str(), uri_len) == 0 )
<a name="l00162"></a>00162                          || ( uri_len  &gt; base.size() &amp;&amp; memcmp(uri, base.c_str(), base.size()) == 0
<a name="l00163"></a>00163                                                      &amp;&amp; uri[base.size()] == <span class="charliteral">'/'</span> )
<a name="l00164"></a>00164                         ) {
<a name="l00165"></a>00165                                 baseURIKnown = <span class="keyword">true</span>;
<a name="l00166"></a>00166                                 baseURI = base.c_str();
<a name="l00167"></a>00167                                 appType = RACK;
<a name="l00168"></a>00168                                 <span class="keywordflow">return</span> baseURI;
<a name="l00169"></a>00169                         }
<a name="l00170"></a>00170                 }
<a name="l00171"></a>00171                 
<a name="l00172"></a>00172                 UPDATE_TRACE_POINT();
<a name="l00173"></a>00173                 <span class="keywordflow">if</span> (shouldAutoDetectRack()
<a name="l00174"></a>00174                  &amp;&amp; verifyRackDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
<a name="l00175"></a>00175                         baseURIKnown = <span class="keyword">true</span>;
<a name="l00176"></a>00176                         baseURI = <span class="stringliteral">"/"</span>;
<a name="l00177"></a>00177                         appType = RACK;
<a name="l00178"></a>00178                         <span class="keywordflow">return</span> baseURI;
<a name="l00179"></a>00179                 }
<a name="l00180"></a>00180                 
<a name="l00181"></a>00181                 UPDATE_TRACE_POINT();
<a name="l00182"></a>00182                 <span class="keywordflow">if</span> (shouldAutoDetectRails()
<a name="l00183"></a>00183                  &amp;&amp; verifyRailsDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
<a name="l00184"></a>00184                         baseURIKnown = <span class="keyword">true</span>;
<a name="l00185"></a>00185                         baseURI = <span class="stringliteral">"/"</span>;
<a name="l00186"></a>00186                         appType = RAILS;
<a name="l00187"></a>00187                         <span class="keywordflow">return</span> baseURI;
<a name="l00188"></a>00188                 }
<a name="l00189"></a>00189                 
<a name="l00190"></a>00190                 UPDATE_TRACE_POINT();
<a name="l00191"></a>00191                 <span class="keywordflow">if</span> (shouldAutoDetectWSGI()
<a name="l00192"></a>00192                  &amp;&amp; verifyWSGIDir(config-&gt;getAppRoot(ap_document_root(r)), cstat, throttleRate)) {
<a name="l00193"></a>00193                         baseURIKnown = <span class="keyword">true</span>;
<a name="l00194"></a>00194                         baseURI = <span class="stringliteral">"/"</span>;
<a name="l00195"></a>00195                         appType = WSGI;
<a name="l00196"></a>00196                         <span class="keywordflow">return</span> baseURI;
<a name="l00197"></a>00197                 }
<a name="l00198"></a>00198                 
<a name="l00199"></a>00199                 baseURIKnown = <span class="keyword">true</span>;
<a name="l00200"></a>00200                 <span class="keywordflow">return</span> NULL;
<a name="l00201"></a>00201         }
<a name="l00202"></a>00202         <span class="comment"></span>
<a name="l00203"></a>00203 <span class="comment">        /**</span>
<a name="l00204"></a>00204 <span class="comment">         * Returns the filename of the 'public' directory of the Rails/Rack application</span>
<a name="l00205"></a>00205 <span class="comment">         * that's associated with the HTTP request.</span>
<a name="l00206"></a>00206 <span class="comment">         *</span>
<a name="l00207"></a>00207 <span class="comment">         * Returns an empty string if the document root of the HTTP request</span>
<a name="l00208"></a>00208 <span class="comment">         * cannot be determined, or if it isn't a valid folder.</span>
<a name="l00209"></a>00209 <span class="comment">         *</span>
<a name="l00210"></a>00210 <span class="comment">         * @throws FileSystemException An error occured while examening the filesystem.</span>
<a name="l00211"></a>00211 <span class="comment">         */</span>
<a name="l00212"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#ef969f27622fb215990a870076648aa1">00212</a>         <span class="keywordtype">string</span> <a class="code" href="classPassenger_1_1DirectoryMapper.html#ef969f27622fb215990a870076648aa1" title="Returns the filename of the &amp;#39;public&amp;#39; directory of the Rails/Rack application...">getPublicDirectory</a>() {
<a name="l00213"></a>00213                 <span class="keywordflow">if</span> (!baseURIKnown) {
<a name="l00214"></a>00214                         <a class="code" href="classPassenger_1_1DirectoryMapper.html#2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
<a name="l00215"></a>00215                 }
<a name="l00216"></a>00216                 <span class="keywordflow">if</span> (baseURI == NULL) {
<a name="l00217"></a>00217                         <span class="keywordflow">return</span> <span class="stringliteral">""</span>;
<a name="l00218"></a>00218                 }
<a name="l00219"></a>00219                 
<a name="l00220"></a>00220                 <span class="keyword">const</span> <span class="keywordtype">char</span> *docRoot = ap_document_root(r);
<a name="l00221"></a>00221                 <span class="keywordtype">size_t</span> len = strlen(docRoot);
<a name="l00222"></a>00222                 <span class="keywordflow">if</span> (len &gt; 0) {
<a name="l00223"></a>00223                         <span class="keywordtype">string</span> path;
<a name="l00224"></a>00224                         <span class="keywordflow">if</span> (docRoot[len - 1] == <span class="charliteral">'/'</span>) {
<a name="l00225"></a>00225                                 path.assign(docRoot, len - 1);
<a name="l00226"></a>00226                         } <span class="keywordflow">else</span> {
<a name="l00227"></a>00227                                 path.assign(docRoot, len);
<a name="l00228"></a>00228                         }
<a name="l00229"></a>00229                         <span class="keywordflow">if</span> (strcmp(baseURI, <span class="stringliteral">"/"</span>) != 0) {
<a name="l00230"></a>00230                                 <span class="comment">/* Application is deployed in a sub-URI.</span>
<a name="l00231"></a>00231 <span class="comment">                                 * This is probably a symlink, so let's resolve it.</span>
<a name="l00232"></a>00232 <span class="comment">                                 */</span>
<a name="l00233"></a>00233                                 path.append(baseURI);
<a name="l00234"></a>00234                                 path = resolveSymlink(path);
<a name="l00235"></a>00235                         }
<a name="l00236"></a>00236                         <span class="keywordflow">return</span> path;
<a name="l00237"></a>00237                 } <span class="keywordflow">else</span> {
<a name="l00238"></a>00238                         <span class="keywordflow">return</span> <span class="stringliteral">""</span>;
<a name="l00239"></a>00239                 }
<a name="l00240"></a>00240         }
<a name="l00241"></a>00241         <span class="comment"></span>
<a name="l00242"></a>00242 <span class="comment">        /**</span>
<a name="l00243"></a>00243 <span class="comment">         * Returns the application type that's associated with the HTTP request.</span>
<a name="l00244"></a>00244 <span class="comment">         *</span>
<a name="l00245"></a>00245 <span class="comment">         * @throws FileSystemException An error occured while examening the filesystem.</span>
<a name="l00246"></a>00246 <span class="comment">         */</span>
<a name="l00247"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#ba438d86ca263972a47540956bf11ec1">00247</a>         ApplicationType <a class="code" href="classPassenger_1_1DirectoryMapper.html#ba438d86ca263972a47540956bf11ec1" title="Returns the application type that&amp;#39;s associated with the HTTP request.">getApplicationType</a>() {
<a name="l00248"></a>00248                 <span class="keywordflow">if</span> (!baseURIKnown) {
<a name="l00249"></a>00249                         <a class="code" href="classPassenger_1_1DirectoryMapper.html#2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
<a name="l00250"></a>00250                 }
<a name="l00251"></a>00251                 <span class="keywordflow">return</span> appType;
<a name="l00252"></a>00252         }
<a name="l00253"></a>00253         <span class="comment"></span>
<a name="l00254"></a>00254 <span class="comment">        /**</span>
<a name="l00255"></a>00255 <span class="comment">         * Returns the application type (as a string) that's associated</span>
<a name="l00256"></a>00256 <span class="comment">         * with the HTTP request.</span>
<a name="l00257"></a>00257 <span class="comment">         *</span>
<a name="l00258"></a>00258 <span class="comment">         * @throws FileSystemException An error occured while examening the filesystem.</span>
<a name="l00259"></a>00259 <span class="comment">         */</span>
<a name="l00260"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#c46f0e74ffd05b7fe9924dd99a057cf7">00260</a>         <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#c46f0e74ffd05b7fe9924dd99a057cf7" title="Returns the application type (as a string) that&amp;#39;s associated with the HTTP request...">getApplicationTypeString</a>() {
<a name="l00261"></a>00261                 <span class="keywordflow">if</span> (!baseURIKnown) {
<a name="l00262"></a>00262                         <a class="code" href="classPassenger_1_1DirectoryMapper.html#2da887c077fc2460dea204783470e821" title="Determine whether the given HTTP request falls under one of the specified RailsBaseURIs...">getBaseURI</a>();
<a name="l00263"></a>00263                 }
<a name="l00264"></a>00264                 <span class="keywordflow">switch</span> (appType) {
<a name="l00265"></a>00265                 <span class="keywordflow">case</span> RAILS:
<a name="l00266"></a>00266                         <span class="keywordflow">return</span> <span class="stringliteral">"rails"</span>;
<a name="l00267"></a>00267                 <span class="keywordflow">case</span> RACK:
<a name="l00268"></a>00268                         <span class="keywordflow">return</span> <span class="stringliteral">"rack"</span>;
<a name="l00269"></a>00269                 <span class="keywordflow">case</span> WSGI:
<a name="l00270"></a>00270                         <span class="keywordflow">return</span> <span class="stringliteral">"wsgi"</span>;
<a name="l00271"></a>00271                 <span class="keywordflow">default</span>:
<a name="l00272"></a>00272                         <span class="keywordflow">return</span> NULL;
<a name="l00273"></a>00273                 };
<a name="l00274"></a>00274         }
<a name="l00275"></a>00275         <span class="comment"></span>
<a name="l00276"></a>00276 <span class="comment">        /**</span>
<a name="l00277"></a>00277 <span class="comment">         * Returns the environment under which the application should be spawned.</span>
<a name="l00278"></a>00278 <span class="comment">         *</span>
<a name="l00279"></a>00279 <span class="comment">         * @throws FileSystemException An error occured while examening the filesystem.</span>
<a name="l00280"></a>00280 <span class="comment">         */</span>
<a name="l00281"></a><a class="code" href="classPassenger_1_1DirectoryMapper.html#f5091e3cef3878e160e5d3b2181d82fb">00281</a>         <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="classPassenger_1_1DirectoryMapper.html#f5091e3cef3878e160e5d3b2181d82fb" title="Returns the environment under which the application should be spawned.">getEnvironment</a>() {
<a name="l00282"></a>00282                 <span class="keywordflow">switch</span> (<a class="code" href="classPassenger_1_1DirectoryMapper.html#ba438d86ca263972a47540956bf11ec1" title="Returns the application type that&amp;#39;s associated with the HTTP request.">getApplicationType</a>()) {
<a name="l00283"></a>00283                 <span class="keywordflow">case</span> RAILS:
<a name="l00284"></a>00284                         <span class="keywordflow">return</span> config-&gt;getRailsEnv();
<a name="l00285"></a>00285                 <span class="keywordflow">case</span> RACK:
<a name="l00286"></a>00286                         <span class="keywordflow">return</span> config-&gt;getRackEnv();
<a name="l00287"></a>00287                 <span class="keywordflow">default</span>:
<a name="l00288"></a>00288                         <span class="keywordflow">return</span> <span class="stringliteral">"production"</span>;
<a name="l00289"></a>00289                 }
<a name="l00290"></a>00290         }
<a name="l00291"></a>00291 };
<a name="l00292"></a>00292 
<a name="l00293"></a>00293 } <span class="comment">// namespace Passenger</span>
<a name="l00294"></a>00294 
<a name="l00295"></a>00295 <span class="preprocessor">#endif </span><span class="comment">/* _PASSENGER_DIRECTORY_MAPPER_H_ */</span>
<a name="l00296"></a>00296 
</pre></div></div>
<hr size="1"><address style="text-align: right;"><small>Generated on Fri Mar 5 11:13:03 2010 for Passenger by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
</body>
</html>