Specify "database:" URL prefix in documentation
-----------------------------------------------
Key: DERBY-4622
URL: https://issues.apache.org/jira/browse/DERBY-4622
Project: Derby
Issue Type: Bug
Components: Documentation
Reporter: Chris Dolan
Priority: Trivial
The tutorial step titled "Activity 3: Run a JDBC program using the embedded
driver" at the following URL
(http://db.apache.org/derby/docs/10.4/getstart/getstart-single.html#tgsactivity3_Setup)
recommends this syntax for specifying a directory-based datasource:
String connectionURL = "jdbc:derby:" + dbName + ";create=true";
For Windows users who need to specify an absolute path to the database, this is
a problem because the connection interprets "c:/path/to/db" as non-existent
protocol "c" and a database name of "/path/to/db". Better documentation would
be explicitly specify the protocol:
String connectionURL = "jdbc:derby:directory:" + dbName + ";create=true";
(this would have saved me about a day of troubleshooting...)
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
