Rewrote Messages

[grobmeier]

Messages

[vy]

@grobmeier, I once started rewriting this, and back then drafted the following intro:

Although Log4j provides `Logger` methods that accept a formatting pattern of type `String` and its parameters of type `Object`, all of these are ultimately captured in link:../javadoc/log4j-api/org/apache/logging/log4j/message/Message.html[`Message`] objects that are attached to the generated log event:

[source,java]
----
LOGGER.info("Everything is awesome!");
LOGGER.info("Party time for `{}`", userName);
----

is analogous to

[source,java]
----
LOGGER.info(new SimpleMessage("Everything is awesome!"));
LOGGER.info(new ParameterizedMessage("Party time for `{}`", new Object[]{userId}));
----

Here I like the way readers are demonstrated with how LOGGER.foo(bar) under-the-hood translates to LOGGER.foo(new Message(bar)). Maybe you can use this. 👼

Caution: "is analogous to" phrase is important here, since it is not "identical to"! That is, we actually use reusable messages under-the-hood, but this detail is irrelevant in this context.

[vy]

As agreed with @grobmeier, merging this to wrap up the work on API docs.