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
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Ant-contrib Tasks: Http Tasks</title>
</head>
<body>
<h1>*Method</h1>
The <method> tasks allows the caller to use the various
HTTP methods (current GET, HEAD and POST are supported). These
methods have some common attributes, and sub-elements which are
are as shown below:
<h2>Parameters</h2>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td valign="top"><i>url</i></td>
<td valign="top">The url that is being called.</td>
<td align="center" valign="top">No, if the client host configuration is
defined, and the path attribute is specified.</td>
</tr>
<tr>
<td valign="top"><i>path</i></td>
<td valign="top">The path which we are going to connect to. If this is used,
you must declare an httpClient subelement, or set the clientRefId attribute
for an HttpClient instance with configured host parameters.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>queryString</i></td>
<td valign="top">The queryString which we are posting to. If this is used,
you must declare an httpClient subelement, or set the clientRefId attribute
for an HttpClient instance with configured host parameters.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>clientRefId</i></td>
<td valign="top">The reference id of a previously declared
<httpClient> data type instance. This is necessary
if you want to retain state (cookies) across multiple requests,
or you want specific client configuration and host configuration
parameters. If not specified, we create a new <httpClient>
with the default settings.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>responseDataFile</td>
<td valign="top">The path of the file where the response data will be placed.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>responseDataProperty</td>
<td valign="top">The property where the response data will be placed.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>statusCodeProperty</i></td>
<td valign="top">The name of the property to set with the HTTP response status code.</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>doAuthentication</i></td>
<td valign="top">Should we perform authentication.</td>
<td align="center" valign="top">No. If set, you must
either declare an <httpClient> instance, or set the
clientRefId attribute for an HttpClient which has credentials
installed into it.</td>
</tr>
<tr>
<td valign="top"><i>followRedirects</i></td>
<td valign="top">Should we automatically follow redirects.</td>
<td align="center" valign="top">No.</td>
</tr>
</table>
<h2>Parameters specified as Nested Elements</h2>
<br />
<br />
<b><httpClient></b> <br />
<p>
Create (or reference an existing) HttpClient
for use with this HTTP method call. This is necessary if you wish
to configure the client beyond the default settings, enable
authentication, or retain state across multiple method calls.
</p>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Please see the <a href="http-client_type.html">httpClient</a>
documentation for more details on this element</th>
</tr>
</table>
<br />
<br />
<b><header></b><br />
<p>
Create a request header to be sent.
</p>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td valign="top"><i>name</i></td>
<td valign="top">The header name.</td>
<td align="center" valign="top">Yes.</td>
</tr>
<tr>
<td valign="top"><i>value</i></td>
<td valign="top">The header value.</td>
<td align="center" valign="top">Yes.</td>
</tr>
</table>
<br />
<br />
<b><responseHeader></b><br />
<p>
Specify a response header to be retrieved into a property.
</p>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td valign="top"><i>name</i></td>
<td valign="top">The header name.</td>
<td align="center" valign="top">Yes.</td>
</tr>
<tr>
<td valign="top"><i>property</i></td>
<td valign="top">The property to be set with the header value.</td>
<td align="center" valign="top">Yes.</td>
</tr>
</table>
<br />
<br />
<b><params></b><br />
<p>
Create http method paramaters.
</p>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td valign="top"><i>contentCharSet</i></td>
<td valign="top">The content character set</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>cookiePolicy</i></td>
<td valign="top">The cookie policy (IGNORE_COOKIES, RFC_2109, NETSCAPE or DEFAULT)</td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>credentialCharSet</i></td>
<td valign="top"></td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>httpElementCharSet</i></td>
<td valign="top"></td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>soTimeout</i></td>
<td valign="top"></td>
<td align="center" valign="top">No.</td>
</tr>
<tr>
<td valign="top"><i>version</i></td>
<td valign="top">The HTTP version.</td>
<td align="center" valign="top">No.</td>
</tr>
</table>
<br />
<br />
Additional <b><params></b> subelements:<br />
<double>,<int>,<long>,<boolean>
,<string> <br />
<p>
Create a method parameter.
</p>
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Required</th>
</tr>
<tr>
<td valign="top"><i>name</i></td>
<td valign="top">The parameter name</td>
<td align="center" valign="top">Yes.</td>
</tr>
<tr>
<td valign="top"><i>value</i></td>
<td valign="top">The parameter value.</td>
<td align="center" valign="top">Yes.</td>
</tr>
</table>
<h2>Examples</h2>
<hr>
<p align="center">Copyright © 2002-2003 Ant-Contrib Project. All
rights Reserved.</p>
</body>
</html>
|
