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


javax.servlet
Интерфейс ServletContext


public interface ServletContext

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

Есть один контекст на "веб-приложение" на виртуальную машину Java. ("Веб-приложение" является набором сервлетов и контента, установленного под определенным подмножеством пространства имен URL сервера такой как /catalog и возможно установленный через a .war файл.)

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

ServletContext объект содержится в пределах ServletConfig объект, который веб-сервер обеспечивает сервлет, когда сервлет инициализируется.

Автор:
Различный
См. Также:
Servlet#getServletConfig, ServletConfig#getServletContext

Полевая Сводка
static java.lang.String ORDERED_LIBS
          Имя ServletContext припишите чье значение (типа java.util.List<java.lang.String>) содержит список имен файлов JAR в WEB-INF/lib упорядоченный их веб-именами фрагмента (с возможными исключениями, если <absolute-ordering> ни с кем <others/> используется), или нуль, если никакое абсолютное или относительное упорядочивание не было определено
static java.lang.String TEMPDIR
          Имя атрибута ServletContext, который хранит частный временный каталог (типа java.io.File) обеспеченный контейнером сервлета для ServletContext
 
Сводка метода
 FilterRegistration. Динамичный addFilter(java.lang.String filterName, java.lang.Class<? extends Filter> filterClass)
          Добавляет фильтр с именем и типом class к этому контексту сервлета.
 FilterRegistration. Динамичный addFilter(java.lang.String filterName, Filter filter)
          Регистрирует приведенный пример фильтра в этом ServletContext под данным filterName.
 FilterRegistration. Динамичный addFilter(java.lang.String filterName, java.lang.String className)
          Добавляет фильтр с именем и именем class к этому контексту сервлета.
 void addListener(java.lang.Class<? extends java.util.EventListener> listenerClass)
          Добавляет слушатель данного типа class к этому ServletContext.
 void addListener(java.lang.String className)
          Добавляет слушатель с данным именем class к этому ServletContext.
<T extends java.util.EventListener>
void
addListener(T t)
          Добавляет данный слушатель этого ServletContext.
 ServletRegistration. Динамичный addServlet(java.lang.String servletName, java.lang.Class<? extends Servlet> servletClass)
          Добавляет сервлет с именем и типом class к этому контексту сервлета.
 ServletRegistration. Динамичный addServlet(java.lang.String servletName, Servlet servlet)
          Регистрирует приведенный пример сервлета в этом ServletContext под данным servletName.
 ServletRegistration. Динамичный addServlet(java.lang.String servletName, java.lang.String className)
          Добавляет сервлет с именем и именем class к этому контексту сервлета.
<T extends Filter>
T
createFilter(java.lang.Class<T> clazz)
          Инстанцирует данного Фильтра class.
<T extends java.util.EventListener>
T
createListener(java.lang.Class<T> clazz)
          Инстанцирует данного EventListener class.
<T extends Servlet>
T
createServlet(java.lang.Class<T> clazz)
          Инстанцирует данного Сервлета class.
 void declareRoles(java.lang.String... roleNames)
          Объявляет ролевые имена, которые тестируются, используя isUserInRole.
 java.lang.Object getAttribute(java.lang.String name)
          Возвращает атрибут контейнера сервлета с именем, или null если нет никакого атрибута тем именем.
 java.util.Enumeration<java.lang.String> getAttributeNames()
          Возвраты Enumeration содержа названия атрибута, доступные в пределах этого ServletContext.
 java.lang.ClassLoader getClassLoader()
          Получает загрузчик class веб-приложения, представленного этим ServletContext.
 ServletContext getContext(java.lang.String uripath)
          Возвраты a ServletContext объект, который соответствует указанному URL на сервере.
 java.lang.String getContextPath()
          Возвращает путь контекста веб-приложения.
 java.util.Set<SessionTrackingMode> getDefaultSessionTrackingModes()
          Получает режимы отслеживания сеанса, которые поддерживаются по умолчанию для этого ServletContext.
 int getEffectiveMajorVersion()
          Получает основную версию спецификации Сервлета, на которой приложение, представленное этим ServletContext, основано.
 int getEffectiveMinorVersion()
          Получает вспомогательную версию спецификации Сервлета, на которой приложение, представленное этим ServletContext, основано.
 java.util.Set<SessionTrackingMode> getEffectiveSessionTrackingModes()
          Получает режимы отслеживания сеанса, которые являются в действительности для этого ServletContext.
 FilterRegistration getFilterRegistration(java.lang.String filterName)
          Получает FilterRegistration, соответствующий фильтру с данным filterName.
 java.util.Map<java.lang.String,? extends FilterRegistration> getFilterRegistrations()
          Становится (возможно пустым) Карта объектов FilterRegistration (включенный именем фильтра) соответствующий всем фильтрам, зарегистрированным в этом ServletContext.
 java.lang.String getInitParameter(java.lang.String name)
          Возвраты a String содержа значение именованного параметра инициализации всего контекста, или null если параметр не существует.
 java.util.Enumeration<java.lang.String> getInitParameterNames()
          Возвращает имена параметров инициализации контекста как Enumeration из String объекты, или пустое Enumeration если у контекста нет никаких параметров инициализации.
 JspConfigDescriptor getJspConfigDescriptor()
          Добирается <jsp-config> связанная конфигурация, которая была агрегирована от web.xml и web-fragment.xml файлы дескриптора веб-приложения представляются этим ServletContext.
 int getMajorVersion()
          Возвращает основную версию API Сервлета, который поддерживает этот контейнер сервлета.
 java.lang.String getMimeType(java.lang.String file)
          Возвращает тип MIME указанного файла, или null если тип MIME не известен.
 int getMinorVersion()
          Возвращает вспомогательную версию API Сервлета, который поддерживает этот контейнер сервлета.
 RequestDispatcher getNamedDispatcher(java.lang.String name)
          Возвраты a RequestDispatcher возразите что действия как обертка для именованного сервлета.
 java.lang.String getRealPath(java.lang.String path)
          Получает реальный путь, соответствующий данному виртуальному пути.
 RequestDispatcher getRequestDispatcher(java.lang.String path)
          Возвраты a RequestDispatcher возразите что действия как обертка для ресурса, расположенного в данном пути.
 java.net.URL getResource(java.lang.String path)
          Возвращает URL ресурсу, который отображается на данный путь.
 java.io.InputStream getResourceAsStream(java.lang.String path)
          Возвращает ресурс, расположенный в именованном пути как InputStream объект.
 java.util.Set<java.lang.String> getResourcePaths(java.lang.String path)
          Возвращает подобное каталогу перечисление всех путей к ресурсам в пределах веб-приложения, самый длинный подпуть которого соответствует предоставленный параметр пути.
 java.lang.String getServerInfo()
          Возвращает имя и версию контейнера сервлета, на котором работает сервлет.
 Сервлет getServlet(java.lang.String name)
          Осуждаемый. С API Сервлета Java 2.1, без прямой замены.

