[jira] Updated: (ZOOKEEPER-490) the java docs for session creation are misleading/incomplete

["Patrick Hunt (JIRA)" <ji...@apache.org>]

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

Patrick Hunt updated ZOOKEEPER-490:
-----------------------------------

    Attachment: ZOOKEEPER-490.patch

this patch updates the javadoc for zk construction
talks about async nature
talks about thread safety


> the java docs for session creation are misleading/incomplete
> ------------------------------------------------------------
>
>                 Key: ZOOKEEPER-490
>                 URL: https://issues.apache.org/jira/browse/ZOOKEEPER-490
>             Project: Zookeeper
>          Issue Type: Bug
>    Affects Versions: 3.1.1, 3.2.0
>            Reporter: Patrick Hunt
>            Assignee: Patrick Hunt
>             Fix For: 3.2.1, 3.3.0
>
>         Attachments: ZOOKEEPER-490.patch
>
>
> the javadoc for ZooKeeper constructor says:
>      * The client object will pick an arbitrary server and try to connect to it.
>      * If failed, it will try the next one in the list, until a connection is
>      * established, or all the servers have been tried.
> the "or all server tried" phrase is misleading, it should indicate that we retry until success, con closed, or session expired. 
> we also need ot mention that connection is async, that constructor returns immed and you need to look for connection event in watcher

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