1bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor/* 21d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Copyright (C) 2009 The Guava Authors 3bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 4bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * Licensed under the Apache License, Version 2.0 (the "License"); 5bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * you may not use this file except in compliance with the License. 6bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * You may obtain a copy of the License at 7bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 8bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * http://www.apache.org/licenses/LICENSE-2.0 9bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 10bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * Unless required by applicable law or agreed to in writing, software 11bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * distributed under the License is distributed on an "AS IS" BASIS, 12bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * See the License for the specific language governing permissions and 14bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * limitations under the License. 15bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor */ 16bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor 17bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnorpackage com.google.common.io; 18bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor 191d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.annotations.Beta; 201d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 21bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnorimport java.io.IOException; 22bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor 23bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor/** 24bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * A callback to be used with the streaming {@code readLines} methods. 25bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 26bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * <p>{@link #processLine} will be called for each line that is read, and 27bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * should return {@code false} when you want to stop processing. 28bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 29bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * @author Miles Barr 301d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @since 1.0 31bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor */ 321d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert@Beta 33bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnorpublic interface LineProcessor<T> { 34bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor 35bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor /** 36bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * This method will be called once for each line. 37bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * 38bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * @param line the line read from the input, without delimiter 39bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor * @return true to continue processing, false to stop 40bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor */ 41bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor boolean processLine(String line) throws IOException; 42bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor 43bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor /** Return the result of processing all the lines. */ 44bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor T getResult(); 45bfe2dd089341dcb4c1fb65a5b6b077ad0ebbf6dcDan Egnor} 46