java.beans

Класс Introspector

java.lang. Объект

java.beans. Introspector

public class Introspector
extends Object

class Introspector обеспечивает стандартный путь к инструментам, чтобы узнать о свойствах, событиях, и методах, поддерживаемых целевым Бобом Java.

Для каждого из тех трех видов информации Introspector будет отдельно анализировать class боба и суперклассы, ища или явную или неявную информацию и использовать ту информацию, чтобы создать объект BeanInfo, который всесторонне описывает целевой боб.

Для каждого class "Foo" явная информация может быть доступной, если там существует соответствующий class "FooBeanInfo", который обеспечивает ненулевое значение когда запрошено для информации. Мы сначала ищем BeanInfo class, беря полное полностью определенное имя пакета целевого боба class и добавляя "BeanInfo", чтобы сформировать новое имя class. Если это перестало работать, то мы берем заключительный компонент имени класса этого имени, и ищем тот class в каждом из пакетов, определенных в пути поиска пакета BeanInfo.

Таким образом для class такой как "sun.xyz. OurButton" мы сначала искали бы BeanInfo class, вызванный "sun.xyz. OurButtonBeanInfo" и если это перестало работать, мы будем смотреть в каждом пакете в пути поиска BeanInfo для OurButtonBeanInfo class. С путем поиска значения по умолчанию это означало бы искать "sun.beans.infos. OurButtonBeanInfo".

Если class предоставляет явному BeanInfo о себе тогда, мы добавляем, что к информации о BeanInfo получили из анализа любых производных классов, но мы расцениваем явную информацию, как являющуюся категоричным для текущего class и его базовых классов, и не продолжаем дальше цепочку суперкласса.

Если мы не находим явный BeanInfo на class, мы используем низкоуровневое отражение, чтобы изучить методы class и применить стандартные шаблоны разработки, чтобы идентифицировать средства доступа свойства, источники событий, или открытые методы. Мы тогда продолжаем, чтобы проанализировать суперкласс class и добавить в информации от этого (и возможно на цепочке суперкласса).

Для получения дополнительной информации о самоанализе и шаблонах разработки, пожалуйста, консультируйтесь со спецификацией JavaBeans™.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	IGNORE_ALL_BEANINFO
static int	IGNORE_IMMEDIATE_BEANINFO
static int	USE_ALL_BEANINFO

Сводка метода

Модификатор и Тип	Метод и Описание
static String	decapitalize(String name) Служебный метод, чтобы взять строку и преобразовать это в нормальное написание прописными буквами имени переменной Java.
static void	flushCaches() Сбросьте все внутренние кэши Интроспектора.
static void	flushFromCaches(Class<?> clz) Сбросьте внутреннюю кэшируемую информацию Интроспектора для данного class.
static BeanInfo	getBeanInfo(Class<?> beanClass) Займитесь самоанализом на Бобе Java и узнайте обо всех его свойствах, представленных методах, и событиях.
static BeanInfo	getBeanInfo(Class<?> beanClass, Class<?> stopClass) Займитесь самоанализом на бобе Java и изучите все о его свойствах, представленных методах, ниже данной точки "остановки".
static BeanInfo	getBeanInfo(Class<?> beanClass, Class<?> stopClass, int flags) Займитесь самоанализом на Бобе Java и узнайте обо всех его свойствах, представленных методах и событиях, ниже данного stopClass укажите подвергающийся некоторому управлению flags.
static BeanInfo	getBeanInfo(Class<?> beanClass, int flags) Займитесь самоанализом на бобе Java и узнайте обо всех его свойствах, представленных методах, и событиях согласно некоторым флагам управления.
static String[]	getBeanInfoSearchPath() Получает список имен пакета, которые будут использоваться для того, чтобы найти классы BeanInfo.
static void	setBeanInfoSearchPath(String[] path) Измените список имен пакета, которые будут использоваться для того, чтобы найти классы BeanInfo.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

USE_ALL_BEANINFO

public static final int USE_ALL_BEANINFO

См. Также:

Постоянные Значения полей

IGNORE_IMMEDIATE_BEANINFO

public static final int IGNORE_IMMEDIATE_BEANINFO

См. Также:

Постоянные Значения полей

IGNORE_ALL_BEANINFO

public static final int IGNORE_ALL_BEANINFO

См. Также:

Постоянные Значения полей

Деталь метода

getBeanInfo

public static BeanInfo getBeanInfo(Class<?> beanClass)
                            throws IntrospectionException

Займитесь самоанализом на Бобе Java и узнайте обо всех его свойствах, представленных методах, и событиях.

Если BeanInfo, class для Боба Java ранее Анализировался тогда BeanInfo class, получается от кэша BeanInfo.

Параметры:

beanClass - Боб class, который будет проанализирован.

Возвраты:

Объект BeanInfo описание целевого боба.

Броски:

IntrospectionException - если исключение происходит во время самоанализа.

См. Также:

flushCaches(), flushFromCaches(java.lang.Class<?>)

getBeanInfo

public static BeanInfo getBeanInfo(Class<?> beanClass,
                                   int flags)
                            throws IntrospectionException

Займитесь самоанализом на бобе Java и узнайте обо всех его свойствах, представленных методах, и событиях согласно некоторым флагам управления.

Если BeanInfo, class для Боба Java ранее Анализировался основанный на тех же самых параметрах тогда BeanInfo class, получается от кэша BeanInfo.

