Spec-Zone .ru спецификации, руководства, описания, API

javax.faces.render
Класс RenderKit

java.lang.Object
  javax.faces.render.RenderKit

Прямые Известные Подклассы:

RenderKitWrapper

public abstract class RenderKit
расширяет java.lang. Объект

RenderKit представляет набор Renderer экземпляры, которые, вместе, знают, как представить Поверхности JavaServer UIComponent экземпляры для определенного клиента. Как правило, RenderKits специализируются для некоторой комбинации типа клиентского устройства, языка разметки, и/или пользователя Locale. A RenderKit также действия как Фабрика для связанного Renderer экземпляры, которые выполняют фактический процесс рендеринга для каждого компонента.

Типичная реализация Поверхностей JavaServer сконфигурирует один или больше RenderKit экземпляры при запуске веб-приложения. Они делаются доступными посредством звонков getRenderKit() методы RenderKitFactory. Поскольку RenderKit экземпляры совместно используются, они должны быть реализованы ориентированным на многопотоковое исполнение способом. Из-за ограничений в текущей спецификации, имеющей многократный RenderKit экземпляры в действии в том же самом приложении требуют пользовательского ViewHandler экземпляр, который знает, как иметь дело с этим случаем. Это ограничение будет снято в будущей версии спецификации.

RenderKit экземпляр должен также продать a ResponseStateManager экземпляр, который используется в процессе сохранения и восстановления древовидной структуры и состояния.

Сводка конструктора

RenderKit()

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

void	addClientBehaviorRenderer(java.lang.String type, ClientBehaviorRenderer renderer) Зарегистрируйте указанное ClientBehaviorRenderer экземпляр, связанный с указанным компонентом type, к набору ClientBehaviorRenderers зарегистрированный в этом RenderKit, замена любого ранее зарегистрировалась ClientBehaviorRenderer для этого типа.
abstract void	addRenderer(java.lang.String family, java.lang.String rendererType, Renderer renderer) Зарегистрируйте указанное Renderer экземпляр, связанный с указанным компонентом family и rendererType, к набору Renderers зарегистрированный в этом RenderKit, замена любого ранее зарегистрировалась Renderer для этой комбинации идентификаторов.
abstract ResponseStream	createResponseStream(java.io.OutputStream out) Используйте обеспеченный OutputStream создать новое ResponseStream экземпляр.
abstract ResponseWriter	createResponseWriter(java.io.Writer writer, java.lang.String contentTypeList, java.lang.String characterEncoding) Используйте обеспеченный Writer создать новое ResponseWriter экземпляр для указанного (дополнительного) типа контента, и кодировка символов.
ClientBehaviorRenderer	getClientBehaviorRenderer(java.lang.String type) Возвратитесь ClientBehaviorRenderer экземпляр последний раз зарегистрировался для указанного type, если любой; иначе, возвратиться null.
java.util.Iterator<java.lang.String>	getClientBehaviorRendererTypes() Возвратитесь Iterator по ClientBehaviorRenderer типы.
java.util.Iterator<java.lang.String>	getComponentFamilies() Возвратитесь Iterator по записям компонентного семейства, поддерживаемым этим RenderKit экземпляр.
abstract Renderer	getRenderer(java.lang.String family, java.lang.String rendererType) Возвратитесь Renderer экземпляр последний раз зарегистрировался для указанного компонента family и rendererType, если любой; иначе, возвратиться null.
java.util.Iterator<java.lang.String>	getRendererTypes(java.lang.String componentFamily) Возвратитесь Iterator по записям типа средства рендеринга для данного компонентного семейства.
abstract ResponseStateManager	getResponseStateManager() Возвратите экземпляр ResponseStateManager обработать технологию рендеринга определенные решения управления состоянием.

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

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

Деталь конструктора

RenderKit

public RenderKit()

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

addRenderer

public abstract void addRenderer(java.lang.String family,
                                 java.lang.String rendererType,
                                 Renderer renderer)

Зарегистрируйте указанное Renderer экземпляр, связанный с указанным компонентом family и rendererType, к набору Renderers зарегистрированный в этом RenderKit, замена любого ранее зарегистрировалась Renderer для этой комбинации идентификаторов.

Параметры:

family - Компонентное семейство Renderer зарегистрироваться

rendererType - Тип средства рендеринга Renderer зарегистрироваться

renderer - Renderer экземпляр мы регистрируемся

Броски:

java.lang.NullPointerException - если family или rendererType или renderer нуль

getRenderer

public abstract Renderer getRenderer(java.lang.String family,
                                     java.lang.String rendererType)

