Red Hat Bugzilla – Bug 785005
JON 3.0.1 RC#1 CLI API Doc is incomplete
Last modified: 2012-02-08 13:33:00 EST
Description of problem: JON 3.0.1 RC#1 CLI API Doc is incomplete
Specifically, I do not see in the API doc
1) any object listed in CLI Doc table 2.3 (subject, pretty,rhq)
2) the findResourceByCriteria method from CLI Doc section 2.5
I would expect the CLI API doc to contain all the methods available from the CLI ... or at least that the ones documented elsewhere in the CLI Doc
12/30/2012 BZ triage meeting mfoley, ccrouch, loleary, asantos
I am looking at the 3.0 javadoc, so I cannot attest, at the moment, to whether the method is in the 2.4 javadoc. I did find findResourcesByCriteria in the ResourceManager class here (apologies for the long URL):
Backing up to the other part, about the objects. My understanding is that those are commands specifically for the CLI in interactive mode, not methods that can or should be invoked in a script file or things that should be in the API. I think. I will verify that with dev. At the least, that point should be clear when I redo the docs for 3.1.
Still on comment 2), I checked, and findResourcesByCriteria is also in the 2.4 API.
As for 1), the locations of a lot of those implicit variables is different, of course. Everything in org.rhq.core.domain* is here:
That's where I found subject, pageControl, and unlimited PC.
There are a fair number of managers in org.rhq.enterprise.server.*, which all seem to be in the normal remote API set.
I cannot find anything in org.rhq.enterprise.client.* in the public APIs. According to Ian, the rhq method is contained in the CLI JAR itself, so I don't think these are public APIs at all, just tools available to the CLI to use.
I can try to make it more clear in the docs where these methods and classes are coming from.