Этот метод был первоначально определен, чтобы получить сервлет от a ServletContext. В этой версии всегда возвращается этот метод null и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.

Вместо этого метода, сервлеты могут поделиться информацией, используя ServletContext class и может выполнить совместно использованную бизнес-логику, вызывая методы на общие классы несервлета.

 java.lang.String getServletContextName()
          Возвращает имя этого веб-приложения, соответствующего этому ServletContext как определено в дескрипторе развертывания для этого веб-приложения элементом имени дисплея.
 java.util.Enumeration<java.lang.String> getServletNames()
          Осуждаемый. С API Сервлета Java 2.1, без замены.

Этот метод был первоначально определен, чтобы возвратиться Enumeration из всего сервлета называет известным этому контексту. В этой версии этот метод всегда возвращает пустое Enumeration и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.

 ServletRegistration getServletRegistration(java.lang.String servletName)
          Получает ServletRegistration, соответствующий сервлету с данным servletName.
 java.util.Map<java.lang.String,? extends ServletRegistration> getServletRegistrations()
          Становится (возможно пустым) Карта объектов ServletRegistration (включенный именем сервлета) соответствующий всем сервлетам, зарегистрированным в этом ServletContext.
 java.util.Enumeration<Servlet> getServlets()
          Осуждаемый. С API Сервлета Java 2.0, без замены.

Этот метод был первоначально определен, чтобы возвратиться Enumeration из всех сервлетов, известных этому контексту сервлета. В этой версии этот метод всегда возвращает пустое перечисление и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.

 SessionCookieConfig getSessionCookieConfig()
          Добирается SessionCookieConfig объект, через который могут быть сконфигурированы различные свойства cookie отслеживания сеанса, создаваемых от имени этого ServletContext.
 void log(java.lang.Exception exception, java.lang.String msg)
          Осуждаемый. С API Сервлета Java 2.1, использовать log(String message, Throwable throwable) вместо этого.

Этот метод был первоначально определен, чтобы записать трассировку стека исключения и объяснительное сообщение об ошибке к файлу журнала сервлета.

 void log(java.lang.String msg)
          Пишут указанное сообщение в файл журнала сервлета, обычно журнал событий.
 void log(java.lang.String message, java.lang.Throwable throwable)
          Пишут объяснительное сообщение и трассировка стека для данного Throwable исключение к файлу журнала сервлета.
 void removeAttribute(java.lang.String name)
          Удаляет атрибут с именем из этого ServletContext.
 void setAttribute(java.lang.String name, java.lang.Object object)
          Связывает объект с данным названием атрибута в этом ServletContext.
 boolean setInitParameter(java.lang.String name, java.lang.String value)
          Устанавливает параметры инициализации контекста с именем и значением на этом ServletContext.
 void setSessionTrackingModes(java.util.Set<SessionTrackingMode> sessionTrackingModes)
          Устанавливает режимы отслеживания сеанса, которые должны вступить в силу для этого ServletContext.
 

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

TEMPDIR

static final java.lang.String TEMPDIR
Имя атрибута ServletContext, который хранит частный временный каталог (типа java.io.File) обеспеченный контейнером сервлета для ServletContext

См. Также:
Постоянные Значения полей

ORDERED_LIBS

static final java.lang.String ORDERED_LIBS
Имя ServletContext припишите чье значение (типа java.util.List<java.lang.String>) содержит список имен файлов JAR в WEB-INF/lib упорядоченный их веб-именами фрагмента (с возможными исключениями, если <absolute-ordering> ни с кем <others/> используется), или нуль, если никакое абсолютное или относительное упорядочивание не было определено

См. Также:
Постоянные Значения полей
Деталь метода

getContextPath

java.lang.String getContextPath()
Возвращает путь контекста веб-приложения.

Путь контекста является частью URI запроса, который используется, чтобы выбрать контекст запроса. Путь контекста всегда на первом месте в URI запроса. Путь запускается с символа /, но не заканчивается символом /. Для сервлетов в значении по умолчанию (корень) контекст этот метод возвращается "".

Возможно, что контейнер сервлета может соответствовать контекст больше чем одним путем контекста. В таких случаях HttpServletRequest.getContextPath() возвратит фактический путь контекста, используемый запросом, и это может отличаться от пути, возвращенного этим методом. Путь контекста, возвращенный этим методом, нужно рассмотреть как главный или привилегированный путь контекста приложения.

