Class Q2

java.lang.Object

org.jpos.q2.Q2

All Implemented Interfaces:

FileFilter, Runnable

public class Q2
extends Object
implements FileFilter, Runnable

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Q2.QEntry

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_DEPLOY_DIR
static final String	DUPLICATE_EXTENSION
static final String	ENV_EXTENSION
static final String	ERROR_EXTENSION
static final String	JMX_NAME
static final String	LICENSEE
static final String	LOGGER_CONFIG
static final String	LOGGER_NAME
static final String	PROTECTED_QBEAN
static final byte[]	PUBKEYHASH
static final String	Q2_CLASS_LOADER
static final String	QBEAN_NAME
static final String	REALM
static final int	SCAN_INTERVAL
static final long	SHUTDOWN_TIMEOUT

Constructor Summary

Constructors

Constructor	Description
Q2()	Constructs a new Q2 instance with no command-line arguments and the default class loader.
Q2(String deployDir)	Constructs a new Q2 instance with the specified deployment directory and the default class loader.
Q2(String[] args)	Constructs a new Q2 instance with the specified command-line arguments and the default class loader.
Q2(String[] args, ClassLoader classLoader)	Constructs a new Q2 instance with the specified command-line arguments and class loader.

Method Summary

Modifier and Type	Method	Description
boolean	accept(File f)
protected org.jdom2.Document	decrypt(org.jdom2.Document doc)
void	deployElement(org.jdom2.Element e, String fileName, boolean encrypt, boolean isTransient)
void	deployTemplate(String template, String filename, String prefix)
void	displayVersion()
protected org.jdom2.Document	encrypt(org.jdom2.Document doc)
String[]	environmentArgs(String[] args)
static String	getAppVersionString()
static String	getBranch()
static String	getBuildTimestamp()
String[]	getCommandLineArgs()
File	getDeployDir()
QFactory	getFactory()
UUID	getInstanceId()
protected byte[]	getKey()
QClassLoader	getLoader()
Log	getLog()
MBeanServer	getMBeanServer()
io.micrometer.core.instrument.MeterRegistry	getMeterRegistry()
io.micrometer.prometheusmetrics.PrometheusMeterRegistry	getPrometheusMeterRegistry()
static Q2	getQ2()
static Q2	getQ2(long timeout)
static String	getRelease()
static String	getRevision()
Duration	getUptime()
static String	getVersion()
static String	getVersionString()
String	getWatchServiceClassname()
boolean	isDisableDynamicClassloader()
static void	main(String[] args)
static int	node()
boolean	ready()
boolean	ready(long millis)
void	relax()
void	relax(long sleep)
void	run()
boolean	running()
void	shutdown()
void	shutdown(boolean join)
void	start()
void	stop()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_DEPLOY_DIR

public static final String DEFAULT_DEPLOY_DIR

See Also:

• Constant Field Values

JMX_NAME

public static final String JMX_NAME

See Also:

• Constant Field Values

LOGGER_NAME

public static final String LOGGER_NAME

See Also:

• Constant Field Values

REALM

public static final String REALM

See Also:

• Constant Field Values

LOGGER_CONFIG

public static final String LOGGER_CONFIG

See Also:

• Constant Field Values

QBEAN_NAME

public static final String QBEAN_NAME

See Also:

• Constant Field Values

Q2_CLASS_LOADER

public static final String Q2_CLASS_LOADER

See Also:

• Constant Field Values

DUPLICATE_EXTENSION

public static final String DUPLICATE_EXTENSION

See Also:

• Constant Field Values

ERROR_EXTENSION

public static final String ERROR_EXTENSION

See Also:

• Constant Field Values

ENV_EXTENSION

public static final String ENV_EXTENSION

See Also:

• Constant Field Values

LICENSEE

public static final String LICENSEE

See Also:

• Constant Field Values

PUBKEYHASH

public static final byte[] PUBKEYHASH

PROTECTED_QBEAN

public static final String PROTECTED_QBEAN

See Also:

• Constant Field Values

SCAN_INTERVAL

public static final int SCAN_INTERVAL

See Also:

• Constant Field Values

SHUTDOWN_TIMEOUT

public static final long SHUTDOWN_TIMEOUT

See Also:

• Constant Field Values

Constructor Details

Q2

public Q2(String[] args,
 ClassLoader classLoader)

Constructs a new Q2 instance with the specified command-line arguments and class loader. This constructor initializes various configurations, processes command-line arguments, sets up directories, and registers necessary components for the application.

