sitemesh技術的應用

一,基本概念html

1,Sitemesh是一種頁面裝飾技術 :web

 1  :它經過過濾器(filter)來攔截頁面訪問
 2  :根據被訪問頁面的URL找到合適的裝飾模板
 3  :提取被訪問頁面的內容,放到裝飾模板中合適的位置
 4  :最終將裝飾後的頁面發送給客戶端。app

2,在sitemesh中,頁面分爲兩種:裝飾模板和普通頁面。
1)裝飾模板,是指用於修飾其它頁面的頁面。
2)普通頁面,通常指各類應用頁面。
3,接下來,咱們經過一個簡單的例子來講明一下sitemesh修飾網頁的基本原理。jsp

二,模板修飾網頁的原理







經過Sitemesh的註冊機制,告訴Sitemesh,當訪問該路徑時使用XXX模板(假定使用前面那個模板)來修飾被訪問頁面。 

url

 

當用戶在左邊導航欄點擊「戲說長城」( /ShowGreatWall.do)時,右邊的「戲說長城」頁面將會被指定的模板修飾



總結上面過程,Sitemesh修飾網頁的基本原理,能夠經過下面來講明:



三,Sitemesh的配置與使用spa

1)WEB-INF/web.xml中加入filter定義與sitemesh的taglib定義.net

     <filter>
          
<filter-name>sitemesh</filter-name>
          
<filter-class>com.opensymphony.module.sitemesh.filter.PageFilter</filter-class>
     
</filter>
     
<filter-mapping>
          
<filter-name>sitemesh</filter-name>
          
<url-pattern>/*</url-pattern>
     </filter-mapping>

     <taglib>
          <taglib-uri>sitemesh-decorator</taglib-uri>
          <taglib-location>/WEB-INF/sitemesh-decorator.tld</taglib-location>
     </taglib>
     <taglib>
          <taglib-uri>sitemesh-page</taglib-uri>
          <taglib-location>/WEB-INF/sitemesh-page.tld</taglib-location>
     </taglib> 
xml

2)建立WEB-INF/decorators.xml,在該文件中配置有哪些模板,以及每一個模板具體修飾哪些URL,另外也能夠配置哪些URL不須要模板控制 , decorators.xml的一個例子以下:htm

<excludes>
<pattern>/Login*</pattern>
</excludes>

<decorators defaultdir="/decorators">
    
<decorator name="main" page=「DecoratorMainPage.jsp">
        
<pattern>/*</pattern> 
    
</decorator>

    
<decorator name=「pop" page=「PopPage.jsp">
        
<pattern>/showinfo.jsp*</pattern>
        
<pattern>
              /myModule/GreatWallDetailAction.do*
        
</pattern>
    
</decorator>
</decorators>對象

3)咱們看一個修飾模板的例子

<%@page contentType="text/html;?charset=GBK"%>
<%@taglib uri="sitemesh-decorator"?prefix="decorator" %>

<html>
    
<head>
         
<title<decorator:title/> </title>
         
<decorator:head/>
    
</head>

    
<body>
        Hello World  
<hr/>
        
<decorator:body/>
    
</body>
</html> 

4)咱們看一個被修飾的頁面的例子:

<%@ page contentType="text/html;?charset=GBK"%>
<html>
    
<head>
        
<title>Hello World</title>
    
</head>

    
<body>
        
<p>Decorated page goes here.</p
    </body
>
</html> 

5)咱們看一下裝飾模板中可使用的Sitemesh標籤 

<decorator:head />

 取出被裝飾頁面的head標籤中的內容。

<decorator:body />

取出被裝飾頁面的body標籤中的內容。

<decorator:title default=""  />

取出被裝飾頁面的title標籤中的內容。default爲默認值

<decorator:getProperty property="" default=""  writeEntireProperty=""/>

取出被裝飾頁面相關標籤的屬性值。

writeEntireProperty代表,是顯示屬性的值仍是顯示「屬性=值」

Html標籤的屬性
Body標籤的屬性
Meta標籤的屬性

注意若是其content值中包含「>或<」會報錯,需轉碼,例如&lt;等等

default是默認值

<decorator:usePage id="" />

 將被裝飾頁面構造爲一個對象,能夠在裝飾頁面的JSP中直接引用

6)看一個在裝飾模板中使用標籤的例子

<html lang=「 <decorator:getProperty property=‘lang’/> 」>
    
<head>
        
<title> <decorator:title default=「你好」 /> </title>
        
<decorator:head />
    
</head>
    
    
<body <decorator:getProperty property=「body.onload" writeEntireProperty=「1"/> >
         
從meta中獲取變量company的名稱:
             <decorator:getProperty property
=「meta.company」/>

            
下面是被修飾頁面的body中的內容:
             <decorator:body 
/>

         
<decorator:usePage id=「myPage" />

         
<%=myPage.getRequest().getAttribute(「username」)%>
    
</body>
</html>

7)看一下相應的在被修飾頁面中的代碼:

<html lang=「en」>
    
<head>
        
<title>個人sitemesh</title>
        
<meta name=「company」 content=「smartdot」/>
        
<meta name=「Author」 content=「zhangsan」/>
        
<script>
             function count(){return 10;}
        
</script>
    
</head>

    
<body onload=「count()」>
         
<p>這是一個被修飾頁面</p>
    
</body>
</html>

四,總結

1,Sitemesh最爲重要的就是作用於修飾的模板,並在decorators.xml中配置這些模板用於修飾哪些頁面。所以使用Sitemesh的主要過程就是:作裝飾模板,而後在decorators.xml中配置URL Pattern

2,分析整個工程,看哪些頁面須要抽象成模板,例如二級頁面、三級頁面、彈出窗口等等可能都須要作成相應的模板,通常來講,一個大型的OA系統,模板不會超過8個。

 

— — —— — — — — — — — — — — — — — — — — — — — — —

若是某個特殊的需求請求路徑在過濾器的範圍內,但又不想使用模板怎麼辦?
你總不能這麼不講道理吧!
        你們放心吧,SiteMesh早就考慮到這一點了,上面第5步說道的decorators.xml這個時候就起到做用了!
       


下面是個人decorators.xml:

 

<?xml version="1.0" encoding="ISO-8859-1"?> 
<decorators defaultdir="/decorators"> 
    <!-- Any urls that are excluded will never be decorated by Sitemesh --> 
    <excludes> 
        <pattern>/index.jsp*</pattern> 
          <pattern>/login/*</pattern> 
    </excludes> 
    <decorator name="main" page="main.jsp"> 
        <pattern>/*</pattern> 
    </decorator> 
</decorators>

 

decorators.xml有兩個主要的結點:
      decorator結點指定了模板的位置和文件名,經過pattern來指定哪些路徑引用哪一個模板
      excludes結點則指定了哪些路徑的請求不使用任何模板

如上面代碼,/index.jsp和凡是以/login/開頭的請求路徑一概不使用模板;

另外還有一點要注意的是:decorators結點的defaultdir屬性指定了模板文件存放的目錄;

相關文章
相關標籤/搜索