Introspector (Платформа Java SE 7)

java.lang. Объект
- java.beans. Introspector

```
public class Introspector
extends Object
```
Класс Introspector обеспечивает стандартный путь к инструментам, чтобы узнать о свойствах, событиях, и методах, поддерживаемых целевым Бобом Java.
Для каждого из тех трех видов информации Introspector будет отдельно анализировать класс боба и суперклассы, ища или явную или неявную информацию и использовать ту информацию, чтобы создать объект BeanInfo, который всесторонне описывает целевой боб.
Для каждого класса "Foo" явная информация может быть доступной, если там существует соответствующий класс "FooBeanInfo", который обеспечивает ненулевое значение когда запрошено для информации. Мы сначала ищем класс BeanInfo, беря полное полностью определенное имя пакета целевого бобового класса и добавляя "BeanInfo", чтобы сформировать новое имя класса. Если это перестало работать, то мы берем заключительный компонент имени класса этого имени, и ищем тот класс в каждом из пакетов, определенных в пути поиска пакета BeanInfo.
Таким образом для класса такой как "sun.xyz. OurButton" мы сначала искали бы класс BeanInfo, вызванный "sun.xyz. OurButtonBeanInfo" и если это перестало работать, мы будем смотреть в каждом пакете в пути поиска BeanInfo для класса OurButtonBeanInfo. С путем поиска по умолчанию это означало бы искать "sun.beans.infos. OurButtonBeanInfo".
Если класс предоставляет явному BeanInfo о себе тогда, мы добавляем, что к информации о BeanInfo получили из анализа любых производных классов, но мы расцениваем явную информацию, как являющуюся категоричным для текущего класса и его базовых классов, и не продолжаем дальше цепочку суперкласса.
Если мы не находим явный BeanInfo на классе, мы используем низкоуровневое отражение, чтобы изучить методы класса и применить стандартные шаблоны разработки, чтобы идентифицировать средства доступа свойства, источники событий, или открытые методы. Мы тогда продолжаем, чтобы проанализировать суперкласс класса и добавить в информации от этого (и возможно на цепочке суперкласса).
Для получения дополнительной информации о самоанализе и шаблонах разработки, пожалуйста, консультируйтесь со спецификацией JavaBeans™.

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

Поля
Модификатор и Тип Поле и Описание

static int IGNORE_ALL_BEANINFO

static int IGNORE_IMMEDIATE_BEANINFO

static int USE_ALL_BEANINFO

Поля
Модификатор и Тип	Поле и Описание
`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)` Сбросьте внутреннюю кэшируемую информацию Интроспектора для данного класса.
`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.

Методы 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 для Боба Java ранее Анализировался тогда, класс BeanInfo получается от кэша BeanInfo.
    
    Параметры:
    beanClass - Бобовый класс, который будет проанализирован.
    
    Возвраты:
    Объект BeanInfo описание целевого боба.
    
    Броски:
    
    IntrospectionException - если исключение происходит во время самоанализа.
    См. Также:
    flushCaches(), flushFromCaches(java.lang.Class<?>)
  - getBeanInfo
```
public static BeanInfo getBeanInfo(Class<?> beanClass,
                   int flags)
                            throws IntrospectionException
```
    Займитесь самоанализом на бобе Java и узнайте обо всех его свойствах, представленных методах, и событиях согласно некоторым флагам управления.
    Если класс BeanInfo для Боба Java ранее Анализировался основанный на тех же самых параметрах тогда, класс BeanInfo получается от кэша BeanInfo.
    
    Параметры:
    beanClass - Бобовый класс, который будет проанализирован.
    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 для Боба Java ранее Анализировался основанный на тех же самых параметрах, то класс BeanInfo получается от кэша BeanInfo.
    
    Параметры:
    beanClass - Бобовый класс, который будет проанализирован.
    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 для Боба Java ранее анализировался основанный на тех же самых параметрах тогда, класс BeanInfo получается от кэша BeanInfo.
    
    Параметры:
    beanClass - бобовый класс, который будет проанализирован
    stopClass - родительский класс, в котором можно остановить анализ
    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)
```
    Сбросьте внутреннюю кэшируемую информацию Интроспектора для данного класса. Этот метод обычно не требуется. Это обычно только необходимо усовершенствованным инструментам, которые обновляют существующие оперативные объекты "Класса" и должны заставить Introspector повторно проанализировать существующий объект Класса. Отметьте, что только прямое состояние, связанное с целевым объектом Класса, сбрасывается. Мы не сбрасываем состояние для других объектов Класса с тем же самым именем, и при этом мы не сбрасываем состояние для любых связанных объектов Класса (таких как подклассы), даже при том, что их состояние может включать информацию, косвенно полученную из целевого объекта Класса.
    
    Параметры:
    clz - Объект класса, который будет сброшен.
    
    Броски:
    
    NullPointerException - Если объект Класса является нулем.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс Introspector

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

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

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

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

USE_ALL_BEANINFO

IGNORE_IMMEDIATE_BEANINFO

IGNORE_ALL_BEANINFO

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

getBeanInfo

getBeanInfo

getBeanInfo

getBeanInfo

decapitalize

getBeanInfoSearchPath

setBeanInfoSearchPath

flushCaches

flushFromCaches