[rhq] Branch 'stefan/inventorycontext' - modules/core
snegrea
snegrea at fedoraproject.org
Tue Aug 7 21:03:39 UTC 2012
modules/core/plugin-api/src/main/java/org/rhq/core/pluginapi/inventory/InventoryContext.java | 24 +++++-----
1 file changed, 12 insertions(+), 12 deletions(-)
New commits:
commit 14b7dd184880140d74d4658ffa0e62a575f27c4f
Author: Stefan Negrea <snegrea at redhat.com>
Date: Tue Aug 7 16:03:33 2012 -0500
[BZ 828329] Minor documentation updates and rewording.
diff --git a/modules/core/plugin-api/src/main/java/org/rhq/core/pluginapi/inventory/InventoryContext.java b/modules/core/plugin-api/src/main/java/org/rhq/core/pluginapi/inventory/InventoryContext.java
index 50a7945..ec1fab4 100644
--- a/modules/core/plugin-api/src/main/java/org/rhq/core/pluginapi/inventory/InventoryContext.java
+++ b/modules/core/plugin-api/src/main/java/org/rhq/core/pluginapi/inventory/InventoryContext.java
@@ -28,25 +28,25 @@ package org.rhq.core.pluginapi.inventory;
public interface InventoryContext {
/**
- * This method requests a deferred service discovery process for children of the resource. It request the discovery
- * process and returns immediately without waiting for results. The discovery process inventories all discovered
- * resources, so no further action is required.
+ * This method requests a deferred service discovery process for children of the resource. It requests the discovery
+ * process and returns immediately without waiting for results. The discovery process imports into inventory all discovered
+ * resources, so no further action is required from the caller.
*
* This method should be used by resources following an action (outside of create/delete children) that results
* in having additional children discoverable. A good example is an operation execution that enables extra functionality
- * on managed resource which in turn translates into having additional children available for management.
+ * on the managed resource which in turn translates into having additional children available for management.
*
- * Note: All resources are discovered by the regular platform level discovery process that runs every 24 hours. This method allows
- * a resource to request a discovery for child resources to be run immediately, rather than wait for the scheduled platform
- * discovery.
+ * Note: All services are discovered by the regular discovery process that runs every 24 hours. This method allows
+ * a resource to request an immediate run of the discovery process for child resources, rather than wait for the scheduled
+ * service discovery.
*/
public void requestDeferredChildResourcesDiscovery();
/**
* This method requests a service discovery process for children of the resource. It schedules the discovery
- * process and blocks until the discovery finishes. The discovery process inventories all discovered
- * resources, so no further action is required.
+ * process and blocks until the discovery finishes. The discovery process imports into inventory all discovered
+ * resources, so no further action is required from the caller.
*
* This method should be used by resources following an action (outside of create/delete children) that results
* in having additional children discoverable. A good example is an operation execution that enables extra functionality
@@ -54,9 +54,9 @@ public interface InventoryContext {
* until the discovery processes finishes, this includes committing resources to inventory. For additional processing,
* the calling resource can then request the list of child resources (it will include newly discovered resources too).
*
- * Note: All resources are discovered by the regular platform level discovery process that runs every 24 hours. This method allows
- * a resource to request a discovery for child resources to be run immediately, rather than wait for the scheduled platform
- * discovery.
+ * Note: All services are discovered by the regular discovery process that runs every 24 hours. This method allows
+ * a resource to request an immediate run of the discovery process for child resources, rather than wait for the scheduled
+ * service discovery.
*
* @return discovered child resources
*/
More information about the rhq-commits
mailing list