1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<!--NewPage-->
3<HTML>
4<HEAD>
5<!-- Generated by javadoc (build 1.5.0_04) on Sun Feb 19 05:15:30 PST 2006 -->
6<TITLE>
7USPostalCodeService (JPostal API)
8</TITLE>
9
10<META NAME="keywords" CONTENT="org.ahmadsoft.postal.USPostalCodeService class">
11
12<LINK REL ="stylesheet" TYPE="text/css" HREF="/stylesheet.css" TITLE="Style">
13
14<SCRIPT type="text/javascript">
15function windowTitle()
16{
17    parent.document.title="USPostalCodeService (JPostal API)";
18}
19</SCRIPT>
20<NOSCRIPT>
21</NOSCRIPT>
22
23</HEAD>
24
25<BODY BGCOLOR="white" onload="windowTitle();">
26
27
28<!-- ========= START OF TOP NAVBAR ======= -->
29<A NAME="navbar_top"><!-- --></A>
30<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
31<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
32<TR>
33<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
34<A NAME="navbar_top_firstrow"><!-- --></A>
35<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
36  <TR ALIGN="center" VALIGN="top">
37  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/org/ahmadsoft/postal/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
38  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
39  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/USPostalCodeService.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
40  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
41  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
42  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
43  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
44  </TR>
45</TABLE>
46</TD>
47<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
48</EM>
49</TD>
50</TR>
51
52<TR>
53<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
54&nbsp;<A HREF="/org/ahmadsoft/postal/ReadOnceStrategy.html" title="class in org.ahmadsoft.postal"><B>PREV CLASS</B></A>&nbsp;
55&nbsp;<A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal"><B>NEXT CLASS</B></A></FONT></TD>
56<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57  <A HREF="/index.html?org/ahmadsoft/postal/USPostalCodeService.html" target="_top"><B>FRAMES</B></A>  &nbsp;
58&nbsp;<A HREF="USPostalCodeService.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
59&nbsp;<SCRIPT type="text/javascript">
60  <!--
61  if(window==top) {
62    document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>');
63  }
64  //-->
65</SCRIPT>
66<NOSCRIPT>
67  <A HREF="/allclasses-noframe.html"><B>All Classes</B></A>
68</NOSCRIPT>
69
70
71</FONT></TD>
72</TR>
73<TR>
74<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
75  SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
76<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
77DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
78</TR>
79</TABLE>
80<A NAME="skip-navbar_top"></A>
81<!-- ========= END OF TOP NAVBAR ========= -->
82
83<HR>
84<!-- ======== START OF CLASS DATA ======== -->
85<H2>
86<FONT SIZE="-1">
87org.ahmadsoft.postal</FONT>
88<BR>
89Class USPostalCodeService</H2>
90<PRE>
91java.lang.Object
92  <IMG SRC="/resources/inherit.gif" ALT="extended by "><B>org.ahmadsoft.postal.USPostalCodeService</B>
93</PRE>
94<HR>
95<DL>
96<DT><PRE>public class <B>USPostalCodeService</B><DT>extends java.lang.Object</DL>
97</PRE>
98
99<P>
100Provides a postal code service implementation for the United 
101 States of America.
102<P>
103
104<P>
105<DL>
106<DT><B>Author:</B></DT>
107  <DD>Amin Ahmad</DD>
108</DL>
109<HR>
110
111<P>
112<!-- ======== NESTED CLASS SUMMARY ======== -->
113
114<A NAME="nested_class_summary"><!-- --></A>
115<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
116<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
117<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
118<B>Nested Class Summary</B></FONT></TH>
119</TR>
120<TR BGCOLOR="white" CLASS="TableRowColor">
121<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
122<CODE>static&nbsp;class</CODE></FONT></TD>
123<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal">USPostalCodeService.MatchOptions</A></B></CODE>
124
125<BR>
126&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Specifies options for performing an advanced match
127 operation.</TD>
128</TR>
129<TR BGCOLOR="white" CLASS="TableRowColor">
130<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
131<CODE>static&nbsp;class</CODE></FONT></TD>
132<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchResult.html" title="class in org.ahmadsoft.postal">USPostalCodeService.MatchResult</A></B></CODE>
133
134<BR>
135&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The result of a matching operation.</TD>
136</TR>
137</TABLE>
138&nbsp;
139<!-- ======== CONSTRUCTOR SUMMARY ======== -->
140
141<A NAME="constructor_summary"><!-- --></A>
142<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
143<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
144<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
145<B>Constructor Summary</B></FONT></TH>
146</TR>
147<TR BGCOLOR="white" CLASS="TableRowColor">
148<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#USPostalCodeService()">USPostalCodeService</A></B>()</CODE>
149
150<BR>
151&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
152</TR>
153</TABLE>
154&nbsp;
155<!-- ========== METHOD SUMMARY =========== -->
156
157<A NAME="method_summary"><!-- --></A>
158<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
159<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
160<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
161<B>Method Summary</B></FONT></TH>
162</TR>
163<TR BGCOLOR="white" CLASS="TableRowColor">
164<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
165<CODE>&nbsp;void</CODE></FONT></TD>
166<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#dispose()">dispose</A></B>()</CODE>
167
168<BR>
169&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Disposes an instance of this object.</TD>
170</TR>
171<TR BGCOLOR="white" CLASS="TableRowColor">
172<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
173<CODE>&nbsp;<A HREF="/org/ahmadsoft/postal/PostalCodeEntry.html" title="class in org.ahmadsoft.postal">PostalCodeEntry</A></CODE></FONT></TD>
174<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#getActualFor(int)">getActualFor</A></B>(int&nbsp;postalCode)</CODE>
175
176<BR>
177&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the <code>PostalCodeEntry</code> for the actual city
178 registered with the U.S.</TD>
179</TR>
180<TR BGCOLOR="white" CLASS="TableRowColor">
181<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
182<CODE>&nbsp;java.util.List</CODE></FONT></TD>
183<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#getCandidates(int)">getCandidates</A></B>(int&nbsp;postalCode)</CODE>
184
185<BR>
186&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a list of all recognized candidate cities for a given postal
187 code.</TD>
188</TR>
189<TR BGCOLOR="white" CLASS="TableRowColor">
190<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
191<CODE>&nbsp;void</CODE></FONT></TD>
192<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#initialize(org.ahmadsoft.postal.PostalRetrievalStrategy)">initialize</A></B>(<A HREF="/org/ahmadsoft/postal/PostalRetrievalStrategy.html" title="interface in org.ahmadsoft.postal">PostalRetrievalStrategy</A>&nbsp;retrievalStrategy)</CODE>
193
194<BR>
195&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Initializes an instance of the US Postal Code Service.</TD>
196</TR>
197<TR BGCOLOR="white" CLASS="TableRowColor">
198<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
199<CODE>&nbsp;boolean</CODE></FONT></TD>
200<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#isPostalCodeIn(int, java.lang.String)">isPostalCodeIn</A></B>(int&nbsp;postalCode,
201               java.lang.String&nbsp;stateAbbr)</CODE>
202
203<BR>
204&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns <code>true</code> if the given postal code is within
205 the given state, or <code>false</code> otherwise.</TD>
206</TR>
207<TR BGCOLOR="white" CLASS="TableRowColor">
208<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
209<CODE>&nbsp;java.util.List</CODE></FONT></TD>
210<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#match(java.lang.String, int)">match</A></B>(java.lang.String&nbsp;city,
211      int&nbsp;postalCode)</CODE>
212
213<BR>
214&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Performs a match using default matching options well-suited 
215 to common validation.</TD>
216</TR>
217<TR BGCOLOR="white" CLASS="TableRowColor">
218<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
219<CODE>&nbsp;java.util.List</CODE></FONT></TD>
220<TD><CODE><B><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#match(java.lang.String, int, org.ahmadsoft.postal.USPostalCodeService.MatchOptions)">match</A></B>(java.lang.String&nbsp;city,
221      int&nbsp;postalCode,
222      <A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal">USPostalCodeService.MatchOptions</A>&nbsp;options)</CODE>
223
224<BR>
225&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a list of the closest matches to the specified city
226 within the specified postal code.</TD>
227</TR>
228</TABLE>
229&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
230<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
231<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
232<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
233</TR>
234<TR BGCOLOR="white" CLASS="TableRowColor">
235<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
236</TR>
237</TABLE>
238&nbsp;
239<P>
240
241<!-- ========= CONSTRUCTOR DETAIL ======== -->
242
243<A NAME="constructor_detail"><!-- --></A>
244<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
245<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
246<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
247<B>Constructor Detail</B></FONT></TH>
248</TR>
249</TABLE>
250
251<A NAME="USPostalCodeService()"><!-- --></A><H3>
252USPostalCodeService</H3>
253<PRE>
254public <B>USPostalCodeService</B>()</PRE>
255<DL>
256</DL>
257
258<!-- ============ METHOD DETAIL ========== -->
259
260<A NAME="method_detail"><!-- --></A>
261<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
262<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
263<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
264<B>Method Detail</B></FONT></TH>
265</TR>
266</TABLE>
267
268<A NAME="dispose()"><!-- --></A><H3>
269dispose</H3>
270<PRE>
271public void <B>dispose</B>()
272             throws java.lang.Exception</PRE>
273<DL>
274<DD>Disposes an instance of this object. Subsequent use of this
275 object is a logical programming error.
276<P>
277<DD><DL>
278
279<DT><B>Throws:</B>
280<DD><CODE>java.lang.Exception</CODE></DL>
281</DD>
282</DL>
283<HR>
284
285<A NAME="initialize(org.ahmadsoft.postal.PostalRetrievalStrategy)"><!-- --></A><H3>
286initialize</H3>
287<PRE>
288public void <B>initialize</B>(<A HREF="/org/ahmadsoft/postal/PostalRetrievalStrategy.html" title="interface in org.ahmadsoft.postal">PostalRetrievalStrategy</A>&nbsp;retrievalStrategy)
289                throws java.lang.Exception</PRE>
290<DL>
291<DD>Initializes an instance of the US Postal Code Service. Initialization 
292 is required prior to use.
293<P>
294<DD><DL>
295<DT><B>Parameters:</B><DD><CODE>retrievalStrategy</CODE> - an initialized postal retrieval strategy.
296<DT><B>Throws:</B>
297<DD><CODE>java.lang.Exception</CODE> - if an error occurs during initialization. Renders 
298 this service instance unusable.</DL>
299</DD>
300</DL>
301<HR>
302
303<A NAME="getCandidates(int)"><!-- --></A><H3>
304getCandidates</H3>
305<PRE>
306public java.util.List <B>getCandidates</B>(int&nbsp;postalCode)</PRE>
307<DL>
308<DD>Returns a list of all recognized candidate cities for a given postal
309 code. Candidate cities are catogorized as actual, acceptable, and 
310 unacceptable.
311<P>
312<DD><DL>
313<DT><B>Parameters:</B><DD><CODE>postalCode</CODE> - the postal code.
314<DT><B>Returns:</B><DD>a list of all recognized candidate cities for a given postal
315 code.</DL>
316</DD>
317</DL>
318<HR>
319
320<A NAME="isPostalCodeIn(int, java.lang.String)"><!-- --></A><H3>
321isPostalCodeIn</H3>
322<PRE>
323public boolean <B>isPostalCodeIn</B>(int&nbsp;postalCode,
324                              java.lang.String&nbsp;stateAbbr)</PRE>
325<DL>
326<DD>Returns <code>true</code> if the given postal code is within
327 the given state, or <code>false</code> otherwise.  For
328 example, <code>isPostalCodeIn(85050, "AZ")</code> will return <code>true</code>
329 because the 85050 postal code is within Arizona, but 
330 <code>isPostalCodeIn(43202, "CA")</code> will return <code>false</code>
331 because the 43202 is not in California, but rather in Ohio.
332<P>
333<DD><DL>
334<DT><B>Parameters:</B><DD><CODE>postalCode</CODE> - the postal code.<DD><CODE>stateAbbr</CODE> - the two-digit, upper-case abbreviation for 
335 a state, as specified in <a href="http://www.usps.com/ncsc/lookups/usps_abbreviations.html">
336 United States Postal Service - Abbreviations</a>.
337<DT><B>Returns:</B><DD><code>true</code> if the given postal code is within
338 the given state, or <code>false</code> otherwise.</DL>
339</DD>
340</DL>
341<HR>
342
343<A NAME="getActualFor(int)"><!-- --></A><H3>
344getActualFor</H3>
345<PRE>
346public <A HREF="/org/ahmadsoft/postal/PostalCodeEntry.html" title="class in org.ahmadsoft.postal">PostalCodeEntry</A> <B>getActualFor</B>(int&nbsp;postalCode)</PRE>
347<DL>
348<DD>Returns the <code>PostalCodeEntry</code> for the actual city
349 registered with the U.S. Post Office for this postal code. This 
350 is a useful operation because every postal code has an official
351 city name associated with it, as well as several other names
352 recognized by the post office as acceptable or unacceptable.
353 <p>  
354 For example, <code>getActualFor(90064)</code> will return a 
355 <code>PostalCodeEntry</code> for Los Angeles, CA, which is
356 the official city for the 90064 postal code. Rancho Park, CA
357 is an acceptable, but not the actual, name.
358<P>
359<DD><DL>
360<DT><B>Parameters:</B><DD><CODE>postalCode</CODE> - 
361<DT><B>Returns:</B><DD>the <code>PostalCodeEntry</code> for the actual city
362 registered with the U.S. Post Office for this postal code, or
363 <code>null</code> if there is no "actual" candidate for this postal code. 
364 This may occur if the postal code is not yet assigned, or is
365 out of range.</DL>
366</DD>
367</DL>
368<HR>
369
370<A NAME="match(java.lang.String, int)"><!-- --></A><H3>
371match</H3>
372<PRE>
373public java.util.List <B>match</B>(java.lang.String&nbsp;city,
374                            int&nbsp;postalCode)</PRE>
375<DL>
376<DD>Performs a match using default matching options well-suited 
377 to common validation. Specifically, ignore capitalization is
378 <code>true</code>, ignore punctuation is <code>true</code>,
379 ignore whitespace is <code>false</code>, and the minimum match
380 level is <code>PostalCodeConstants.CITY_ACCEPTABLE</code>.
381<P>
382<DD><DL>
383<DT><B>Parameters:</B><DD><CODE>city</CODE> - the city to match.<DD><CODE>postalCode</CODE> - the postal code within which to match the city.
384<DT><B>Returns:</B><DD>the closest matches to the specified city within the specified
385 postal code.<DT><B>See Also:</B><DD><A HREF="/org/ahmadsoft/postal/USPostalCodeService.html#match(java.lang.String, int, org.ahmadsoft.postal.USPostalCodeService.MatchOptions)"><CODE>match(String, int, MatchOptions)</CODE></A></DL>
386</DD>
387</DL>
388<HR>
389
390<A NAME="match(java.lang.String, int, org.ahmadsoft.postal.USPostalCodeService.MatchOptions)"><!-- --></A><H3>
391match</H3>
392<PRE>
393public java.util.List <B>match</B>(java.lang.String&nbsp;city,
394                            int&nbsp;postalCode,
395                            <A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal">USPostalCodeService.MatchOptions</A>&nbsp;options)</PRE>
396<DL>
397<DD>Returns a list of the closest matches to the specified city
398 within the specified postal code. The details of the matching
399 process can be controlled by specifying match options. 
400 <p>
401 Note: This method does not take the state into consideration. Rather,
402 use #isPostalCodeIn(int, String) to determine if a postal code
403 is within a given state.
404<P>
405<DD><DL>
406<DT><B>Parameters:</B><DD><CODE>city</CODE> - the city to match.<DD><CODE>postalCode</CODE> - the postal code within which to match the city.<DD><CODE>options</CODE> - parameters to control the matching process.
407<DT><B>Returns:</B><DD>a list of the closest matches to the specified city within
408 the specfied postal code.<DT><B>See Also:</B><DD><A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal"><CODE>USPostalCodeService.MatchOptions</CODE></A></DL>
409</DD>
410</DL>
411<!-- ========= END OF CLASS DATA ========= -->
412<HR>
413
414
415<!-- ======= START OF BOTTOM NAVBAR ====== -->
416<A NAME="navbar_bottom"><!-- --></A>
417<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
418<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
419<TR>
420<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
421<A NAME="navbar_bottom_firstrow"><!-- --></A>
422<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
423  <TR ALIGN="center" VALIGN="top">
424  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/org/ahmadsoft/postal/package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
425  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
426  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/USPostalCodeService.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
427  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
428  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
429  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
430  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="/help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
431  </TR>
432</TABLE>
433</TD>
434<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
435</EM>
436</TD>
437</TR>
438
439<TR>
440<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
441&nbsp;<A HREF="/org/ahmadsoft/postal/ReadOnceStrategy.html" title="class in org.ahmadsoft.postal"><B>PREV CLASS</B></A>&nbsp;
442&nbsp;<A HREF="/org/ahmadsoft/postal/USPostalCodeService.MatchOptions.html" title="class in org.ahmadsoft.postal"><B>NEXT CLASS</B></A></FONT></TD>
443<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
444  <A HREF="/index.html?org/ahmadsoft/postal/USPostalCodeService.html" target="_top"><B>FRAMES</B></A>  &nbsp;
445&nbsp;<A HREF="USPostalCodeService.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
446&nbsp;<SCRIPT type="text/javascript">
447  <!--
448  if(window==top) {
449    document.writeln('<A HREF="/allclasses-noframe.html"><B>All Classes</B></A>');
450  }
451  //-->
452</SCRIPT>
453<NOSCRIPT>
454  <A HREF="/allclasses-noframe.html"><B>All Classes</B></A>
455</NOSCRIPT>
456
457
458</FONT></TD>
459</TR>
460<TR>
461<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
462  SUMMARY:&nbsp;<A HREF="#nested_class_summary">NESTED</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
463<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
464DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
465</TR>
466</TABLE>
467<A NAME="skip-navbar_bottom"></A>
468<!-- ======== END OF BOTTOM NAVBAR ======= -->
469
470<HR>
471<i>Copyright &#169; 2006 Ahmadsoft. All Rights Reserved.</i>
472</BODY>
473</HTML>
474