Возвраты:
Путь контекста веб-приложения, или "" для значения по умолчанию (корень) контекст
С тех пор:
Сервлет 2.5
См. Также:
HttpServletRequest.getContextPath()

getContext

ServletContext getContext(java.lang.String uripath)
Возвраты a ServletContext объект, который соответствует указанному URL на сервере.

Этот метод позволяет сервлетам получать доступ к контексту для различных частей сервера, и как необходимый получать RequestDispatcher объекты от контекста. Данный путь должен быть, начинаются с /, интерпретируется относительно корня документа сервера и соответствующий против корней контекста других веб-приложений, размещенных на этом контейнере.

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

Параметры:
uripath - a String определение пути контекста другого веб-приложения в контейнере.
Возвраты:
ServletContext объект, который соответствует именованному URL, или нуль, если или ни один не существует или контейнер, хочет ограничить этот доступ.
См. Также:
RequestDispatcher

getMajorVersion

int getMajorVersion()
Возвращает основную версию API Сервлета, который поддерживает этот контейнер сервлета. У всех реализаций, которые выполняют Версию 3.0, должен быть этот возврат метода целое число 3.

Возвраты:
3

getMinorVersion

int getMinorVersion()
Возвращает вспомогательную версию API Сервлета, который поддерживает этот контейнер сервлета. У всех реализаций, которые выполняют Версию 3.0, должен быть этот возврат метода целое число 0.

Возвраты:
0

getEffectiveMajorVersion

int getEffectiveMajorVersion()
Получает основную версию спецификации Сервлета, на которой приложение, представленное этим ServletContext, основано.

Возвращенное значение может отличаться от getMajorVersion(), который возвращает основную версию спецификации Сервлета, поддерживаемой контейнером Сервлета.

Возвраты:
основная версия спецификации Сервлета, на которой приложение, представленное этим ServletContext, основано
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getEffectiveMinorVersion

int getEffectiveMinorVersion()
Получает вспомогательную версию спецификации Сервлета, на которой приложение, представленное этим ServletContext, основано.

Возвращенное значение может отличаться от getMinorVersion(), который возвращает вспомогательную версию спецификации Сервлета, поддерживаемой контейнером Сервлета.

Возвраты:
вспомогательная версия спецификации Сервлета, на которой приложение xrepresented этим ServletContext основано
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getMimeType

java.lang.String getMimeType(java.lang.String file)
Возвращает тип MIME указанного файла, или null если тип MIME не известен. Тип MIME определяется конфигурацией контейнера сервлета, и может быть определен в дескрипторе развертывания веб-приложения. Общие типы MIME включают text/html и image/gif.

Параметры:
file - a String определение имени файла
Возвраты:
a String определение типа MIME файла

getResourcePaths

java.util.Set<java.lang.String> getResourcePaths(java.lang.String path)
Возвращает подобное каталогу перечисление всех путей к ресурсам в пределах веб-приложения, самый длинный подпуть которого соответствует предоставленный параметр пути.

Пути, указывающие на пути подкаталога, заканчиваются /.

Возвращенные пути - все относительно корня веб-приложения, или относительно каталога /META-INF/resources файла JAR в каталоге /WEB-INF/lib веб-приложения, и имеют ведущий /.

Например, для веб-приложения, содержащего:

   /welcome.html
   /catalog/index.html
   /catalog/products.html
   /catalog/offers/books.html
   /catalog/offers/music.html
   /customer/login.jsp
   /WEB-INF/web.xml
   /WEB-INF/classes/com.acme.OrderServlet.class
   /WEB-INF/lib/catalog.jar!/META-INF/resources/catalog/moreOffers/books.html
 
getResourcePaths("/") возвратил бы {"/welcome.html", "/catalog/", "/customer/", "/WEB-INF/"}, и getResourcePaths("/catalog/") возвратит {"/catalog/index.html", "/catalog/products.html", "/catalog/offers/", "/catalog/moreOffers/"}.

Параметры:
path - частичный путь, используемый, чтобы соответствовать ресурсы, которые должны запуститься с /
Возвраты:
Набор, содержащий перечисление каталога, или нуль, если нет никаких ресурсов в веб-приложении, путь которого начинается с предоставленного пути.
С тех пор:
Сервлет 2.3

getResource

java.net.URL getResource(java.lang.String path)
                         throws java.net.MalformedURLException
Возвращает URL ресурсу, который отображается на данный путь.

Путь должен начаться с / и интерпретируется как относительно текущего корня контекста, или относительно каталога /META-INF/resources файла JAR в каталоге /WEB-INF/lib веб-приложения. Этот метод будет сначала искать корень документа веб-приложения для требуемого ресурса, прежде, чем искать любой из файлов JAR в /WEB-INF/lib. Порядок, в котором ищутся файлы JAR в /WEB-INF/lib, неопределен.

Этот метод позволяет контейнеру сервлета делать ресурс доступным для сервлетов из любого источника. Ресурсы могут быть расположены на локальной файловой системе или удаленной файловой системе в базе данных, или в a .war файл.

Контейнер сервлета должен реализовать обработчики URL и URLConnection объекты, которые необходимы, чтобы получить доступ к ресурсу.

Этот метод возвраты null если никакой ресурс не отображается на путь.

Некоторые контейнеры могут позволить писать в URL, возвращенный этим методом, используя методы URL class.

Контент ресурса возвращается непосредственно, так знать тот запрос a .jsp страница возвращает исходный код JSP. Используйте a RequestDispatcher вместо этого включать результаты выполнения.

У этого метода есть различная цель чем java.lang.Class.getResource, который ищет ресурсы, основанные на загрузчике class. Этот метод не использует загрузчики class.