Parameters:

args - an array of String containing the command-line arguments.

classLoader - the ClassLoader to be used by the application. If null, the class loader of the current class is used.

Key Initialization Steps:

• Parses the command-line arguments twice: once before environment variable substitution and once after.
• Initializes the deployment directory and library directory (`lib`).
• Generates a unique instance identifier for the application instance.
• Sets the application start time to the current moment.
• Registers MicroMeter metrics and Q2-specific components.

Note: The deployDir directory is created if it does not already exist.

See Also:

• parseCmdLine(String[], boolean)
• registerMicroMeter()
• registerQ2()

Q2

public Q2(String[] args)

Constructs a new Q2 instance with the specified command-line arguments and the default class loader.

Parameters:

args - an array of String containing the command-line arguments. If no arguments are provided, the application initializes with default settings.

This constructor delegates to Q2(String[], ClassLoader) with a null class loader, causing the default class loader to be used.

See Also:

• Q2(String[], ClassLoader)

Q2

public Q2()

Constructs a new Q2 instance with no command-line arguments and the default class loader.

This constructor is equivalent to calling Q2(new String[]{}). It initializes the application with default settings.

See Also:

• Q2(String[], ClassLoader)
• Q2(String[])

Q2

public Q2(String deployDir)

Constructs a new Q2 instance with the specified deployment directory and the default class loader.

Parameters:

deployDir - a String specifying the path to the deployment directory. This is passed as a command-line argument using the -d option.

This constructor is equivalent to calling Q2(new String[]{"-d", deployDir}). It sets the deployment directory and initializes the application.

See Also:

• Q2(String[], ClassLoader)
• Q2(String[])

Method Details

start

public void start()

stop

public void stop()

getMeterRegistry

public io.micrometer.core.instrument.MeterRegistry getMeterRegistry()

getPrometheusMeterRegistry

public io.micrometer.prometheusmetrics.PrometheusMeterRegistry getPrometheusMeterRegistry()

run

public void run()

Specified by:

run in interface Runnable

shutdown

public void shutdown()

running

public boolean running()

ready

public boolean ready()

ready

public boolean ready(long millis)

shutdown

public void shutdown(boolean join)

getLoader

public QClassLoader getLoader()

getFactory

public QFactory getFactory()

getCommandLineArgs

public String[] getCommandLineArgs()

accept

public boolean accept(File f)

Specified by:

accept in interface FileFilter

getDeployDir

public File getDeployDir()

getWatchServiceClassname

public String getWatchServiceClassname()

getQ2

public static Q2 getQ2()

getQ2

public static Q2 getQ2(long timeout)

node

public static int node()

relax

public void relax(long sleep)

relax

public void relax()

getLog

public Log getLog()

getMBeanServer

public MBeanServer getMBeanServer()

getUptime

public Duration getUptime()

displayVersion

public void displayVersion()

getInstanceId

public UUID getInstanceId()

getVersionString

public static String getVersionString()

deployElement

public void deployElement(org.jdom2.Element e,
 String fileName,
 boolean encrypt,
 boolean isTransient)
                   throws ISOException,
IOException,
GeneralSecurityException

Throws:

ISOException

IOException

GeneralSecurityException

getKey

protected byte[] getKey()

encrypt

protected org.jdom2.Document encrypt(org.jdom2.Document doc)
                              throws GeneralSecurityException,
IOException

Throws:

GeneralSecurityException

IOException

decrypt

protected org.jdom2.Document decrypt(org.jdom2.Document doc)
                              throws GeneralSecurityException,
IOException,
org.jdom2.JDOMException

Throws:

GeneralSecurityException

IOException

org.jdom2.JDOMException

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception

getVersion

public static String getVersion()

getRevision

public static String getRevision()

getBranch

public static String getBranch()

getBuildTimestamp

public static String getBuildTimestamp()

getRelease

public static String getRelease()

getAppVersionString

public static String getAppVersionString()

isDisableDynamicClassloader

public boolean isDisableDynamicClassloader()

deployTemplate

public void deployTemplate(String template,
 String filename,
 String prefix)
                    throws IOException,
org.jdom2.JDOMException,
GeneralSecurityException,
ISOException,
NullPointerException

Throws:

IOException

org.jdom2.JDOMException

GeneralSecurityException

ISOException

NullPointerException

environmentArgs

public String[] environmentArgs(String[] args)