Возвратитесь Renderer экземпляр последний раз зарегистрировался для указанного компонента family и rendererType, если любой; иначе, возвратиться null.

Параметры:

family - Компонентное семейство требуемого Renderer экземпляр

rendererType - Тип средства рендеринга требуемого Renderer экземпляр

Броски:

java.lang.NullPointerException - если family или rendererType null

getResponseStateManager

public abstract ResponseStateManager getResponseStateManager()

Возвратите экземпляр ResponseStateManager обработать технологию рендеринга определенные решения управления состоянием.

createResponseWriter

public abstract ResponseWriter createResponseWriter(java.io.Writer writer,
                                                    java.lang.String contentTypeList,
                                                    java.lang.String characterEncoding)

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

Конструкторам советуют консультироваться getCharacterEncoding() метод class ServletResponse получить необходимое значение для characterEncoding для этого метода. Начиная с Writer поскольку этот ответ будет уже получен (из-за этого в конечном счете передаваемый к этому методу), мы знаем, что кодировка символов не может измениться во время рендеринга ответа.

Параметры:

writer - Писатель тот, вокруг который это ResponseWriter должен быть создан.

contentTypeList - "Принимают список" стиля заголовка типов контента для этого ответа, или null если RenderKit должен выбрать лучшую подгонку. С текущей версии значения, принятые Стандартным представлять-набором для этого параметра, включают, любой допустимый "Принимает Строку" стиля заголовка, которая включает Строку text/html, application/xhtml+xml, application/xml или text/xml. Это может измениться в будущей версии. RenderKit должен поддерживать значение для этого параметра, который прибывает прямо из Accept HTTP-заголовок, и поэтому требует парсинга согласно спецификации Accept заголовок. Пожалуйста, см. Раздел 14.1 из RFC 2616 для спецификации Accept заголовок.

characterEncoding - такой как "ISO-8859-1" для этого ResponseWriter, или null если RenderKit должен выбрать лучшую подгонку. Пожалуйста, см. IANA для списка кодировок символов.

Возвраты:

новое ResponseWriter.

Броски:

IllegalArgumentException - если никакой тип контента соответствия не может быть найден в contentTypeList, никакой соответствующий тип контента не может быть найден с зависящим от реализации лучшим пригодным алгоритмом, или никакая кодировка символов соответствия не может быть найдена для параметра characterEncoding.

createResponseStream

public abstract ResponseStream createResponseStream(java.io.OutputStream out)

Используйте обеспеченный OutputStream создать новое ResponseStream экземпляр.

getComponentFamilies

public java.util.Iterator<java.lang.String> getComponentFamilies()

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

Реализация по умолчанию этого метода возвращает пустое Iterator

С тех пор:

2.0

getRendererTypes

public java.util.Iterator<java.lang.String> getRendererTypes(java.lang.String componentFamily)

Возвратитесь Iterator по записям типа средства рендеринга для данного компонентного семейства.

Если указанное componentFamily не известен этому RenderKit реализация, возвратите пустое Iterator

Реализация по умолчанию этого метода возвращает пустое Iterator

Параметры:

componentFamily - один из элементов Iterator возвращенный getComponentFamilies().

С тех пор:

2.0

addClientBehaviorRenderer

public void addClientBehaviorRenderer(java.lang.String type,
                                      ClientBehaviorRenderer renderer)

Зарегистрируйте указанное ClientBehaviorRenderer экземпляр, связанный с указанным компонентом type, к набору ClientBehaviorRenderers зарегистрированный в этом RenderKit, замена любого ранее зарегистрировалась ClientBehaviorRenderer для этого типа.

Параметры:

type - тип ClientBehaviorRenderer зарегистрироваться

renderer - ClientBehaviorRenderer экземпляр мы регистрируемся

Броски:

java.lang.NullPointerException - если type или renderer нуль

С тех пор:

2.0

getClientBehaviorRenderer

public ClientBehaviorRenderer getClientBehaviorRenderer(java.lang.String type)

Возвратитесь ClientBehaviorRenderer экземпляр последний раз зарегистрировался для указанного type, если любой; иначе, возвратиться null.

Параметры:

type - тип требуемого ClientBehaviorRenderer экземпляр

Броски:

java.lang.NullPointerException - если type null

С тех пор:

2.0

getClientBehaviorRendererTypes

public java.util.Iterator<java.lang.String> getClientBehaviorRendererTypes()

Возвратитесь Iterator по ClientBehaviorRenderer типы.

С тех пор:

2.0