oracle.ide.model

Class ElementFactory

java.lang.Object

oracle.ide.model.ElementFactory

public final class ElementFactory
extends java.lang.Object

The ElementFactory class is responsible for creating intances of Elements.

The type of Element that gets created depends on the object identifier that is passed into the findOrCreate(URL, Project). The ElementFactory makes use of registered ElementRecognizer instances to determine what Element class corresponds to a particular URL.

Element instances created by the ElementFactory are generally not cached. It is up to a ElementRecognizer to determine if the instances it creates should be cached or not.

See Also:

Element, ElementRecognizer

Constructor Summary

Constructors

Constructor and Description
ElementFactory()

Method Summary

Modifier and Type	Method and Description
static void	addRecognizer(ElementRecognizer recognizer) Registers a ElementRecognizer, appending it to the end of the list of recognizers.
static Element	findOrCreate(java.net.URL url, Project project) Returns an Element associated with the identifier. This method requests the ElementRecognizer that recoginizes the element identifier to create or find the associated element instance.
static void	removeRecognizer(ElementRecognizer recognizer) Unregisters a ElementRecognizer.

Methods inherited from class java.lang.Object

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

Constructor Detail

ElementFactory

public ElementFactory()

Method Detail

findOrCreate

public static Element findOrCreate(java.net.URL url,
                                   Project project)
                            throws java.lang.IllegalAccessException,
                                   java.lang.InstantiationException

Returns an Element associated with the identifier. This method requests the ElementRecognizer that recoginizes the element identifier to create or find the associated element instance. It is left to the recognizer to decide whether created elements should be cached. A recognizer that does not cache newly created elements may return a new element instance every time this method is called.

Parameters:

url - unique url identifier.

project - the project within which the element should be created.

Returns:

an element. May be null.

Throws:

java.lang.IllegalAccessException - if the Element class or its initializer is not accessible.

java.lang.InstantiationException - if the Element class is an abstract class, an interface, an array class, a primitive type, or void; or if the instantiation fails for some other reason.

addRecognizer

public static void addRecognizer(ElementRecognizer recognizer)

Registers a ElementRecognizer, appending it to the end of the list of recognizers.

Parameters:

recognizer - instance of a ElementRecognizer implementation.

removeRecognizer

public static void removeRecognizer(ElementRecognizer recognizer)

Unregisters a ElementRecognizer.

Parameters:

recognizer - instance of a ElementRecognizer implemenation.