db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bryan Pendleton (JIRA)" <j...@apache.org>
Subject [jira] Commented: (DERBY-4622) Specify "database:" URL prefix in documentation
Date Wed, 21 Apr 2010 14:41:52 GMT

    [ https://issues.apache.org/jira/browse/DERBY-4622?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12859374#action_12859374
] 

Bryan Pendleton commented on DERBY-4622:
----------------------------------------

There's something funky about the leading C: in Windows file paths, and the Java URL syntax.

I seem to remember that you need extra slashes in the front, along the lines of

   ///c:/AppData/local/etc.

If indeed this works, we could put it in the docs somewhere.

> 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.


Mime
View raw message