1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">
5
<!-- Generated by javadoc on Sun Oct 10 17:41:05 EDT 2004 -->
7
HttpClient 2.0.2 API: Interface CookieSpec
9
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
11
<BODY BGCOLOR="white">
13
<!-- ========== START OF NAVBAR ========== -->
14
<A NAME="navbar_top"><!-- --></A>
15
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
17
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
18
<A NAME="navbar_top_firstrow"><!-- --></A>
19
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
20
<TR ALIGN="center" VALIGN="top">
21
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
22
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
23
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
24
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/CookieSpec.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
25
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
26
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
27
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
28
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
32
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
38
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
39
PREV CLASS
40
NEXT CLASS</FONT></TD>
41
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
42
<A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
43
<A HREF="CookieSpec.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
46
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
47
SUMMARY: INNER | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
48
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
49
DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
52
<!-- =========== END OF NAVBAR =========== -->
55
<!-- ======== START OF CLASS DATA ======== -->
58
org.apache.commons.httpclient.cookie</FONT>
60
Interface CookieSpec</H2>
62
<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpecBase.html">CookieSpecBase</A></DD>
66
<DT>public interface <B>CookieSpec</B></DL>
69
Defines the cookie management specification.
70
<p>Cookie management specification must define
72
<li> rules of parsing "Set-Cookie" header
73
<li> rules of validation of parsed cookies
74
<li> formatting of "Cookie" header
76
for a given host, port and path of origin
79
<DT><B>Since: </B><DD>2.0</DD>
80
<DT><B>Author: </B><DD><a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a>, <a href="mailto:jsdever@apache.org">Jeff Dever</a></DD>
85
<!-- ======== INNER CLASS SUMMARY ======== -->
88
<!-- =========== FIELD SUMMARY =========== -->
90
<A NAME="field_summary"><!-- --></A>
91
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
92
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
93
<TD COLSPAN=2><FONT SIZE="+2">
94
<B>Field Summary</B></FONT></TD>
96
<TR BGCOLOR="white" CLASS="TableRowColor">
97
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
98
<CODE>static <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
99
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#PATH_DELIM">PATH_DELIM</A></B></CODE>
102
Path delimiter</TD>
104
<TR BGCOLOR="white" CLASS="TableRowColor">
105
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
106
<CODE>static char</CODE></FONT></TD>
107
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#PATH_DELIM_CHAR">PATH_DELIM_CHAR</A></B></CODE>
110
Path delimiting charachter</TD>
114
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
117
<!-- ========== METHOD SUMMARY =========== -->
119
<A NAME="method_summary"><!-- --></A>
120
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
121
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
122
<TD COLSPAN=2><FONT SIZE="+2">
123
<B>Method Summary</B></FONT></TD>
125
<TR BGCOLOR="white" CLASS="TableRowColor">
126
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
127
<CODE> <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
128
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#formatCookie(org.apache.commons.httpclient.Cookie)">formatCookie</A></B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</CODE>
131
Create a <tt>"Cookie"</tt> header value for an array of cookies.</TD>
133
<TR BGCOLOR="white" CLASS="TableRowColor">
134
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
135
<CODE> <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A></CODE></FONT></TD>
136
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#formatCookieHeader(org.apache.commons.httpclient.Cookie)">formatCookieHeader</A></B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</CODE>
139
Create a <tt>"Cookie"</tt> Header for single Cookie.</TD>
141
<TR BGCOLOR="white" CLASS="TableRowColor">
142
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
143
<CODE> <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A></CODE></FONT></TD>
144
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#formatCookieHeader(org.apache.commons.httpclient.Cookie[])">formatCookieHeader</A></B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)</CODE>
147
Create a <tt>"Cookie"</tt> Header for an array of Cookies.</TD>
149
<TR BGCOLOR="white" CLASS="TableRowColor">
150
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
151
<CODE> <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A></CODE></FONT></TD>
152
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#formatCookies(org.apache.commons.httpclient.Cookie[])">formatCookies</A></B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)</CODE>
155
Create a <tt>"Cookie"</tt> header value for an array of cookies.</TD>
157
<TR BGCOLOR="white" CLASS="TableRowColor">
158
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
159
<CODE> boolean</CODE></FONT></TD>
160
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)">match</A></B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
162
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
164
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</CODE>
167
Determines if a Cookie matches a location.</TD>
169
<TR BGCOLOR="white" CLASS="TableRowColor">
170
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
171
<CODE> <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[]</CODE></FONT></TD>
172
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie[])">match</A></B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
174
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
176
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)</CODE>
179
Determines which of an array of Cookies matches a location.</TD>
181
<TR BGCOLOR="white" CLASS="TableRowColor">
182
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
183
<CODE> <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[]</CODE></FONT></TD>
184
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#parse(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Header)">parse</A></B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
186
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
188
<A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A> header)</CODE>
191
Parse the <tt>"Set-Cookie"</tt> Header into an array of Cookies.</TD>
193
<TR BGCOLOR="white" CLASS="TableRowColor">
194
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
195
<CODE> <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[]</CODE></FONT></TD>
196
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#parse(java.lang.String, int, java.lang.String, boolean, java.lang.String)">parse</A></B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
198
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
200
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> header)</CODE>
203
Parse the <tt>"Set-Cookie"</tt> header value into Cookie array.</TD>
205
<TR BGCOLOR="white" CLASS="TableRowColor">
206
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
207
<CODE> void</CODE></FONT></TD>
208
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#parseAttribute(org.apache.commons.httpclient.NameValuePair, org.apache.commons.httpclient.Cookie)">parseAttribute</A></B>(<A HREF="../../../../../org/apache/commons/httpclient/NameValuePair.html">NameValuePair</A> attribute,
209
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</CODE>
212
Parse the cookie attribute and update the corresponsing Cookie
215
<TR BGCOLOR="white" CLASS="TableRowColor">
216
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
217
<CODE> void</CODE></FONT></TD>
218
<TD><CODE><B><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpec.html#validate(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)">validate</A></B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
220
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
222
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</CODE>
225
Validate the cookie according to validation rules defined by the
226
cookie specification.</TD>
232
<!-- ============ FIELD DETAIL =========== -->
234
<A NAME="field_detail"><!-- --></A>
235
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
236
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
237
<TD COLSPAN=1><FONT SIZE="+2">
238
<B>Field Detail</B></FONT></TD>
242
<A NAME="PATH_DELIM"><!-- --></A><H3>
245
public static final <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> <B>PATH_DELIM</B></PRE>
247
<DD>Path delimiter</DL>
250
<A NAME="PATH_DELIM_CHAR"><!-- --></A><H3>
253
public static final char <B>PATH_DELIM_CHAR</B></PRE>
255
<DD>Path delimiting charachter</DL>
257
<!-- ========= CONSTRUCTOR DETAIL ======== -->
260
<!-- ============ METHOD DETAIL ========== -->
262
<A NAME="method_detail"><!-- --></A>
263
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
264
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
265
<TD COLSPAN=1><FONT SIZE="+2">
266
<B>Method Detail</B></FONT></TD>
270
<A NAME="parse(java.lang.String, int, java.lang.String, boolean, java.lang.String)"><!-- --></A><H3>
273
public <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] <B>parse</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
275
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
277
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> header)
278
throws <A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A>,
279
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
281
<DD>Parse the <tt>"Set-Cookie"</tt> header value into Cookie array.<DD><DL>
282
<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host which sent the <tt>Set-Cookie</tt> header<DD><CODE>port</CODE> - the port which sent the <tt>Set-Cookie</tt> header<DD><CODE>path</CODE> - the path which sent the <tt>Set-Cookie</tt> header<DD><CODE>secure</CODE> - <tt>true</tt> when the <tt>Set-Cookie</tt> header
283
was received over secure conection<DD><CODE>header</CODE> - the <tt>Set-Cookie</tt> received from the server<DT><B>Returns:</B><DD>an array of <tt>Cookie</tt>s parsed from the Set-Cookie value<DT><B>Throws:</B><DD><CODE><A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A></CODE> - if an exception occurs during parsing<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
288
<A NAME="parse(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Header)"><!-- --></A><H3>
291
public <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] <B>parse</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
293
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
295
<A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A> header)
296
throws <A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A>,
297
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
299
<DD>Parse the <tt>"Set-Cookie"</tt> Header into an array of Cookies.<DD><DL>
300
<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host which sent the <tt>Set-Cookie</tt> header<DD><CODE>port</CODE> - the port which sent the <tt>Set-Cookie</tt> header<DD><CODE>path</CODE> - the path which sent the <tt>Set-Cookie</tt> header<DD><CODE>secure</CODE> - <tt>true</tt> when the <tt>Set-Cookie</tt> header
301
was received over secure conection<DD><CODE>header</CODE> - the <tt>Set-Cookie</tt> received from the server<DT><B>Returns:</B><DD>an array of <tt>Cookie</tt>s parsed from the header<DT><B>Throws:</B><DD><CODE><A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A></CODE> - if an exception occurs during parsing<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
306
<A NAME="parseAttribute(org.apache.commons.httpclient.NameValuePair, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
309
public void <B>parseAttribute</B>(<A HREF="../../../../../org/apache/commons/httpclient/NameValuePair.html">NameValuePair</A> attribute,
310
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)
311
throws <A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A>,
312
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
314
<DD>Parse the cookie attribute and update the corresponsing Cookie
316
<DT><B>Parameters:</B><DD><CODE>attribute</CODE> - cookie attribute from the <tt>Set-Cookie</tt><DD><CODE>cookie</CODE> - the to be updated<DT><B>Throws:</B><DD><CODE><A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A></CODE> - if an exception occurs during parsing<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
321
<A NAME="validate(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
324
public void <B>validate</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
326
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
328
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)
329
throws <A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A>,
330
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
332
<DD>Validate the cookie according to validation rules defined by the
333
cookie specification.<DD><DL>
334
<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host from which the <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html"><CODE>Cookie</CODE></A> was received<DD><CODE>port</CODE> - the port from which the <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html"><CODE>Cookie</CODE></A> was received<DD><CODE>path</CODE> - the path from which the <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html"><CODE>Cookie</CODE></A> was received<DD><CODE>secure</CODE> - <tt>true</tt> when the <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html"><CODE>Cookie</CODE></A> was received
335
using a secure connection<DD><CODE>cookie</CODE> - the Cookie to validate<DT><B>Throws:</B><DD><CODE><A HREF="../../../../../org/apache/commons/httpclient/cookie/MalformedCookieException.html">MalformedCookieException</A></CODE> - if the cookie is invalid<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
340
<A NAME="match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
343
public boolean <B>match</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
345
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
347
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</PRE>
349
<DD>Determines if a Cookie matches a location.<DD><DL>
350
<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host to which the request is being submitted<DD><CODE>port</CODE> - the port to which the request is being submitted<DD><CODE>path</CODE> - the path to which the request is being submitted<DD><CODE>secure</CODE> - <tt>true</tt> if the request is using a secure connection<DD><CODE>cookie</CODE> - the Cookie to be matched<DT><B>Returns:</B><DD><tt>true</tt> if the cookie should be submitted with a request
351
with given attributes, <tt>false</tt> otherwise.</DL>
356
<A NAME="match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
359
public <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] <B>match</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> host,
361
<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> path,
363
<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)</PRE>
365
<DD>Determines which of an array of Cookies matches a location.<DD><DL>
366
<DT><B>Parameters:</B><DD><CODE>host</CODE> - the host to which the request is being submitted<DD><CODE>port</CODE> - the port to which the request is being submitted
367
(currenlty ignored)<DD><CODE>path</CODE> - the path to which the request is being submitted<DD><CODE>secure</CODE> - <tt>true</tt> if the request is using a secure protocol<DD><CODE>cookies</CODE> - an array of <tt>Cookie</tt>s to be matched<DT><B>Returns:</B><DD><tt>true</tt> if the cookie should be submitted with a request
368
with given attributes, <tt>false</tt> otherwise.</DL>
373
<A NAME="formatCookie(org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
376
public <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> <B>formatCookie</B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)</PRE>
378
<DD>Create a <tt>"Cookie"</tt> header value for an array of cookies.<DD><DL>
379
<DT><B>Parameters:</B><DD><CODE>cookie</CODE> - the cookie to be formatted as string<DT><B>Returns:</B><DD>a string suitable for sending in a <tt>"Cookie"</tt> header.</DL>
384
<A NAME="formatCookies(org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
387
public <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A> <B>formatCookies</B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)
388
throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
390
<DD>Create a <tt>"Cookie"</tt> header value for an array of cookies.<DD><DL>
391
<DT><B>Parameters:</B><DD><CODE>cookies</CODE> - the Cookies to be formatted<DT><B>Returns:</B><DD>a string suitable for sending in a Cookie header.<DT><B>Throws:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
396
<A NAME="formatCookieHeader(org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
397
formatCookieHeader</H3>
399
public <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A> <B>formatCookieHeader</B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[] cookies)
400
throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
402
<DD>Create a <tt>"Cookie"</tt> Header for an array of Cookies.<DD><DL>
403
<DT><B>Parameters:</B><DD><CODE>cookies</CODE> - the Cookies format into a Cookie header<DT><B>Returns:</B><DD>a Header for the given Cookies.<DT><B>Throws:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
408
<A NAME="formatCookieHeader(org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
409
formatCookieHeader</H3>
411
public <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A> <B>formatCookieHeader</B>(<A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A> cookie)
412
throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
414
<DD>Create a <tt>"Cookie"</tt> Header for single Cookie.<DD><DL>
415
<DT><B>Parameters:</B><DD><CODE>cookie</CODE> - the Cookie format as a <tt>Cookie</tt> header<DT><B>Returns:</B><DD>a Cookie header.<DT><B>Throws:</B><DD><CODE><A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if an input parameter is illegal</DL>
418
<!-- ========= END OF CLASS DATA ========= -->
421
<!-- ========== START OF NAVBAR ========== -->
422
<A NAME="navbar_bottom"><!-- --></A>
423
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
425
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
426
<A NAME="navbar_bottom_firstrow"><!-- --></A>
427
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
428
<TR ALIGN="center" VALIGN="top">
429
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
430
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
431
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
432
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/CookieSpec.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
433
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
434
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
435
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
436
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
440
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
446
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
447
PREV CLASS
448
NEXT CLASS</FONT></TD>
449
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
450
<A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A>
451
<A HREF="CookieSpec.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
454
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
455
SUMMARY: INNER | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
456
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
457
DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
460
<!-- =========== END OF NAVBAR =========== -->
463
Copyright © 2001-2004 Apache Software Foundation. All Rights Reserved.