org.tm4j.net.LocatorFactoryBase .createLocator(java.lang.String notation,java.lang.String address)

Description

Creates a new locator. In order for the locator to be created correctly, its notation and implementing class must first have been registered with the factory using #registerImplementation(String, Class). When creating a locator, this method performs the following steps:

• It invokes #getImplementation(String) to retrieve the locator implementation class associated with notation. If this fails, an exception is thrown.
• It then invokes the (LocatorFactory, String, String) constructor on the locator implementation and thereby creates a locator owned by the invoking factory, containing notation and address as its notation and address, respectively. If such a constructor cannot be found, an exception is thrown.
• Finally, it returns the created locator.

Provided subclasses properly override the abstract methods in this base class, this method frees them of having to worry about actual locator creation.

Throws

• org.tm4j.net.LocatorFactoryException - If no locator implementation class associated with notation has yet been registered, or an unexpected condition occurred during locator instantiation.

Other Resources

Related Topics