[jboss-jira] [JBoss JIRA] (JBJCA-1361) Documentation for flush strategies needs clarification

[Stephen Fikes (JIRA)]

Stephen Fikes created JBJCA-1361:
------------------------------------

             Summary: Documentation for flush strategies needs clarification
                 Key: JBJCA-1361
                 URL: https://issues.jboss.org/browse/JBJCA-1361
             Project: IronJacamar
          Issue Type: Bug
          Components: Documentation
    Affects Versions: 1.2.7.Final, WildFly/IronJacamar 1.3.4.Final
            Reporter: Stephen Fikes


http://www.ironjacamar.org/doc/userguide/1.2/en-US/html_single/index.html#d0e3787

It wasn't immediately clear to me how {{EntirePool}} and {{IdleConnections}} flush strategies work since both use the word "all" in their explanation/definition. Comparing {{AllConnections}} and {{AllIdleConnections}} it is clear that "all" with regard to {{EntirePool}} and {{IdleConnections}} is limited in some sense.

The subtlety lies in the fact that a single datasource can have multiple (internal) sets of connections grouped/segregated by authentication credentials. Consequently, "all" in the context of {{EntirePool}} or {{IdleConnections}} is limited to a subset of the connections that are associated with a specific authentication credential whereas the {{All*}} variants are not so limited.



--
This message was sent by Atlassian JIRA
(v7.5.0#75005)