org.rhq.core.pluginapi.configuration
Class ResourceConfigurationUpdateException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              org.rhq.core.pluginapi.configuration.ResourceConfigurationUpdateException

All Implemented Interfaces:

Serializable

public class ResourceConfigurationUpdateException
extends RuntimeException

This exception can be thrown by instances of ResourceConfigurationFacet to indicate an update failed. This exception can be throw by the validateXXX methods to indicate that validation failed or by the persistXXX method to indicate that the actual update failed.

Any unchecked exception thrown from the validateXXX or from the persistXXX methods will be treated as an update failure. When a ResourceConfigurationUpdateException is thrown, only the error messages associated with it are sent back to the server whereas with any other exception, the entire stack trace is sent up to the server. The reason for this is that with a ResourceConfigurationUpdateException, the plugin container assumes that the failure has been handled in some fashion. For instance, catching any exceptions that might thrown from attempting to apply the update. Or consider a scenario in which applying the update involves calling out to an external program. The failed update might only be reported back with some error code.

With any other exception, the plugin container cannot reasonably assume that any errors were handled and as such reports the entire stack trace back to the server to provide additional information for debugging if necessary.

See Also:

Serialized Form

Constructor Summary

ResourceConfigurationUpdateException(String message)

Method Summary

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ResourceConfigurationUpdateException

public ResourceConfigurationUpdateException(String message)