OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.service.deploymentadmin.spi
Class ResourceProcessorException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byorg.osgi.service.deploymentadmin.spi.ResourceProcessorException
All Implemented Interfaces:
java.io.Serializable

public class ResourceProcessorException
extends java.lang.Exception

Checked exception received when something fails during a call to a Resource Processor. A ResourceProcessorException always contains an error code (one of the constants specified in this class), and may optionally contain the textual description of the error condition and a nested cause exception.

See Also:
Serialized Form

Field Summary
static int CODE_OTHER_ERROR
          Other error condition.
static int CODE_PREPARE
          Resource Processors are allowed to raise an exception with this error code to indicate that the processor is not able to commit the operations it made since the last call of ResourceProcessor.begin(DeploymentSession) method.
static int CODE_RESOURCE_SHARING_VIOLATION
          An artifact of any resource already exists.
 
Constructor Summary
ResourceProcessorException(int code)
          Create an instance of the exception.
ResourceProcessorException(int code, java.lang.String message)
          Create an instance of the exception.
ResourceProcessorException(int code, java.lang.String message, java.lang.Throwable cause)
          Create an instance of the exception.
 
Method Summary
 java.lang.Throwable getCause()
           
 int getCode()
           
 java.lang.String getMessage()
           
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CODE_PREPARE

public static final int CODE_PREPARE
Resource Processors are allowed to raise an exception with this error code to indicate that the processor is not able to commit the operations it made since the last call of ResourceProcessor.begin(DeploymentSession) method.

Only the ResourceProcessor.prepare() method is allowed to throw exception with this error code.

See Also:
Constant Field Values

CODE_RESOURCE_SHARING_VIOLATION

public static final int CODE_RESOURCE_SHARING_VIOLATION
An artifact of any resource already exists.

Only the ResourceProcessor.process(String, InputStream) method is allowed to throw exception with this error code.

See Also:
Constant Field Values

CODE_OTHER_ERROR

public static final int CODE_OTHER_ERROR
Other error condition.

All Resource Processor methods which throw ResourceProcessorException is allowed throw an exception with this erro code if the error condition cannot be categorized.

See Also:
Constant Field Values
Constructor Detail

ResourceProcessorException

public ResourceProcessorException(int code,
                                  java.lang.String message,
                                  java.lang.Throwable cause)
Create an instance of the exception.

Parameters:
code - The error code of the failure. Code should be one of the predefined integer values (CODE_X).
message - Message associated with the exception
cause - the originating exception

ResourceProcessorException

public ResourceProcessorException(int code,
                                  java.lang.String message)
Create an instance of the exception. Cause exception is implicitly set to null.

Parameters:
code - The error code of the failure. Code should be one of the predefined integer values (CODE_X).
message - Message associated with the exception

ResourceProcessorException

public ResourceProcessorException(int code)
Create an instance of the exception. Cause exception and message are implicitly set to null.

Parameters:
code - The error code of the failure. Code should be one of the predefined integer values (CODE_X).
Method Detail

getCause

public java.lang.Throwable getCause()
Returns:
Returns the cause.

getCode

public int getCode()
Returns:
Returns the code.

getMessage

public java.lang.String getMessage()
Returns:
Returns the message.

OSGi™ Service Platform
Release 4 Version 4.1

Copyright © OSGi Alliance (2000, 2007). All Rights Reserved. Licensed under the OSGi Specification License, Version 1.0