To support Remote Clients we need to expose a Remote API. This is a set of methods/services exposed via jboss remoting for java clients and jboss WS for web service clients written in a variety of languages. This is an umbrella for work involved in the feature work described here: http://jopr.org/confluence/display/RHQ/Design-API
Pulling in additional tasks that already addressed some of the functional areas.
patches for current changes of the remote apis, Will be comitted after executing/writing more tests,
clean guidelines: * by convention, getXXX methods should expect to return 0 or 1 objects (a single object or null) * by convention, findXXX methods should expect to return 0, 1, or many objects (a list of objects, which could be empty) * do not throw exceptions if they are unnecessary (throws FetchException when no RHQ-specific exception can occur in that method) * try to always throw runtime exceptions (in the QueryGenerator things like NoSuchMethod/FieldException should be wrapped in appropriate runtime exceptions or subclasses thereof) * try to hide internal constructs/elements where possible (i.e., use logout(Subject) not logout(sessionId) in the remote API) * do not use underscore '_' for internal variable names (java man prefers camelCasedTokens) * don't unnecessarily rename parameters in the API signature (subject -> sessionSubject) * if you're going to wrap the exception in a generic one, make sure to include all current context, i.e.... ** do -- catch (SomeException se) { throw new UpdateException(se); } ** instead of -- catch (SomeException se) { new UpdateException("failed to update"); } * DO NOT change the signature of local methods if it can be helped (i.e., SubjectManagerBean.deleteUsers(Subject, Integer[]) was changed to catch all possible exceptions and wrapped them in a DeleteException, but this broken unit tests which were expecting it to throw a PermissionException (which is a distinct classification/errorType from a general DeleteException)
This bug was previously known as http://jira.rhq-project.org/browse/RHQ-1180 Imported an attachment (id=368504) Imported an attachment (id=368505) This bug is incorporated by RHQ-2125
The work under this umbrella is done.