请求处理组件
第1节
介绍
在Cake里，使用请求处理组件来决定关于进来的HTTP请求信息。你可以使用它更好的通知你的controller关于AJAX请求，得到关于远程客户端IP地址，以及请求的内容类型，或者去除输出数据中你不想要的数据的信息。为了使用请求组件，你需要确保在Controller的$component数组中指定它。.
| class ThingsController extends AppController { var $components = array('RequestHandler');
// ... } |
第2节
获取客户/请求信息
让我们更深入一步：
accepts
- string $type
返回客户接受的content-type信息，这取决于$type值。如果传入null或无值，它将返回一个客户端接受的content-type数组。如果传入一字符串，而且在content-type中检验$type(参看setContent()),客户端接受它，它返回true。如果$type是一个数组，每个字符串将分别计算，如果只要他们中的一个符合接受的content-type类型，accepts()方法返回true。例如：
| class PostsController extends AppController { var $components = array('RequestHandler');
function beforeFilter () { if ($this->RequestHandler->accepts('html')) { // Execute code only if client accepts an HTML (text/html) response } elseif ($this->RequestHandler->accepts('rss')) { // Execute RSS-only code } elseif ($this->RequestHandler->accepts('atom')) { // Execute Atom-only code } elseif ($this->RequestHandler->accepts('xml')) { // Execute XML-only code }
if ($this->RequestHandler->accepts(array('xml', 'rss', 'atom'))) { // Executes if the client accepts any of the above: XML, RSS or Atom } } } |
- getAjaxVersion
如果你正在使用Prototype JS库，你可以获取一个特殊的头，此头在AJAX请求中设定。本函数返回使用的Prototype版本。
- getClientIP
返回远程客户端的IP地址。
- getReferrer
返回请求起源的服务器名。
- isAjax
如果当前的请求是一个XMLHttpRequest，返回true。
- isAtom
如果客户端接受Atom feed内容（application/atom+xml），返回true。
- isDelete
如果当前的请求通过DELETE，返回true。
- isGet
如果当前请求通过GET，返回true。
- isMobile
如果user agent字符串符合一个移动的web浏览器，返回true。
- isPost
如果当前请求通过POST，返回true。
- isPut
如果当前请求通过PUT，返回true。
- isRss
如果客户端接受RSS feed内容(application/rss+xml)，返回true。
- isXml
.如果客户端接受XML（application/xml or text/xml)，返回true。
setContent
- string $name
- string $type
对于accepts() 和prefers()的使用，增加一个content-type别名映射，在这里$name是映射（字符串）的名字，$type是一个字符串或者一个字符串数组。它们每个都是一个MIME类型。内建的类型映射如下：
| // Name => Type 'js' => 'text/javascript', 'css' => 'text/css', 'html' => 'text/html', 'form' => 'application/x-www-form-urlencoded', 'file' => 'multipart/form-data', 'xhtml' => array('application/xhtml+xml', 'application/xhtml', 'text/xhtml'), 'xml' => array('application/xml', 'text/xml'), 'rss' => 'application/rss+xml', 'atom' => 'application/atom+xml' |
第3节
清除数据
你偶尔想删除来自一个请求或输出的数据，使用下面的请求处理函数来完成这些操作吧。
stripAll
- string $str
删除$str中的空格，图像，以及脚本(using stripWhitespace(), stripImages(), 和stripScripts()).
stripImages
- string $str
从$str中删除任何嵌入图像的HTML。
stripScripts
- string $str
从$str中删除任何与<script> 和<style>相关的标签。
stripTags
- string $str
- string $tag1
- string $tag2...
从$str中删除$tag1, $tag2等指定的标签。
| $someString = '<font color="#FF0000"><bold>Foo</bold></font> <em>Bar</em>';
echo $this->RequestHandler->stripTags($someString, 'font', 'bold');
// 输出: Foo <em>Bar</em> |
stripWhiteSpace
- string $str
从$str中删除空格。
第4节
其他有用的函数
当你的应用程序包含AJAX请求时，请求处理组件非常有用。使用setAjax()函数来自动检测AJAX请求，并为请求将Controller的布局设置为AJAX布局。这样的好处是你可以创建小的分块的view，这些view作为AJAX view也可能是双倍的。
| // list.thtml <ul> <? foreach ($things as $thing):?> <li><?php echo $thing;?></li> <?endforeach;?> </ul>
//-------------------------------------------------------------
//The list action of my ThingsController: function list() { $this->RequestHandler->setAjax($this); $this->set('things', $this->Thing->findAll()); } |
当一个普通的浏览器请求为/things/list时，对于应用程序而言，无序列会在缺省的布局里render。如果把URL作为一个AJAX操作的一部分请求时，列表会自动在空的AJAX布局里render。
Last Updated:2006年12月03日