Javadoc
Starts a Locator running on the specified port and bind address, as determined by getPort and
getBindAddress respectively, defaulting to 10334 and 'localhost' if not specified, with both
peer and server location enabled.
'start' is an asynchronous invocation of the Locator. As such, this method makes no guarantees
whether the Locator's location services (peer and server) are actually running before it
returns. The Locator's location-based services are initiated in separate, daemon Threads and
depends on the relative timing and scheduling of those Threads by the JVM. If the application
using this API wishes for the Locator to continue running after normal application processing
completes, then one must call waitOnLocator
.
Given the nature of start, the Locator's status will be in either 1 of 2 possible states. If
the 'request' to start the Locator proceeds without exception, the status will be 'STARTED'.
However, if any exception is encountered during the normal startup sequence, then a
RuntimeException is thrown and the status is set to 'STOPPED'.