Параметры:

beanClass - Боб class, который будет проанализирован.

flags - Флаги, чтобы управлять самоанализом. Если флаги == USE_ALL_BEANINFO тогда, мы используем все классы BeanInfo, которые мы можем обнаружить. Если флаги == IGNORE_IMMEDIATE_BEANINFO тогда мы игнорируем какой-либо BeanInfo, связанный с указанным beanClass. Если флаги == IGNORE_ALL_BEANINFO тогда мы игнорируем весь BeanInfo, связанный с указанным beanClass или каким-либо из его родительских классов.

Возвраты:

Объект BeanInfo описание целевого боба.

Броски:

IntrospectionException - если исключение происходит во время самоанализа.

getBeanInfo

public static BeanInfo getBeanInfo(Class<?> beanClass,
                                   Class<?> stopClass)
                            throws IntrospectionException

Займитесь самоанализом на бобе Java и изучите все о его свойствах, представленных методах, ниже данной точки "остановки".

Если BeanInfo, class для Боба Java ранее Анализировался основанный на тех же самых параметрах, то BeanInfo class получается от кэша BeanInfo.

Параметры:

beanClass - Боб class, который будет проанализирован.

stopClass - Базовый класс, в котором можно остановить анализ. Любые методы/свойства/события в stopClass или в его базовых классах будут проигнорированы в анализе.

Броски:

IntrospectionException - если исключение происходит во время самоанализа.

getBeanInfo

public static BeanInfo getBeanInfo(Class<?> beanClass,
                                   Class<?> stopClass,
                                   int flags)
                            throws IntrospectionException

Займитесь самоанализом на Бобе Java и узнайте обо всех его свойствах, представленных методах и событиях, ниже данного stopClass укажите подвергающийся некоторому управлению flags.

USE_ALL_BEANINFO

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

IGNORE_IMMEDIATE_BEANINFO

Любой BeanInfo связался с указанным beanClass будет проигнорирован.

IGNORE_ALL_BEANINFO

Любой BeanInfo связался с указанным beanClass или любой из его родительских классов будет проигнорирован.

Любые методы/свойства/события в stopClass или в его родительских классах будет проигнорирован в анализе.

Если BeanInfo, class для Боба Java ранее анализировался основанный на тех же самых параметрах тогда BeanInfo class, получается от кэша BeanInfo.

Параметры:

beanClass - боб class, который будет проанализирован

stopClass - родительский class, в котором можно остановить анализ

flags - флаги, чтобы управлять самоанализом

Возвраты:

объект BeanInfo описание целевого боба

Броски:

IntrospectionException - если исключение происходит во время самоанализа

С тех пор:

1.7

decapitalize

public static String decapitalize(String name)

Служебный метод, чтобы взять строку и преобразовать это в нормальное написание прописными буквами имени переменной Java. Это обычно означает преобразовывать первый символ от верхнего регистра до нижнего регистра, но в (необычном) особом случае, когда есть больше чем один символ, и и первые и вторые символы являются верхним регистром, мы оставляем это в покое.

Таким образом "FooBah" становится "fooBah", и "X" становится "x", но "URL" остается как "URL".

Параметры:

name - Строка, чтобы быть decapitalized.

Возвраты:

decapitalized версия строки.

getBeanInfoSearchPath

public static String[] getBeanInfoSearchPath()

Получает список имен пакета, которые будут использоваться для того, чтобы найти классы BeanInfo.

Возвраты:

Массив имен пакета, которые будут искаться, чтобы найти классы BeanInfo. Значение по умолчанию для этого массива является зависящим от реализации; например, реализация Sun первоначально устанавливает в {"sun.beans.infos"}.

setBeanInfoSearchPath

public static void setBeanInfoSearchPath(String[] path)

Измените список имен пакета, которые будут использоваться для того, чтобы найти классы BeanInfo. Поведение этого метода неопределено, если путь параметра является нулем.

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

Параметры:

path - Массив имен пакета.

Броски:

SecurityException - если менеджер безопасности существует и checkPropertiesAccess метод не позволяет устанавливать системных свойств.

См. Также:

SecurityManager.checkPropertiesAccess()

flushCaches

public static void flushCaches()

Сбросьте все внутренние кэши Интроспектора. Этот метод обычно не требуется. Это обычно только необходимо усовершенствованным инструментам, которые обновляют существующие оперативные объекты "Класса" и должны заставить Introspector повторно проанализировать существующие объекты Класса.

flushFromCaches

public static void flushFromCaches(Class<?> clz)

Сбросьте внутреннюю кэшируемую информацию Интроспектора для данного class. Этот метод обычно не требуется. Это обычно только необходимо усовершенствованным инструментам, которые обновляют существующие оперативные объекты "Класса" и должны заставить Introspector повторно проанализировать существующий объект Класса. Отметьте, что только прямое состояние, связанное с целевым объектом Класса, сбрасывается. Мы не сбрасываем состояние для других объектов Класса с тем же самым именем, и при этом мы не сбрасываем состояние для любых связанных объектов Класса (таких как подклассы), даже при том, что их состояние может включать информацию, косвенно полученную из целевого объекта Класса.

Параметры:

clz - Объект класса, который будет сброшен.

Броски:

NullPointerException - Если объект Класса является нулем.