svn commit: r1369789 - /cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java

[si...@apache.org]

Author: simonetripodi
Date: Mon Aug  6 11:42:46 2012
New Revision: 1369789

URL: http://svn.apache.org/viewvc?rev=1369789&view=rev
Log:
broken javadoc comment (open code, closed pre), fixed tag balancing, preformatted code only for large portions of code

Modified:
    cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java

Modified: cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java
URL: http://svn.apache.org/viewvc/cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java?rev=1369789&r1=1369788&r2=1369789&view=diff
==============================================================================
--- cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java (original)
+++ cocoon/cocoon3/trunk/cocoon-databases/src/main/java/org/apache/cocoon/sax/component/SQLTransformer.java Mon Aug  6 11:42:46 2012
@@ -55,10 +55,11 @@ import org.xml.sax.helpers.AttributesImp
 /**
  * The <code>SQLTransformer</code> can be plugged into a pipeline to transform
  * SAX events into updated or queries and responses to/from a SQL interface.
- * 
+ *
  * <p>
  * It is declared and configured as follows:
- * 
+ * </p>
+ *
  * <pre>
  * &lt;map:transformers default="..."&gt;
  *   &lt;map:transformer name="sql" src="org.apache.cocoon.transformation.SQLTransformer"&gt;
@@ -68,11 +69,11 @@ import org.xml.sax.helpers.AttributesImp
  *   &lt;/map:transformer&gt;
  * &lt;/map:transformers&gt;
  * </pre>
- * 
- * </p>
- * 
+ *
  * <p>
- * It can be used in the sitemap pipeline as follows: <code>
+ * It can be used in the sitemap pipeline as follows:
+ * </p>
+ * <pre>
  * &lt;map:transform type="sql"&gt;
  *   <!-- True to force each query to create its own connection: -->
  *   &lt;map:parameter name="own-connection" value="..."/&gt;
@@ -82,7 +83,7 @@ import org.xml.sax.helpers.AttributesImp
  *   &lt;map:parameter name="dburl" value="..."/&gt;
  *   &lt;map:parameter name="username" value="..."/&gt;
  *   &lt;map:parameter name="password" value="..."/&gt;
- * 
+ *
  *   <!-- Default query parameters: -->
  *   &lt;map:parameter name="show-nr-or-rows" value="false"/&gt;
  *   &lt;map:parameter name="doc-element" value="rowset"/&gt;
@@ -92,10 +93,11 @@ import org.xml.sax.helpers.AttributesImp
  *   &lt;map:parameter name="clob-encoding" value=""/&gt;
  * &lt;/map:transform&gt;
  * </pre>
- * </p>
- * 
+ *
  * <p>
- * The following DTD is valid: <code>
+ * The following DTD is valid:
+ * </p>
+ * <pre>
  * &lt;!ENTITY % param "(own-connection?,(use-connection|(dburl,username,password))?,show-nr-or-rows?,doc-element?,row-element?,namespace-uri?,namespace-prefix?,clob-encoding?)"&gt;<br>
  * &lt;!ELEMENT execute-query (query,(in-parameter|out-parameter)*,execute-query?, %param;)&gt;<br>
  * &lt;!ELEMENT own-connection (#PCDATA)&gt;<br>
@@ -111,9 +113,8 @@ import org.xml.sax.helpers.AttributesImp
  * &lt;!ELEMENT out-parameter EMPTY&gt;<br>
  * &lt;!ATTLIST out-parameter nr CDATA #REQUIRED name CDATA #REQUIRED type CDATA #REQUIRED&gt;<br>
  * &lt;!ELEMENT escape-string (#PCDATA)&gt;<br>
- * </code>
- * </p>
- * 
+ * </pre>
+ *
  * <p>
  * Each query can override default transformer parameters. Nested queries do not
  * inherit parent query parameters, but only transformer parameters. Each query
@@ -121,25 +122,25 @@ import org.xml.sax.helpers.AttributesImp
  * pool. If database connection parameters are the same as for any of the
  * ancestor queries, nested query will re-use ancestor query connection.
  * </p>
- * 
+ *
  * <p>
  * Connection sharing between queries can be disabled, globally or on per-query
  * basis, using <code>own-connection</code> parameter.
  * </p>
- * 
+ *
  * <p>
  * By default, CLOBs are read from the database using character stream, so that
  * character decoding is performed by the database. Using
  * <code>clob-encoding</code> parameter, this behavior can be overrided, so that
  * data is read as byte stream and decoded using specified character encoding.
  * </p>
- * 
+ *
  * <p>
  * TODO: Support inserting of the XML data into the database without need to
  * escape it. Can be implemented by introducing new &lt;sql:xml/&gt; tag to
  * indicate that startSerializedXMLRecording(...) should be used.
  * </p>
- * 
+ *
  * @version $Id: SQLTransformer.java 587758 2007-10-24 02:55:27Z vgritsenko $
  */
 public class SQLTransformer extends AbstractSAXTransformer implements
@@ -311,7 +312,7 @@ public class SQLTransformer extends Abst
     /**
      * Return attribute value. First try non-namespaced attribute, then try this
      * transformer namespace.
-     * 
+     *
      * @param name
      *            local attribute name
      */
@@ -340,7 +341,7 @@ public class SQLTransformer extends Abst
      * Process the SAX event. The namespace of the event is checked. If it is
      * the defined namespace for this transformer, the
      * {@link #startTransformingElement} hook is called.
-     * 
+     *
      * @see org.xml.sax.ContentHandler#startElement
      */
     public void startElement(String uri, String name, String raw,
@@ -358,7 +359,7 @@ public class SQLTransformer extends Abst
      * Process the SAX event. The namespace of the event is checked. If it is
      * the defined namespace for this transformer, the
      * {@link #endTransformingElement} hook is called.
-     * 
+     *
      * @see org.xml.sax.ContentHandler#endElement
      */
     public void endElement(String uri, String name, String raw)
@@ -734,7 +735,7 @@ public class SQLTransformer extends Abst
 
     /**
      * Qualifies an element name by giving it a prefix.
-     * 
+     *
      * @param name
      *            the element name
      * @param prefix