7.1 Skema am web.xml
Fail web.xml menyimpan maklumat konfigurasi aplikasi. Ia bukan bahagian wajib, tetapi ia digunakan secara meluas untuk mengkonfigurasi aplikasi web.
Fail ini mesti terletak dalam folder WEB-INF . Apabila Tomcat dimulakan, ia membaca kandungannya dan menggunakan konfigurasi yang terkandung di dalamnya. Jika fail mengandungi ralat, maka Tomcat juga memaparkan ralat.
Contoh web.xml:
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0">
<servlet>
<servlet-name>HelloWorld</servlet-name>
<servlet-class>HelloServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorld</servlet-name>
<url-pattern>/welcome</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>
"HelloWorld"
Pemetaan nama servlet dan kelas servlet ditulis di sini dalam warna hijau"HelloServlet"
. Pemetaan nama servlet dan bahagian URL ditulis dengan warna biru"HelloWorld"
"http://localhost/welcome"
. Oleh itu, ia mengatakan di sini bahawa apabila mengakses laluan /welcome, anda perlu memanggil servlet HelloServlet.class
.
Warna merah menunjukkan fail yang perlu diberikan atas permintaan http://localhost/
- ini adalah yang dipanggil halaman selamat datang . Jika pengguna hanya menaip dalam penyemak imbas nama yang sepadan dengan akar aplikasi web kami, maka kandungan index.html
.
7.2 servlet, pemetaan servlet
Satu servlet boleh menyampaikan permintaan pada URL yang berbeza, jadi dalam web-xml, servlet dan pemetaannya ke URL ditulis secara berasingan. Mula-mula, kami menerangkan servlet, memberikan setiap satu nama rentetan yang unik, dan kemudian kami menentukan cara setiap servlet memetakan url mana.
Contoh web.xml:
<web-app>
<servlet>
<servlet-name>remoting</servlet-name>
<servlet-class>com.codegym.RemotingServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>remoting</servlet-name>
<url-pattern>/remoting/*</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>restapi</servlet-name>
<servlet-class>com.codegym.RestApiServlet</servlet-class>
<load-on-startup>2</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>restapi</servlet-name>
<url-pattern>/api/*</url-pattern>
</servlet-mapping>
</web-app>
Dalam contoh ini, dua servlet diisytiharkan, dan setiap satunya dipetakan ke templat url yang berbeza. Servlet RemotingServlet
menyediakan semua permintaan yang pergi ke/remoting/*
. Servlet RestApiServlet
menyediakan semua permintaan yang pergi ke/api/*
. Servlets juga mempunyai susunan daripada memuatkan - parameter muatkan semasa permulaan.
7.3 Pilihan Servlet
Dengan bantuan web.xml, parameter boleh dihantar ke servlet semasa pemulaannya, ia akan tersedia melalui antara muka ServletConfig
. Anda juga boleh menetapkan parameter untuk keseluruhan aplikasi web, ia akan tersedia melalui ServletContext
.
Contoh web.xml:
<web-app>
<context-param>
<description>Server production mode</description>
<param-name>productionMode</param-name>
<param-value>false</param-value>
</context-param>
<context-param>
<param-name>appPropertiesConfig</param-name>
<param-value>
classpath:local-app.properties
classpath:web-app.properties
</param-value>
</context-param>
<servlet>
<servlet-name>mainservlet</servlet-name>
<servlet-class>com.codegym.ApplicationServlet</servlet-class>
<init-param>
<param-name>application</param-name>
<param-value>com.codegym.App</param-value>
</init-param>
<init-param>
<param-name>widgetset</param-name>
<param-value>com.codegym.WidgetSet</param-value>
</init-param>
<init-param>
<param-name>ui</param-name>
<param-value>com.codegym.AppUI</param-value>
</init-param>
</servlet>
</web-app>
Kod yang diserlahkan dalam warna hijau adalah tempat kami menetapkan parameter untukServletContext
. Terdapat dua daripadanya:
productionMode
dengan nilai palsuappPropertiesConfig
dengan tatasusunan dua rentetan:classpath:local-app.properties
classpath:web-app.properties
Parameter untuk servlet ditunjukkan dengan warna biruApplicationServlet
, ia akan tersedia untuknya melalui ServletConfig
:
application
dengan nilai com.codegym.Appwidgetset
dengan nilai com.codegym.WidgetSetui
dengan nilai com.codegym.AppUI
7.4 penapis, pemetaan penapis
Aplikasi web juga mungkin mengandungi utility servlets - filters
. Mereka melakukan pelbagai tugas perkhidmatan: ubah hala panggilan, semak kebenaran, dsb.
Contoh web.xml:
<web-app>
<servlet>
<servlet-name>remoting</servlet-name>
<servlet-class>RemotingServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>remoting </servlet-name>
<url-pattern>/remoting/*</url-pattern>
</servlet-mapping>
<filter>
<filter-name>total_filter</filter-name>
<filter-class>com.javrush.TotalFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>total_filter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
</web-app>
Sebelum permintaan sampai ke servlet RemotingServlet
, ia akan diproses oleh penapis TotalFiler
. Penapis ini dikonfigurasikan untuk memintas semua permintaan yang pergi ke aplikasi web kami. Ini jelas dibayangkan oleh templat url yang dipetakan kepada: /*
.
Anda akan membaca lebih lanjut mengenai servlet dan penapis dalam kuliah berikut.