[DERBY-4515] Document and clarify the use of DataValueDescriptor.setValue(InputStream,int)

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 10.6.1.0
• Fix Version/s: 10.5.3.1, 10.6.1.0
• Component/s: JDBC
• Assignee: Kristian Waagan
• Reporter: Kristian Waagan
• Created: 15/Jan/10 12:48
• Updated: 21/Jan/10 10:59
• Resolved: 21/Jan/10 10:59

Description

The usage of the method DataValueDescriptor.setValue(InputStream stream, int length) is unclear. The intended use seems to be to pass on the known length of an input stream set from the JDBC-layer (i.e. setBinaryStream).
There seems to be two distinct cases:

• the logical length of the stream is known
• the logical length of the stream is not known

Using -1 when the length is not known seems to be an established pattern.

Issue Links

• is depended upon by: DERBY-4455 Prepared statement failure with CLOB: Stream has already been read and end-of-file reached and cannot be re-used.