Package org.camunda.bpm.engine

Class AuthorizationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.camunda.bpm.engine.ProcessEngineException

org.camunda.bpm.engine.AuthorizationException

All Implemented Interfaces:

java.io.Serializable

public class AuthorizationException
extends ProcessEngineException

Exception thrown by the process engine in case a user tries to interact with a resource in an unauthorized way.

The exception contains a list of Missing authorizations. The List is a disjunction i.e. a user should have any of the authorization for the engine to continue the execution beyond the point where it failed.

Author:

Daniel Meyer

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected java.util.List<MissingAuthorization>	missingAuthorizations
protected java.lang.String	permissionName	Deprecated.
protected java.lang.String	resourceId	Deprecated.
protected java.lang.String	resourceType	Deprecated.
protected java.lang.String	userId

Constructor Summary

Constructors

Constructor	Description
AuthorizationException(java.lang.String message)
AuthorizationException(java.lang.String userId, java.lang.String permissionName, java.lang.String resourceType, java.lang.String resourceId)
AuthorizationException(java.lang.String userId, java.util.List<MissingAuthorization> info)
AuthorizationException(java.lang.String userId, MissingAuthorization exceptionInfo)

Method Summary

Modifier and Type	Method	Description
static java.lang.String	generateMissingAuthorizationsList(java.util.List<MissingAuthorization> missingAuthorizations)	Generate a String containing a list of missing authorizations.
java.util.List<MissingAuthorization>	getMissingAuthorizations()
java.lang.String	getResourceId()	Deprecated. Use getMissingAuthorizations() to get the id of the resource of the MissingAuthorization(s).
java.lang.String	getResourceType()	Deprecated. Use getMissingAuthorizations() to get the type of the resource of the MissingAuthorization(s).
java.lang.String	getUserId()
java.lang.String	getViolatedPermissionName()	Deprecated. Use getMissingAuthorizations() to get the violated permission name of the MissingAuthorization(s).

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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

userId

protected final java.lang.String userId

missingAuthorizations

protected final java.util.List<MissingAuthorization> missingAuthorizations

resourceType

@Deprecated
protected java.lang.String resourceType

Deprecated.

permissionName

@Deprecated
protected java.lang.String permissionName

Deprecated.

resourceId

@Deprecated
protected java.lang.String resourceId

Deprecated.

Constructor Detail

AuthorizationException

public AuthorizationException(java.lang.String message)

AuthorizationException

public AuthorizationException(java.lang.String userId,
                              java.lang.String permissionName,
                              java.lang.String resourceType,
                              java.lang.String resourceId)

AuthorizationException

public AuthorizationException(java.lang.String userId,
                              MissingAuthorization exceptionInfo)

AuthorizationException

public AuthorizationException(java.lang.String userId,
                              java.util.List<MissingAuthorization> info)

Method Detail

getResourceType

@Deprecated
public java.lang.String getResourceType()

Deprecated.

Use getMissingAuthorizations() to get the type of the resource of the MissingAuthorization(s). This method may be removed in future versions.

Returns:

the type of the resource if there is only one MissingAuthorization, null otherwise

getViolatedPermissionName

@Deprecated
public java.lang.String getViolatedPermissionName()

Deprecated.

Use getMissingAuthorizations() to get the violated permission name of the MissingAuthorization(s). This method may be removed in future versions.

Returns:

the type of the violated permission name if there is only one MissingAuthorization, null otherwise

getUserId

public java.lang.String getUserId()

Returns:

id of the user in which context the request was made and who misses authorizations to perform it successfully

getResourceId

@Deprecated
public java.lang.String getResourceId()

Deprecated.

Use getMissingAuthorizations() to get the id of the resource of the MissingAuthorization(s). This method may be removed in future versions.

Returns:

the id of the resource if there is only one MissingAuthorization, null otherwise

getMissingAuthorizations

public java.util.List<MissingAuthorization> getMissingAuthorizations()

Returns:

Disjunctive list of MissingAuthorization from which a user needs to have at least one for the authorization to pass

generateMissingAuthorizationsList

public static java.lang.String generateMissingAuthorizationsList(java.util.List<MissingAuthorization> missingAuthorizations)

Generate a String containing a list of missing authorizations.

Parameters:

missingAuthorizations -