org.apache.river.api.util

Interface Startable

All Known Implementing Classes:

SynchronousExecutors

public interface Startable

Implemented by an object to enable starting threads, perform remote export or any other activity after construction is complete, required to put the object into an operational state.

All services in River now implement Startable to avoid exporting a service during construction, for JMM compliance.

see org.apache.river.start.ServiceDescriptor
see org.apache.river.start.ActivateWrapper
see org.apache.river.start.group.SharedGroupImpl
see org.apache.river.start.NonActivatableServiceDescriptor
see net.jini.export.Exporter

Since:

3.0.0

Method Summary

Modifier and Type	Method and Description
void	start() Called after construction, this method enables objects to delay starting threads or exporting until after construction is complete, to allow safe publication of the service in accordance with the JMM.

Method Detail

start

void start()
    throws Exception

Called after construction, this method enables objects to delay starting threads or exporting until after construction is complete, to allow safe publication of the service in accordance with the JMM.

In addition to starting threads after construction, it also allows objects to avoid throwing an exception during construction to avoid finalizer attacks.

The implementation is required to ensure start() is idempotent (only executed once, additional invocations must return immediately).

Throws:

Exception - if there's a problem with construction or startup.