📄 xml.html.primary
字号:
<p>JBuilder提供以下工具执行XML文档的表示功能：</p>
<ul>
<li>Cocoon作为显示层</li>
<li>XML文档的合法性</li>
<li>XML文档的转换</li>
</ul>
<!--****************COCOON****************-->
<a name="cocoon_xml_publishing"></a>
<p><b><font color="#000080" size="3">Cocoon XML 发布架构</font></b></p>
<!--BNDX="Cocoon XML publishing framework"-->
<p>Cocoon是Apache XML 项目的一部分，已经集成进了JBuilder。它是一个基于servlet的Java 发布架构。允许XML里把内容、样式、逻辑分离，使用
XSL转换将它们合并。Cocoon 也可以用逻辑表及Extensible Server Pages (XSP)来传送由嵌入的JAV程序逻辑生成的动态内容。
Cocoon 模式把WEB内容分成以下部分：</p>
<ul>
<li>XML 创建: XML 文件创建者需了解DTD的内容，但不必知道其处理过程。</li>
<li>XML 处理: XML文件根据逻辑格式来处理。逻辑和内容是分离的。</li>
<li>XSL 显示: XML文档通过应用样式表来显示，根据不同的资源类型不同显示不同格式，如PDF, HTML, WML, XHTML, 等.</li>
</ul>
<p>当你运行<i>Cocoon Web Application</i> 向导（<i>File|New|XML</i>）时, Cocoon 被配置成和JBuilder绑定的版本在你开始一个新的项目后，使用<i>Cocoon
Web Application</i> 向导来创建 Cocoon:</p>
<ol>
<li>使用JBuilder Project向导创建一个新项目(<i>File|New Project</i>)。</li>
<li>选择 File|New，然后选择 XML标签。</li>
<li>双击<i>Cocoon Web Application</i> 图标，打开<i>Cocoon Web Application</i> 向导.</li>
<li>接受默认的t Cocoon设置.</li>
<li>如果想生成WAR文件，选择<i>Generate WAR</i> 选项。</li>
<li>点击 OK 关闭向导，生成Cocoon文件。</li>
<li>在项目窗格里 选择项目文件，右键选择<i>Make Project</i>生成WAR文件。</li>
<li>在项目窗格里扩展cocoon 节点看到向导产生的Cocoon 文件：
<p><img src="images/xml_cocoonfiles.gif"></p>
<ul>
<li><code><font size="1">cocoon.war</font></code> - web压缩文件</li>
<li><code>web.xml</code> - web部署描述</li>
<li><code>cocoon.properties</code> -属性文件</li>
<li><code>cocoon.xml</code> -配置文件</li>
<li><code>index.xml </code></li>
<li><code>index.xsl </code></li>
</ul>
你可以在编辑器里直接编辑这些文件，而不用再次运行向导.<br>
<br>
</li>
<li> 用项目窗格的工具条中的<i>Add To Project</i> 按钮把你的现存的XML和XSL文件加到这个项目中来。</li>
</ol>
<p>想了解更多关于web.<code>xml</code>和部署描述编辑器的信息，请参照"部署描述"主题：<a href="../webapps/webapps_context.html#dd">"开发WebApps
和WAR 文件"</a> 和<a href="../webapps/webapps_managing.html#dd">"部署你的WEB应用"</a>
在<cite>Web 应用程序开发指南</cite>. </p>
<p>打开Cocoon例子文件<code>index.xml</code>，注意到它用<code>index.xsl</code> 作为 样式表。</p>
<p class="btbl"> index.xml 的XML 源代码</p>
<p><img src="images/xcocoon_xmlsource.gif" alt="XML source" border="0"></p>
<p class="btbl">index.xsl 样式表源代码</p>
<p><img src="images/xcocoon_xslsource.gif" width="430" height="434" alt="XSL" border="0"></p>
<p>现在运行cocoon，在项目窗格的cocoon节点单击右键，选择<i>Cocoon Run</i> 。Cocoon 装入当前配置servlet ，然后使用由
<i>Cocoon Web Application</i>向导生成的<code>web.xml</code>和<code>cocoon.properties</code>
文件信息把自身放入servlet环境中。你 可以修改<code>cocoon.properties</code> 来加入 XSP (Extensible
Server Pages) 库和自己的资源到每个逻辑表中。</p>
<p>现在，选择Web View标签来看 使用样式表的Cocoon例子。</p>
<p class="btbl">Web view of index.xml</p>
<img src="images/cocoon_webview.gif" width="499" height="392" alt="Web view" border="0">
<p>想看web view的源代码，请 选择Web View Source 标签。</p>
<p>Web view source of index.xml</p>
<img src="images/cocoon_webviewsource.gif" width="625" height="392" alt="Web view source" border="0">
<p>想知道关于使用Cocoon的 信息，请看 Cocoon文档 和例子，它们在JBuilder的cocoon目录或 Apache 网站：<a href="http://xml.apache.org/cocoon/index.html">http://xml.apache.org/cocoon/index.html</a>
可以找到。</p>
<a name="transform"></a>
<p><b><font color="#000080" size="3">XML文档的转换</font></b></p>
<!--BNDX="XML documents:transforming;transforming XML documents;transform trace options;tracing:enabling;XML traces:enabling;stylesheets:applying to XML documents;XML documents:applying stylesheets to;Transform view toolbar"-->
<!--BNDX="Xalan stylesheet processor;transforming XML documents;XSLT (Extensible Sytlesheet Language Transformations);Xalan stylesheeting processor:and Xerces;Xerces parser:and Xalan"-->
<p>XML文档转换就是把XML文档转换成任何其他文档的过程。JBuilder包含 Xalan 作为样式表处理器来转换XML文档，用Extensible Style
Language Transformations (XSLT) 写的样式表来转换。一个XSL样式表包含指令，可以把XML文档转换成其他文档类型：XML、HTML、PFD、WML、等等。</p>
<p>想了解 Xalan，请到JBuilder完全安装的附加目录或Apache 网站：<a href="http://xml.apache.org/">http://xml.apache.org/</a>来看
Xalan 的文档和例子。</p>
<a name="internal"></a>
<p><font size="2" color="#000080"><b>使用内部样式表</b></font></p>
<p>为了给XML文档应用样式表，在内容窗格里选择XML文件的<i>Transform View </i>标签。如果文档包含一个XSLT处理指令，且有一个单独的样式表，则这个样式表应用到XML文档。如果是显示一个树形视图，请按下在转换视图工具条的<i>Default
Stylesheet</i> 按钮<img src="images/defaultstylesheetbutton.gif" width="20" height="19" alt="Default stylesheet button" border="0">屏蔽掉树形视图。稍等片刻，转换后的使用了样式表的XML文档便显示在内容窗格的Transform
View 标签里。通过Transform View Source标签，你可以看到转换的源代码。</p>
<p>如果你想把另一个外部的在文档样式表指令列表中的样式表应用到 文档，请从下拉列表中选择选择它。</p>
<p class="bfig">Transform view 工具条</p>
<p><img src="images/xml_transform_toolbar.gif"></p>
<p class="btbl">Transform view 工具条按钮</p>
<table border="1" cellspacing=0 cellspadding=0>
<thead>
<tr>
<th style="background-color: #000080"><font color="#FFFFFF">按钮</font></th>
<th style="background-color: #000080"><font color="#FFFFFF">描述</font></th>
</tr>
</thead>
<tr>
<td>默认的样式表</td>
<td>应用JBuilder 默认的样式表，是一个折叠树形。</td>
</tr>
<tr>
<td>刷新</td>
<td>刷新视图</td>
</tr>
<tr>
<td>设置单步选项</td>
<td>打开 Set Transform Trace Options 对话框，你可以设置程序处理的单步选项。</td>
</tr>
<tr>
<td>添加样式表</td>
<td>打开 Configure Node Stylesheets 对话框，把样式表和 文档关联起来。</td>
</tr>
</table>
<a name="external"></a>
<p><b><font size="2" color="#000080">使用外部样式表</font></b></p>
<p>你也可以给XML文档使用外部样式表。首先，你必须把样式表 和 XML文档关联。有几种方法可以添加或删除XML文档的样式表关联。</p>
<ul>
<li>在项目窗格中XML文档名上右键，选择 <i>Properties</i>。</li>
<li>单击<i>transform view </i>工具条的<i>Add Stylesheets</i> 按钮<img src="images/addstylesheetsbutton.gif" width="21" height="22" alt="Add Stylesheets button" border="0">
。
<p><img src="images/xaddstylesheets.gif" width="422" height="487" alt="Properties" border="0"></p>
</li>
</ul>
<p>然后，用Add and Remove按钮添加或删除选中的样式表。一旦样式表和 文档建立关联，在<i> transform view</i>工具条的样式表下拉列表中便可以看到它在内部样式表的后面。</p>
<p>下一步，选择<i>Transform View</i>标签，从样式表下拉列表里选择刚才加的外部的样式表，应用。如果看到文档以树形显示，在 <i>transform
view</i>标签中选择<i>Default Stylesheet</i> 按钮禁用它。</p>
<p class="bfig">Transform view 使用外部样式表</p>
<p><img src="images/xtransform_ss.gif" alt="External stylesheet applied" border="0"></p>
<p>如果样式表不可用，在<i> transform view</i>里会 显示一个消息，表示样式表没有和文档关联。</p>
<p class="bfig">Transform view 没有样式表</p>
<p><img src="images/xtransform_problem.gif" alt="Problem message" border="0"></p>
<p>为了显示使用默认的样式表转换结果， 选择<i> transform view</i>工具条的<i>Default Stylesheet</i>按钮<img src="images/defaultstylesheetbutton.gif" width="20" height="19" alt="Default Stylesheet button" border="0">
。当文档是另一个没有样式表的XML文档的转换输出时，就很有用处。</p>
<p class="bfig">Transform view 使用默认的样式表</p>
<p><img src="images/xtransform_tree.gif" alt="Tree view" border="0"></p>
<a name="traceoptions"></a>
<p><b><font size="2" color="#000080">设置转换单步选项</font></b></p>
<p>你可以设置转换单步选项，这样当一个转换发生时，你可以在处理过程中设单步运行。这些选项包括Generation、Templates、Elements 和Selections。为了开启单步，选择<i>Tools|IDE
Options</i>，然后选择 XML 标签，就可以设置这些选项了。你 也可以通过选择在<i> transform view</i>的工具条上的<i>Set
Trace Options</i>按钮<img src="images/settracebutton.gif" width="20" height="20" alt="Set Trace Options button" border="0">
来设置。这些单步记录显示在消息窗格中。点击一个单步信息，加亮相应的源代码，双击一个单步使光标移到源代码编辑框中，开始编辑。</p>
<p><img src="images/xml_transformtrace.gif" alt="Set trace"></p>
<br><br>
<!--****************XML CONFIG****************-->
<a name="xml_config"></a>
<hr>
<p><font size="3" color="#000080"><b>XML 配置</b></font></p>
<!--BNDX="XML options:setting;XML viewer:enabling;enabling XML viewer;default stylesheet;Transform Trace options:setting;"-->
<blockquote class="bsku"><font color="#FF0000">这个功能在JBuilder 专业版和企业版提供.</font></blockquote>
<p>你可以在 <a href="../ui/dialogs/dlgxmlconfig.html">IDE Options</a> 对话框中设置XML配置信息。选择<i>Tools|IDE
Options</i>，点击XML 标签设置下列选项：</p>
<ul>
<li>通用选项
<ul>
<li><i>Enable Browser View</i>: 开启JBuilder's XML viewer. 当这个选项开启，在内容窗格中，View标签便可用。</li>
<li><i>Apply Default Stylesheet</i>: JBuilder's 默认的把XML文档显示为树形结构的样式表。</li>
</ul>
</li>
<li><i>Transform Trace options</i>: 设置单步选项，这样在转换发生时，你可以看到不同样式表元素转换的顺序。单步选项包括：
<ul>
<li> Generation</li>
<li> Templates</li>
<li> Elements</li>
<li> Selections</li>
</ul>
</li>
</ul>
<p><img src="images/xml_options.gif" width="408" height="487" alt="XML page" border="0"></p>
<br><br>
<!--****************XML RESOURCES***-->
<a name="xml_resources"></a>
<hr>
<p><font color="#000080" size="3"><b>XML资源</b></font></p>
<p>在JBuilder完全安装的<i>附加</i>目录中可以找到有用资源，如Xerces, Xalan, Castor, and Borland XML.
Documentation, Javadoc，及附带的 例子。</p>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -