~ubuntu-branches/ubuntu/lucid/commons-httpclient/lucid

« back to all changes in this revision

Viewing changes to docs/apidocs/org/apache/commons/httpclient/cookie/CookieSpec.html

  • Committer: Bazaar Package Importer
  • Author(s): Barry Hawkins
  • Date: 2005-11-25 13:12:23 UTC
  • Revision ID: james.westby@ubuntu.com-20051125131223-2g7eyo21pqgrohpo
Tags: upstream-2.0.2
ImportĀ upstreamĀ versionĀ 2.0.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">
 
2
<!--NewPage-->
 
3
<HTML>
 
4
<HEAD>
 
5
<!-- Generated by javadoc on Sun Oct 10 17:41:05 EDT 2004 -->
 
6
<TITLE>
 
7
HttpClient 2.0.2 API: Interface  CookieSpec
 
8
</TITLE>
 
9
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
 
10
</HEAD>
 
11
<BODY BGCOLOR="white">
 
12
 
 
13
<!-- ========== START OF NAVBAR ========== -->
 
14
<A NAME="navbar_top"><!-- --></A>
 
15
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
 
16
<TR>
 
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>&nbsp;</TD>
 
22
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 
23
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 
24
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/CookieSpec.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
 
25
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 
26
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 
27
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 
28
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 
29
  </TR>
 
30
</TABLE>
 
31
</TD>
 
32
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 
33
</EM>
 
34
</TD>
 
35
</TR>
 
36
 
 
37
<TR>
 
38
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 
39
&nbsp;PREV CLASS&nbsp;
 
40
&nbsp;NEXT CLASS</FONT></TD>
 
41
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 
42
  <A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
 
43
&nbsp;<A HREF="CookieSpec.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
 
44
</TR>
 
45
<TR>
 
46
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 
47
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 
48
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 
49
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 
50
</TR>
 
51
</TABLE>
 
52
<!-- =========== END OF NAVBAR =========== -->
 
53
 
 
54
<HR>
 
55
<!-- ======== START OF CLASS DATA ======== -->
 
56
<H2>
 
57
<FONT SIZE="-1">
 
58
org.apache.commons.httpclient.cookie</FONT>
 
59
<BR>
 
60
Interface  CookieSpec</H2>
 
61
<DL>
 
62
<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../org/apache/commons/httpclient/cookie/CookieSpecBase.html">CookieSpecBase</A></DD>
 
63
</DL>
 
64
<HR>
 
65
<DL>
 
66
<DT>public interface <B>CookieSpec</B></DL>
 
67
 
 
68
<P>
 
69
Defines the cookie management specification.
 
70
 <p>Cookie management specification must define
 
71
 <ul>
 
72
   <li> rules of parsing "Set-Cookie" header
 
73
   <li> rules of validation of parsed cookies
 
74
   <li>  formatting of "Cookie" header 
 
75
 </ul>
 
76
 for a given host, port and path of origin
 
77
<P>
 
78
<DL>
 
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>
 
81
</DL>
 
82
<HR>
 
83
 
 
84
<P>
 
85
<!-- ======== INNER CLASS SUMMARY ======== -->
 
86
 
 
87
 
 
88
<!-- =========== FIELD SUMMARY =========== -->
 
89
 
 
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>
 
95
</TR>
 
96
<TR BGCOLOR="white" CLASS="TableRowColor">
 
97
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
98
<CODE>static&nbsp;<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>
 
100
 
 
101
<BR>
 
102
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Path delimiter</TD>
 
103
</TR>
 
104
<TR BGCOLOR="white" CLASS="TableRowColor">
 
105
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
106
<CODE>static&nbsp;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>
 
108
 
 
109
<BR>
 
110
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Path delimiting charachter</TD>
 
111
</TR>
 
112
</TABLE>
 
113
&nbsp;
 
114
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
 
115
 
 
116
 
 
117
<!-- ========== METHOD SUMMARY =========== -->
 
118
 
 
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>
 
124
</TR>
 
125
<TR BGCOLOR="white" CLASS="TableRowColor">
 
126
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
127
<CODE>&nbsp;<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>&nbsp;cookie)</CODE>
 
129
 
 
130
<BR>
 
131
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a <tt>"Cookie"</tt> header value for an array of cookies.</TD>
 
132
</TR>
 
133
<TR BGCOLOR="white" CLASS="TableRowColor">
 
134
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
135
<CODE>&nbsp;<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>&nbsp;cookie)</CODE>
 
137
 
 
138
<BR>
 
139
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a <tt>"Cookie"</tt> Header for single Cookie.</TD>
 
140
</TR>
 
141
<TR BGCOLOR="white" CLASS="TableRowColor">
 
142
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
143
<CODE>&nbsp;<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>[]&nbsp;cookies)</CODE>
 
145
 
 
146
<BR>
 
147
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a <tt>"Cookie"</tt> Header for an array of Cookies.</TD>
 
