/****************************************************************
* Licensed to the Apache Software Foundation (ASF) under one *
* or more contributor license agreements. See the NOTICE file *
* distributed with this work for additional information *
* regarding copyright ownership. The ASF licenses this file *
* to you 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 org.apache.james.mime4j.parser;
import org.apache.james.mime4j.MimeException;
/**
* MIME entity configuration
*/
public final class MimeEntityConfig implements Cloneable {
private boolean maximalBodyDescriptor;
private boolean strictParsing;
private int maxLineLen;
private int maxHeaderCount;
private long maxContentLen;
private boolean countLineNumbers;
public MimeEntityConfig() {
this.maximalBodyDescriptor = false;
this.strictParsing = false;
//this.maxLineLen = 2048;
// Juanjo: disabling the max length
this.maxLineLen = -1;
this.maxHeaderCount = 2048;
this.maxContentLen = -1;
this.countLineNumbers = false;
}
public boolean isMaximalBodyDescriptor() {
return this.maximalBodyDescriptor;
}
public void setMaximalBodyDescriptor(boolean maximalBodyDescriptor) {
this.maximalBodyDescriptor = maximalBodyDescriptor;
}
/**
* Defines whether minor violations of the MIME specification should be
* tolerated or should result in a {@link MimeException}. If this parameter
* is set to <code>true</code>, a strict interpretation of the MIME
* specification will be enforced, If this parameter is set to <code>false</code>
* minor violations will result in a warning in the log.
*
* @param strictParsing value of the strict parsing mode
*/
public void setStrictParsing(boolean strictParsing) {
this.strictParsing = strictParsing;
}
/**
* Returns the value of the strict parsing mode
* @see #setStrictParsing(boolean)
*
* @return value of the strict parsing mode
*/
public boolean isStrictParsing() {
return this.strictParsing;
}
/**
* Sets the maximum line length limit. Parsing of a MIME entity will be terminated
* with a {@link MimeException} if a line is encountered that exceeds the maximum
* length limit. If this parameter is set to a non positive value the line length
* check will be disabled.
*
* @param maxLineLen maximum line length limit
*/
public void setMaxLineLen(int maxLineLen) {
this.maxLineLen = maxLineLen;
}
/**
* Returns the maximum line length limit
* @see #setMaxLineLen(int)
*
* @return value of the the maximum line length limit
*/
public int getMaxLineLen() {
return this.maxLineLen;
}
/**
* Sets the maximum header limit. Parsing of a MIME entity will be terminated
* with a {@link MimeException} if the number of headers exceeds the maximum
* limit. If this parameter is set to a non positive value the header limit check
* will be disabled.
*
* @param maxHeaderCount maximum header limit
*/
public void setMaxHeaderCount(int maxHeaderCount) {
this.maxHeaderCount = maxHeaderCount;
}
/**
* Returns the maximum header limit
* @see #setMaxHeaderCount(int)
*
* @return value of the the maximum header limit
*/
public int getMaxHeaderCount() {
return this.maxHeaderCount;
}
/**
* Sets the maximum content length limit. Parsing of a MIME entity will be terminated
* with a {@link MimeException} if a content body exceeds the maximum length limit.
* If this parameter is set to a non positive value the content length
* check will be disabled.
*
* @param maxContentLen maximum content length limit
*/
public void setMaxContentLen(long maxContentLen) {
this.maxContentLen = maxContentLen;
}
/**
* Returns the maximum content length limit
* @see #setMaxContentLen(long)
*
* @return value of the the maximum content length limit
*/
public long getMaxContentLen() {
return maxContentLen;
}
/**
* Defines whether the parser should count line numbers. If enabled line
* numbers are included in the debug output.
*
* @param countLineNumbers
* value of the line number counting mode.
*/
public void setCountLineNumbers(boolean countLineNumbers) {
this.countLineNumbers = countLineNumbers;
}
/**
* Returns the value of the line number counting mode.
*
* @return value of the line number counting mode.
*/
public boolean isCountLineNumbers() {
return countLineNumbers;
}
@Override
public MimeEntityConfig clone() {
try {
return (MimeEntityConfig) super.clone();
} catch (CloneNotSupportedException e) {
// this shouldn't happen, since we are Cloneable
throw new InternalError();
}
}
@Override
public String toString() {
return "[max body descriptor: " + maximalBodyDescriptor
+ ", strict parsing: " + strictParsing + ", max line length: "
+ maxLineLen + ", max header count: " + maxHeaderCount
+ ", max content length: " + maxContentLen
+ ", count line numbers: " + countLineNumbers + "]";
}
}