Параметры:
path - a String определение пути к ресурсу
Возвраты:
ресурс, расположенный в именованном пути, или null если нет никакого ресурса в том пути
Броски:
java.net.MalformedURLException - если путь не дается в корректной форме

getResourceAsStream

java.io.InputStream getResourceAsStream(java.lang.String path)
Возвращает ресурс, расположенный в именованном пути как InputStream объект.

Данные в InputStream может иметь любой тип или длину. Путь должен быть определен согласно поданным правилам getResource. Этот метод возвраты null если никакой ресурс не существует в указанном пути.

Метаинформация, такая как длина контента и тип контента, который доступен через getResource метод теряется при использовании этого метода.

Контейнер сервлета должен реализовать обработчики URL и URLConnection возражает необходимый, чтобы получить доступ к ресурсу.

Этот метод отличается от java.lang.Class.getResourceAsStream, который использует загрузчик class. Этот метод позволяет контейнерам сервлета делать ресурс доступным для сервлета от любого расположения, не используя загрузчик class.

Параметры:
path - a String определение пути к ресурсу
Возвраты:
InputStream возвращенный к сервлету, или null если никакой ресурс не существует в указанном пути

getRequestDispatcher

RequestDispatcher getRequestDispatcher(java.lang.String path)
Возвраты a RequestDispatcher возразите что действия как обертка для ресурса, расположенного в данном пути. A RequestDispatcher объект может использоваться, чтобы передать запрос к ресурсу или включать ресурс в ответ. Ресурс может быть динамичным или статичным.

Путь должен начаться с / и интерпретируется как относительно текущего корня контекста. Использовать getContext получить a RequestDispatcher для ресурсов во внешних контекстах.

Этот метод возвраты null если ServletContext не может возвратить a RequestDispatcher.

Параметры:
path - a String определение пути к ресурсу
Возвраты:
a RequestDispatcher возразите что действия как обертка для ресурса в указанном пути, или null если ServletContext не может возвратить a RequestDispatcher
См. Также:
RequestDispatcher, ServletContext#getContext

getNamedDispatcher

RequestDispatcher getNamedDispatcher(java.lang.String name)
Возвраты a RequestDispatcher возразите что действия как обертка для именованного сервлета.

Сервлеты (и страницы JSP также) могут быть именами через администрирование сервера или через дескриптор развертывания веб-приложения. Экземпляр сервлета может определить свое использование имени ServletConfig#getServletName.

Этот метод возвраты null если ServletContext не может возвратить a RequestDispatcher по любой причине.

Параметры:
name - a String определение имени сервлета, чтобы перенестись
Возвраты:
a RequestDispatcher возразите что действия как обертка для именованного сервлета, или null если ServletContext не может возвратить a RequestDispatcher
См. Также:
RequestDispatcher, ServletContext#getContext, ServletConfig#getServletName

getServlet

Servlet getServlet(java.lang.String name)
                   throws ServletException
Осуждаемый. С API Сервлета Java 2.1, без прямой замены.

Этот метод был первоначально определен, чтобы получить сервлет от a ServletContext. В этой версии всегда возвращается этот метод null и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.

Вместо этого метода, сервлеты могут поделиться информацией, используя ServletContext class и может выполнить совместно использованную бизнес-логику, вызывая методы на общие классы несервлета.

Броски:
ServletException

getServlets

java.util.Enumeration<Servlet> getServlets()
Осуждаемый. С API Сервлета Java 2.0, без замены.

Этот метод был первоначально определен, чтобы возвратиться Enumeration из всех сервлетов, известных этому контексту сервлета. В этой версии этот метод всегда возвращает пустое перечисление и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.


getServletNames

java.util.Enumeration<java.lang.String> getServletNames()
Осуждаемый. С API Сервлета Java 2.1, без замены.

Этот метод был первоначально определен, чтобы возвратиться Enumeration из всего сервлета называет известным этому контексту. В этой версии этот метод всегда возвращает пустое Enumeration и остается только сохранять совместимость на уровне двоичных кодов. Этот метод будет постоянно удален в будущей версии API Сервлета Java.


журнал

void log(java.lang.String msg)
Пишут указанное сообщение в файл журнала сервлета, обычно журнал событий. Имя и тип файла журнала сервлета являются определенными для контейнера сервлета.

Параметры:
msg - a String определение сообщения, которое будет записано файлу журнала

журнал

void log(java.lang.Exception exception,
         java.lang.String msg)
Осуждаемый. С API Сервлета Java 2.1, использовать log(String message, Throwable throwable) вместо этого.

Этот метод был первоначально определен, чтобы записать трассировку стека исключения и объяснительное сообщение об ошибке к файлу журнала сервлета.


журнал

void log(java.lang.String message,
         java.lang.Throwable throwable)
Пишут объяснительное сообщение и трассировка стека для данного Throwable исключение к файлу журнала сервлета. Имя и тип файла журнала сервлета являются определенными для контейнера сервлета, обычно журнал событий.

Параметры:
message - a String это описывает ошибку или исключение
throwable - Throwable ошибка или исключение

getRealPath

java.lang.String getRealPath(java.lang.String path)
Получает реальный путь, соответствующий данному виртуальному пути.

Например, если path будет равен /index.html, то этот метод возвратит абсолютный путь к файлу на файловой системе сервера, на которую запрос формы был бы отображен http://<host>:<port>/<contextPath>/index.html, где <contextPath> соответствует пути контекста этого ServletContext.

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

Ресурсы в каталогах /META-INF/resources файлов JAR, связанных в каталоге /WEB-INF/lib приложения, нужно рассмотреть, только если контейнер распаковал их от их содержания файла JAR, когда путь к распакованному расположению должен быть возвращен.

