type

AbstractMain

src abstract class AbstractMain : Obj

AbstractMain provides conveniences for writing the main routine of an app. Command line arguments are configured as fields with the Arg facet:

@Arg { help = "source file to process" }
File? src

Arguments are ordered by the field declaration order. The last argument may be declared as a list to handle a variable numbers of arguments.

Command line options are configured as fields with the Opt facet :

@Opt { help = "http port"; aliases=["p"] }
Int port := 8080

Bool fields should always default to false and are considered flag options. All other arg and opt fields must be a Str, File, or have a type which supports a fromStr method.

Option fields may include the "Opt" suffix, and arguments the "Arg" suffix. These suffixes can be used when a field conflicts with an existing slot name.

AbstractMain will automatically implement usage and parseArgs based on the fields which are declared as options and arguments. In general subclasses only need to override run. If writing a daemon main, then you'll probably want to configure your services then call runServices.

See example.

fields

helpOpt	Print usage help.

methods

appName	Get the application name.
argFields	Get all the fields annotated with the `@Arg` facet.
homeDir	Home directory for the application.
log	Log for this application; defaults to `appName`.
main	Main performs the following tasks
optFields	Get all the fields annotated with the `@Opt` facet.
parseArgs	Parse the command line and set this instances fields.
run	Run the application.
runServices	Run the set of services
usage	Print usage of arguments and options.

Slot Details

appName

src virtual Str appName()

Get the application name. If this is a script it is the name of the script file. For a precompiled class called "Main" this is the pod name, otherwise it is the type name.

argFields

src virtual Field[] argFields()

Get all the fields annotated with the @Arg facet.

helpOpt

src @Opt { help="Print usage help"; aliases=["?"] } Bool helpOpt := false

Print usage help.

homeDir

src virtual File homeDir()

Home directory for the application. For a script this defaults to directory of the script. For pods the default is "{Env.cur.workDir}/etc/{pod}".

log

src virtual Log log()

Log for this application; defaults to appName.

main

src virtual Int main(Str[] args := Env.cur().args())

Main performs the following tasks:

Calls parseArgs to parse command line
If args were incomplete or -help was specified then dump usage and return 1
Call run and return 0
If an exception is raised log it and return 1

optFields

src virtual Field[] optFields()

Get all the fields annotated with the @Opt facet.

parseArgs

src virtual Bool parseArgs(Str[] toks)

Parse the command line and set this instances fields. Return false if not all of the arguments were passed.

run

src abstract Int run()

Run the application. This method is called after the command line has been parsed. See runServices to launch a deamon application. Return status code, zero for success.

runServices

src virtual Int runServices(Service[] services)

Run the set of services:

call install on each service
call start on each service
put main thread to sleep.
on shutodwn call stop on each service
then call uninstall on each service

usage

src virtual Int usage(OutStream out := Env.cur().out())

Print usage of arguments and options. Return non-zero.