Класс SecurityManager

Создает новый SecurityManager.

Если менеджер безопасности уже установлен, этот метод сначала вызывает метод checkPermission менеджера безопасности с разрешением RuntimePermission("createSecurityManager") для проверки, имеет ли вызывающая нить разрешение на создание нового менеджера безопасности. Это может привести к исключению SecurityException.

Возвращает текущий стек вызовов в виде массива классов.

Длина массива равна количеству методов в стеке вызовов. Элемент с индексом 0 — это класс текущего выполняемого метода, элемент с индексом 1 — это класс вызывающего метода, и так далее.

Возвращает загрузчик классов наиболее недавно выполняемого метода из класса, определенного с помощью несистемного загрузчика классов. Несистемный загрузчик классов определяется как загрузчик классов, не равный системному загрузчику классов (как возвращается ClassLoader.getSystemClassLoader()) или одному из его предков.

Этот метод вернет null в следующих трех случаях:

1. Все методы в стеке вызовов принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
2. Все методы в стеке вызовов до первого «привилегированного» вызывающего метода (см. AccessController.doPrivileged(java.security.PrivilegedAction<T>)) принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
3. Вызов checkPermission с java.security.AllPermission не приводит к SecurityException.

Возвращает класс наиболее недавно выполняемого метода из класса, определенного с помощью несистемного загрузчика классов. Несистемный загрузчик классов определяется как загрузчик классов, не равный системному загрузчику классов (как возвращается ClassLoader.getSystemClassLoader()) или одному из его предков.

Этот метод вернет null в следующих трех случаях:

1. Все методы в стеке вызовов принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
2. Все методы в стеке вызовов до первого «привилегированного» вызывающего метода (см. AccessController.doPrivileged(java.security.PrivilegedAction<T>)) принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
3. Вызов checkPermission с java.security.AllPermission не приводит к SecurityException.

Возвращает глубину стека для последнего выполняемого метода из класса, определенного с помощью несистемного загрузчика классов. Несистемный загрузчик классов определяется как загрузчик классов, не равный системному загрузчику классов (как возвращается ClassLoader.getSystemClassLoader()) или одному из его предков.

Этот метод вернет -1 в следующих трех случаях:

1. Все методы в стеке вызовов принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
2. Все методы в стеке вызовов до первого «привилегированного» вызывающего метода (см. AccessController.doPrivileged(java.security.PrivilegedAction<T>)) принадлежат классам, определенным с помощью системного загрузчика классов или одного из его предков.
3. Вызов checkPermission с java.security.AllPermission не приводит к SecurityException.

Создает объект, который инкапсулирует текущую среду выполнения. Результат этого метода используется, например, методом checkConnect с тремя аргументами и методом checkRead с двумя аргументами. Эти методы необходимы, потому что доверенный метод может быть вызван для чтения файла или открытия сокета от имени другого метода. Доверенный метод должен определить, разрешено ли другому (возможно, недоверенному) методу выполнить операцию самостоятельно.

По умолчанию этот метод возвращает объект AccessControlContext.

Выбрасывает SecurityException если запрошенный доступ, указанный заданным разрешением, не разрешен в соответствии с текущей политикой безопасности.

Этот метод вызывает AccessController.checkPermission с заданным разрешением.

Выбрасывает SecurityException если указанный контекст безопасности получает отказ в доступе к ресурсу, указанному в данном разрешении. Контекст должен быть контекстом безопасности, возвращенным предыдущим вызовом getSecurityContext, и решение об управлении доступом основано на конфигурированной политике безопасности для этого контекста безопасности.

Если context является экземпляром AccessControlContext, тогда вызывается метод AccessControlContext.checkPermission с указанным разрешением.

Если context не является экземпляром AccessControlContext, то выбрасывается SecurityException.

Выбрасывает SecurityException если вызывающей нити не разрешено создавать новый загрузчик классов.

Этот метод вызывает checkPermission с разрешением RuntimePermission("createClassLoader").

Если вы переопределяете этот метод, то вы должны вызвать super.checkCreateClassLoader в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException если вызывающей нити не разрешено изменять переданную нить.

Этот метод вызывается текущим менеджером безопасности методами stop, suspend, resume, setPriority, setName, и setDaemon класса Thread.

