You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xerces.apache.org by an...@locus.apache.org on 2000/09/15 23:57:25 UTC
cvs commit: xml-xerces/java/design/xsl design.xsl schedule.xsl
andyc 00/09/15 14:57:24
Modified: java/design Tag: xerces_j_2 architecture.html crimson.html
design.html index.html schedule.html xerces.html
Added: java/design/css Tag: xerces_j_2 design.css index.css
site.css
java/design/src Tag: xerces_j_2
DesignDoc$IndentingWriter.class DesignDoc.class
DesignDoc.java Stylesheet.class Stylesheet.java
java/design/xml Tag: xerces_j_2 design.dtd design.xml
schedule.dtd schedule.xml
java/design/xsl Tag: xerces_j_2 design.xsl schedule.xsl
Removed: java/design Tag: xerces_j_2 DesignDoc$IndentingWriter.class
DesignDoc.class DesignDoc.java Stylesheet.class
Stylesheet.java design.css design.dtd design.xml
index.css schedule.dtd schedule.xml schedule.xsl
Log:
1) Since the documentation was starting to build up, I
re-organized the tree by moving things into separate
directories. (Hopefully I didn't break any links
doing so).
2) Also incorporated comments from the mailing list into
the architecture overview.
a) Ed Staub commented that XInclude operates on the
XML Infoset. So I changed the text to read that an
XInclude filter can be inserted either before *or
after* the validator and added a lengthy note
regarding the problem of working on an Infoset.
This will be part of an open issues document to be
added soon.
b) Ed also wanted a clarification on the parser being
both the manager and a component. Added some text
to the Configuration section regarding this point.
I still have a lot of comments from Ted Leung to address.
Revision Changes Path
No revision
No revision
1.1.2.3 +43 -7 xml-xerces/java/design/Attic/architecture.html
Index: architecture.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/architecture.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- architecture.html 2000/09/14 23:01:58 1.1.2.2
+++ architecture.html 2000/09/15 21:56:49 1.1.2.3
@@ -1,8 +1,8 @@
-<!-- $Id: architecture.html,v 1.1.2.2 2000/09/14 23:01:58 andyc Exp $ -->
+<!-- $Id: architecture.html,v 1.1.2.3 2000/09/15 21:56:49 andyc Exp $ -->
<html>
<head>
<title>Xerces 2 | Architecture</title>
- <link rel='stylesheet' type='text/css' href='site.css'>
+ <link rel='stylesheet' type='text/css' href='css/site.css'>
<style type='text/css'>
.diagram { color: black; background: white;
font-weight: normal;
@@ -103,9 +103,8 @@
This architecture can also be used to implement upcoming
standards like <a href='http://www.w3.org/TR/xinclude'>XInclude</a>.
A new XInclude filter can be written that includes document
- fragments into the pipeline stream before the validator. In this
- way, the document inclusion would be expanded without the validator
- ever knowing that there was an inclusion.
+ fragments into the pipeline stream before or after the validator.
+ <sup><a href='#note.2'>[2]</a></sup>
</p>
<p>
Parsing of DTDs can also be viewed as a pipeline. Since the
@@ -154,7 +153,8 @@
transmits settings to each component, and controls their actions.
The configuration is managed by the parser object and the values are
communicated to the components. The following diagram shows a
- general parser configuration and its components.
+ general parser configuration and its components. (No ordering or
+ direct connection between components should be implied.)
</p>
<p>
<table border='2' cellspacing='0' cellpadding='7'>
@@ -179,6 +179,17 @@
</tr>
</table>
</p>
+ <p>
+ In the parser configuration, the parser object acts both as the
+ configuration manager and as a component in the pipeline.
+ The parser object does <strong>not</strong> have to be the final
+ stage in the pipeline, though. Most users of the parser will not
+ need to create new parsers by assembling the components but may
+ want to change some part of the behavior of the parser (e.g.
+ capitalize element names that get created in the DOM tree). By
+ having the parser be the last stage, the user can extend the
+ parser class and override the necessary methods.
+ </p>
<a name='Configuration.FeaturesAndProperties'></a>
<h3>Features & Properties</h3>
<p>
@@ -318,13 +329,38 @@
be known as a "filter".
</td>
</tr>
+ <tr>
+ <td><a name='note.2'></a>[2]</td>
+ <td>
+ XInclude is defined to work on the
+ <a href='http://www.w3.org/TR/xml-infoset'>XML Infoset</a> which
+ means that it <em>should</em> occur after validation but there
+ may be situations where the application wants to validate the
+ included material. In this case, the filter would be inserted
+ before the validator so that the document inclusion would
+ be expanded without the validator ever knowing that there was an
+ inclusion. However, since the pipeline does not buffer the
+ document, there is a problem with supporting features of
+ specifications that operate on the Infoset.
+ <a href='http://www.w3.org/TR/xinclude#IDwgAq1'>Section 3.1</a>
+ of the XInclude specification highlights this problem in the
+ example. Any use of
+ <a href='http://www.w3.org/TR/xptr'>XPointer</a>
+ to reference parts of the document containing the XInclude could
+ not be supported without buffering the document in some way.
+ Perhaps this means that the best way to support XInclude, and
+ other specifications that rely on the XML Infoset, is to
+ operate on the document model (such as DOM) and not to try to
+ do it in the parser pipeline.
+ </td>
+ </tr>
</table>
</p>
</span>
<a name='BOTTOM'></a>
<hr>
<span class='netscape'>
- Last modified: $Date: 2000/09/14 23:01:58 $
+ Last modified: $Date: 2000/09/15 21:56:49 $
</span>
</body>
</html>
1.1.2.3 +3 -3 xml-xerces/java/design/Attic/crimson.html
Index: crimson.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/crimson.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- crimson.html 2000/09/14 23:01:58 1.1.2.2
+++ crimson.html 2000/09/15 21:56:49 1.1.2.3
@@ -1,8 +1,8 @@
-<!-- $Id: crimson.html,v 1.1.2.2 2000/09/14 23:01:58 andyc Exp $ -->
+<!-- $Id: crimson.html,v 1.1.2.3 2000/09/15 21:56:49 andyc Exp $ -->
<html>
<head>
<title>Xerces 2 | Crimson</title>
- <link rel='stylesheet' type='text/css' href='site.css'>
+ <link rel='stylesheet' type='text/css' href='css/site.css'>
</head>
<body>
<span class='netscape'>
@@ -87,7 +87,7 @@
<a name='BOTTOM'></a>
<hr>
<span class='netscape'>
- Last modified: $Date: 2000/09/14 23:01:58 $
+ Last modified: $Date: 2000/09/15 21:56:49 $
</span>
</body>
</html>
1.1.2.5 +7 -13 xml-xerces/java/design/Attic/design.html
Index: design.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/design.html,v
retrieving revision 1.1.2.4
retrieving revision 1.1.2.5
diff -u -r1.1.2.4 -r1.1.2.5
--- design.html 2000/09/11 18:56:43 1.1.2.4
+++ design.html 2000/09/15 21:56:50 1.1.2.5
@@ -2,9 +2,9 @@
"http://www.w3.org/TR/WD-html-in-xml/DTD/xhtml1-strict.dtd">
<HTML>
<HEAD>
- <TITLE>Design</TITLE>
- <LINK href="index.css" rel="stylesheet" type="text/css">
- <LINK href="design.css" rel="stylesheet" type="text/css">
+ <TITLE>Xerces 2 | Design</TITLE>
+ <LINK href="css/index.css" rel="stylesheet" type="text/css">
+ <LINK href="css/design.css" rel="stylesheet" type="text/css">
</HEAD>
<BODY>
<H1 align="center">Xerces-J 2.0 Design </H1>
@@ -675,7 +675,7 @@
<DD class="fields"> fields: <UL>
<LI>
<SPAN class="class-title">InputSource</SPAN> <SPAN class="field-title">fInputSource</SPAN>
- <LI>int <SPAN class="field-title">fRowNumber</SPAN>
+ <LI>int <SPAN class="field-title">fLineNumber</SPAN>
<LI>int <SPAN class="field-title">fColumnNumber</SPAN>
<LI>long <SPAN class="field-title">fBytePosition</SPAN>
<LI>long <SPAN class="field-title">fCharPosition</SPAN>
@@ -731,12 +731,6 @@
<SPAN class="constructor-title">XMLValidator</SPAN> (
)
</UL>
- <DD class="methods"> methods: <UL>
- <LI>
- <SPAN class="method-title">setDocumentHandler</SPAN> (
- <SPAN class="interface-title">XMLDocumentHandler</SPAN> <SPAN
- class="param-title">documentHandler</SPAN> )
- </UL>
</DL>
</A></BLOCKQUOTE>
<BLOCKQUOTE>
@@ -826,7 +820,7 @@
) : int
<LI>
<SPAN class="method-title">getNextEntityDeclIndex</SPAN> (
- int <SPAN class="param-title">elementDeclIndex</SPAN> )
+ int <SPAN class="param-title">entityDeclIndex</SPAN> )
: int
<LI>
<SPAN class="method-title">getEntityDeclIndex</SPAN> (
@@ -842,7 +836,7 @@
( ) : int
<LI>
<SPAN class="method-title">getNextNotationDeclIndex</SPAN>
- ( int <SPAN class="param-title">elementDeclIndex</SPAN>
+ ( int <SPAN class="param-title">notationDeclIndex</SPAN>
) : int
<LI>
<SPAN class="method-title">getNotationDeclIndex</SPAN> (
@@ -1715,5 +1709,5 @@
class="param-title">arguments</SPAN> ) : <SPAN class="class-title">String</SPAN>
</UL>
</DL>
- </A></BLOCKQUOTE> Last modified: $Date: 2000/09/11 18:56:43 $</BODY>
+ </A></BLOCKQUOTE> Last modified: $Date: 2000/09/15 21:56:50 $</BODY>
</HTML>
1.1.2.7 +12 -12 xml-xerces/java/design/Attic/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/index.html,v
retrieving revision 1.1.2.6
retrieving revision 1.1.2.7
diff -u -r1.1.2.6 -r1.1.2.7
--- index.html 2000/09/14 23:02:01 1.1.2.6
+++ index.html 2000/09/15 21:56:51 1.1.2.7
@@ -1,8 +1,8 @@
-<!-- $Id: index.html,v 1.1.2.6 2000/09/14 23:02:01 andyc Exp $ -->
+<!-- $Id: index.html,v 1.1.2.7 2000/09/15 21:56:51 andyc Exp $ -->
<html>
<head>
<title>Xerces 2</title>
- <link rel='stylesheet' type='text/css' href='site.css'>
+ <link rel='stylesheet' type='text/css' href='css/site.css'>
<style type='text/css'>
.needs { font-size: smaller }
</style>
@@ -69,24 +69,24 @@
<dd>
Design
[<a href='design.html'>.html</a>]
- [<a href='design.css'>.css</a>]
- [<a href='design.dtd'>.dtd</a>]
- [<a href='design.xml'>.xml</a>]
- [<a href='design.xsl'>.xsl</a>]
+ [<a href='css/design.css'>.css</a>]
+ [<a href='xml/design.dtd'>.dtd</a>]
+ [<a href='xml/design.xml'>.xml</a>]
+ [<a href='xsl/design.xsl'>.xsl</a>]
[<a href='design.zip'>.zip</a>]
</dd>
<dt>Useful Programs</dt>
<dd>
Stylesheet
- [<a href='Stylesheet.java'>.java</a>]
- [<a href='Stylesheet.class'>.class</a>]
+ [<a href='src/Stylesheet.java'>.java</a>]
+ [<a href='src/Stylesheet.class'>.class</a>]
</dd>
<dd>
DesignDoc
- [<a href='DesignDoc.java'>.java</a>]
- [<a href='DesignDoc.class'>.class</a>]
- [<a href='DesignDoc$IndentingWriter.class'>.class</a>]
+ [<a href='src/DesignDoc.java'>.java</a>]
+ [<a href='src/DesignDoc.class'>.class</a>]
+ [<a href='src/DesignDoc$IndentingWriter.class'>.class</a>]
</dd>
</dl>
</p>
@@ -94,7 +94,7 @@
<a name='BOTTOM'></a>
<hr>
<span class='netscape'>
- Last modified: $Date: 2000/09/14 23:02:01 $
+ Last modified: $Date: 2000/09/15 21:56:51 $
</span>
</body>
</html>
1.1.2.3 +1 -1 xml-xerces/java/design/Attic/schedule.html
Index: schedule.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/schedule.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- schedule.html 2000/09/14 23:02:01 1.1.2.2
+++ schedule.html 2000/09/15 21:56:52 1.1.2.3
@@ -3,7 +3,7 @@
<HTML>
<HEAD>
<TITLE>Xerces 2 | Schedule</TITLE>
- <LINK href="site.css" rel="stylesheet" type="text/css">
+ <LINK href="css/site.css" rel="stylesheet" type="text/css">
</HEAD>
<BODY>
<SPAN class="netscape">
@@ -100,6 +100,6 @@
</P>
</SPAN>
<HR>
- <SPAN class="netscape"> Last modified: $Date: 2000/09/14 23:02:01 $</SPAN>
+ <SPAN class="netscape"> Last modified: $Date: 2000/09/15 21:56:52 $</SPAN>
</BODY>
</HTML>
1.1.2.3 +3 -3 xml-xerces/java/design/Attic/xerces.html
Index: xerces.html
===================================================================
RCS file: /home/cvs/xml-xerces/java/design/Attic/xerces.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- xerces.html 2000/09/14 23:02:01 1.1.2.2
+++ xerces.html 2000/09/15 21:56:54 1.1.2.3
@@ -1,8 +1,8 @@
-<!-- $Id: xerces.html,v 1.1.2.2 2000/09/14 23:02:01 andyc Exp $ -->
+<!-- $Id: xerces.html,v 1.1.2.3 2000/09/15 21:56:54 andyc Exp $ -->
<html>
<head>
<title>Xerces 2 | Xerces</title>
- <link rel='stylesheet' type='text/css' href='site.css'>
+ <link rel='stylesheet' type='text/css' href='css/site.css'>
</head>
<body>
<span class='netscape'>
@@ -102,7 +102,7 @@
<a name='BOTTOM'></a>
<hr>
<span class='netscape'>
- Last modified: $Date: 2000/09/14 23:02:01 $
+ Last modified: $Date: 2000/09/15 21:56:54 $
</span>
</body>
</html>
No revision
No revision
1.1.2.1 +22 -0 xml-xerces/java/design/css/Attic/design.css
1.1.2.1 +2 -0 xml-xerces/java/design/css/Attic/index.css
1.1.2.1 +26 -0 xml-xerces/java/design/css/Attic/site.css
No revision
No revision
1.1.2.1 +25 -0 xml-xerces/java/design/src/Attic/DesignDoc$IndentingWriter.class
<<Binary file>>
1.1.2.1 +163 -0 xml-xerces/java/design/src/Attic/DesignDoc.class
<<Binary file>>
1.1.2.1 +1168 -0 xml-xerces/java/design/src/Attic/DesignDoc.java
1.1.2.1 +18 -0 xml-xerces/java/design/src/Attic/Stylesheet.class
<<Binary file>>
1.1.2.1 +60 -0 xml-xerces/java/design/src/Attic/Stylesheet.java
No revision
No revision
1.1.2.1 +65 -0 xml-xerces/java/design/xml/Attic/design.dtd
1.1.2.1 +2956 -0 xml-xerces/java/design/xml/Attic/design.xml
1.1.2.1 +11 -0 xml-xerces/java/design/xml/Attic/schedule.dtd
1.1.2.1 +60 -0 xml-xerces/java/design/xml/Attic/schedule.xml
No revision
No revision
1.1.2.1 +216 -0 xml-xerces/java/design/xsl/Attic/design.xsl
1.1.2.1 +70 -0 xml-xerces/java/design/xsl/Attic/schedule.xsl