Этот метод возвраты null если контейнер сервлета неспособен преобразовать данный виртуальный путь к реальному пути.

Параметры:
path - виртуальный путь, который будет преобразован в реальный путь
Возвраты:
реальный путь, или null, если преобразование не может быть выполнено

getServerInfo

java.lang.String getServerInfo()
Возвращает имя и версию контейнера сервлета, на котором работает сервлет.

Форма возвращенной строки является servername/versionnumber. Например, Набор Веб-разработки JavaServer может возвратить строку JavaServer Web Dev Kit/1.0.

Контейнер сервлета может возвратить другую дополнительную информацию после основной строки в круглых скобках, например, JavaServer Web Dev Kit/1.0 (JDK 1.1.6; Windows NT 4.0 x86).

Возвраты:
a String содержа, по крайней мере, имя контейнера сервлета и номер версии

getInitParameter

java.lang.String getInitParameter(java.lang.String name)
Возвраты a String содержа значение именованного параметра инициализации всего контекста, или null если параметр не существует.

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

Параметры:
name - a String содержа имя параметра, значение которого требуют
Возвраты:
a String содержа, по крайней мере, имя контейнера сервлета и номер версии
См. Также:
ServletConfig#getInitParameter

getInitParameterNames

java.util.Enumeration<java.lang.String> getInitParameterNames()
Возвращает имена параметров инициализации контекста как Enumeration из String объекты, или пустое Enumeration если у контекста нет никаких параметров инициализации.

Возвраты:
Enumeration из String объекты, содержащие имена параметров инициализации контекста
См. Также:
ServletConfig#getInitParameter

setInitParameter

boolean setInitParameter(java.lang.String name,
                         java.lang.String value)
Устанавливает параметры инициализации контекста с именем и значением на этом ServletContext.

Параметры:
name - имя параметра инициализации контекста, чтобы установить
value - значение параметра инициализации контекста, чтобы установить
Возвраты:
истина, если параметры инициализации контекста с именем и значением были установлены успешно на этом ServletContext, и лжи, если это не было установлено, потому что этот ServletContext уже содержит параметр инициализации контекста с соответствующим именем
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getAttribute

java.lang.Object getAttribute(java.lang.String name)
Возвращает атрибут контейнера сервлета с именем, или null если нет никакого атрибута тем именем.

Атрибут позволяет контейнеру сервлета давать дополнительную информацию сервлета, не уже обеспеченную этим интерфейсом. См. свою документацию сервера для информации о ее атрибутах. Список поддерживаемых атрибутов может быть получен, используя getAttributeNames.

Атрибут возвращается как a java.lang.Object или некоторый подкласс.

Названия атрибута должны следовать за тем же самым соглашением как имена пакета. Спецификация API Сервлета Java резервирует соответствие имен java.*, javax.*, и sun.*.

Параметры:
name - a String определение имени атрибута
Возвраты:
Object содержа значение атрибута, или null если никакой атрибут не существует, соответствуя имя
См. Также:
ServletContext#getAttributeNames

getAttributeNames

java.util.Enumeration<java.lang.String> getAttributeNames()
Возвраты Enumeration содержа названия атрибута, доступные в пределах этого ServletContext.

Используйте getAttribute(java.lang.String) метод с названием атрибута, чтобы получить значение атрибута.

Возвраты:
Enumeration из названий атрибута
См. Также:
getAttribute(java.lang.String)

setAttribute

void setAttribute(java.lang.String name,
                  java.lang.Object object)
Связывает объект с данным названием атрибута в этом ServletContext. Если определенное имя будет уже использоваться для атрибута, то этот метод заменит атрибут новым для нового атрибута.

Если слушатели конфигурируются на ServletContext контейнер уведомляет их соответственно.

Если нулевое значение передают, эффект является тем же самым как вызовом removeAttribute().

Названия атрибута должны следовать за тем же самым соглашением как имена пакета. Спецификация API Сервлета Java резервирует соответствие имен java.*, javax.*, и sun.*.

Параметры:
name - a String определение имени атрибута
object - Object представление атрибута, который будет связан

removeAttribute

void removeAttribute(java.lang.String name)
Удаляет атрибут с именем из этого ServletContext. После удаления, последующих звонков getAttribute(java.lang.String) получать значение атрибута возвратится null.

Если слушатели конфигурируются на ServletContext контейнер уведомляет их соответственно.

Параметры:
name - a String определение имени атрибута, который будет удален

getServletContextName

java.lang.String getServletContextName()
Возвращает имя этого веб-приложения, соответствующего этому ServletContext как определено в дескрипторе развертывания для этого веб-приложения элементом имени дисплея.

Возвраты:
Имя веб-приложения или нуля, если никакое имя не было объявлено в дескрипторе развертывания.
С тех пор:
Сервлет 2.3

addServlet

ServletRegistration.Dynamic addServlet(java.lang.String servletName,
                                       java.lang.String className)
Добавляет сервлет с именем и именем class к этому контексту сервлета.

Зарегистрированный сервлет может быть далее сконфигурирован через возвращенный ServletRegistration объект.

Указанный className будет загружен, используя classloader, связанный с приложением, представленным этим ServletContext.

Если этот ServletContext уже будет содержать предварительный ServletRegistration для сервлета с данным servletName, то он будет завершен (присваивая данный className этому) и возвращен.

Этот метод анализирует class с данным className для ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, и аннотации javax.annotation.security.DeclareRoles. Кроме того, этот метод поддерживает инжекцию ресурса, если class с данным className представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
servletName - имя сервлета
className - полностью определенное имя class сервлета
Возвраты:
объект ServletRegistration, который может использоваться, чтобы далее сконфигурировать зарегистрированный сервлет, или null, если этот ServletContext уже содержит полный ServletRegistration для сервлета с данным servletName
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addServlet