Если переданная нить является системной нитью (принадлежит группе нитей с null родителем), то этот метод вызывает checkPermission с разрешением RuntimePermission("modifyThread"). Если переданная нить не является системной нитью, этот метод просто возвращается без выполнения действий.

Приложения, требующие более строгой политики, должны переопределить этот метод. Если этот метод переопределён, метод, который его переопределяет, должен дополнительно проверить, обладает ли вызывающая нить разрешением RuntimePermission("modifyThread"), и если да, то возвратиться без выполнения действий. Это гарантирует, что код, которому предоставлено это разрешение (например, сам JDK), может изменять любые нити.

Если этот метод переопределён, то super.checkAccess должен быть вызван первой инструкцией в переопределённом методе, или эквивалентная проверка безопасности должна быть размещена в переопределённом методе.

Выбрасывает SecurityException если вызывающей нити не разрешено изменять переданную группу нитей.

Этот метод вызывается текущим менеджером безопасности при создании новой дочерней нити или группы нитей, а также методами setDaemon, setMaxPriority, stop, suspend, resume, и destroy класса ThreadGroup.

Если переданная группа нитей является системной группой нитей (имеет null родителя), то этот метод вызывает checkPermission с разрешением RuntimePermission("modifyThreadGroup"). Если переданная группа нитей не является системной группой нитей, этот метод просто возвращается без выполнения действий.

Приложения, требующие более строгой политики, должны переопределить этот метод. Если этот метод переопределён, метод, который его переопределяет, должен дополнительно проверить, обладает ли вызывающая нить разрешением RuntimePermission("modifyThreadGroup"), и если да, то возвратиться без выполнения действий. Это гарантирует, что код, которому предоставлено это разрешение (например, сам JDK), может изменять любые нити.

Если этот метод переопределён, то super.checkAccess должен быть вызван первой инструкцией в переопределённом методе, или эквивалентная проверка безопасности должна быть размещена в переопределённом методе.

Выбрасывает SecurityException если вызывающей нити не разрешено заставить виртуальную машину Java завершиться с указанным кодом состояния.

Этот метод вызывается текущим менеджером безопасности методом exit класса Runtime . Значение 0 указывает на успех; другие значения указывают на различные ошибки.

Этот метод вызывает checkPermission с разрешением RuntimePermission("exitVM."+status).

Если вы переопределяете этот метод, то вы должны вызвать super.checkExit в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException если вызывающей нити не разрешено создать дочерний процесс.

Этот метод вызывается текущим менеджером безопасности методами exec класса Runtime.

Этот метод вызывает checkPermission с разрешением FilePermission(cmd,"execute") если cmd является абсолютным путём, иначе вызывает checkPermission с FilePermission("<<ALL FILES>>","execute").

Если вы переопределяете этот метод, то вы должны вызвать super.checkExec в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException если вызывающей нити не разрешено динамически связать код библиотеки, указанный строковым аргументом file. Аргумент может быть простым именем библиотеки или полным именем файла.

Этот метод вызывается текущим менеджером безопасности методами load и loadLibrary класса Runtime.

Этот метод вызывает checkPermission с разрешением RuntimePermission("loadLibrary."+lib).

Если вы переопределяете этот метод, то вы должны вызвать super.checkLink в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException если вызывающей нити не разрешено читать из указанного дескриптора файла.

Этот метод вызывает checkPermission с разрешением RuntimePermission("readFileDescriptor").

Если вы переопределяете этот метод, то вы должны вызвать super.checkRead в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException если вызывающей нити не разрешено читать файл, указанный строковым аргументом.

Этот метод вызывает checkPermission с разрешением FilePermission(file,"read").

Если вы переопределяете этот метод, то вы должны вызвать super.checkRead в той точке, где переопределённый метод обычно выбрасывал бы исключение.

Выбрасывает SecurityException , если указанный контекст безопасности не имеет права на чтение файла, заданного строковым аргументом. Контекст должен быть контекстом безопасности, возвращенным предыдущим вызовом getSecurityContext.

Если context является экземпляром AccessControlContext, то будет вызван метод AccessControlContext.checkPermission с разрешением FilePermission(file,"read").

Если context не является экземпляром AccessControlContext, то выбрасывается исключение SecurityException.

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkRead в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено записывать в указанный дескриптор файла.

