com.google.code.mojo.license.header.HeaderParser Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of maven-license-plugin Show documentation
Show all versions of maven-license-plugin Show documentation
Maven 2 plugin to check and update license headers in source files
/**
* Copyright (C) 2008 http://code.google.com/p/maven-license-plugin/
*
* 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
*
* http://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 com.google.code.mojo.license.header;
import com.google.code.mojo.license.util.FileContent;
import com.google.code.mojo.license.util.StringUtils;
/**
* The HeaderParser class is used to get header information about the current header defined in the given
* file.
The achieve this it will use the HeaderDefinition associated to the type of the given file.
*
* Important: is considered a license header a header which contains the word copyright (case insensitive)
* within a section of the file which match the given HeaderDefinition associated to this
* HeaderParser.
*
* @author Mathieu Carbou ([email protected])
* @see com.google.code.mojo.license.header.HeaderDefinition
*/
public final class HeaderParser {
private final int beginPosition;
private final int endPosition;
private final boolean existingHeader;
private final FileContent fileContent;
private final String[] keywords;
private HeaderDefinition headerDefinition;
private String line;
/**
* Creates a HeaderParser object linked to the given file content and the associated header definition
* based on the file type.
*
* @param fileContent The file content.
* @param headerDefinition The associated header definition to use.
* @throws IllegalArgumentException If the file content is null or if the header definition is null.
*/
public HeaderParser(FileContent fileContent, HeaderDefinition headerDefinition, String[] keywords) {
if (fileContent == null) {
throw new IllegalArgumentException("Cannot create a header parser for null file content");
}
if (headerDefinition == null) {
throw new IllegalArgumentException("Cannot work on file header if the header definition is null");
}
this.keywords = keywords.clone();
this.headerDefinition = headerDefinition;
this.fileContent = fileContent;
beginPosition = findBeginPosition();
existingHeader = hasHeader();
endPosition = existingHeader ? findEndPosition() : -1;
}
/**
* Returns the index position in the content where the header effectively starts.
*
* @return The index in the content.
*/
public int getBeginPosition() {
return beginPosition;
}
/**
* Returns the index position in the content where the header effectively ends.
*
* @return The index in the content.
*/
public int getEndPosition() {
return endPosition;
}
/**
* Tells if the given file already contains a license header.
*
* @return true if a license header has been detect or false.
*/
public boolean gotAnyHeader() {
return existingHeader;
}
/**
* Returns the file content.
*
* @return The content.
*/
public FileContent getFileContent() {
return fileContent;
}
/**
* Returns the header definition associated to this header parser (itself bounded to a file).
*
* @return The associated header definition.
*/
public HeaderDefinition getHeaderDefinition() {
return headerDefinition;
}
private int findBeginPosition() {
int beginPos = 0;
line = fileContent.nextLine();
if (headerDefinition.getSkipLinePattern() == null)
return beginPos;
while (line != null && !headerDefinition.isSkipLine(line))
line = fileContent.nextLine();
if (line == null) fileContent.reset();
beginPos = line == null ? 0 : fileContent.getPosition();
line = fileContent.nextLine();
return beginPos;
}
private boolean hasHeader() {
// skip blank lines
while (line != null && "".equals(line.trim()))
line = fileContent.nextLine();
// check if there is already a header
boolean gotHeader = false;
if (headerDefinition.isFirstHeaderLine(line)) {
// skip blank lines before header text
if (headerDefinition.allowBlankLines())
do line = fileContent.nextLine();
while (line != null && "".equals(line.trim()));
StringBuilder inPlaceHeader = new StringBuilder();
String before = StringUtils.rtrim(headerDefinition.getBeforeEachLine());
if ("".equals(before) && !headerDefinition.isMultiLine())
before = headerDefinition.getBeforeEachLine();
boolean foundEnd = false;
do {
inPlaceHeader.append(line.toLowerCase());
line = fileContent.nextLine();
if (headerDefinition.isMultiLine() && headerDefinition.isLastHeaderLine(line)) {
foundEnd = true;
break;
}
}
while (line != null && line.startsWith(before));
// skip blank lines after header text
if (headerDefinition.allowBlankLines())
do line = fileContent.nextLine();
while (line != null && "".equals(line.trim()));
if (headerDefinition.allowBlankLines() || !foundEnd)
fileContent.rewind();
if (!headerDefinition.isMultiLine()) {
// keep track of the position for headers where the end line is the same as the before each line
int pos = fileContent.getPosition();
// check if the line is the end line
while (line != null
&& !headerDefinition.isLastHeaderLine(line)
&& (headerDefinition.allowBlankLines() || !"".equals(line.trim())))
line = fileContent.nextLine();
if (line == null)
fileContent.resetTo(pos);
}
gotHeader = true;
for (String keyword : keywords) {
if (inPlaceHeader.indexOf(keyword.toLowerCase()) == -1) {
gotHeader = false;
break;
}
}
}
return gotHeader;
}
private int findEndPosition() {
// we check if there is a header, if the next line is the blank line of the header
int end = fileContent.getPosition();
line = fileContent.nextLine();
if (line != null && "".equals(line.trim()))
end = fileContent.getPosition();
return end;
}
}