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

javax.faces.webapp
Класс FacesServlet

java.lang.Object
  javax.faces.webapp.FacesServlet

Все Реализованные Интерфейсы:

Сервлет

public final class FacesServlet
расширяет java.lang. Объект
Сервлет реализаций

FacesServlet является сервлетом, который управляет жизненным циклом обработки запросов для веб-приложений, которые используют Поверхности JavaServer, чтобы создать пользовательский интерфейс.

Если приложение работает в Сервлете 3.0 (и вне) контейнер, время выполнения должно обеспечить реализацию ServletContainerInitializer интерфейс, который объявляет следующие классы в HandlesTypes аннотация.

• ResourceDependencies
• ResourceDependency
• javax.faces.bean. ManagedBean
• FacesComponent
• UIComponent
• Converter
• FacesConverter
• ListenerFor
• ListenersFor
• FacesBehaviorRenderer
• Renderer
• FacesValidator
• Validator

Этот сервлет должен автоматически быть отображен, если он явно не отображается в web.xml или web-fragment.xml и один или больше следующих условий истина.

• A faces-config.xml файл находится в WEB-INF

• A faces-config.xml файл находится в META-INF каталог фляги в пути к классу приложения.

• Имя файла, заканчивающееся в .faces-config.xml находится в META-INF каталог фляги в пути к классу приложения.

• javax.faces.CONFIG_FILES контекст param объявляется в web.xml или web-fragment.xml.

• Set из классов, которые передают к onStartup() метод ServletContainerInitializer реализация не пуста.

Если время выполнения решает, что сервлет должен быть автоматически отображен, это должно быть отображено на следующий <url-pattern> записи.

• / поверхности
• *.jsf
• *.faces

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

static java.lang.String	CONFIG_FILES_ATTR Название параметра инициализации контекста для запятой разграниченный список контекстно-зависимых путей ресурса (в дополнение к /WEB-INF/faces-config.xml который загружается автоматически, если это существует), содержащий конфигурационную информацию Поверхностей JavaServer.
static java.lang.String	LIFECYCLE_ID_ATTR Название параметра инициализации контекста для идентификатора жизненного цикла Lifecycle экземпляр, который будет использован.

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

FacesServlet()

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

void	destroy() Высвободите все средства, полученные во время запуска.
ServletConfig	getServletConfig() Возвратитесь ServletConfig экземпляр для этого сервлета.
java.lang.String	getServletInfo() Возвратите информацию об этом Сервлете.
void	init(ServletConfig servletConfig) Получите экземпляры фабрики, которых мы потребуем.
void	service(ServletRequest request, ServletResponse response) Обработайте входящий запрос, и создайте соответствующий ответ согласно следующей спецификации.

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

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

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

CONFIG_FILES_ATTR

public static final java.lang.String CONFIG_FILES_ATTR

Название параметра инициализации контекста для запятой разграниченный список контекстно-зависимых путей ресурса (в дополнение к /WEB-INF/faces-config.xml который загружается автоматически, если это существует), содержащий конфигурационную информацию Поверхностей JavaServer.

См. Также:

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

LIFECYCLE_ID_ATTR

public static final java.lang.String LIFECYCLE_ID_ATTR

Название параметра инициализации контекста для идентификатора жизненного цикла Lifecycle экземпляр, который будет использован.

См. Также:

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

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

FacesServlet

public FacesServlet()

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

уничтожить

public void destroy()

Высвободите все средства, полученные во время запуска.

Определенный:

destroy в интерфейсе Servlet

getServletConfig

public ServletConfig getServletConfig()

Возвратитесь ServletConfig экземпляр для этого сервлета.

Определенный:

getServletConfig в интерфейсе Servlet

Возвраты:

ServletConfig объект, который инициализирует этот сервлет

См. Также:

Servlet.init(javax.servlet.ServletConfig)

getServletInfo

public java.lang.String getServletInfo()

Возвратите информацию об этом Сервлете.

Определенный:

getServletInfo в интерфейсе Servlet

Возвраты:

a String содержа информацию о сервлете

init

public void init(ServletConfig servletConfig)
          throws ServletException

Получите экземпляры фабрики, которых мы потребуем.

Определенный:

init в интерфейсе Servlet

Параметры:

servletConfig - a ServletConfig объект, содержащий конфигурацию сервлета и параметры инициализации

Броски:

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

См. Также:

UnavailableException, Servlet.getServletConfig()

служба

public void service(ServletRequest request,
                    ServletResponse response)
             throws java.io.IOException,
                    ServletException

Обработайте входящий запрос, и создайте соответствующий ответ согласно следующей спецификации.

Если request и response параметрами этому методу не являются экземпляры HttpServletRequest и HttpServletResponse, соответственно, результаты вызова этого метода неопределены.

Этот метод должен ответить на запросы, которые запускаются со следующих строк, вызывая sendError метод на параметре ответа (бросок к HttpServletResponse), передача кода HttpServletResponse.SC_NOT_FOUND как параметр.

/WEB-INF/
/WEB-INF
/META-INF/
/META-INF

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

Получите a FacesContext экземпляр для этого запроса.

Получите ResourceHandler для этого запроса, вызывая Application.getResourceHandler(). Вызвать ResourceHandler.isResourceRequest(javax.faces.context.FacesContext). Если это возвращается true вызвать ResourceHandler.handleResourceRequest(javax.faces.context.FacesContext). Если это возвращается false, вызвать Lifecycle.execute(javax.faces.context.FacesContext) сопровождаемый Lifecycle.render(javax.faces.context.FacesContext). Если a FacesException бросается в любой случай, извлеките причину из FacesException. Если причина null извлеките сообщение из FacesException, вставьте это нового ServletException экземпляр, и передача FacesException экземпляр как первопричина, затем повторно бросьте ServletException экземпляр. Если причиной является экземпляр ServletException, повторно бросьте причину. Если причиной является экземпляр IOException, повторно бросьте причину. Иначе, создайте новое ServletException экземпляр, передавая сообщение от причины, как первый параметр, и причина непосредственно как второй параметр.

Реализация должна сделать это так FacesContext.release() вызывается в пределах наконец блок уже в возможном в обработке для JSF связанная часть этого запроса.

Определенный:

service в интерфейсе Servlet

Параметры:

request - Запрос сервлета мы обрабатываем

response - Ответ сервлета мы создаем

Броски:

java.io.IOException - если ввод/ошибка на выходе происходит во время обработки

ServletException - если ошибка сервлета происходит во время обработки