148
</TR>
 
149
<TR BGCOLOR="white" CLASS="TableRowColor">
 
150
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
151
<CODE>&nbsp;<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>[]&nbsp;cookies)</CODE>
 
153
 
 
154
<BR>
 
155
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Create a <tt>"Cookie"</tt> header value for an array of cookies.</TD>
 
156
</TR>
 
157
<TR BGCOLOR="white" CLASS="TableRowColor">
 
158
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
159
<CODE>&nbsp;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>&nbsp;host,
 
161
      int&nbsp;port,
 
162
      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
163
      boolean&nbsp;secure,
 
164
      <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;cookie)</CODE>
 
165
 
 
166
<BR>
 
167
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Determines if a Cookie matches a location.</TD>
 
168
</TR>
 
169
<TR BGCOLOR="white" CLASS="TableRowColor">
 
170
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
171
<CODE>&nbsp;<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>&nbsp;host,
 
173
      int&nbsp;port,
 
174
      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
175
      boolean&nbsp;secure,
 
176
      <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[]&nbsp;cookies)</CODE>
 
177
 
 
178
<BR>
 
179
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Determines which of an array of Cookies matches a location.</TD>
 
180
</TR>
 
181
<TR BGCOLOR="white" CLASS="TableRowColor">
 
182
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
183
<CODE>&nbsp;<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>&nbsp;host,
 
185
      int&nbsp;port,
 
186
      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
187
      boolean&nbsp;secure,
 
188
      <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A>&nbsp;header)</CODE>
 
189
 
 
190
<BR>
 
191
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Parse the <tt>"Set-Cookie"</tt> Header into an array of Cookies.</TD>
 
192
</TR>
 
193
<TR BGCOLOR="white" CLASS="TableRowColor">
 
194
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
195
<CODE>&nbsp;<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>&nbsp;host,
 
197
      int&nbsp;port,
 
198
      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
199
      boolean&nbsp;secure,
 
200
      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;header)</CODE>
 
201
 
 
202
<BR>
 
203
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Parse the <tt>"Set-Cookie"</tt> header value into Cookie array.</TD>
 
204
</TR>
 
205
<TR BGCOLOR="white" CLASS="TableRowColor">
 
206
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
207
<CODE>&nbsp;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>&nbsp;attribute,
 
209
               <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;cookie)</CODE>
 
210
 
 
211
<BR>
 
212
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Parse the cookie attribute and update the corresponsing Cookie 
 
213
  properties.</TD>
 
214
</TR>
 
215
<TR BGCOLOR="white" CLASS="TableRowColor">
 
216
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
 
217
<CODE>&nbsp;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>&nbsp;host,
 
219
         int&nbsp;port,
 
220
         <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
221
         boolean&nbsp;secure,
 
222
         <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;cookie)</CODE>
 
223
 
 
224
<BR>
 
225
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Validate the cookie according to validation rules defined by the 
 
226
  cookie specification.</TD>
 
227
</TR>
 
228
</TABLE>
 
229
&nbsp;
 
230
<P>
 
231
 
 
232
<!-- ============ FIELD DETAIL =========== -->
 
233
 
 
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>
 
239
</TR>
 
240
</TABLE>
 
241
 
 
242
<A NAME="PATH_DELIM"><!-- --></A><H3>
 
243
PATH_DELIM</H3>
 
244
<PRE>
 
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>
 
246
<DL>
 
247
<DD>Path delimiter</DL>
 
248
<HR>
 
249
 
 
250
<A NAME="PATH_DELIM_CHAR"><!-- --></A><H3>
 
251
PATH_DELIM_CHAR</H3>
 
252
<PRE>
 
253
public static final char <B>PATH_DELIM_CHAR</B></PRE>
 
254
<DL>
 
255
<DD>Path delimiting charachter</DL>
 
256
 
 
257
<!-- ========= CONSTRUCTOR DETAIL ======== -->
 
258
 
 
259
 
 
260
<!-- ============ METHOD DETAIL ========== -->
 
261
 
 
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>
 
267
</TR>
 
268
</TABLE>
 
269
 
 
270
<A NAME="parse(java.lang.String, int, java.lang.String, boolean, java.lang.String)"><!-- --></A><H3>
 
271
parse</H3>
 
272
<PRE>
 
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>&nbsp;host,
 
274
                      int&nbsp;port,
 
275
                      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
276
                      boolean&nbsp;secure,
 
277
                      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;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>
 
280
<DL>
 
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>
 
284
</DD>
 
285
</DL>
 
286
<HR>
 
287
 
 
288
<A NAME="parse(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Header)"><!-- --></A><H3>
 
289
parse</H3>
 
290
<PRE>
 
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>&nbsp;host,
 
292
                      int&nbsp;port,
 
293
                      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
294
                      boolean&nbsp;secure,
 
295
                      <A HREF="../../../../../org/apache/commons/httpclient/Header.html">Header</A>&nbsp;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>
 
