java.lang.IllegalArgumentException: Invalid URL Pattern: [xhtml]

Question

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 ?

How is your `url-pattern` declared in your web.xml for Faces Servlet? — Buhake Sindi, Mar 26 '11 at 10:54

score 4 · Accepted Answer · answered Mar 26 '11 at 11:02

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>

Buhake Sindi · Answer 2 · 2015-02-05T22:04:20.960

4

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>

edited Feb 05 '15 at 22:04

answered Mar 26 '11 at 11:05

Buhake Sindi

87,898
29
167
228

2

Vote up for beeing the first commenter to this question. – Matt Handy Mar 26 '11 at 11:17

score 3 · Answer 3 · answered Mar 26 '11 at 11:17

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>

java.lang.IllegalArgumentException: Invalid URL Pattern: [xhtml]

3 Answers3

Linked