Dokumentation der Java Mail-API-Konfiguration für JNDI in Tomcat

Ich habe mehrere Tage damit verbracht, herauszufinden, wie man eine javax.mail.Session in Tomcat über JNDI mit Authentifizierung konfiguriert, jetzt bekomme ich es aber erst nach einem tiefen Tauchgang im Code.

In dieser Zeit habe ich den schlechtesten Code aller Zeiten gesehen: javax.mail.Service # connect (String, String, String, String) Version 1.4.1

Wann ist das Passwort vergeben? und warum wird zweimal gegen Null geprüft? - und dann erkenne, dass das else nicht zu ob ob gehört. (Dies ist die ursprüngliche Einrückung). Zurück zum Thema.

Zumindest habe ich festgestellt, dass die richtige Ressourcendefinition ist:

Achten Sie darauf, dass es "password" und "mail.smtp.user" oder "mail.user" ist, aber nicht "mail.smtp.password" oder "user".

Zumindest ist die Magie in Tomcats org.apache.naming.factory.MailSessionFactory erledigt. Diese Factory fügt der Mailsitzung javax.mail.Authenticator hinzu, wenn eine Eigenschaft password und eine Eigenschaft mail.smtp.user oder mail.user beendet wird.

Jetzt ist meine Frage, wo ist die Dokumentation für all das Zeug. Vor allem über die Konfiguration von Benutzername und Passwort?

Übrigens: Ich habe es ein bisschen detaillierter erklärt, um anderen zu helfen, wie das gleiche Problem ist.