01: /*
02: * $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/httpcore/tags/4.0-beta1/module-main/src/main/java/org/apache/http/TokenIterator.java $
03: * $Revision: 601000 $
04: * $Date: 2007-12-04 18:03:49 +0100 (Tue, 04 Dec 2007) $
05: *
06: * ====================================================================
07: * Licensed to the Apache Software Foundation (ASF) under one
08: * or more contributor license agreements. See the NOTICE file
09: * distributed with this work for additional information
10: * regarding copyright ownership. The ASF licenses this file
11: * to you under the Apache License, Version 2.0 (the
12: * "License"); you may not use this file except in compliance
13: * with the License. You may obtain a copy of the License at
14: *
15: * http://www.apache.org/licenses/LICENSE-2.0
16: *
17: * Unless required by applicable law or agreed to in writing,
18: * software distributed under the License is distributed on an
19: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
20: * KIND, either express or implied. See the License for the
21: * specific language governing permissions and limitations
22: * under the License.
23: * ====================================================================
24: *
25: * This software consists of voluntary contributions made by many
26: * individuals on behalf of the Apache Software Foundation. For more
27: * information on the Apache Software Foundation, please see
28: * <http://www.apache.org/>.
29: *
30: */
31:
32: package org.apache.http;
33:
34: import java.util.Iterator;
35:
36: /**
37: * An iterator for {@link String} tokens.
38: * This interface is designed as a complement to
39: * {@link HeaderElementIterator}, in cases where the items
40: * are plain strings rather than full header elements.
41: *
42: * @version $Revision: 601000 $
43: */
44: public interface TokenIterator extends Iterator {
45:
46: /**
47: * Indicates whether there is another token in this iteration.
48: *
49: * @return <code>true</code> if there is another token,
50: * <code>false</code> otherwise
51: */
52: boolean hasNext();
53:
54: /**
55: * Obtains the next token from this iteration.
56: * This method should only be called while {@link #hasNext hasNext}
57: * is true.
58: *
59: * @return the next token in this iteration
60: */
61: String nextToken();
62: }
|