這幾天一直在用myfaces，遇到一個問題，使用inputDate 和 tree2 這樣的組件的時候，當開啟了一些和JavaScript相關的選項時，總是會提示JavaScript錯誤，但是卻總是找不到這些JavaScript在哪里，很納悶，昨天為了查找 tree2 的用法在網上尋覓，在 JBoss 的論壇看到了相關的問題，其實這個問題在 myfaces 的官方網站上已經有明確的說明了，參見http://myfaces.apache.org/tomahawk/extensionsFilter.html
引用官方的原文來解釋一下這個問題
What is the Extensions Filter for?
Some MyFaces components do more than include some HTML in the pages. They may need additional support scripts, style sheets, images, ...
Those resources are included in the MyFaces' jar file and the Extensions Filter add the code and URL needed to provide those resources to the generated HTML.
Some other components, like the file upload component (t:inputFileUpload) need to parse Multipart requests.
The extensions filter handles this as well.
Why is this useful?
This design has several benefits :
- It provides a clean separation between MyFaces' components and your webapp.
- You don't have to include additional MyFaces' components related code or resources in your pages or webapp.
- It provides great flexibility to the MyFaces' team upgrade the components, while keeping transparent backward compatibility.
- It makes it possible for complex components to use many support resources without any burden on the page developer.
- It loads only the resources really useful for the rendered components.
- It handles the MyFaces' resources caching.
How does it work?
When a component needs a resource, is calls one of the org.apache.myfaces.component.html.util.AddResource methods (for example AddResource.addJavaScriptToHeader(InputHtmlRenderer.class, "sarissa.js", context); ).
This method add an attribute to the request so that the filter knows that is must include the given javascript, stylesheet or resource link to the page.
The code for this resource is automatically included in the generated HTML.
The URL for an embedded resource is constructed and always begins by /myfaces/ so that it can be intercepted by the filter when the client need to load the resource.
When the clients fetches the resource, the filter decodes the URL, and serves the proper resource that is embedded in MyFaces' jar.
How do I configure it?
In your web.xml, map this filter to the path used for the JSF pages (most likely *.jsf) AND to the /faces/* path as in the following example :
<filter>
<filter-name>MyFacesExtensionsFilter</filter-name>
<filter-class>org.apache.myfaces.component.html.util.ExtensionsFilter</filter-class>
<init-param>
<param-name>maxFileSize</param-name>
<param-value>20m</param-value>
<description>Set the size limit for uploaded files.
Format: 10 - 10 bytes
10k - 10 KB
10m - 10 MB
1g - 1 GB
</description>
</init-param>
</filter>
<filter-mapping>
<filter-name>MyFacesExtensionsFilter</filter-name>
<url-pattern>*.jsf</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>MyFacesExtensionsFilter</filter-name>
<url-pattern>/faces/*</url-pattern>
</filter-mapping>
Under what circumstances am I *required* to use the extensions filter?
If you just use standard JSF component, but don't use any MyFaces' extended component (beginning with t:), then you don't need the Extensions Filter.
However, if you use some of the MyFaces' extended components like t:inputFileUpload, t:inputHTtml, t:inputCalendar, ... then you most likely need to have this filter configured in your webapp.
Does this impact performance?
The filter hasn't any significant impact the response time.
However, as the filter has to cache the whole response in memory before writing it out to the client, it slightly increases the memory usage.
posted on 2005-11-17 08:34
steady 閱讀(1953)
評論(1) 編輯 收藏 所屬分類:
JSF & Myfaces