Этот метод вызывает checkPermission с разрешением RuntimePermission("writeFileDescriptor").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkWrite в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено записывать в файл, указанный строковым аргументом.

Этот метод вызывает checkPermission с разрешением FilePermission(file,"write").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkWrite в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено удалять указанный файл.

Этот метод вызывается текущим менеджером безопасности методом delete класса File.

Этот метод вызывает checkPermission с разрешением FilePermission(file,"delete").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkDelete в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено открывать соединение сокета с указанным хостом и номером порта.

Номер порта -1 указывает, что вызывающий метод пытается определить IP-адрес указанного имени хоста.

Этот метод вызывает checkPermission с разрешением SocketPermission(host+":"+port,"connect") если порт не равен -1. Если порт равен -1, то он вызывает checkPermission с разрешением SocketPermission(host,"resolve").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkConnect в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если указанный контекст безопасности не имеет права на открытие сокет-соединения с указанным хостом и номером порта.

Номер порта -1 указывает, что вызывающий метод пытается определить IP-адрес указанного имени хоста.

Если context не является экземпляром AccessControlContext, то выбрасывается SecurityException.

В противном случае проверяется номер порта. Если он не равен -1, то вызывается метод context с разрешением SocketPermission(host+":"+port,"connect"). Если порт равен -1, то вызывается метод context с разрешением SocketPermission(host,"resolve").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkConnect в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено ожидать запрос соединения на указанном локальном номере порта.

Этот метод вызывает checkPermission с разрешением SocketPermission("localhost:"+port,"listen").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkListen в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено принимать сокет-соединение с указанного хоста и порта.

Этот метод вызывается текущим менеджером безопасности методом accept класса ServerSocket.

Этот метод вызывает checkPermission с разрешением SocketPermission(host+":"+port,"accept").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkAccept в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает SecurityException , если вызывающей нити запрещено использовать IP-мультипоток (подключение/отключение/отправка/прием).

Этот метод вызывает checkPermission с разрешением java.net.SocketPermission(maddr.getHostAddress(), "accept,connect").

Если вы переопределяете этот метод, то вы должны сделать вызов super.checkMulticast в тот момент, когда переопределенный метод обычно сгенерировал бы исключение.

Выбрасывает исключение SecurityException, если вызывающая нить не имеет разрешения на использование (подключение/отключение/отправку/прием) IP-мультиадресной рассылки.

Этот метод вызывает checkPermission с разрешением java.net.SocketPermission(maddr.getHostAddress(), "accept,connect").

Если вы переопределяете этот метод, то должны вызвать super.checkMulticast в тот момент, когда переопределенный метод обычно бы бросал исключение.

Выбрасывает исключение SecurityException, если вызывающая нить не имеет разрешения на доступ к системным свойствам или их изменение.

Этот метод используется методами getProperties и setProperties класса System.

Этот метод вызывает checkPermission с разрешением PropertyPermission("*", "read,write").

Если вы переопределяете этот метод, то должны вызвать super.checkPropertiesAccess в тот момент, когда переопределенный метод обычно бы бросал исключение.

Выбрасывает исключение SecurityException, если вызывающая нить не имеет разрешения на доступ к системному свойству с указанным key именем.

Этот метод используется методом getProperty класса System.

Этот метод вызывает checkPermission с разрешением PropertyPermission(key, "read").

Если вы переопределяете этот метод, то должны вызвать super.checkPropertyAccess в тот момент, когда переопределенный метод обычно бы бросал исключение.

Возвращает false, если вызывающая нить имеет право создавать верхнеуровневое окно, указанное аргументом window. В этом случае вызывающий может всё равно решить показать окно, но окно должно включать некий вид визуального предупреждения. Если метод возвращает true, то окно можно показать без особых ограничений.

См. класс Window для получения дополнительной информации о доверенных и недоверенных окнах.

Этот метод вызывает checkPermission с разрешением AWTPermission("showWindowWithoutWarningBanner"), и возвращает true, если не брошено исключение SecurityException, иначе возвращает false. В случае подмножеств профилей Java SE, не включающих пакет java.awt, вместо checkPermission используется вызов для проверки разрешения java.security.AllPermission.

