Класс SecurityManager

public SecurityManager()

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

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

protected Class<?>[] getClassContext()

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

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

public Object getSecurityContext()

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

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

public void checkPermission(Permission perm)

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

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

public void checkPermission(Permission perm, Object context)

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

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

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

public void checkCreateClassLoader()

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

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

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

public void checkAccess(Thread t)

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

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

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

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

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

public void checkAccess(ThreadGroup g)

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

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

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

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

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

public void checkExit(int status)

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

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

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

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

public void checkExec(String cmd)

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

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

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

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

public void checkLink(String lib)

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

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

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

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

public void checkRead(FileDescriptor fd)

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

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

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

public void checkRead(String file)

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

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

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

public void checkRead(String file, Object context)

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

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

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

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

public void checkWrite(FileDescriptor fd)

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

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

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

public void checkWrite(String file)

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

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

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

public void checkDelete(String file)

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

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

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

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

public void checkConnect(String host, int port)

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

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

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

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

public void checkConnect(String host, int port, Object context)

Бросает исключение SecurityException, если указанный контекст безопасности не разрешён для открытия сокетного подключения к указанному хосту и номеру порта.

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

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

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

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

public void checkListen(int port)

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

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

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

public void checkAccept(String host, int port)

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

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

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

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

public void checkMulticast(InetAddress maddr)

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

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

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

@Deprecated(since="1.4", forRemoval=true) public void checkMulticast(InetAddress maddr, byte ttl)

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

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

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

public void checkPropertiesAccess()

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

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

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

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

public void checkPropertyAccess(String key)

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

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

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

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

public void checkPrintJobAccess()

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

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

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

public void checkPackageAccess(String pkg)

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

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

Этот метод проверяет, начинается ли указанный пакет или совпадает ли он с любым из пакетов в свойстве безопасности package.access. Реализация также может проверить пакет на дополнительный список ограниченных пакетов, как указано ниже. Если пакет ограничен, вызывается checkPermission(Permission) с разрешением RuntimePermission("accessClassInPackage."+pkg).

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

public void checkPackageDefinition(String pkg)

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

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

Этот метод проверяет, начинается ли указанный пакет или совпадает ли он с любым из пакетов в свойстве безопасности package.definition. Реализация также может проверить пакет на дополнительный список ограниченных пакетов, как указано ниже. Если пакет ограничен, вызывается checkPermission(Permission) с разрешением RuntimePermission("defineClassInPackage."+pkg).

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

public void checkSetFactory()

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

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

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

public void checkSecurityAccess(String target)

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

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

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

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

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

public ThreadGroup getThreadGroup()

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