stream.runtime

Class ProcessContainer

java.lang.Object

stream.runtime.ProcessContainer

All Implemented Interfaces:

Runnable, IContainer

public class ProcessContainer
extends Object
implements IContainer, Runnable

A process-container is a collection of processes that run independently. Each process is a self-contained thread that is reading from a data-stream (or queue). The process-container is responsible for instantiating the processor elements, grouping them into processes (threads) and creating the data-streams defined in the corresponding XML configuration. Upon startup, the process-container will start all processes (threads) and wait until all of them have finished.

Author:

Christian Bockermann <christian.bockermann@udo.edu>

Field Summary

Fields

Modifier and Type	Field and Description
(package private) static Map<String,ElementHandler>	autoHandlers
(package private) static List<ProcessContainer>	container
protected Variables	containerVariables
protected ContainerContext	context The global container context
protected DependencyInjection	dependencyInjection The dependency-injection management, required for gathering dependencies while the compute graph is being built up.
protected ComputeGraph	depGraph The final compute graph that will be build...
protected List<DocumentHandler>	documentHandler
protected Map<String,ElementHandler>	elementHandler
(package private) static String[]	extensions
private Exception	failFastReason
protected List<LifeCycle>	lifeCyleObjects
protected Map<String,Queue>	listeners The list of data-stream-queues, that can be fed from external instances
(package private) static org.slf4j.Logger	log
protected String	name The name of this container, used in lookup URIs (e.g.
protected NamingService	namingService
protected ObjectFactory	objectFactory
protected Map<Process,ProcessContext>	processContexts
protected List<Process>	processes The list of processes running in this container
protected ProcessorFactory	processorFactory
protected long	runtime
(package private) boolean	server
protected List<ServiceReference>	serviceRefs
protected Map<String,Sink>	sinks The set of sinks
protected Long	startTime
protected Map<String,Source>	streams The set of data streams (sources)
(package private) Supervisor	supervisor
protected List<ProcessThread>	worker

Constructor Summary

Constructors

Constructor and Description
ProcessContainer(Document doc, Map<String,ElementHandler> customElementHandler, Map<String,String> variables)
ProcessContainer(URL url) This constructor creates a new process-container instance by parsing an XML document located at the specified URL.
ProcessContainer(URL url, Map<String,ElementHandler> customElementHandler)
ProcessContainer(URL url, Map<String,ElementHandler> customElementHandler, Map<String,String> vars)

Method Summary

Modifier and Type	Method and Description
ComputeGraph	computeGraph()
void	dataArrived(String key, Data item)
private void	drawGraph()
long	execute()
ContainerContext	getContext()
String	getName()
NamingService	getNamingService()
ObjectFactory	getObjectFactory()
List<Process>	getProcesses()
List<ServiceReference>	getServiceRefs()
Set<String>	getStreamListenerNames()
Set<Source>	getStreams()
Variables	getVariables()
private void	init(Document doc)
List<LifeCycle>	lifeCycles()
static Document	parseDocument(URL url)
void	register(LifeCycle lc)
void	registerQueue(String id, Queue queue, boolean externalListener)
void	registerSink(String id, Sink sink)
void	registerStream(String id, Source stream)
void	run()
void	setName(String name)
void	setProcessContext(Process process, ProcessContext ctx)
void	shutdown()

Methods inherited from class java.lang.Object

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

Field Detail

log

static org.slf4j.Logger log

container

static final List<ProcessContainer> container

objectFactory

protected final ObjectFactory objectFactory

processorFactory

protected final ProcessorFactory processorFactory

depGraph

protected final ComputeGraph depGraph

The final compute graph that will be build...

dependencyInjection

protected final DependencyInjection dependencyInjection

The dependency-injection management, required for gathering dependencies while the compute graph is being built up.

name

protected String name

The name of this container, used in lookup URIs (e.g. //container-name/serice-name )

context

protected final ContainerContext context

The global container context

streams

protected final Map<String,Source> streams

The set of data streams (sources)

sinks

protected final Map<String,Sink> sinks

The set of sinks

listeners

protected final Map<String,Queue> listeners

The list of data-stream-queues, that can be fed from external instances

processes

protected final List<Process> processes

The list of processes running in this container

processContexts

protected final Map<Process,ProcessContext> processContexts

worker

protected final List<ProcessThread> worker

serviceRefs

protected final List<ServiceReference> serviceRefs

elementHandler

protected final Map<String,ElementHandler> elementHandler

documentHandler

protected final List<DocumentHandler> documentHandler

namingService

protected NamingService namingService

lifeCyleObjects

protected final List<LifeCycle> lifeCyleObjects

server

boolean server

runtime

protected long runtime

startTime

protected Long startTime

containerVariables

protected Variables containerVariables

failFastReason

private Exception failFastReason

extensions

static final String[] extensions

autoHandlers

static final Map<String,ElementHandler> autoHandlers

supervisor

Supervisor supervisor

Constructor Detail

ProcessContainer

public ProcessContainer(URL url)
                 throws Exception

This constructor creates a new process-container instance by parsing an XML document located at the specified URL.

Parameters:

url -

Throws:

Exception

ProcessContainer

public ProcessContainer(URL url,
                        Map<String,ElementHandler> customElementHandler)
                 throws Exception

Throws:

Exception

ProcessContainer

public ProcessContainer(URL url,
                        Map<String,ElementHandler> customElementHandler,
                        Map<String,String> vars)
                 throws Exception

Throws:

Exception

ProcessContainer

public ProcessContainer(Document doc,
                        Map<String,ElementHandler> customElementHandler,
                        Map<String,String> variables)
                 throws Exception

Throws:

Exception

Method Detail

parseDocument

public static Document parseDocument(URL url)
                              throws Exception

Throws:

Exception

computeGraph

public ComputeGraph computeGraph()

Specified by:

computeGraph in interface IContainer

See Also:

IContainer

getStreams

public Set<Source> getStreams()

Specified by:

getStreams in interface IContainer

See Also:

IContainer

getName

public String getName()

Specified by:

getName in interface IContainer

See Also:

IContainer

setName

public void setName(String name)

Parameters:

name - the name to set

lifeCycles

public List<LifeCycle> lifeCycles()

getContext

public ContainerContext getContext()

Specified by:

getContext in interface IContainer

getProcesses

public List<Process> getProcesses()

Specified by:

getProcesses in interface IContainer

getServiceRefs

public List<ServiceReference> getServiceRefs()

Specified by:

getServiceRefs in interface IContainer

register

public void register(LifeCycle lc)

init

private void init(Document doc)
           throws Exception

Throws:

Exception

drawGraph

private void drawGraph()

registerQueue

public void registerQueue(String id,
                          Queue queue,
                          boolean externalListener)
                   throws Exception

Throws:

Exception

registerSink

public void registerSink(String id,
                         Sink sink)

registerStream

public void registerStream(String id,
                           Source stream)

run

public void run()

Specified by:

run in interface Runnable

execute

public long execute()
             throws Exception

Throws:

Exception

getVariables

public Variables getVariables()

Specified by:

getVariables in interface IContainer

See Also:

IContainer

getStreamListenerNames

public Set<String> getStreamListenerNames()

getObjectFactory

public ObjectFactory getObjectFactory()

dataArrived

public void dataArrived(String key,
                        Data item)

shutdown

public void shutdown()

setProcessContext

public void setProcessContext(Process process,
                              ProcessContext ctx)

Parameters:

process -

ctx -

getNamingService

public NamingService getNamingService()

Specified by:

getNamingService in interface IContainer