You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kim Haase (JIRA)" <ji...@apache.org> on 2012/04/24 20:37:33 UTC

[jira] [Updated] (DERBY-5516) Document the fact that attributes on the connection URL trump attributes specified in a connection Properties object.

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

Kim Haase updated DERBY-5516:
-----------------------------

    Attachment: DERBY-5516.zip
                DERBY-5516.stat
                DERBY-5516.diff

Thanks for the guidance, Rick. I'm attaching DERBY-5516.diff, DERBY-5516.stat, and DERBY-5516.zip, with changes to the following:

M       src/devguide/cdevdvlp51654.dita
M       src/devguide/tdevdvlp36289.dita
M       src/ref/rrefattrib24612.dita
M       src/ref/rrefjdbc34565.dita
M       src/ref/rrefjdbc10889.dita

The java.sql.Driver topic didn't seem like a logical place to put this information. I looked for other possibilities, but I think you found the best locations.

Please let me know what changes might be needed here.
                
> Document the fact that attributes on the connection URL trump attributes specified in a connection Properties object.
> ---------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-5516
>                 URL: https://issues.apache.org/jira/browse/DERBY-5516
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation, JDBC
>    Affects Versions: 10.9.0.0
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>         Attachments: DERBY-5516.diff, DERBY-5516.stat, DERBY-5516.zip
>
>
> Attributes for a Derby connection can be set via semicolon-separated lists on the connection url as well as in a Properties object passed to the java.sql.DriverManager.getConnection() and java.sql.Driver.connect() methods. The JDBC spec does not indicate what should happen if an attribute is specified both on the connection url and in the Properties object. For some databases, like Derby, the attributes on the connection url trump the attributes in the Properties object. For other databases, like MySQL, the reverse is true.
> Because the JDBC spec does not dictate standard behavior here, we should document what Derby does. This information would be useful in some or all of the following sections:
> Reference Manual:
>   Setting attributes for the database connection URL
>   Attributes of the Derby database connection URL
>   java.sql.Driver interface
>   java.sql.DriverManager.getConnection method
> Developer's Guide:
>   Working with the database connection URL attributes
>   Specifying attributes in a properties object

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira