📄 common.html
字号:
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../../displayToc.js"></script>
<script language="JavaScript" src="../../../tocParas.js"></script>
<script language="JavaScript" src="../../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../../scineplex.css">
<title>HTTP::Request::Common - Construct common HTTP::Request objects</title>
<link rel="stylesheet" href="../../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>
<body>
<script>writelinks('__top__',3);</script>
<h1><a>HTTP::Request::Common - Construct common HTTP::Request objects</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#copyright">COPYRIGHT</a></li>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>HTTP::Request::Common - Construct common HTTP::Request objects</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
<span class="keyword">use</span> <span class="variable">HTTP::Request::Common</span><span class="operator">;</span>
<span class="variable">$ua</span> <span class="operator">=</span> <span class="variable">LWP::UserAgent</span><span class="operator">-></span><span class="variable">new</span><span class="operator">;</span>
<span class="variable">$ua</span><span class="operator">-></span><span class="variable">request</span><span class="operator">(</span><span class="variable">GET</span> <span class="string">'http://www.sn.no/'</span><span class="operator">);</span>
<span class="variable">$ua</span><span class="operator">-></span><span class="variable">request</span><span class="operator">(</span><span class="variable">POST</span> <span class="string">'http://somewhere/foo'</span><span class="operator">,</span> <span class="operator">[</span><span class="string">foo</span> <span class="operator">=></span> <span class="variable">bar</span><span class="operator">,</span> <span class="string">bar</span> <span class="operator">=></span> <span class="variable">foo</span><span class="operator">]</span><span class="operator">);</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This module provide functions that return newly created <code>HTTP::Request</code>
objects. These functions are usually more convenient to use than the
standard <code>HTTP::Request</code> constructor for the most common requests. The
following functions are provided:</p>
<dl>
<dt><strong><a name="item_get__24url">GET $url</a></strong>
<dt><strong><a name="item_get__24url_2c_header__3d_3e_value_2c_2e_2e_2e">GET $url, Header => Value,...</a></strong>
<dd>
<p>The <code>GET()</code> function returns an <code>HTTP::Request</code> object initialized with
the "GET" method and the specified URL. It is roughly equivalent to the
following call</p>
</dd>
<dd>
<pre>
HTTP::Request->new(
GET => $url,
HTTP::Headers->new(Header => Value,...),
)</pre>
</dd>
<dd>
<p>but is less cluttered. What is different is that a header named
<code>Content</code> will initialize the content part of the request instead of
setting a header field. Note that GET requests should normally not
have a content, so this hack makes more sense for the <code>PUT()</code> and <code>POST()</code>
functions described below.</p>
</dd>
<dd>
<p>The <code>get(...)</code> method of <code>LWP::UserAgent</code> exists as a shortcut for
$ua->request(GET ...).</p>
</dd>
</li>
<dt><strong><a name="item_head__24url">HEAD $url</a></strong>
<dt><strong><a name="item_head__24url_2c_header__3d_3e_value_2c_2e_2e_2e">HEAD $url, Header => Value,...</a></strong>
<dd>
<p>Like <code>GET()</code> but the method in the request is "HEAD".</p>
</dd>
<dd>
<p>The <code>head(...)</code> method of "LWP::UserAgent" exists as a shortcut for
$ua->request(HEAD ...).</p>
</dd>
</li>
<dt><strong><a name="item_put__24url">PUT $url</a></strong>
<dt><strong><a name="item_put__24url_2c_header__3d_3e_value_2c_2e_2e_2e">PUT $url, Header => Value,...</a></strong>
<dt><strong><a name="item_put__24url_2c_header__3d_3e_value_2c_2e_2e_2e_2c_c">PUT $url, Header => Value,..., Content => $content</a></strong>
<dd>
<p>Like <code>GET()</code> but the method in the request is "PUT".</p>
</dd>
</li>
<dt><strong><a name="item_post__24url">POST $url</a></strong>
<dt><strong><a name="item_post__24url_2c_header__3d_3e_value_2c_2e_2e_2e">POST $url, Header => Value,...</a></strong>
<dt><strong><a name="item_post__24url_2c__24form_ref_2c_header__3d_3e_value_">POST $url, $form_ref, Header => Value,...</a></strong>
<dt><strong><a name="item_post__24url_2c_header__3d_3e_value_2c_2e_2e_2e_2c_">POST $url, Header => Value,..., Content => $form_ref</a></strong>
<dd>
<p>This works mostly like <code>GET()</code> with "POST" as the method, but this function
also takes a second optional array or hash reference parameter
($form_ref). This argument can be used to pass key/value pairs for
the form content. By default we will initialize a request using the
<code>application/x-www-form-urlencoded</code> content type. This means that
you can emulate a HTML <form> POSTing like this:</p>
</dd>
<dd>
<pre>
<span class="variable">POST</span> <span class="string">'http://www.perl.org/survey.cgi'</span><span class="operator">,</span>
<span class="operator">[</span> <span class="string">name</span> <span class="operator">=></span> <span class="string">'Gisle Aas'</span><span class="operator">,</span>
<span class="string">email</span> <span class="operator">=></span> <span class="string">'gisle@aas.no'</span><span class="operator">,</span>
<span class="string">gender</span> <span class="operator">=></span> <span class="string">'M'</span><span class="operator">,</span>
<span class="string">born</span> <span class="operator">=></span> <span class="string">'1964'</span><span class="operator">,</span>
<span class="string">perc</span> <span class="operator">=></span> <span class="string">'3%'</span><span class="operator">,</span>
<span class="operator">]</span><span class="operator">;</span>
</pre>
</dd>
<dd>
<p>This will create a HTTP::Request object that looks like this:</p>
</dd>
<dd>
<pre>
POST <a href="http://www.perl.org/survey.cgi">http://www.perl.org/survey.cgi</a>
Content-Length: 66
Content-Type: application/x-www-form-urlencoded</pre>
</dd>
<dd>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -