issrg.pba
Class DecisionWithObligationException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by issrg.utils.EmbeddedException
              extended by issrg.pba.PbaException
                  extended by issrg.pba.DecisionWithObligationException
All Implemented Interfaces:
java.io.Serializable

public class DecisionWithObligationException
extends PbaException

This class represents a special type of PbaException, DecisionWithObligationException, which is thrown by the traditional decision method of PBAAPI, if the decision cannot be enforced without enforcing the Obligations, i.e. this Exception is thrown when enforcing a simple boolean decision is not sufficient to meet the security requirements of the system. The AEF or PEP is free to either log this exception as an error, or obtain the Response from this object and enforce the decision in it as well as the Obligations. Note that if you call response method of the PBAAPI, you always get the Response, and never get this exception.

Author:
gansen, A.Otenko
See Also:
Serialized Form

Constructor Summary
DecisionWithObligationException(java.lang.String msg, Response r)
          This method creates a DecisionWithObligationException with a message and the Response that contains Obligations.
 
Method Summary
 Response getResponse()
          This method returns the Response that was computed at decision time, but which cannot be enforced without enforcing the Obligations inside.
 
Methods inherited from class issrg.utils.EmbeddedException
getEmbedded, printStackTrace, printStackTrace, printStackTrace
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DecisionWithObligationException

public DecisionWithObligationException(java.lang.String msg,
                                       Response r)
This method creates a DecisionWithObligationException with a message and the Response that contains Obligations.

Parameters:
msg - - a human-readable diagnostic message, which makes sense only if the code is not going to enforce the Obligations in the Response
r - - the Response with Obligations that need to be enforced along with the decision
Method Detail

getResponse

public Response getResponse()
This method returns the Response that was computed at decision time, but which cannot be enforced without enforcing the Obligations inside.