[jboss-jira] [JBoss JIRA] Created: (JBCACHE-1313) Cache javadoc doesn't discuss behavior of non-started cache

[Brian Stansberry (JIRA)]

Cache javadoc doesn't discuss behavior of non-started cache
-----------------------------------------------------------

                 Key: JBCACHE-1313
                 URL: http://jira.jboss.com/jira/browse/JBCACHE-1313
             Project: JBoss Cache
          Issue Type: Bug
      Security Level: Public (Everyone can see)
    Affects Versions: 2.1.0.GA
            Reporter: Brian Stansberry
         Assigned To: Manik Surtani
            Priority: Minor


When writing org.jboss.cache.DestroyedCacheAPITest for JBCACHE-1312 I saw that a lot of methods will throw an ISE if invoked when the cache is not started.  That's fine, but the Cache javadoc doesn't describe that behavior, or really any other case where behavior differs when the cache is and isn't started.

I'm going to add @throws declarations in a lot of places re: the ISE, but will leave this assigned to Manik in case he/others want to have a look at any other unclear areas in the docs.  Also, the get/setInvocationContext methods work fine when cache is destroyed, but perhaps they should fail with ISE as well, just to be consistent with get/put/remove, etc.?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira