/*
 * Copyright 2006-2007 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.batch.item.file.separator;

import java.io.BufferedReader;

/**
 * Policy for text file-based input sources to determine the end of a record, e.g. a
 * record might be a single line, or it might be multiple lines terminated by a semicolon.
 *
 * @author Dave Syer
 *
 */
public interface RecordSeparatorPolicy {

	/**
	 * Signal the end of a record based on the content of the current record. During the
	 * course of processing, each time this method returns false, the next line read is
	 * appended onto it (building the record). The input is what you would expect from
	 * {@link BufferedReader#readLine()} - i.e. no line separator character at the end.
	 * But it might have line separators embedded in it.
	 * @param record a String without a newline character at the end.
	 * @return true if this line is a complete record.
	 */
	boolean isEndOfRecord(String record);

	/**
	 * Give the policy a chance to post-process a complete record, e.g. remove a suffix.
	 * @param record the complete record.
	 * @return a modified version of the record if desired.
	 */
	String postProcess(String record);

	/**
	 * Pre-process a record before another line is appended, in the case of a multi-line
	 * record. Can be used to remove a prefix or line-continuation marker. If a record is
	 * a single line this callback is not used (but {@link #postProcess(String)} will be).
	 * @param record the current record.
	 * @return the line as it should be appended to a record.
	 */
	String preProcess(String record);

}
