commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1078309 - in /commons/sandbox/digester3/trunk/src/site/fml: ./ guide/ guide/faq.fml
Date Sat, 05 Mar 2011 16:15:31 GMT
Author: simonetripodi
Date: Sat Mar  5 16:15:31 2011
New Revision: 1078309

first checkin of FAQ


Added: commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml
--- commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml (added)
+++ commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml Sat Mar  5 16:15:31 2011
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+See the License for the specific language governing permissions and
+limitations under the License.
+<faqs xmlns=""
+  xmlns:xsi=""
+  xsi:schemaLocation=""
+  title="Frequently Asked Questions"
+  toplink="false">
+    <part id="General">
+        <faq id="jaxp_1_1_warnings">
+            <question>Why do I get warnings when using a JAXP 1.1 parser?</question>
+            <answer>
+                <p>If you're using a JAXP 1.1 parser, you might see the following warning
(in your log):</p>
+[WARN] Digester - -Error: JAXP SAXParser property not recognized:
+<p>This property is needed for JAXP 1.2 (XML Schema support) as required
+for the Servlet Spec. 2.4 but is not recognized by JAXP 1.1 parsers.
+This warning is harmless.</p>
+            </answer>
+        </faq>
+        <faq id="schema_validation_out_box">
+            <question>Why Doesn't Schema Validation Work With Parser XXX Out Of The
+            <answer><p>
+Schema location and language settings are often need for validation using schemas.
+Unfortunately, there isn't a single standard approach to how these properties are
+configured on a parser.
+Digester tries to guess the parser being used and configure it appropriately
+but it's not infallible.
+You might need to grab an instance, configure it and pass it to Digester.
+If you want to support more than one parser in a portable manner, 
+then you'll probably want to take a look at the 
+<code>org.apache.commons.digester.parsers</code> package
+and add a new class to support the particular parser that's causing problems.
+        </faq>
+        <faq id="help">
+            <question>Help! 
+I'm Validating Against Schema But Digester Ignores Errors!</question>
+            <answer><p>
+Digester is based on <a href="">SAX</a>. The convention
+SAX parsers is that all errors are reported (to any registered 
+<code>ErrorHandler</code>) but processing continues. Digester (by default) 
+registers its own <code>ErrorHandler</code> implementation. This logs details

+but does not stop the processing (following the usual convention for SAX 
+based processors). 
+This means that the errors reported by the validation of the schema will appear in the
+Digester logs but the processing will continue. To change this behaviour, call
+<code>digester.setErrorHandler</code> with a more suitable implementation.
+        </faq>
+        <faq id="example_code">
+            <question>Where Can I Find Example Code?</question>
+            <answer><p>Digester ships with a sample application: a mapping for
the <em>Rich Site 
+Summary</em> format used by many newsfeeds. Download the source distribution 
+to see how it works.</p>
+<p>Digester also ships with a set of examples demonstrating most of the 
+features described in this document. See the "src/examples" subdirectory 
+of the source distribution.</p></answer>
+        </faq>
+        <faq id="support_rich_site">
+            <question>When Are You Going To Support <em>Rich Site Summary</em>
Version x.y.z?</question>
+            <answer><p>The <em>Rich Site Summary</em> application
is intended to be a sample application. 
+It works but we have no plans to add support for other versions of the format.
+We would consider donations of standard digester applications but it's unlikely that
+these would ever be shipped with the base digester distribution.
+If you want to discuss this, please post to <a href="">
+commons dev mailing list</a>
+        </faq>
+    </part>

View raw message