Spring/spring-framework
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix minor problems and polish reference docs

Browse Source 
Problems

 - Eliminate — in favor of —

   — was causing 'no such entity' errors during docbook
   processing; — produces the equivalent output.

 - Fix column issues in appendices

   column counts were set to 3, when they are in fact 4. This passed
   under DocBook 4 and Spring Build for unknown reasons, but caused a
   hard stop under DocBook 5 and the docbook-reference-plugin.

 - Add jdbc callout section in docbook 5-friendly style

   use <co/> tags as advertised in DocBook documentation.

 - Set correct widths for PDF ref doc images

   images were rendering larger than the PDF page; just set all to
   width=400 and everything looks good.

Polish

 - Update reference doc copyright to 2012

 - Remove "work-in-progress" language from ref docs

 - Update maven URLs to repo.springsource.org

 - Update javadoc urls from 3.0.x/javadoc-api => current/api

 - Replace hardcoded "3.1" with ${version} in ref doc
This commit is contained in:
Chris Beams
2012-01-15 00:29:39 +01:00
parent 7a3aa70565
commit 86b5066a96
22 changed files with 163 additions and 157 deletions
Download Patch File Download Diff File Expand all files Collapse all files

99
src/reference/docbook/jdbc.xml
View File

@@ -2600,93 +2600,74 @@ public class TitlesAfterDateStoredProcedure extends StoredProcedure {
of a <classname>DefaultLobHandler</classname>. You typically set this
value through dependency injection.<!--Rewording ok? (What does what through dependency injection?) TR: Revised.--></para>
<!--
<programlistingco>
<areaspec>
<area coords="8" id="jdbc.lobhandler.variableref" />
<area coords="12" id="jdbc.lobhandler.setClob" />
<area coords="13" id="jdbc.lobhandler.setBlob" />
</areaspec>
<programlisting language="java">final File blobIn = new File("spring2004.jpg");
<programlisting language="java"><![CDATA[final File blobIn = new File("spring2004.jpg");
final InputStream blobIs = new FileInputStream(blobIn);
final File clobIn = new File("large.txt");
final InputStream clobIs = new FileInputStream(clobIn);
final InputStreamReader clobReader = new InputStreamReader(clobIs);
jdbcTemplate.execute(
"INSERT INTO lob_table (id, a_clob, a_blob) VALUES (?, ?, ?)",
new AbstractLobCreatingPreparedStatementCallback(lobHandler) {
new AbstractLobCreatingPreparedStatementCallback(lobHandler) {]]><co id="lobHandler"/><![CDATA[
protected void setValues(PreparedStatement ps, LobCreator lobCreator)
throws SQLException {
ps.setLong(1, 1L);
lobCreator.setClobAsCharacterStream(ps, 2, clobReader, (int)clobIn.length());
lobCreator.setBlobAsBinaryStream(ps, 3, blobIs, (int)blobIn.length());
lobCreator.setClobAsCharacterStream(ps, 2, clobReader, (int)clobIn.length());]]><co id="setClobAsCharacterStream"/><![CDATA[
lobCreator.setBlobAsBinaryStream(ps, 3, blobIs, (int)blobIn.length());]]><co id="setBlobAsBinaryStream"/><![CDATA[
}
}
);
blobIs.close();
clobReader.close();</programlisting>
clobReader.close();]]></programlisting>
<calloutlist>
<callout arearefs="jdbc.lobhandler.variableref">
<para>Pass in the lobHandler that in this example is a plain
<classname>DefaultLobHandler</classname></para>
</callout>
<calloutlist>
<callout arearefs="lobHandler">
<para>Pass in the lobHandler that in this example is a plain
<classname>DefaultLobHandler</classname></para>
</callout>
<callout arearefs="jdbc.lobhandler.setClob">
<para>Using the method
<classname>setClobAsCharacterStream</classname>, pass in the
contents of the CLOB.</para>
</callout>
<callout arearefs="setClobAsCharacterStream">
<para>Using the method
<classname>setClobAsCharacterStream</classname>, pass in the
contents of the CLOB.</para>
</callout>
<callout arearefs="jdbc.lobhandler.setBlob">
<para>Using the method
<classname>setBlobAsBinaryStream</classname>, pass in the contents
of the BLOB.</para>
</callout>
</calloutlist>
</programlistingco>
-->
<callout arearefs="setBlobAsBinaryStream">
<para>Using the method
<classname>setBlobAsBinaryStream</classname>, pass in the contents
of the BLOB.</para>
</callout>
</calloutlist>
<para>Now it's time to read the LOB data from the database. Again, you
use a <code>JdbcTemplate</code> with the same instance variable
<code>l</code><code>obHandler </code>and a reference to a
<classname>DefaultLobHandler</classname>.</para>
<para><!--<programlistingco>
<areaspec>
<area coords="5" id="jdbc.lobhandler.getClob" />
<area coords="7" id="jdbc.lobhandler.getBlob" />
</areaspec>
<programlisting language="java">List&lt;Map&lt;String, Object&gt;&gt; l = jdbcTemplate.query("select id, a_clob, a_blob from lob_table",
new RowMapper&lt;Map&lt;String, Object&gt;&gt;() {
public Map&lt;String, Object&gt; mapRow(ResultSet rs, int i) throws SQLException {
Map&lt;String, Object&gt; results = new HashMap&lt;String, Object&gt;();
String clobText = lobHandler.getClobAsString(rs, "a_clob");
<para>
<programlisting language="java"><![CDATA[List<Map<String, Object>> l = jdbcTemplate.query("select id, a_clob, a_blob from lob_table",
new RowMapper<Map<String, Object>>() {
public Map<String, Object> mapRow(ResultSet rs, int i) throws SQLException {
Map<String, Object> results = new HashMap<String, Object>();
String clobText = lobHandler.getClobAsString(rs, "a_clob");]]><co id="getClobAsString"/><![CDATA[
results.put("CLOB", clobText);
byte[] blobBytes = lobHandler.getBlobAsBytes(rs, "a_blob");
byte[] blobBytes = lobHandler.getBlobAsBytes(rs, "a_blob");]]><co id="getBlobAsBytes"/><![CDATA[
results.put("BLOB", blobBytes);
return results;
}
});
</programlisting>
});]]></programlisting>
<calloutlist>
<callout arearefs="jdbc.lobhandler.setClob">
<para>Using the method <classname>getClobAsString,
</classname>retrieve the contents of the CLOB.</para>
</callout>
<calloutlist>
<callout arearefs="getClobAsString">
<para>Using the method <classname>getClobAsString,
</classname>retrieve the contents of the CLOB.</para>
</callout>
<callout arearefs="jdbc.lobhandler.setBlob">
<para>Using the method <classname>getBlobAsBytes,</classname>
retrieve the contents of the BLOB.</para>
</callout>
</calloutlist>
</programlistingco>--></para>
<callout arearefs="getBlobAsBytes">
<para>Using the method <classname>getBlobAsBytes,</classname>
retrieve the contents of the BLOB.</para>
</callout>
</calloutlist>
</para>
</section>
<section id="jdbc-in-clause">