Stay organized with collections
Save and categorize content based on your preferences.
AccessControlException
open class AccessControlException : SecurityException
This exception is thrown by the AccessController to indicate that a requested access (to a critical system resource such as the file system or the network) is denied.
The reason to deny access can vary. For example, the requested permission might be of an incorrect type, contain an invalid value, or request access that is not allowed according to the security policy. Such information should be given whenever possible at the time the exception is thrown.
Summary
| Public constructors |
|
Constructs an AccessControlException with the specified, detailed message.
|
|
Constructs an AccessControlException with the specified, detailed message, and the requested permission that caused the exception.
|
| Public methods |
| open Permission! |
Gets the Permission object associated with this exception, or null if there was no corresponding Permission object.
|
Public constructors
AccessControlException
AccessControlException(s: String!)
Constructs an AccessControlException with the specified, detailed message.
| Parameters |
s |
String!: the detail message. |
AccessControlException
AccessControlException(
s: String!,
p: Permission!)
Constructs an AccessControlException with the specified, detailed message, and the requested permission that caused the exception.
| Parameters |
s |
String!: the detail message. |
p |
Permission!: the permission that caused the exception. |
Public methods
getPermission
open fun getPermission(): Permission!
Gets the Permission object associated with this exception, or null if there was no corresponding Permission object.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# AccessControlException\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)\n\nAccessControlException\n======================\n\n```\nopen class AccessControlException : SecurityException\n```\n\n|---|---|---|---|---|-------------------------------------------|\n| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) ||||||\n| ↳ | [kotlin.Throwable](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-throwable/index.html) |||||\n| | ↳ | [java.lang.Exception](../lang/Exception.html#) ||||\n| | | ↳ | [java.lang.RuntimeException](../lang/RuntimeException.html#) |||\n| | | | ↳ | [java.lang.SecurityException](../lang/SecurityException.html#) ||\n| | | | | ↳ | [java.security.AccessControlException](#) |\n\nThis exception is thrown by the AccessController to indicate that a requested access (to a critical system resource such as the file system or the network) is denied.\n\nThe reason to deny access can vary. For example, the requested permission might be of an incorrect type, contain an invalid value, or request access that is not allowed according to the security policy. Such information should be given whenever possible at the time the exception is thrown.\n\nSummary\n-------\n\n| Public constructors ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [AccessControlException](#AccessControlException(kotlin.String))`(`s:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`)` Constructs an `AccessControlException` with the specified, detailed message. |\n| [AccessControlException](#AccessControlException(kotlin.String,%20java.security.Permission))`(`s:` `[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!`, `p:` `[Permission](/reference/kotlin/java/security/Permission)!`)` Constructs an `AccessControlException` with the specified, detailed message, and the requested permission that caused the exception. |\n\n| Public methods ||\n|----------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| open [Permission](/reference/kotlin/java/security/Permission)! | [getPermission](#getPermission())`()` Gets the Permission object associated with this exception, or null if there was no corresponding Permission object. |\n\nPublic constructors\n-------------------\n\n### AccessControlException\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nAccessControlException(s: String!)\n```\n\nConstructs an `AccessControlException` with the specified, detailed message.\n\n| Parameters ||\n|-----|--------------------------------------------------------------------------------------------------------|\n| `s` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: the detail message. |\n\n### AccessControlException\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nAccessControlException(\n s: String!, \n p: Permission!)\n```\n\nConstructs an `AccessControlException` with the specified, detailed message, and the requested permission that caused the exception.\n\n| Parameters ||\n|-----|--------------------------------------------------------------------------------------------------------|\n| `s` | [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)!: the detail message. |\n| `p` | [Permission](/reference/kotlin/java/security/Permission)!: the permission that caused the exception. |\n\nPublic methods\n--------------\n\n### getPermission\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nopen fun getPermission(): Permission!\n```\n\nGets the Permission object associated with this exception, or null if there was no corresponding Permission object.\n\n| Return ||\n|-----------------------------------------------------------|------------------------|\n| [Permission](/reference/kotlin/java/security/Permission)! | the Permission object. |"]]