ServletRegistration.Dynamic addServlet(java.lang.String servletName,
                                       Servlet servlet)
Регистрирует приведенный пример сервлета в этом ServletContext под данным servletName.

Зарегистрированный сервлет может быть далее сконфигурирован через возвращенный ServletRegistration объект.

Если этот ServletContext уже будет содержать предварительный ServletRegistration для сервлета с данным servletName, то он будет завершен (присваивая имя class приведенного примера сервлета к этому) и возвращен.

Параметры:
servletName - имя сервлета
servlet - экземпляр сервлета, чтобы зарегистрироваться
Возвраты:
объект ServletRegistration, который может использоваться, чтобы далее сконфигурировать данный сервлет, или null, если этот ServletContext уже содержит полный ServletRegistration для сервлета с данным servletName или если тот же самый экземпляр сервлета был уже зарегистрирован в этом или другом ServletContext в том же самом контейнере
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
IllegalArgumentException - если приведенный пример сервлета реализует SingleThreadModel
С тех пор:
Сервлет 3.0

addServlet

ServletRegistration.Dynamic addServlet(java.lang.String servletName,
                                       java.lang.Class<? extends Servlet> servletClass)
Добавляет сервлет с именем и типом class к этому контексту сервлета.

Зарегистрированный сервлет может быть далее сконфигурирован через возвращенный ServletRegistration объект.

Если этот ServletContext уже будет содержать предварительный ServletRegistration для сервлета с данным servletName, то он будет завершен (присваивая имя данного servletClass к этому) и возвращен.

Этот метод анализирует данный servletClass для ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, и аннотации javax.annotation.security.DeclareRoles. Кроме того, этот метод поддерживает инжекцию ресурса, если данный servletClass представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
servletName - имя сервлета
servletClass - объект class, от которого инстанцируют сервлет
Возвраты:
объект ServletRegistration, который может использоваться, чтобы далее сконфигурировать зарегистрированный сервлет, или null, если этот ServletContext уже содержит полный ServletRegistration для данного servletName
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

createServlet

<T extends Servlet> T createServlet(java.lang.Class<T> clazz)
                                throws ServletException
Инстанцирует данного Сервлета class.

Возвращенный экземпляр Сервлета может быть далее настроен прежде, чем он будет зарегистрирован в этом ServletContext через звонок addServlet(String,Servlet).

Данный class Сервлета должен определить нулевого конструктора параметра, который используется, чтобы инстанцировать его.

Этот метод анализирует данный clazz для следующих аннотаций: ServletSecurity, MultipartConfig, javax.annotation.security.RunAs, и javax.annotation.security.DeclareRoles. Кроме того, этот метод поддерживает инжекцию ресурса, если данный clazz представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
clazz - Сервлет class, чтобы инстанцировать
Возвраты:
новый экземпляр Сервлета
Броски:
ServletException - если данный clazz не в состоянии быть инстанцированным
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getServletRegistration

ServletRegistration getServletRegistration(java.lang.String servletName)
Получает ServletRegistration, соответствующий сервлету с данным servletName.

Возвраты:
(завершаются или предварительный), ServletRegistration для сервлета с данным servletName, или нуль, если никакой ServletRegistration не существует под тем именем
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getServletRegistrations

java.util.Map<java.lang.String,? extends ServletRegistration> getServletRegistrations()
Становится (возможно пустым) Карта объектов ServletRegistration (включенный именем сервлета) соответствующий всем сервлетам, зарегистрированным в этом ServletContext.

Возвращенная Карта включает объекты ServletRegistration, соответствующие всем объявленным и аннотируемым сервлетам, так же как объектам ServletRegistration, соответствующим всем сервлетам, которые были добавлены через один из методов addServlet.

Если разрешено, любые изменения к возвращенной Карте не должны влиять на этот ServletContext.

Возвраты:
Карта (полный и предварительный) объекты ServletRegistration, соответствующие всем сервлетам в настоящий момент, зарегистрировалась в этом ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addFilter

FilterRegistration.Dynamic addFilter(java.lang.String filterName,
                                     java.lang.String className)
Добавляет фильтр с именем и именем class к этому контексту сервлета.

Зарегистрированный фильтр может быть далее сконфигурирован через возвращенный FilterRegistration объект.

Указанный className будет загружен, используя classloader, связанный с приложением, представленным этим ServletContext.

Если этот ServletContext уже будет содержать предварительный FilterRegistration для фильтра с данным filterName, то он будет завершен (присваивая данный className этому) и возвращен.

Этот метод поддерживает инжекцию ресурса, если class с данным className представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
filterName - имя фильтра
className - полностью определенное имя class фильтра
Возвраты:
объект FilterRegistration, который может использоваться, чтобы далее сконфигурировать зарегистрированный фильтр, или null, если этот ServletContext уже содержит полный FilterRegistration для фильтра с данным filterName
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addFilter

FilterRegistration.Dynamic addFilter(java.lang.String filterName,
                                     Filter filter)
Регистрирует приведенный пример фильтра в этом ServletContext под данным filterName.

Зарегистрированный фильтр может быть далее сконфигурирован через возвращенный FilterRegistration объект.

Если этот ServletContext уже будет содержать предварительный FilterRegistration для фильтра с данным filterName, то он будет завершен (присваивая имя class приведенного примера фильтра к этому) и возвращен.

