oracle.ide.xml

Class XMLRecognizer

java.lang.Object

oracle.ide.model.Recognizer

oracle.ide.xml.XMLRecognizer

public final class XMLRecognizer
extends Recognizer

The XMLRecognizer is the default Recognizer implementation used in the IDE. It contains support for recognizing an XML document through a variety of mechanisms.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XMLRecognizer.Attribute Represents one attribute name/value pair used in the Attributes class.
static class	XMLRecognizer.Attributes When Node types are recognized based on root element name and namespace, they can additionally be recognized based on root element attribute name/value pairs, either an and'ed list of attribute name/value pairs (all name/value pairs have to be present for the Node to be recognized), or an or'ed list (at least one of the name/value pairs has to be present for the Node to be recognized).
static class	XMLRecognizer.Doctype Two Doctype instances are considered equal if their public IDs match, regardless of what the system IDs are.
static class	XMLRecognizer.NoNamespaceRule
static class	XMLRecognizer.NSElem

Nested classes/interfaces inherited from class oracle.ide.model.Recognizer

Recognizer.DeclarativeDocumentInfo

Method Summary

Modifier and Type	Method and Description
Node	create(java.net.URL url, java.lang.Class nodeType) This method creates a Node instance of the specified type with the specified URL.
static NodeInfo	findNodeInfo(java.lang.Class dataClass) This method finds a NodeInfo instance that is associated with a particular data Class.
static XMLRecognizer	getInstance()
static void	mapDoctypeToClass(java.lang.String publicId, java.lang.String systemId, java.lang.Class cls) Maps the specified public ID and system ID (from the XML doctype) to the specified data class.
static void	mapNamespaceElemAttributesToClass(java.lang.String namespaceURI, java.lang.String localElemName, XMLRecognizer.Attributes attributes, java.lang.Class cls) Maps the specified root namespace element (a combination of the XML namespace URI with local element name) and Attributes to the specified data class.
static void	mapNamespaceElemToClass(java.lang.String namespaceURI, java.lang.String localElemName, java.lang.Class cls) Maps the specified namespace element (a combination of the XML namespace URI with local element name) to the specified data class.
static void	mapRootElementToClass(java.lang.String rootElem, java.lang.Class cls) Maps the specified file extension to the specified data class.
static void	mapSchemaInstanceToClass(java.lang.String schemaLocationURI, java.lang.String rootElemLocalName, java.lang.Class nodeType) Maps the specified schema location URI and root element's local name to the specified data class.
MetaClass	recognizeAsMeta(java.net.URL url) This method allows gets the MetaClass of a recognized Node.
static void	registerNodeInfo(NodeInfo info) Uses the specified NodeInfo to register recognizer behavior.
static void	treatExtensionAsXML(java.lang.String extension) Registers the specified extension as one that corresponds to an XML file.
static void	treatExtensionAsXML(java.lang.String extension, NodeInfoLoader loader) Registers the specified extension as one that corresponds to an XML file.
java.net.URL	validate(java.net.URL newURL, java.net.URL oldURL) Validate the specified new name.

Methods inherited from class oracle.ide.model.Recognizer

canConvert, findRecognizer, getClassForExtension, getContentTypeForExtension, getDeclarativeExtensionToClassMap, getDeclarativeExtensionToContentTypeMap, getDefaultNodeType, getDefaultNodeTypeAsMeta, getDefaultRecognizer, getDocumentInfo, getDocumentInfo, getDocumentInfoForDeclarativeEntries, getExtensionToClassMap, getExtensionToContentTypeMap, getExtensionToMetaClassMap, getLogger, isXmlExtension, mapExtensionToClass, mapExtensionToContentType, mapExtensionToMetaClass, mapExtensionToXML, recognize, recognizeURL, recognizeURL, recognizeURLAsMeta, recognizeURLAsMeta, registerConversion, registerDocumentInfo, registerLowPriorityRecognizer, registerRecognizer, registerRecognizer, sanitizeExtension, setDefaultRecognizer

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static XMLRecognizer getInstance()

treatExtensionAsXML

public static void treatExtensionAsXML(java.lang.String extension)

Registers the specified extension as one that corresponds to an XML file. The XMLRecognizer only attempts to find a data class for an XML file if the URL for the file has an extension that is treated as XML.

The extension passed in is allowed to contain or omit the leading "."; if it is omitted, it will be added automatically.

treatExtensionAsXML

public static void treatExtensionAsXML(java.lang.String extension,
                                       NodeInfoLoader loader)

