SendMail ( Frame4J -- the Java framework de.frame4j... )

java.lang.Object
- de.frame4j.util.App
- - de.frame4j.SendMail

All Implemented Interfaces:

AttrSettable, TextHelper.MessageComponents, AppMBean, ComVar, UIInfo, ActionListener, EventListener
```
@MinDoc(copyright="Copyright 2002 - 2004 , 2009  A. Weinert",
        author="Albrecht Weinert",
        version="V.44",
        lastModified="6.05.2021",
        usage="start as Java application (-? for help)",
        purpose="a tiny E-mail sender (command line controlled)")
public class SendMail
extends App
```
A tiny E-Mail sender.

This application is a tiny command line controlled SMTP-Client using the JavaMail API (javax.mail).

On a successful execution this application send a plain text e-mail (BodyPart) and / or one or more file attachments (Multipart) to one or more addressees.

By start arguments, by an extra .properties file or by an RFC822 e-mail definition file among others the following mail properties may be specified:
- To (addressee(s))
- CC and BCC (further addressee(s)
- From (sender)
- Subject
- Text (content)
The content of a text file (or URL) or the text property set by command line options may be taken as
- just the (plain text) content or
- the full RFC822 parseable mail definition.
A RFC822 mail definition file may define the content and all header fields a in the following example:
```
  From    : the cheap provider <dev.executive@sioux.tv>
  To      : the customer <dear.customer@customers-ltd.tv>
  Reply-To: call centre <pontius.pilatus@sioux.tv>
  Subject : You are disconnected after your Western Union payment
  
  This mail was only send to you to keep you calm. You should get the
  impression your error report is taken seriously and the repair is under
  way. But this is just an automated response by a clever computer
  programme.
  
  Thank you for your endless patience.
  
```
On such RFC822 mail definitions the very first empty line is the separation of the header definitions from the (optional) mail text.

Hint 1: The basic .properties file named SendMail.properties is an integral part of this application and may be considered as part of the documentation.

Hint 2: This application also has a convenience starter SendMail in the anonymous package.

Hint 3: In a RFC-822 definition one can give lists of addressees for To, CC and BCC. The list separator has to be (best) 1 comma (,) + + 1 line + 1 space.

Hint 4: The separating line between header definitions and text body has to be absolutely empty (otherwise "miracles" occur). This missing robustness bug is RFC 822 taken to SUN's Java mail API. (to do in a later version: parse here robustly.)

Hint 5: On your server the default settings can (should) be overridden by placing a file SendMail.properties in jdk\jre\lib defining (at least) the following properties according to your environment:
```
 #  Property-File for SendMail.java  (jdk\jre\lib\SendMail.properties)
 #  V1.0  (So, 04.04.2010, 21:57 MEZ)
 #  for location / server: @ home 
 #  A. Weinert changes for 1&1
 #
 mail.from= no.reply@frame4j.de
 mail.smtp.host = smtp.1und1.de
 userName= ano.reply@frame4j.de
 # use the next line if you like it here more than in the command line
 # userPass=monRepos
 proxySet = false
 mail.smtp.auth = true
 # if behind a proxy say:
 # proxySet   = true
 # proxyHost  = myCompany'sProxy
 # proxyPort  = 8080
```
© Copyright 2002 - 2003, 2006 Albrecht Weinert
See Also:

InternetAddress, MimeMessage

Nested Class Summary
- Nested classes/interfaces inherited from interface de.frame4j.util.ComVar
  ComVar.Impl

Field Summary

Fields
Modifier and Type	Field and Description
`String`	`attach` First attachment file.
`String`	`bcc` The secret copy recipient(s) (may be a list).
`String`	`cc` The copy recipient(s) (may be a list).
`String`	`contFile` The content file.
`String`	`contFileEncoding` File encoding for content file.
`int`	`contLogLength` Log length of content.
`boolean`	`parse` The file is not only the content.
`String`	`proxyHost` The proxy server's name.
`String`	`proxyPort` The proxy server's port.
`boolean`	`proxySet` Use a proxy server connecting to mail host.
`String`	`subject` The subject.
`String`	`text` The content.
`String`	`timeFormat` Format for time stamp.
`boolean`	`timeStamp` Set actual time stamp.
`String`	`to` The recipient(s) (may be a list).
`String`	`userName`
`String`	`userPass`

Fields inherited from class de.frame4j.util.App
ano, appBase, appIO, appStartTime, appStartTimeMS, args, argsOrig, bgColor, err, fullClassName, help, icon, log, mainThread, myClass, myFrame, name, out, outMode, packName, prop, retCode, runFlag, shortClassName, title, verbose, verbosity

Fields inherited from interface de.frame4j.util.ComVar
AUTHOR, BLANK_STRING, cons, CONSOL_ENCODING, COPYRIGHT, D, D_NaN, D_NegInf, D_PosInf, EMPTY_INT_A, EMPTY_STRING, FILE_ENCODING, FRW_CLLD, FS, FSS, H, hasCons, HOST_IP, HOST_IPv4, HOST_NAME, INIT_ERROR, JAR_ENCODING, JH, JOB_DONE_OK, JRL, LOG_OUT_ERROR, M, MAIN_THREAD_EXC, NO_BYTES, NO_CLASSES, NO_DOUBLES, NO_OBJECTS, NO_PARS_ERROR, NO_STRINGS, NOT_WINDOWS, ON_PI, ONE_DAY, ONE_HOUR, ONE_LEAP_YEAR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, ONE_YEAR, OS, PROG_NAME, PROG_SHORT, PS, RUNTIME, S, SHY, UD, UL, UL_UR_da, UR

Fields inherited from interface de.frame4j.net.AttrSettable
ILLEGAL_TYPE, ILLEGAL_VALUE, NO_ATTRIBUTE, NO_KNOWN_ATTRIBUTE, NO_VALUE, OK, retVtext

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`doIt()` Working method of SendMail.
`static void`	`main(String[] args)` Start method of SendMail.

Methods inherited from class de.frame4j.util.App
actionPerformed, allowNoPropertiesFile, clientOrder, condHelpLog, connect, errMeld, errMeld, errorExit, errorExit, errorText, extraPropertiesFile, formMessage, formMessage, formMessage, getAbout, getAboutText, getActTime, getAppLogger, getAppStartTime, getArgs, getAuthor, getCopyright, getDbLogger, getExecTimeMs, getExecTimeMsL, getExecTimeString, getHelp, getHelpText, getIcon, getLanguage, getLogHandler, getMessageComponent, getMessageComponentsLength, getMyFrame, getName, getNameWithVersDate, getOutMode, getProp, getPurpose, getStartTime, getStateString, getTheCloser, getTitle, getUsage, getVerbose, getVerbosity, getVersDate, go, go, go, haveIcon, isDebug, isHelp, isHelpLog, isNormal, isRunFlag, isSilent, isTest, isVerbose, logVerbose, logVerbose, makeStatusTextEnd, makeStatusTextStart, messageFormat, normalExit, parsePartial, performeAction, queueAction, regAsStdMBean, repExc, setAboutText, setAttribute, setAttribute, setAuthor, setBgColor, setCodePages, setCopyright, setHelp, setLogOut2, setName, setOutMode, setOutMode, setPurpose, setTitle, setUsage, setVerbose, setVerbose, setVerbosity, setVerbosity, setVersDate, stop, threeLineEndMsg, toString, twoLineEndMsg, twoLineStartMsg, valueLang, valueLang, wakeMainThread

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.frame4j.net.AttrSettable
retVtext

- Field Detail
  - contLogLength
```
public int contLogLength
```
    Log length of content.
    
    If App.verbose is true the mail content will be logged, but truncated in the log output after a maximum of contLogLength characters. The truncation does not happen if contLogLength is <= 42. If the mail text is truncated in the log, that will be signalled by dots ( ....).
    
    default: see SendMail.properties.
  - to
```
public String to
```
    The recipient(s) (may be a list).
    
    This denotes the mail's recipient. It may be a comma-separated list of more than one recipient. If used together with a RFC822 parsed file this properties specifies additional recipient(s). Additional means that in case of parseed RFC 822 definition file contFile that will be added to the addressees defined in the parsed file.
    
    default: see SendMail.properties.
  - cc
```
public String cc
```
    The copy recipient(s) (may be a list).
    
    This denotes the mail's copy recipient. The same conditions as for the to property apply.
    
    default: null
  - bcc
```
public String bcc
```
    The secret copy recipient(s) (may be a list).
    
    This denotes the mail's secret or blind copy recipient. The same conditions as for the to property apply.
    
    default: null
  - subject
```
public String subject
```
    The subject.
    
    For the mail's subject (header) field.
    
    default: seeSendMail.properties.
  - timeStamp
```
public boolean timeStamp
```
    Set actual time stamp.
    
    If true the mails's date (header) field will be set by the actual time.
    
    default: false
    
    See Also:
    
    TimeHelper.formatRFC(java.time.ZonedDateTime), TimeHelper.formatGMT(java.time.ZonedDateTime)
  - timeFormat
```
public String timeFormat
```
    Format for time stamp.
    
    If timeStamp is true, this format will be used for the mails's date (header) field.
    
    default: "r" (meaning ugly rfc822 standard)
  - text
```
public String text
```
    The content.
    
    The (normal) text content of the mail (if any).
    Will be set by start argument, .properties file or by a file (contFile) read.
  - contFile
```
public String contFile
```
    The content file.
    
    If contFile is not empty, it is tried to read the mail's text content directly from there respectively to parse the whole RFC822 mail definition from it.
    contFile may denote a file or an URL.
    
    default: null
  - parse
```
public boolean parse
```
    The file is not only the content.
    
    If parse is true the file or URL denoted by contFile will not be taken for content only, but parsed as whole RFC 822 mail definition.
    
    default: false (set by options)
  - contFileEncoding
```
public String contFileEncoding
```
    File encoding for content file.
    
    If contFile is not empty, it is tried to read the mail's text content directly from there respectively to parse the whole RFC822 mail definition from it.
    In that case contFileEncoding will be used for that file or URL.
    
    default: null, meaning the platform's encoding (mostly 8859-1 on European Windows)
  - attach
```
public String attach
```
    First attachment file.
    
    If attach is nor empty it is tried to add the file denoted by it as a true attachment to the mail.
    
    In case of success a property attach2, attach3 and so on is looked for and treated in the same way.
    
    default: null
  - userName
```
public String userName
```
  - userPass
```
public String userPass
```
  - proxySet
```
public boolean proxySet
```
    Use a proxy server connecting to mail host.
    
    If true a proxy will be used to connect to the mail server and the properties proxyHost and proxyHost are in effect.
    
    default: false
  - proxyHost
```
public String proxyHost
```
    The proxy server's name.
    
    default: "cache"
    
    See Also:
    
    proxySet
  - proxyPort
```
public String proxyPort
```
    The proxy server's port.
    
    default: 8080
    
    See Also:
    
    proxySet
- Method Detail
  - main
```
public static void main(String[] args)
```
    Start method of SendMail.
    
    Execution is: Java SendMail [options] [contFile] | [-help]
    
    Parameters:
    
    args - command line parameter
    
    See Also:
    
    doIt(), App.go(String[])
  - doIt
```
public int doIt()
```
    Working method of SendMail.
    
    Specified by:
    
    doIt in class App
    
    Returns:
    
    the exit code; 0 means OK
    
    See Also:
    
    main(Strin[]), App.go(String[])

Class SendMail

Nested Class Summary

Nested classes/interfaces inherited from interface de.frame4j.util.ComVar

Field Summary

Fields inherited from class de.frame4j.util.App

Fields inherited from interface de.frame4j.util.ComVar

Fields inherited from interface de.frame4j.net.AttrSettable

Method Summary

Methods inherited from class de.frame4j.util.App

Methods inherited from class java.lang.Object

Methods inherited from interface de.frame4j.net.AttrSettable

Field Detail

contLogLength

to

cc

bcc

subject

timeStamp

timeFormat

text

contFile

parse

contFileEncoding

attach

userName

userPass

proxySet

proxyHost

proxyPort

Method Detail

main

doIt