BUG Oxygen 8.2 Catalog file templates create illegal file

[AndyDent]

On Windows XP, creating a catalog file with the OASIS Template gives you a file which will get an I/O error when Oxgen attempts to use it. You have to turn on verbosity for catalogs to see the error as it shows during the Catalog loading in the Catalog pane, NOT in the Error pane.

The only way I could reliably see the error occurring was to quit and relaunch Oxygen.

It has taken me HOURS (overnight with a deadline looming today) to work out this was the bug and that it wasn't anything I had typed into the file (vent, vent, rant, rant ...) and to work out how to reliably see that was the problem.

I proved it was OK by just copying the content from the main catalog.xml and pasting it into the file with a select all so it is something about the XML but I am not inclined to spend any more time digging. I thought it was the UTF-8 encoding flag but removing that didn't seem to make a difference, might be because I was tired and didn't force a refresh somehow.

[sorin_ristache]

Hello,

If I create a new XML document by going to New from Templates and selecting OASIS XML Catalog 1.0 or OASIS XML Catalog 1.1 the document is validated without error by the Validate Document action even if I do not have an Internet connection. That means the system ID of the catalog is also resolved through an XML catalog, that is the default oXygen catalog. I do not understand how you can get an I/O error when the catalog is used. What is the full error message? Can you post the complete content of the catalog file?


Regards,
Sorin

[AndyDent]

Sorry, I'm struggling with deadlines here so it will be Saturday probably before I can respond in more detail.

Briefly, the catalog gets an I/O error that is visible when you turn on the Verbose catalog option but the loading step that encounters the error doesn't seem to occur until you restart the app.

the steps are roughly something like:
1) create your catalog file with the template
2) make it a user catalog (ie: add to your list of catalogs)
3) quit
4) launch Oxygen and see the list of catalog stuff being resolved.

One of the reasons it took me a long time to work out what was going wrong is that the error is NOT reported as an error on an error tab - it appears as just another line in the Catalog list, Here's a copy of that.

Code: Select all

SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/tei/custom/schema/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/tei/schema/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/teip4/custom/schema/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/teip4/schema/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/4.3/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/4.2/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/5.0/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/svg/dtd/svgcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/jsp/xsd/jspcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml/dtd/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml11/dtd/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml11/schema/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/fo/xsd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xs3p/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xmlspec/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/dev/simonTasks/ANZLIC_1_0/trunk/resources/anzlic-tools/ANZLIC-Catalog.xml



SystemID: null

Description: Failed to load catalog, I/O error: file:/C:/dev/simonTasks/ANZLIC_1_0/trunk/resources/anzlic-tools/ANZLIC-Catalog.xml



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/xml.xsd = null



SystemID: null

Description: Resolved public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN	file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN System: http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd = file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/schematron1-5.xsd = null



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/xml.xsd = null



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/iso-schematron.xsd = null



SystemID: null

Description: Resolved public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN	file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN System: http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd = file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Resolved public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN	file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN System: http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd = file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Resolved public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN	file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN System: http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd = file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Resolved public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN	file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd



SystemID: null

Description: Public: -//OASIS//DTD Entity Resolution XML Catalog V1.0//EN System: http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd = file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog1.0.dtd

[sorin_ristache]

Code: Select all

Description: Failed to load catalog, I/O error: file:/C:/dev/simonTasks/ANZLIC_1_0/trunk/resources/anzlic-tools/ANZLIC-Catalog.xml

It seems a problem of disk access. Does the path exist on disk? Can you open ANZLIC-Catalog.xml in oXygen and validate it as an XML file?


Regards,
Sorin

[AndyDent]

Code: Select all

Description: Failed to load catalog, I/O error: file:/C:/dev/simonTasks/ANZLIC_1_0/trunk/resources/anzlic-tools/ANZLIC-Catalog.xml

It seems a problem of disk access. Does the path exist on disk? Can you open ANZLIC-Catalog.xml in oXygen and validate it as an XML file?

Yes the file exists, yes I have been editing it in oxygen and it validates - I had suspicions the problem was due to location of a path with various characters in the name (eg: underscores, or a deeper tree) so did a few variants with identical results.

I have over twenty years experience primarily as a software developer so know what it is like to be on the receiving end of insufficiently detailed bug reports but I need more sleep and unfortunately have to get certain things out the door (all being happily edited in Oxygen) before I can return to the bug in much more detail. Hopefully what I have now given you will be enough.

