Difference between revisions of "Using the XML Catalog"

From Eclipsepedia

Jump to: navigation, search
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
The eclipes WTP project provides support for using an XML Catalog based on the [http://www.oasis-open.org/committees/entity/spec.html OASIS XML Catalog specification]. An XML Catalog allows a user to control how resources references are resolved. So for example if a user has one or more XML documents that reference a DTD or XML Schema via a web address (e.g. http://www.example.org/foo.xsd) they may want to map this address to their own local copy of this resource.  This way 'catalog aware' tools won't need to go off to the internet to fetch the resource.  There's several other ways an XML Catalog can be used as defined by the [http://www.oasis-open.org/committees/entity/spec.html OASIS XML Catalog specification]. If you're an eclipse plugin developer there's also some convenient extension points you can utilize to contribute to the XML Catalog settings.
+
The eclipes WTP project provides support for using an XML Catalog based on the [http://www.oasis-open.org/committees/entity/spec.html OASIS XML Catalog specification]. An XML Catalog provides a user with some limited control over how references to other resources handled. So for example if a user has one or more XML documents that reference a DTD or XML Schema via a web address (e.g. http://www.example.org/foo.xsd) they can use the XML Catalog to map this address to their own local copy of this resource.  This way 'catalog aware' tools won't need to go off to the internet to fetch the resource.  There's several other ways an XML Catalog can be used as defined by the [http://www.oasis-open.org/committees/entity/spec.html OASIS XML Catalog specification]. If you're an eclipse plugin developer there's also some convenient extension points you can utilize to contribute to the XML Catalog settings.
  
 
<h3>Editing the XML Catalog Settings</h3>
 
<h3>Editing the XML Catalog Settings</h3>
Line 12: Line 12:
 
<h3>Registering DTDs</h3>
 
<h3>Registering DTDs</h3>
 
TODO..
 
TODO..
 +
by Public ID
 +
by System ID
  
 
<h3>Registering XML Schemas</h3>
 
<h3>Registering XML Schemas</h3>
 
TODO..
 
TODO..
 +
by Namespace Name
 +
by Schema Location
  
 
<h3>FAQ</h3>
 
<h3>FAQ</h3>
 
TODO...
 
TODO...
 +
<ol>
 +
<li>I've registered a DTD with a 'System ID' key of 'foo.dtd' and it doesn't work.  Why not?
 +
</li>
 +
<li>I've registered an XML Schema with a 'Schema Location' key of 'foo.dtd' and it doesn't work.  Why not?
 +
</li>
 +
<li>I've registered my DTD or XML Schema but eclipse is still going off to the internet to fetch a resource. Why?
 +
</li>
 +
<li>I've registered a XML Schema by namespace but XML files are still using the 'xsi:schemaLocation' value.  Why?
 +
</li>
 +
</ol>
  
 
<h4>Some links to other XML Catalog related resources</h4>
 
<h4>Some links to other XML Catalog related resources</h4>

Revision as of 01:52, 23 June 2006

The eclipes WTP project provides support for using an XML Catalog based on the OASIS XML Catalog specification. An XML Catalog provides a user with some limited control over how references to other resources handled. So for example if a user has one or more XML documents that reference a DTD or XML Schema via a web address (e.g. http://www.example.org/foo.xsd) they can use the XML Catalog to map this address to their own local copy of this resource. This way 'catalog aware' tools won't need to go off to the internet to fetch the resource. There's several other ways an XML Catalog can be used as defined by the OASIS XML Catalog specification. If you're an eclipse plugin developer there's also some convenient extension points you can utilize to contribute to the XML Catalog settings.

Editing the XML Catalog Settings

TODO...

The XML Catalog can be accessed through the preferences as follows...
1. Select “Window -> Preferences” to launch the Preferences dialog.
2. Expand the “Web and XML” heading and select “XML Catalog”.

Registering DTDs

TODO.. by Public ID by System ID

Registering XML Schemas

TODO.. by Namespace Name by Schema Location

FAQ

TODO...

  1. I've registered a DTD with a 'System ID' key of 'foo.dtd' and it doesn't work. Why not?
  2. I've registered an XML Schema with a 'Schema Location' key of 'foo.dtd' and it doesn't work. Why not?
  3. I've registered my DTD or XML Schema but eclipse is still going off to the internet to fetch a resource. Why?
  4. I've registered a XML Schema by namespace but XML files are still using the 'xsi:schemaLocation' value. Why?

Some links to other XML Catalog related resources

OASIS XML Catalog specification
OASIS XML Catalog V1.1 specification
XML Catalog Tutorial