This question already has answers here:
Closed 4 years ago.
I am trying to deploy a very simple & my first JSF application (following a really good tutorial by BalusC) on glassfish local server. I completed all the steps to create the application. And when I tried to deploy the application on the glassfish server, it just failed with the following exception message:-
cannot Deploy Playground
Deployment Error for module: Playground: Exception while deploying the app :
java.lang.IllegalArgumentException: Invalid URL Pattern: [xhtml]
Could anyone explain where is the fault and how can I amend it ?
This is not a valid url-pattern. You can arrange the mapping as prefix mapping or extension mapping (from the JSF 2.0 specification):
Prefix mapping:
<servlet-mapping>
<servlet-name> faces-servlet-name </servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
Extension mapping:
<servlet-mapping>
<servlet-name> faces-servlet-name </servlet-name>
<url-pattern>*.xhtml</url-pattern>
</servlet-mapping>
Your <url-pattern>
must either have an extension matching (starts with a *
) or prefix matching (starting with /
) included, not just xhtml
.
Here's how I did mine.
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.xhtml</url-pattern>
</servlet-mapping>
The rules for servlet mappings are covered in the Servlet 3.0 specs:
Specification of Mappings
In the Web application deployment
descriptor, the following syntax is
used to define mappings:
- A string beginning with a
/
character and ending with a /*
suffix is used for path mapping.
- A string beginning with a
*.
prefix is used as an extension
mapping.
- The empty string ("") is a special URL pattern that exactly maps to the
application's context root, i.e.,
requests of the form
http://host:port/<contextroot>/
. In
this case the path info is /
and the
servlet path and context path is empty
string ("").
- A string containing only the
/
character indicates the "default"
servlet of the application. In this
case the servlet path is the request
URI minus the context path and the
path info is null.
- All other strings are used for exact matches only.
When you encounter this error, check your web.xml and any mapping annotations (WebServlet, WebFilter, etc.)
You can find recommendations for JSF servlet mapping in the JSF 2.0 spec.
When using extension mapping the
following mapping is recommended, but
not required:
<servlet-mapping>
<servlet-name> faces-servlet-name </servlet-name>
<url-pattern>*.faces</url-pattern>
</servlet-mapping>