Если вы переопределяете этот метод, то должны вызвать super.checkTopLevelWindow в точке, где переопределенный метод обычно возвращал false, и должно быть возвращено значение super.checkTopLevelWindow.

Выбрасывает исключение SecurityException, если вызывающей нити не разрешено инициировать запрос на печать.

Этот метод вызывает checkPermission с разрешением RuntimePermission("queuePrintJob").

Если вы переопределяете этот метод, то должны вызвать super.checkPrintJobAccess в тот момент, когда переопределенный метод обычно бы бросал исключение.

Выбрасывает исключение SecurityException, если вызывающей нити не разрешен доступ к системному буферу обмена.

Этот метод вызывает checkPermission с разрешением AWTPermission("accessClipboard"). В случае подмножеств профилей Java SE, не включающих пакет java.awt, используется checkPermission для проверки разрешения java.security.AllPermission.

Если вы переопределяете этот метод, то должны вызвать super.checkSystemClipboardAccess в точке, где переопределённый метод обычно бы бросал исключение.

Выбрасывает исключение SecurityException, если вызывающей нити не разрешен доступ к очереди событий AWT.

Этот метод вызывает checkPermission с разрешением AWTPermission("accessEventQueue"). В случае подмножеств профилей Java SE, не включающих пакет java.awt, используется checkPermission для проверки разрешения java.security.AllPermission.

Если вы переопределяете этот метод, то должны вызвать super.checkAwtEventQueueAccess в точке, где переопределённый метод обычно бы бросал исключение.

Выбрасывает исключение SecurityException, если вызывающей нити не разрешен доступ к пакету, указанному в аргументе.

Этот метод используется загрузчиками классов.

Этот метод сначала получает список запрещенных пакетов, получив список, разделенный запятыми, из вызова java.security.Security.getProperty("package.access"), и проверяет, начинается ли pkg или совпадает ли с любым из запрещенных пакетов. Если это так, то checkPermission вызывается с разрешением RuntimePermission("accessClassInPackage."+pkg).

Если этот метод переопределяется, то super.checkPackageAccess должен вызываться как первая строка переопределённого метода.

Выбрасывает исключение SecurityException, если вызывающей нити не разрешено определять классы в пакете, указанном в аргументе.

Этот метод используется некоторыми загрузчиками классов.

Этот метод сначала получает список запрещенных пакетов, получив список, разделенный запятыми, из вызова java.security.Security.getProperty("package.definition"), и проверяет, начинается ли pkg или совпадает ли с любым из запрещенных пакетов. Если это так, то checkPermission вызывается с разрешением RuntimePermission("defineClassInPackage."+pkg).

Если этот метод переопределяется, то super.checkPackageDefinition должен вызываться как первая строка переопределённого метода.

Выбрасывает SecurityException , если вызывающей потоковой нити не разрешено задать сокет-фабрику, используемую ServerSocket или Socket, или фабрику обработчика потоков, используемую URL.

Этот метод вызывает checkPermission с разрешением RuntimePermission("setFactory").

Если вы переопределяете этот метод, вы должны вызвать super.checkSetFactory в том месте, где переопределённый метод обычно бы выбросил исключение.

Выбрасывает SecurityException , если вызывающей потоковой нити не разрешено получить доступ к членам.

По умолчанию разрешен доступ к общедоступным членам, а также к классам, у которых загрузчик классов совпадает с загрузчиком вызывающей стороны. Во всех остальных случаях этот метод вызывает checkPermission с разрешением RuntimePermission("accessDeclaredMembers") .

Если этот метод переопределён, то вызов super.checkMemberAccess сделать нельзя, так как стандартная реализация checkMemberAccess полагается на то, что проверяемый код находится на глубине стека 4.

Определяет, следует ли предоставить или запретить разрешение с указанным целевым именем разрешения.

Если запрошенное разрешение разрешено, этот метод возвращается без каких-либо действий. Если разрешение запрещено, генерируется SecurityException.

Этот метод создаёт объект SecurityPermission для заданного целевого имени разрешения и вызывает checkPermission с ним.

См. документацию для SecurityPermission для получения списка возможных целевых имён разрешений.

Если вы переопределяете этот метод, вы должны вызвать super.checkSecurityAccess в том месте, где переопределённый метод обычно бы выбросил исключение.