Параметры:
filterName - имя фильтра
filter - экземпляр фильтра, чтобы зарегистрироваться
Возвраты:
объект FilterRegistration, который может использоваться, чтобы далее сконфигурировать данный фильтр, или null, если этот ServletContext уже содержит полный FilterRegistration для фильтра с данным filterName или если тот же самый экземпляр фильтра был уже зарегистрирован в этом или другом ServletContext в том же самом контейнере
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addFilter

FilterRegistration.Dynamic addFilter(java.lang.String filterName,
                                     java.lang.Class<? extends Filter> filterClass)
Добавляет фильтр с именем и типом class к этому контексту сервлета.

Зарегистрированный фильтр может быть далее сконфигурирован через возвращенный FilterRegistration объект.

Если этот ServletContext уже будет содержать предварительный FilterRegistration для фильтра с данным filterName, то он будет завершен (присваивая имя данного filterClass к этому) и возвращен.

Этот метод поддерживает инжекцию ресурса, если данный filterClass представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
filterName - имя фильтра
filterClass - объект class, от которого инстанцируют фильтр
Возвраты:
объект FilterRegistration, который может использоваться, чтобы далее сконфигурировать зарегистрированный фильтр, или null, если этот ServletContext уже содержит полный FilterRegistration для фильтра с данным filterName
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

createFilter

<T extends Filter> T createFilter(java.lang.Class<T> clazz)
                              throws ServletException
Инстанцирует данного Фильтра class.

Возвращенный экземпляр Фильтра может быть далее настроен прежде, чем он будет зарегистрирован в этом ServletContext через звонок addFilter(String,Filter).

Данный class Фильтра должен определить нулевого конструктора параметра, который используется, чтобы инстанцировать его.

Этот метод поддерживает инжекцию ресурса, если данный clazz представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
clazz - Фильтр class, чтобы инстанцировать
Возвраты:
новый экземпляр Фильтра
Броски:
ServletException - если данный clazz не в состоянии быть инстанцированным
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getFilterRegistration

FilterRegistration getFilterRegistration(java.lang.String filterName)
Получает FilterRegistration, соответствующий фильтру с данным filterName.

Возвраты:
(завершаются или предварительный), FilterRegistration для фильтра с данным filterName, или нуль, если никакой FilterRegistration не существует под тем именем
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getFilterRegistrations

java.util.Map<java.lang.String,? extends FilterRegistration> getFilterRegistrations()
Становится (возможно пустым) Карта объектов FilterRegistration (включенный именем фильтра) соответствующий всем фильтрам, зарегистрированным в этом ServletContext.

Возвращенная Карта включает объекты FilterRegistration, соответствующие всем объявленным и аннотируемым фильтрам, так же как объектам FilterRegistration, соответствующим всем фильтрам, которые были добавлены через один из методов addFilter.

Любые изменения к возвращенной Карте не должны влиять на этот ServletContext.

Возвраты:
Карта (полный и предварительный) объекты FilterRegistration, соответствующие всем фильтрам в настоящий момент, зарегистрировалась в этом ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getSessionCookieConfig

SessionCookieConfig getSessionCookieConfig()
Добирается SessionCookieConfig объект, через который могут быть сконфигурированы различные свойства cookie отслеживания сеанса, создаваемых от имени этого ServletContext.

Повторные вызовы этого метода возвратят тот же самый экземпляр SessionCookieConfig.

Возвраты:
объект SessionCookieConfig, через который могут быть сконфигурированы различные свойства cookie отслеживания сеанса, создаваемых от имени этого ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

setSessionTrackingModes

void setSessionTrackingModes(java.util.Set<SessionTrackingMode> sessionTrackingModes)
Устанавливает режимы отслеживания сеанса, которые должны вступить в силу для этого ServletContext.

Данный sessionTrackingModes заменяет любые режимы отслеживания сеанса, установленные предыдущим вызовом этого метода на этом ServletContext.

Параметры:
sessionTrackingModes - набор режимов отслеживания сеанса, чтобы вступить в силу для этого ServletContext
Броски:
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
IllegalArgumentException - если sessionTrackingModes определяет комбинацию SessionTrackingMode.SSL с режимом отслеживания сеанса кроме SessionTrackingMode.SSL, или если sessionTrackingModes определяет режим отслеживания сеанса, который не поддерживается контейнером сервлета
С тех пор:
Сервлет 3.0

getDefaultSessionTrackingModes

java.util.Set<SessionTrackingMode> getDefaultSessionTrackingModes()
Получает режимы отслеживания сеанса, которые поддерживаются по умолчанию для этого ServletContext.

Возвраты:
набор режимов отслеживания сеанса, поддерживаемых по умолчанию для этого ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

getEffectiveSessionTrackingModes

java.util.Set<SessionTrackingMode> getEffectiveSessionTrackingModes()
Получает режимы отслеживания сеанса, которые являются в действительности для этого ServletContext.

Режимы отслеживания сеанса в действительности - обеспеченные для setSessionTrackingModes.

По умолчанию, режимы отслеживания сеанса, возвращенные getDefaultSessionTrackingModes в действительности.

Возвраты:
набор режимов отслеживания сеанса в действительности для этого ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addListener

void addListener(java.lang.String className)
Добавляет слушатель с данным именем class к этому ServletContext.

class с именем будет загружен, используя classloader, связанный с приложением, представленным этим ServletContext, и должен реализовать один или больше следующих интерфейсов:

Если к этому ServletContext передали ServletContainerInitializer#onStartup, тогда class с именем может также реализовать ServletContextListener, в дополнение к упомянутым выше интерфейсам.

Как часть этого вызова метода, контейнер должен загрузить class указанным именем class, чтобы гарантировать, что это реализует один из необходимых интерфейсов.

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

Этот метод поддерживает инжекцию ресурса, если class с данным className представляет Управляемый Боб. См. платформу EE Java и JSR 299 спецификаций для дополнительных деталей об Управляемых Бобах и инжекции ресурса.

