db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Chris Dolan (JIRA)" <j...@apache.org>
Subject [jira] Created: (DERBY-4622) Specify "database:" URL prefix in documentation
Date Tue, 20 Apr 2010 14:28:49 GMT
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.

View raw message