Demo
Demo

Knowledge base

PMTA knowledge base›Mechanism§ 7.3

Java submission API

Java Submission API
The second of five

The Java submission binding is the second of five in the chapter: pmta.jar is added to the classpath, and for working through JavaMail the supplied javamail.providers file is installed.

The description is in JavaDoc format: on Linux — /opt/pmta/api/java/doc/javadoc/index.html, on Windows — the pmtajavadoc.zip archive in the api\java folder. Java 6 or later is required, and for JavaMail also the JavaMail and Java Activation Framework libraries.

The JavaMail provider is the main convenience: an application written for JavaMail can submit through the node without being rewritten for the binding’s own interface.

The main trap is looking for method descriptions in the manual. The chapter only gives the path to JavaDoc: methods and their behavior are described there, not in the section.
What the Hub does. Not used: the Hub submits messages to the node over SMTP.
Recommended values

What is where:

What Where
library pmta.jar in the classpath
working through JavaMail the javamail.providers file
description on Linux /opt/pmta/api/java/doc/javadoc/index.html
description on Windows pmtajavadoc.zip in api\java
version Java 6 and later
The library, the JavaMail provider, the description locations and the Java version come from the manual (§ 7.3, § 7.1). The table is ours.
Example configuration
# add the binding library when starting the application
java -cp pmta.jar:app.jar com.example.Sender
pmta.jar is taken from the installation’s bindings directory; the application names are for illustration.
yellow — — directive names, blue — blocks. They are highlighted the same way in the text of the card.
Compatibility
PowerMTA 6.0
described in the manual of this version · platform: any
The vendor does not state the first version for every directive — there is no note here. The name also appears in the 5.0 edition of the manual.
⇄

Related entries

1 relation

Where you can see it

What the submitting system assembles before sendingThe same setting at another level. § 7.3

How to check on the node
Check that the binding description is in place:
ls /opt/pmta/api/java/doc/javadoc/index.html
The description file exists — the Java binding is installed.
◇

What else to read

3 articles

◇How a message gets into the engineSix described submission methods: extended SMTP, four language bindings and a directory the node watches on disk.◇Who is allowed to submit mail and for whom to accept itOut of the box, the node accepts submission only from the machine itself; two different questions — “who can send through us” and “for whose addresses we accept mail” — are answered by different directives.◇Headers the sender uses to control deliverySix control headers let the submitting side choose a stream, tag a message with a job, set signing options and the key, the envelope identifier and the schedule; each is allowed separately and per source.

In the Hub
Cost of a mistake
safe: a wrong value breaks nothing
Scenarios
Connect a sending platform