Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Create an XML registry

The XML Registry is a facility for configuring and administering the XML resources of WebLogic Server. XML resources include the default parser and transformer factories and external entity resolution. In particular, you use the XML registry to specify:

- An alternative server-wide XML parser, used by default when parsing XML documents, instead of the parser that is installed by default. You do this by specifying the names of the classes that implement the `javax.xml.parsers.DocumentBuilderFactory` and `javax.xml.parsers.SaxParserFactory` interfaces; these implementing classes are used to parse XML in DOM and SAX mode, respectively.
- A specific XML parser that should be used to parse a particular document type.
- An alternative server-wide transformer instead of the default transformer. You do this by specifying the name of the class that implements the `javax.xml.transform.TransformerFactory` interface, used to transform XML documents.
- External entities that are to be resolved by using local copies of the entities. Once you specify these entities, the Administration Server stores local copies of them in the file system and automatically distributes them to the server’s parser at parse time. This feature eliminates the need to construct and set SAX EntityResolvers.
- External entities to be cached by WebLogic Server after retrieval from the Web. You specify how long these external entities should be cached before WebLogic Server re-retrieves them and when WebLogic should first retrieve the entities, either at application run time or when WebLogic Server starts.

You can create as many XML Registries as you like; however, you can associate only one XML registry with a particular instance of WebLogic Server.

If an instance of WebLogic Server does not have an XML registry associated with it, then the default parser and transformer are used when parsing or transforming documents.

Note: The default parser and transformer are those included in the JDK Version 5.0.

Once you associate an XML registry with an instance of WebLogic Server, all its configuration options are available for XML applications that use that server.

To create a new XML registry and associate it with a WebLogic Server instance:

1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
2. In the left pane, expand Services and seclect XML Registries.
3. On the Summary of XML Registries page, click New.
4. On the Create a New XML Registries page, enter a unique XML registry name in the Name field.
5. Enter the fully qualified name of the class that implements the `javax.xml.parsers.DocumentBuilderFactory` interface in the Document Builder Factory field.
6. Enter the fully qualified name of the class that implements the `javax.xml.parsers.SaxParserFactory` interface in the SAX Parser Factory field.
7. Enter the fully qualified name of the class that implements the `javax.xml.transform.TransformerFactory` interface in the Transformer Factory field.
8. Click Next.
9. Select the WebLogic Server instance(s) to which you want to deploy this XML registry.
10. Click Finish.
11. Optionally, configure additional properties of the XML registry:
    1. In the table of XML Registries, click on the name of the registry you just created.
    2. Associate a parser to a document type.
    3. Configure external entity resolution.
12. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).