It does appear that there were no illegal characters in the file and, as I recall, all I did to make the I/O error go away was copy the contents of the main catalog.xml into there, replacing all the original text from the template. At that stage I still had the main catalog.xml active so saw double messages from some things. I then took out the nextCatalog elements and started putting in my rewriteURI and rewriteSystem elements as it was working.

I have replicated the following with project-based catalogs as well as the purely global settings shown in this test.

1. create a new catalog file from templates using the Oasis XML Catalog 1.1 template
2. confirm the file validates
3. save this file as c:\testTemplateCatalog.xml
4. go to options - Preferences, choose XML Catalog and add a New catalog entry (see screenshot below), browsing to the file gets an entry of file:/C:/testTemplateCatalog.xml
5. make sure verbosity is On
6. close all documents
7. choose New Project, so there won't be an existing project being opened on startup
8. quit Oxygen
9. relaunch Oxygen
10. no Catalog pane appears yet as nothing is loaded
11. open an existing document such as a .sch or .xsd file that has namespaces that need resolving with uri's that are not in the inbuilt stuff
12. observe the Catalogs pane appears and has the loading I/O error shown (see below)

Catalog pane log when opening a document with full http: namespace uri's and catalog resolution is attempted

Code: Select all

SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/tei/custom/schema/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/tei/schema/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/teip4/custom/schema/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/tei/xml/teip4/schema/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/4.3/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/4.2/dtd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/docbook/5.0/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/svg/dtd/svgcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/jsp/xsd/jspcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xml/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml/dtd/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml11/dtd/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xhtml11/schema/xhtmlcatalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/fo/xsd/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xs3p/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/frameworks/xmlspec/catalog.xml



SystemID: null

Description: Loading catalog: file:/C:/testTemplateCatalog.xml



SystemID: null

Description: Failed to load catalog, I/O error: file:/C:/testTemplateCatalog.xml



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/xml.xsd = null



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/schematron1-5.xsd = null



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/xml.xsd = null



SystemID: null

Description: Public: null System: jar:file:/C:/Program%20Files/Oxygen%20XML%20Editor%208.2/lib/oxygen.jar!/builtin/iso-schematron.xsd = null

The (generated) catalog file is at
http://www.oofile.com.au/files/misc/tes ... atalog.xml

[sorin_ristache]

Code: Select all

SystemID: null

Description: Failed to load catalog, I/O error: file:/C:/testTemplateCatalog.xml

The (generated) catalog file is at
http://www.oofile.com.au/files/misc/tes ... atalog.xml

Thank you for the catalog file and for the steps for reproducing the I/O error. We fixed the problem. The system ID of an XML Catalog 1.1, that is "http://www.oasis-open.org/committees/en ... atalog.dtd" is not resolved correctly to the internal schema which is shipped with oXygen when the catalog file is parsed. The fix will be included in the next version of oXygen.

To avoid the error please remove the DOCTYPE declaration from your XML Catalog 1.1 files which you added in Options -> Preferences -> XML -> XML Catalog. After removing the DOCTYPE declaration the catalog files will be used correctly for entity and URI resolution.


Regards,
Sorin

[Frank Ralf]

I get the same issue when creating an XML Catalog 1.1 file with oXygen 15.2 (File > New OASIS XML Catalog > XML Catalog 1.1). Xerxes throws the following error message:

Code: Select all

HttpExceptionWithDetails-404 Not Found for: http://www.oasis-open.org/committees/entity/release/1.1/catalog.dtd

The reason is that the DTD isn't available at http://www.oasis-open.org/committees/en ... atalog.dtd Has the URL changed? Which is the correct one to use for XML Catalog 1.1 files?

TIA
Frank

[adrian]

Hi,

The URL is not important, that's how it was in 2005 when the OASIS standard for XML Catalogs was approved. If it complains about the URL, it's trying to retrieve it from the web, which is the wrong thing to do.
This usually means you've disabled the default catalogs that handle OASIS XML catalogs (yes, there is an XML catalog for OASIS XML catalogs).
Check in Options > Preferences, XML > XML Catalog and make sure that the Use default catalog option is enabled. If you don't want to enable that for some reason, you should manually add to the list of catalogs the catalog for OASIS XML catalogs: Oxygen\frameworks\xml\catalog.xml

Regards,
Adrian

[Frank Ralf]

Thanks for the quick reply! I did indeed disable the default catalog while experimenting with different catalog settings. Re-activating validates the XML Catalog 1.1 file.

Frank