[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.6

Add maven-javadoc-plugin (#54)

To generate the Javadoc run:

```
mvn clean install site
```

The javadoc will be located in `target/site/apidocs`

To be published on the website.

Co-authored-by: Tellier Benoit <btellier@linagora.com>

MIME4J-306 MimeUtil::unfold should group char appends (#52)

Calling repeatedly append requires ensuring the capacity amongst other.

Appends to the string builder can be done for all previous chars when a line delimiter is encountered, thus reducing the cost of the operation.

Gain: 66%

MIME4J-305 ContentUtil::decode can avoid using StringBuilder (#51)

StringBuilder is an expensive construct, we spend most of our time, for each character, ensuring the capacity of the string builder.

Size being known, the operation simple, we can directly operate on top of a char array.

Gains: 78%

MIME4J-304 DecoderUtil::decodeEncodedWords without REGEXP (#50)

[Documentation] Fix site.xml license

RAT plugin complains

[Documentation] Retire HUPA

[Documentation] Links should enforce HTTPS in menus

[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.5

[RELEASE] Roll out changelog

[CHANGELOG] Track changes prior 0.8.5

[EXAMPLES] RAT exceptions for newly added example resources

[EXAMPLES] Github links for examples

 - One can then easily find them without
 requiring to clone the repository
 - Mention explaining they could easily be
 launched from within an IDE
 - Also, I added the new `Parsing` example.

[EXAMPLES] Fix a typo in NAV panel

We have several examples...

[EXAMPLES] Link github and sit examples from the Mime4J index

This makes discovering the examples easier.

[EXAMPLES] Add an example for parsing messages

[EXAMPLES] Migrate away from MessageBuilder

[EXAMPLES] IterateOverMbox should be easy to launch from an IDE

We can default to a local resource if no argument is provided.

[EXAMPLES] MessageTree should be easy to launch from an IDE

We can default to a local resource if no argument is provided.

MIME-298 DateTimeFieldLenientImpl: remove unneeded option

Removing it breaks no tests, as 0000 is the
default GMT.

This prevents one defensive copy of the
parsed entity thus gets parsing slightly
faster.

MIME-303 Base64OutputStream is two time slower than its Java8 counterpart

While looking and running mime4J benchmarks, I tried some alternative implementations for Base64 encoding / decoding.

Base64InputStream proved to be 20% faster than its Java8 counterpart.

However, throughtput went from 280 MB/s to 520 MB/s by switching to Java8 Base64.getMimeEncoder().wrap(...)

Tests pass and this speeds up message writing operations... Apache James can for instance benefit of it when composing JMAP messages with large attachments.

MIME4J-298 Convert DateTimeFieldLenientImpl to DateTimeFormatter (#44)

This allows:
 - Specifying all patterns at once, avoiding one parsing pass per pattern
 - DateTimeFormatter is thread safe, thus can be initialized once and reused

Special care have been taken to preserve previous behaviour (missing tests were added):
 - Accept extra input after the date
 - Relax cross-validation

MIME4J-301 ContentTypeFieldImpl: more tests for extra semicolon in parameters

MIME4J-301 ContentTypeFieldImpl do fill a stacktrace when ended by a semicolon

While running some performance tests for the Apache James server, I noted a bunch of time spent filling some stacktraces while parsing some content types.

I noted that inputs like `Content-Type: text/plain;` was causing ContentTypeFieldImpl to fill some stacktraces while not preventing this class from doing a correct parsing.

As such, it make sense to me to consider such inputs as valid.

MIME4J-302 Use lowercase when looking up known headers

An optimization implemented in MaximalBodyDescriptor aims at reducing the costs of toLowerCase calls: upon known header names lookup the lowercase version of the field instead of the normal version to benefit optimizations (calling toLowerCase on a lowerCase string do not do allocation, it just iterates String content). It might be worth generalizing it.

MIME4J-302 Parser should avoid multiple calls to "toLowerCase"

I was surprised MIME4J parsing spends 18% of its time calling toLowerCase on header names. This represents 12% of allocated memory.

By holding the lowerCased name as part of the field name, and doing lazy initialization on it we can get this down to 6%.

MIME4J-300 Set up an automated build for Apache MIME4J

[WARNING] Remove unecessary toString calls

The StringBuilder handles the conversion
itself.

[WARNING] Group: iterations can be replaces by Collection::addAll

This is likely to be more efficient.

[WARNING] Manual calls to Math.max

Using Math.max is more explicit and thus
should be favored.

[WARNING] Unneeded array boxing

[WARNING] Remove uneeded redundant interface qualifiers

Idem, this was reported by intelliJ inspections.

[WARNING] MessageBuilder::getReadDate infinitely recurse

This was reported by intelliJ as "likely a bug".
There is no shortcut to exit this infinite recursion.

The pattern applied with MIME4J-262, that is
to call the same method on the delegate
builder is not followed.

[WARNING] Remove unused import

Run intelliJ inspection to find unused imports

Merge pull request #17 from bwndai/encodeQ

MIME4J-273 Fix encoded word splitting point for EncodeQ method as well.

Merge pull request #40 from chibenwa/MIME4J-299

MIME4J-299 Access to the Header map

fixup! MIME4J-299 Access to the Header map

[REFACTORING] Pre-compile ContentLocationFieldImpl REGEX

Using String::replaceAll leads to recompile the regex on each calls.

[REFACTORING] Pre-compile EncoderUtil::quote REGEX

Using String::replaceAll leads to recompile the regex on each calls.

[REFACTORING] AbstractHeader was calling toLowerCase twice

This generates needless object allocation and uselessly huggs CPU

[REFACTORING] AbstractEntityBuilder was colling toLowerCase twice

[WARNING] Remove redundant string operations

Run an intelliJ inspection to sole a warning

MIME4J-299 Access to the Header map

Preserving the "grouped by name" structure can ease the work of callers.

MIME4J-255 Add method to allow setting of "no recurse" mode to underlying mime token stream

MIME4J-297 0.8.4 release in the changelog

MIME4J-297 Merge the changelog and the release notes together, drop 0.9.0

MIME4J-297 Detail more the changelog pre-8.0.4 release

[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.4

MIME4J-296 Use Path instead of File in MboxIterator

JAMES-3226 Ignore Antora doc missing licenses (#36)

MIME4J-290 Fix build for recent mvn and JDK versions (#35)

* [MIME4J-290] Fix build for recent mvn and JDK versions

* Remove unneed import

MIME4J-295 Allow for overriding the specified charset when decoding q or b encoded words (#34)

* Allow for overriding the specified charset when decoding q or b encoded words.

It it very common to recieve mislabeled charsets for windows-1252, which usually end up
being ISO-8898-1. This is a minimal change allows our email servers to not have to rewrite
q-encoding, but doesn't change any default behaviors within Mime4J.

* Address review feedback

* Tighten up charset lookup method

MIME4J-233 Fix ByteBufferInputStream read implementation (#33)

* Fix ByteBufferInputStream read implementation
* Check preconditions in read
* Add license to ByteBufferInputStreamTest

JAMES-3226 #comment Added antora docs stub

MIME4J-273 Add limit and position to LimitedInputStream exception message

MIME4J-289 Upgrade maven-assembly-plugin 3.0.0 -> 3.1.1

 - Use goals `single` instead of `attached` by the recommendation at
http://maven.apache.org/plugins-archives/maven-assembly-plugin-2.5.5/attached-mojo.html

MIME4J-289 Upgrade apache parent pom version 18 -> 21

MIME4J-289 Upgrade guava 18.0 -> 28.1-jre

MIME4J-289 Upgrade slf4j-api 1.7.7 -> 1.7.28

MIME4J-289 Upgrade mockito 1.9.5 -> 3.0.0

MIME4J-289 Upgrade assertj 1.7.1 -> 3.13.2

MIME4J-289 Upgrade log4j 1.2.14 -> 1.2.17

MIME4J-289 Upgrade junit 4.10 -> 4.12

MIME4J-289 Upgrade common-logging 1.1.1 -> 1.2

MIME4J-289 Upgrade common-io 2.4 -> 2.6

MIME4J-289 Upgrade maven-jar-plugin 2.4 -> 3.1.2

MIME4J-289 Upgrade maven-bundle-plugin 2.3.7 -> 4.2.1

MIME4J-289 Upgrade maven-compiler-plugin 3.0 -> 3.8.1

MIME4J-273 Fix encoded word splitting point for EncodeQ method as well.

MIME4J-287 Use JDK 1.8

CHANGELOG for MIME4J

CHANGELOG for MIME4J

[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.3

MIME4J-283 DecoderUtil performance fix

Merge remote-tracking branch 'dmak/MIME4J-280'

MIME4J-280 Wrapping the underlying exception rather then ignoring it.

Fix failing tests.

MIME4J-279 Fixed JavaDoc errors to comply with Java8.

Add the lost self link for site of Mime4J doc

Reported and fixed by https://github.com/dongxuwang

MIME4J-263 decoding encoded words with empty encoded-text

MIME4J-270 Using "alternative" as default subtype.

Fix encoded word splitting point for EncodeQ method as well.

[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.2

MIME4J-273 Update encodeB encoding bytes splitting point.

EncoderUtil.encodeIfNecessary(<unicode string>, EncoderUtil.Usage.TEXT_TOKEN, <number less than 10>) is broken in some cases, such as : https://issues.apache.org/jira/projects/MIME4J/issues/MIME4J-250?filter=allopenissues

The culprit is line
String part1 = text.substring(0, text.length() / 2);
Since the breaking point can be in between one unicode character. Once the string is breaking into two part, part1 will have a broken tail and part2 will have a broken head in this case.

Update test for failing testEncodeEncodedWordSplitForUnicode. Changed parameter is to force word split.

MIME4J-272 Implicit DOM builder calls

MIME4J-271 Make possible to define a Content-Type parameter

MIME4J-269 Expose a convenient 100 Mo limited "permissive" mime config limit

This aims at remaining very permissive while still denying a single email to use all JVM memory.

MIME4J-268 DefaultMessageWriter should expose a convenient *asBytes* method

MIME4J-269 Introduce a Lenient default mimeConfig object

MIME4J-267 DateTimeFieldLenientImpl should support date with no timezones.

JAMES-1789 Remove mention to SVN

[maven-release-plugin] prepare for next development iteration

[maven-release-plugin] prepare release apache-mime4j-project-0.8.1

JAMES-2045 DateTimeFieldImpl should assume 19xx century when date without century >= 70

JAMES-2045 LenientDateTimeField should support partial years