Параметры:
className - полностью определенное имя class слушателя
Броски:
IllegalArgumentException - если class с именем не реализует ни одного из вышеупомянутых интерфейсов, или если это реализует ServletContextListener и к этому ServletContext не передали ServletContainerInitializer#onStartup
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addListener

<T extends java.util.EventListener> void addListener(T t)
Добавляет данный слушатель этого ServletContext.

Данный слушатель должен быть экземпляром один или больше следующих интерфейсов:

Если к этому ServletContext передали ServletContainerInitializer#onStartup, тогда данный слушатель может также быть экземпляром ServletContextListener, в дополнение к упомянутым выше интерфейсам.

Если данный слушатель является экземпляром интерфейса слушателя, порядок вызова которого соответствует порядку объявления (то есть, если это - экземпляр ServletRequestListener, ServletContextListener, или HttpSessionListener), тогда слушатель будет добавлен до конца упорядоченного списка слушателей того интерфейса.

Параметры:
t - слушатель, который будет добавлен
Броски:
IllegalArgumentException - если данный слушатель не является экземпляром какого-либо из вышеупомянутых интерфейсов, или если это - экземпляр ServletContextListener и к этому ServletContext не передали ServletContainerInitializer#onStartup
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

addListener

void addListener(java.lang.Class<? extends java.util.EventListener> listenerClass)
Добавляет слушатель данного типа class к этому ServletContext.

Данный listenerClass должен реализовать один или больше следующих интерфейсов:

Если к этому ServletContext передали ServletContainerInitializer#onStartup, тогда данный listenerClass может также реализовать ServletContextListener, в дополнение к упомянутым выше интерфейсам.

Если данный listenerClass implements a listener interface whose invocation order corresponds to the declaration order (i.e., if it implements ServletRequestListener, ServletContextListener, или HttpSessionListener), тогда новый слушатель будет добавлен до конца упорядоченного списка слушателей того интерфейса.

This method supports resource injection if the given listenerClass represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

Параметры:
listenerClass - слушатель class, который инстанцируют
Броски:
IllegalArgumentException - if the given listenerClass does not implement any of the above interfaces, or if it implements ServletContextListener и к этому ServletContext не передали ServletContainerInitializer#onStartup
IllegalStateException - если этот ServletContext был уже инициализирован
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0

createListener

<T extends java.util.EventListener> T createListener(java.lang.Class<T> clazz)
                                                 throws ServletException
Инстанцирует данного EventListener class.

Указанный EventListener class должен реализовать по крайней мере один из ServletContextListener, ServletContextAttributeListener, ServletRequestListener, ServletRequestAttributeListener, HttpSessionListener, или HttpSessionAttributeListener интерфейсы.

Возвращенный экземпляр EventListener может быть далее настроен прежде, чем он будет зарегистрирован в этом ServletContext через звонок addListener(EventListener).

Данный class EventListener должен определить нулевого конструктора параметра, который используется, чтобы инстанцировать его.

This method supports resource injection if the given clazz represents a Managed Bean. See the Java EE platform and JSR 299 specifications for additional details about Managed Beans and resource injection.

Параметры:
clazz - EventListener class, чтобы инстанцировать
Возвраты:
новый экземпляр EventListener
Броски:
ServletException - if the given clazz fails to be instantiated
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
IllegalArgumentException - если указанный EventListener class не реализует ни одного из ServletContextListener, ServletContextAttributeListener, ServletRequestListener, ServletRequestAttributeListener, HttpSessionListener, или HttpSessionAttributeListener интерфейсы.
С тех пор:
Сервлет 3.0

getJspConfigDescriptor

JspConfigDescriptor getJspConfigDescriptor()
Добирается <jsp-config> связанная конфигурация, которая была агрегирована от web.xml и web-fragment.xml файлы дескриптора веб-приложения представляются этим ServletContext.

Возвраты:
<jsp-config> связанная конфигурация, которая была агрегирована от web.xml и web-fragment.xml файлы дескриптора веб-приложения, представленного этим ServletContext, или нулем, если никакая такая конфигурация не существует
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
С тех пор:
Сервлет 3.0
См. Также:
JspConfigDescriptor

getClassLoader

java.lang.ClassLoader getClassLoader()
Получает загрузчик class веб-приложения, представленного этим ServletContext.

Если менеджер безопасности существует, и загрузчик class вызывающей стороны не является тем же самым как, или предок требуемого загрузчика class, то менеджер безопасности checkPermission метод вызывают с a RuntimePermission("getClassLoader") разрешение, чтобы проверить, должен ли доступ к требуемому загрузчику class быть предоставлен.

Возвраты:
загрузчик class веб-приложения представляется этим ServletContext
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
SecurityException - если менеджер безопасности лишает доступа к требуемому загрузчику class
С тех пор:
Сервлет 3.0

declareRoles

void declareRoles(java.lang.String... roleNames)
Объявляет ролевые имена, которые тестируются, используя isUserInRole.

Роли, которые неявно объявляются в результате их использования в пределах setServletSecurity или setRunAsRole методы ServletRegistration взаимодействуйте через интерфейс не должен быть объявлен.

Параметры:
roleNames - роль называет быть объявленным
Броски:
UnsupportedOperationException - если этот ServletContext передали к ServletContextListener#contextInitialized метод a ServletContextListener это ни не было объявлено в web.xml или web-fragment.xml, ни аннотируемый WebListener
IllegalArgumentException - если каким-либо параметром roleNames является нуль или пустая строка
IllegalStateException - если ServletContext был уже инициализирован
С тех пор:
Сервлет 3.0


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter