Servlet3.0 模塊化支持

?

?????? Servlet3.0 現在已經支持各 Web 組件的模塊化了。也就是說現在我們可以把各 Web 組件單獨拿出來進行開發，之后把它們打成對應的 jar 包放到主項目中就可以了，而不必像之前那樣——所有的內容都必須在 web.xml 文件中進行定義。有了對模塊化的支持后我們在實際應用中就可以把某些通用功能的 Filter 、 Listener 、 Servlet 作為一個單獨的 Web 模塊進行定義，在需要使用它們的項目中就把對應 Web 模塊對應的 jar 包加進去就可以了。是不是很有用呢？接下來我們就來看一下這些 Web 組件究竟是怎樣模塊化的。

?????? Web 模塊打成的 jar 包的內容的文件結構要求是這個樣子的：

|--META-INF

|???? |--web-fragment.xml

|???? |--resources

|???? |???? |--jsp 、圖片等，相當于 web 的根目錄

|--class 文件和類路徑下的文件

?

?????? 其中 web-fragment.xml 文件是必須要的。上述目錄結構就相當于在我們的類路徑下有一個 META-INF 目錄，該目錄下有 web-fragment.xml 文件及包含 jsp 、圖片等資源的 resources 目錄。針對于上述這樣的目錄結構，所以當我們在使用 Maven 構建項目的時候，我們的 Maven 項目的目錄結構應該是這個樣子的：

?
? ? ? ?web-fragment.xml文件的作用與Web應用下的web.xml文件的作用是相似的，在web.xml文件可以配置的信息都可以在web-fragment.xml文件中進行配置。此外，它們的文檔結構也非常的相似。所不同的是web-fragment.xml文件的根元素是web-fragment，所使用的schema也是web-fragment相應的schema。

      <web-fragment version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd">
  
</web-fragment>
    

?

? ? ? ? 另外，在 web-fragment.xml 文件中我們可以通過 <name> 元素來指定當前模塊的名稱，用 <ordering> 元素來指定當前模塊相對的加載順序。 <ordering> 元素下面可以指定 <before> 或 <after> 元素，而 <before> 和 <after> 元素下又可以指定 <name> 和 <others> 元素。我們來看幾個指定 ordering 的示例。

在其他模塊之前加載

         <ordering>
      <!-- 在其它模塊之前加載 -->
      <before>
         <others/>
      </before>
   </ordering>
    

??

在指定模塊之后加載

         <ordering>
      <!-- 在指定模塊之后加載 -->
      <after>
         <name>模塊名稱</name>
      </after>
   </ordering>

    

??

?????? 除了可以在 web-fragment.xml 文件里面通過 <ordering> 元素定義當前模塊的加載順序外，我們還可以在 web.xml 文件中通過 <absolute-ordering> 元素指定各模塊的 加載順序。而且 web.xml 文件中指定的加載順序比 web-fragment.xml 文件中指定的加載順序具有更高的優先級。如：

         <absolute-ordering>
      <name>module1</name>
      <name>module2</name>
      <name>module3</name>
      <others/>
   </absolute-ordering>

    

??

?????? 接下來我們來展示一個創建 web 模塊的例子。假設我們要創建一個叫做 module1 的模塊，其中含有一個 Module1Servlet ，其代碼如下所示：

      public class Module1Servlet extends HttpServlet {
 
   private static final long serialVersionUID = 1L;
 
   @Override
   protected void doGet(HttpServletRequest req, HttpServletResponse resp)
         throws ServletException, IOException {
      this.doPost(req, resp);
   }
 
   @Override
   protected void doPost(HttpServletRequest req, HttpServletResponse resp)
         throws ServletException, IOException {
      req.getRequestDispatcher("/module1.jsp").forward(req, resp);
   }
 
}

    

??

?????? 接著我們在類路徑下創建一個 META-INF 文件夾，在該文件夾下創建一個 resources 目錄，在 resources 目錄下創建一個 module1.jsp 文件。接著在 META-INF 目錄下創建一個 web-fragment.xml 文件，其內容如下：

      <web-fragment version="3.0" xmlns="http://java.sun.com/xml/ns/javaee"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd">
  
   <!-- 指定模塊名稱 -->
   <name>module1</name>
   <!-- 加載順序 -->
   <ordering>
      <!-- 在其它模塊之前加載 -->
      <before>
         <others/>
      </before>
   </ordering>
  
   <servlet>
      <servlet-name>module1Servlet</servlet-name>
      <servlet-class>com.xxx.Module1Servlet</servlet-class>
   </servlet>
  
   <servlet-mapping>
      <servlet-name>module1Servlet</servlet-name>
      <url-pattern>/servlet/module1</url-pattern>
   </servlet-mapping>
  
</web-fragment>
    

?

?????? 之后我們把該項目打成一個 jar 包就可以把它作為一個 jar 加到其它 Web 應用中，在其它 Web 應用中使用了。放到其它 Web 應用中后，我們通過訪問 /servlet/module1 就可以訪問到我們 module1 模塊中定義的 Module1Servlet 了。

?

?