db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Knut Anders Hatlen (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-1932) Reference Manual updates - JDBC Reference section
Date Wed, 27 Aug 2008 12:25:44 GMT

     [ https://issues.apache.org/jira/browse/DERBY-1932?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Knut Anders Hatlen updated DERBY-1932:
--------------------------------------

    Attachment: encoding.diff

I think the simplest way to clean up the examples is

1) In rrefjavsqlprst, change the text above the example from "how a user can store a streamed
java.io.File" to "how a user can store a streamed, ASCII-encoded java.io.File". Then there
shouldn't be any problems with using setAsciiStream().

2) In rrefjavsqlrssc, use getCharacterStream() instead of getAsciiStream(). Then char is used
instead of byte throughout the example, and there won't be any issues with converting between
a byte representation and characters.

I have attached a patch (encoding.diff) which suggests how it could be done.

> Reference Manual updates - JDBC Reference section
> -------------------------------------------------
>
>                 Key: DERBY-1932
>                 URL: https://issues.apache.org/jira/browse/DERBY-1932
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.2.1.6
>            Reporter: Laura Stewart
>            Assignee: Kim Haase
>             Fix For: 10.5.0.0
>
>         Attachments: DERBY-1932.diff, DERBY-1932.stat, DERBY-1932.zip, encoding.diff
>
>
> JDBC Reference: 
> Section =  java.sql.Blob and java.sql.Clob 
> File = http://db.apache.org/derby/docs/10.2/ref/rrefjdbc96386.html 
> Update = 
> This section has a table titled Table 1. JDBC 2.0 java.sql.Blob Methods Supported. The
first row, 3rd column of this table shows up empty in the html page but has an ' in the pdf
format. The pdf format should also show the column empty. I think this happens for all the
tables with no data in the pdf format 
>  
> Section = DatabaseMetaData functionality not supported 
> File =  http://db.apache.org/derby/docs/10.2/ref/ref-single.html#N2E3A9 
> Update =  
> This section says that getColumnPrivileges and getTablePrivileges are not supported.
But checkin r381109 has changes to metadata.properties for these 2 functions. So, looks like
these methods are probably now supported with grant revoke functionality. 
>  
> Section = Data streaming 
> Files = 
> (1) http://db.apache.org/derby/docs/dev/ref/rrefjavsqlprst.html
> (2) http://db.apache.org/derby/docs/dev/ref/rrefjavsqlrssc.html
> (3) http://db.apache.org/derby/docs/dev/ref/crefjavbclobnot.html 
> (4) http://db.apache.org/derby/docs/dev/ref/rrefjdbc4_0summary.html
> Updates =  
> (1): Rewrite section to reflect a newer JDBC version than 1.2? Comment that getUnicodeStream
is deprecated and no longer implemented in Derby. Add description of getCharacterStream. Could
also add info about setNCharacterStream, which is JDBC 4 only and not supported. The note
under the table is no longer accurate; it only applies when using the client driver (and also
only for the client?).
> (2): OK 
> (3): Update list of methods (mark as deprecated, add getCharacterStream). 
> (4): OK.
>  

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message