INT-2865: Stored Procedure SqlReturnType support

JIRA: https://jira.springsource.org/browse/INT-2865
This commit is contained in:
Artem Bilan
2013-05-12 21:00:39 +03:00
committed by Gunnar Hillert
parent 3154173d23
commit 7d96dc7969
14 changed files with 364 additions and 29 deletions

View File

@@ -810,10 +810,13 @@
attribute.
</para>
<programlisting language="xml"><![CDATA[<int-jdbc:sql-parameter-definition name="" ]]><co id="sp-parameter-definition-xml01-co" linkends="sp-parameter-definition-xml01" /><![CDATA[
direction="IN" ]]><co id="sp-parameter-definition-xml02-co" linkends="sp-parameter-definition-xml02" /><![CDATA[
type="STRING" ]]><co id="sp-parameter-definition-xml03-co" linkends="sp-parameter-definition-xml03" /><![CDATA[
scale=""/> ]]><co id="sp-parameter-definition-xml04-co" linkends="sp-parameter-definition-xml04" /></programlisting>
<programlisting language="xml"><![CDATA[<int-jdbc:sql-parameter-definition
name="" ]]><co id="sp-parameter-definition-xml01-co" linkends="sp-parameter-definition-xml01" /><![CDATA[
direction="IN" ]]><co id="sp-parameter-definition-xml02-co" linkends="sp-parameter-definition-xml02" /><![CDATA[
type="STRING" ]]><co id="sp-parameter-definition-xml03-co" linkends="sp-parameter-definition-xml03" /><![CDATA[
scale="5" ]]><co id="sp-parameter-definition-xml04-co" linkends="sp-parameter-definition-xml04" /><![CDATA[
type-name="FOO_STRUCT" ]]><co id="sp-parameter-definition-xml05-co" linkends="sp-parameter-definition-xml05" /><![CDATA[
return-type="fooSqlReturnType"/> ]]><co id="sp-parameter-definition-xml06-co" linkends="sp-parameter-definition-xml06" /></programlisting>
<para>
<calloutlist>
<callout arearefs="sp-parameter-definition-xml01-co" id="sp-parameter-definition-xml01">
@@ -850,6 +853,23 @@
<emphasis>Optional</emphasis>.
</para>
</callout>
<callout arearefs="sp-parameter-definition-xml05-co" id="sp-parameter-definition-xml05">
<para>
The typeName for types that are user-named like: STRUCT, DISTINCT, JAVA_OBJECT, named array types.
This attribute is mutually exclusive with the <emphasis>scale</emphasis> attribute.
<emphasis>Optional</emphasis>.
</para>
</callout>
<callout arearefs="sp-parameter-definition-xml06-co" id="sp-parameter-definition-xml06">
<para>
The reference to a custom value handler for complex types. An implementation of
<ulink url="http://static.springsource.org/spring/docs/current/javadoc-api/org/springframework/jdbc/core/SqlReturnType.html"
>SqlReturnType</ulink>.
This attribute is mutually exclusive with the <emphasis>scale</emphasis> attribute
and is applicable for OUT(INOUT)-parameters only.
<emphasis>Optional</emphasis>.
</para>
</callout>
</calloutlist>
</para>

View File

@@ -191,6 +191,21 @@
For more information see <xref linkend="chain"/>.
</para>
</section>
<section id="3.0-stored-proc-sql-return-type">
<title>SqlReturnType support for Stored Procedure components</title>
<para>
For more complex database-specific types, not supported by the standard
<code>CallableStatement.getObject</code> method, 2 new additional
attributes were introduced to the <code>&lt;sql-parameter-definition/&gt;</code>
element with OUT-direction:
</para>
<itemizedlist>
<listitem><emphasis>type-name</emphasis></listitem>
<listitem><emphasis>return-type</emphasis></listitem>
</itemizedlist>
<para>
For more information see <xref linkend="stored-procedures"/>.
</para>
</section>
</section>
</chapter>