Registers the specified extension as one that corresponds to an XML file. The NodeInfoLoader will be used to trigger the lazy loading of NodeInfo objects if an URL with the specified extension is recognized by XMLRecognizer.

The loader can be null, which means that there is no NodeInfoLoader that needs to be invoked for the specified extension.

mapNamespaceElemToClass

public static void mapNamespaceElemToClass(java.lang.String namespaceURI,
                                           java.lang.String localElemName,
                                           java.lang.Class cls)

Maps the specified namespace element (a combination of the XML namespace URI with local element name) to the specified data class. This is the preferred recognition mechanism for objects that are marshalled by Object2Dom.

mapNamespaceElemAttributesToClass

public static void mapNamespaceElemAttributesToClass(java.lang.String namespaceURI,
                                                     java.lang.String localElemName,
                                                     XMLRecognizer.Attributes attributes,
                                                     java.lang.Class cls)

Maps the specified root namespace element (a combination of the XML namespace URI with local element name) and Attributes to the specified data class.

Parameters:

namespaceURI - The namespace of the root element

localElemName - The name of the root element

attributes - The attributes to match in the root element

cls - The Node type to recognize

mapSchemaInstanceToClass

public static void mapSchemaInstanceToClass(java.lang.String schemaLocationURI,
                                            java.lang.String rootElemLocalName,
                                            java.lang.Class nodeType)

Maps the specified schema location URI and root element's local name to the specified data class. If the root element has a namespace, then the XMLRecognizer will search for a schema location URI associated with that namespace. Otherwise, the XMLRecognizer will look for an xsi:noNamespaceSchemaLocation attribute on the root element that identifies the schema location.

mapDoctypeToClass

public static void mapDoctypeToClass(java.lang.String publicId,
                                     java.lang.String systemId,
                                     java.lang.Class cls)

Maps the specified public ID and system ID (from the XML doctype) to the specified data class. One of public ID or system ID must be non-null; if both IDs are null, this method has no effect.

mapRootElementToClass

public static void mapRootElementToClass(java.lang.String rootElem,
                                         java.lang.Class cls)

Maps the specified file extension to the specified data class.

The specified extension is allowed to contain or omit the leading "."; if omitted, it will be added automatically.

registerNodeInfo

public static void registerNodeInfo(NodeInfo info)

Uses the specified NodeInfo to register recognizer behavior.

See Also:

NodeInfo

findNodeInfo

public static NodeInfo findNodeInfo(java.lang.Class dataClass)

This method finds a NodeInfo instance that is associated with a particular data Class.

Parameters:

dataClass - The data Class.

Returns:

the NodeInfo associated with the data class or null if no NodeInfo is found.

recognizeAsMeta

public MetaClass recognizeAsMeta(java.net.URL url)

Description copied from class: Recognizer

This method allows gets the MetaClass of a recognized Node. This is useful for cases in which the classloader of a metaclass is not the same as the real classloader of the node class. It may also be useful, for cases when we need to get the MetaClass of a recognized node without initializing the node extensions.

Overrides:

recognizeAsMeta in class Recognizer

Parameters:

url - unique URL identifying the document.

Returns:

the Node type as a MetaClass object.

create

public Node create(java.net.URL url,
                   java.lang.Class nodeType)
            throws java.lang.IllegalAccessException,
                   java.lang.InstantiationException

Description copied from class: Recognizer

This method creates a Node instance of the specified type with the specified URL. If the type is null, then the returned Node is also null.

Overrides:

create in class Recognizer

Parameters:

url - unique URL identifying the document.

nodeType - the type of the Node. The specified Class object must represent a type of Node, or else a ClassCastException will occur.

Returns:

The design-time Node.

Throws:

java.lang.IllegalAccessException

java.lang.InstantiationException

validate

public java.net.URL validate(java.net.URL newURL,
                             java.net.URL oldURL)
                      throws RecognizerException

Description copied from class: Recognizer

Validate the specified new name. Returns null if the name does not validate. This method may modify the URL to make it valid, such as adding a file extension. The old URL is used as the validation base. For example, if the new URL does not have the correct file extension, the old URL extension may be added to the new URL during the validation process.

Overrides:

validate in class Recognizer

Parameters:

newURL - the new URL to validate.

oldURL - the old URL used as the validation base.

Returns:

the validated URL or null if the name does not validate.

Throws:

RecognizerException - if validation fails. The reason why validation failed is in the exception's message. The message should be suitably formatted so that it can be displayed to the user.