[MIME4J-272] Ease builder uses by implicitly calling build when possible.

• Type: Improvement
• Status: Reopened
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: 0.8.2
• Component/s: dom
• Assignee: Unassigned
• Reporter: Benoit Tellier
• Created: 09/Apr/18 02:51
• Updated: 16/Apr/21 03:13

Description

While using mime4J DOM builders, we often ends up using builders to build a builder argument.

However, the caller needs to convert the builder into the wanted object calling the build method. This conversion can be a bit boiler plate. Thus Mime4J should offer an opportunity to implicitly call "build" in non ambiguoud situations.

Example:

Message message = Message.Builder.of()
            .setBody(MultipartBuilder.create("report")
                .addBodyPart(BodyPartBuilder.create()
                    .setBody(SingleBodyBuilder.create()
                        .setText("first")
                        .buildText())
                    .build())
                .addBodyPart(mdn)
                .build())
            .build();

Would become:

Message message = Message.Builder.of()
            .setBody(MultipartBuilder.create("report")
                .addBodyPart(BodyPartBuilder.create()
                    .setBody(SingleBodyBuilder.create()
                        .setText("first")
                        .buildText()))
                .addBodyPart(mdn))
            .build();