Класс CodeSource

public CodeSource(URL url, Certificate[] certs)

Создает CodeSource и связывает его с указанным местоположением и набором сертификатов.

public CodeSource(URL url, CodeSigner[] signers)

Создает CodeSource и связывает его с указанным местоположением и набором подписантов кода.

public int hashCode()

Возвращает значение хеш-кода этого объекта.

public boolean equals(Object obj)

Проверяет равенство указанного объекта и этого объекта. Два объекта CodeSource считаются равными, если их местоположения имеют одинаковые значения и цепочки сертификатов подписантов имеют одинаковые значения. Порядок сертификатов в цепочках может различаться.

public final URL getLocation()

Возвращает местоположение, связанное с этим CodeSource.

public final Certificate[] getCertificates()

Возвращает сертификаты, связанные с этим CodeSource.

Если этот объект CodeSource был создан с помощью конструктора CodeSource(URL url, CodeSigner[] signers), его цепочки сертификатов извлекаются и используются для создания массива объектов Certificate. За сертификатом каждого подписанта следует поддерживающая его цепочка сертификатов (которая может быть пустой). Сертификат каждого подписанта и поддерживающая его цепочка сертификатов упорядочены снизу вверх (то есть сначала идет сертификат подписанта, а последним — сертификат центра сертификации (корневой сертификат)).

public final CodeSigner[] getCodeSigners()

Возвращает подписантов кода, связанных с этим CodeSource.

Если этот объект CodeSource был создан с помощью конструктора CodeSource(URL url, java.security.cert.Certificate[] certs), его цепочки сертификатов извлекаются и используются для создания массива объектов CodeSigner. Обратите внимание, что проверяются только сертификаты X.509 — все остальные типы сертификатов игнорируются.

public boolean implies(CodeSource codesource)

Возвращает true, если объект CodeSource «подразумевает» указанный CodeSource.

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

• codesource не должен быть null.
• Если сертификаты этого объекта не равны null, все сертификаты этого объекта должны присутствовать в сертификатах codesource.
• Если местоположение этого объекта (getLocation()) не равно null, выполняются следующие проверки местоположения этого объекта и местоположения codesource:
  • Местоположение codesource не должно быть null.
  • Если местоположение этого объекта равно местоположению codesource, возвращается true.
  • Протокол этого объекта (getLocation().getProtocol()) должен совпадать с протоколом codesource без учета регистра.
  • Если хост этого объекта (getLocation().getHost()) не равен null, последовательно выполняются следующие проверки:
    • Если хост этого объекта был инициализирован одним IP-адресом, один из IP-адресов codesource должен совпадать с IP-адресом этого объекта.
    • Если хост этого объекта является доменом с подстановочным знаком (например, *.example.com), каноническое имя хоста codesource (имя без предшествующего *) должно заканчиваться каноническим именем хоста этого объекта. Например, *.example.com подразумевает *.foo.example.com.
    • Если хост этого объекта не был инициализирован одним IP-адресом, один из IP-адресов этого объекта должен совпадать с одним из IP-адресов codesource либо каноническое имя хоста этого объекта должно совпадать с каноническим именем хоста codesource.
  • Если порт этого объекта (getLocation().getPort()) не равен -1 (то есть порт указан), он должен совпадать с портом codesource или портом по умолчанию (codesource.getLocation().getDefaultPort()).
  • Если файл этого объекта (getLocation().getFile()) не совпадает с файлом codesource, выполняются следующие проверки: если имя файла этого объекта заканчивается на "/-", имя файла codesource должно начинаться с имени файла этого объекта (без завершающего "-"). Если имя файла этого объекта заканчивается на "/*", имя файла codesource должно начинаться с имени файла этого объекта и не должно содержать дополнительных разделителей "/". Если имя файла этого объекта не заканчивается на "/", имя файла codesource должно совпадать с именем файла этого объекта с добавленным в конце символом '/'.
  • Если ссылка этого объекта (getLocation().getRef()) не равна null, она должна совпадать со ссылкой codesource.

Например, объекты codesource со следующими местоположениями и сертификатами null подразумевают codesource с местоположением http://www.example.com/classes/foo.jar и сертификатами null:

    http:
    http://*.example.com/classes/*
    http://www.example.com/classes/-
    http://www.example.com/classes/foo.jar

Обратите внимание: если этот CodeSource имеет местоположение null и цепочку сертификатов null, он подразумевает все остальные CodeSource.

public String toString()

Возвращает строку с описанием этого CodeSource, содержащую сведения о его URL и сертификатах.