Package org.pipservices3.container

Class ProcessContainer

java.lang.Object

org.pipservices3.container.Container

org.pipservices3.container.ProcessContainer

All Implemented Interfaces:

org.pipservices3.commons.config.IConfigurable, org.pipservices3.commons.refer.IReferenceable, org.pipservices3.commons.refer.IUnreferenceable, org.pipservices3.commons.run.IClosable, org.pipservices3.commons.run.IOpenable

public class ProcessContainer
extends Container

Inversion of control (IoC) container that runs as a system process. It processes command line arguments and handles unhandled exceptions and Ctrl-C signal to gracefully shutdown the container.

### Command line arguments ###

• --config / -c path to JSON or YAML file with container configuration (default: "./config/config.yml")
• --param / --params / -p value(s) to parameterize the container configuration
• --help / -h prints the container usage help

### Example ###

 
 ProcessContainer container = new ProcessContainer();
 container.addFactory(new MyComponentFactory());

 container.run(process.getArgs());
 
 

See Also:

• Container

Field Summary

Fields

Modifier and Type	Field	Description
protected String	_configPath

Fields inherited from class org.pipservices3.container.Container

_config, _factories, _info, _logger, _references

Constructor Summary

Constructors

Constructor	Description
ProcessContainer(String name, String description)	Creates a new instance of the container.

Method Summary

Modifier and Type	Method	Description
void	run(String[] args)	Runs the container by instantiating and running components inside the container.

Methods inherited from class org.pipservices3.container.Container

addFactory, close, configure, getConfig, getReferences, isOpen, open, readConfigFromFile, setConfig, setReferences, unsetReferences

Methods inherited from class java.lang.Object

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

Field Details

_configPath

protected String _configPath

Constructor Details

ProcessContainer

public ProcessContainer(String name,
 String description)

Creates a new instance of the container.

Parameters:

name - (optional) a container name (accessible via ContextInfo)

description - (optional) a container description (accessible via ContextInfo)

Method Details

run

public void run(String[] args)
         throws Exception

Runs the container by instantiating and running components inside the container.

It reads the container configuration, creates, configures, references and opens components. On process exit it closes, unreferences and destroys components to gracefully shutdown.

Parameters:

args - command line arguments

Throws:

Exception - when error occured.