298
<DL>
 
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>
 
302
</DD>
 
303
</DL>
 
304
<HR>
 
305
 
 
306
<A NAME="parseAttribute(org.apache.commons.httpclient.NameValuePair, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
 
307
parseAttribute</H3>
 
308
<PRE>
 
309
public void <B>parseAttribute</B>(<A HREF="../../../../../org/apache/commons/httpclient/NameValuePair.html">NameValuePair</A>&nbsp;attribute,
 
310
                           <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;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>
 
313
<DL>
 
314
<DD>Parse the cookie attribute and update the corresponsing Cookie 
 
315
  properties.<DD><DL>
 
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>
 
317
</DD>
 
318
</DL>
 
319
<HR>
 
320
 
 
321
<A NAME="validate(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
 
322
validate</H3>
 
323
<PRE>
 
324
public void <B>validate</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;host,
 
325
                     int&nbsp;port,
 
326
                     <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
327
                     boolean&nbsp;secure,
 
328
                     <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;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>
 
331
<DL>
 
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>
 
336
</DD>
 
337
</DL>
 
338
<HR>
 
339
 
 
340
<A NAME="match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
 
341
match</H3>
 
342
<PRE>
 
343
public boolean <B>match</B>(<A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;host,
 
344
                     int&nbsp;port,
 
345
                     <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
346
                     boolean&nbsp;secure,
 
347
                     <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>&nbsp;cookie)</PRE>
 
348
<DL>
 
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>
 
352
</DD>
 
353
</DL>
 
354
<HR>
 
355
 
 
356
<A NAME="match(java.lang.String, int, java.lang.String, boolean, org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
 
357
match</H3>
 
358
<PRE>
 
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>&nbsp;host,
 
360
                      int&nbsp;port,
 
361
                      <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/String.html">String</A>&nbsp;path,
 
362
                      boolean&nbsp;secure,
 
363
                      <A HREF="../../../../../org/apache/commons/httpclient/Cookie.html">Cookie</A>[]&nbsp;cookies)</PRE>
 
364
<DL>
 
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>
 
369
</DD>
 
370
</DL>
 
371
<HR>
 
372
 
 
373
<A NAME="formatCookie(org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
 
374
formatCookie</H3>
 
375
<PRE>
 
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>&nbsp;cookie)</PRE>
 
377
<DL>
 
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>
 
380
</DD>
 
381
</DL>
 
382
<HR>
 
383
 
 
384
<A NAME="formatCookies(org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
 
385
formatCookies</H3>
 
386
<PRE>
 
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>[]&nbsp;cookies)
 
388
                     throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
 
389
<DL>
 
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>
 
392
</DD>
 
393
</DL>
 
394
<HR>
 
395
 
 
396
<A NAME="formatCookieHeader(org.apache.commons.httpclient.Cookie[])"><!-- --></A><H3>
 
397
formatCookieHeader</H3>
 
398
<PRE>
 
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>[]&nbsp;cookies)
 
400
                          throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
 
401
<DL>
 
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>
 
404
</DD>
 
405
</DL>
 
406
<HR>
 
407
 
 
408
<A NAME="formatCookieHeader(org.apache.commons.httpclient.Cookie)"><!-- --></A><H3>
 
409
formatCookieHeader</H3>
 
410
<PRE>
 
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>&nbsp;cookie)
 
412
                          throws <A HREF="http://java.sun.com/j2se/1.4.1/docs/api/java/lang/IllegalArgumentException.html">IllegalArgumentException</A></PRE>
 
413
<DL>
 
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>
 
416
</DD>
 
417
</DL>
 
418
<!-- ========= END OF CLASS DATA ========= -->
 
419
<HR>
 
420
 
 
421
<!-- ========== START OF NAVBAR ========== -->
 
422
<A NAME="navbar_bottom"><!-- --></A>
 
423
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
 
424
<TR>
 
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>&nbsp;</TD>
 
430
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 
431
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 
432
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/CookieSpec.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
 
433
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 
434
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 
435
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 
436
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 
437
  </TR>
 
438
</TABLE>
 
439
</TD>
 
440
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 
441
</EM>
 
442
</TD>
 
443
</TR>
 
444
 
 
445
<TR>
 
446
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 
447
&nbsp;PREV CLASS&nbsp;
 
448
&nbsp;NEXT CLASS</FONT></TD>
 
449
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 
450
  <A HREF="../../../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
 
451
&nbsp;<A HREF="CookieSpec.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
 
452
</TR>
 
453
<TR>
 
454
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 
455
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 
456
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 
457
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 
458
</TR>
 
459
</TABLE>
 
460
<!-- =========== END OF NAVBAR =========== -->
 
461
 
 
462
<HR>
 
463
Copyright &copy; 2001-2004 Apache Software Foundation. All Rights Reserved.
 
464
</BODY>
 
465
</HTML>