RedirectFilter
Examples of typical setups
Redirect domain names to their www. counterpart
This example assumes that your webapp has been setup to answer to
http://myfirstdomain.com and
http://myseconddomain.com. It will redirect all traffic to the same URLs with a "www." prepended to their domain names. The redirection will be a permanent redirect and will not include whatever query string the user originally submitted.
<filter>
<filter-name>MyFirstRedirectFilter</filter-name>
<filter-class>net.pieroxy.tools.j2ee.RedirectFilter</filter-class>
<init-param>
<param-name>http://myfirstdomain\.com/</param-name>
<param-value>http://www.myfirstdomain.com/</param-value>
</init-param>
<init-param>
<param-name>http://myseconddomain\.com/</param-name>
<param-value>http://www.myseconddomain.com/</param-value>
</init-param>
<init-param>
<param-name>https://myfirstdomain\.com/</param-name>
<param-value>https://www.myfirstdomain.com/</param-value>
</init-param>
<init-param>
<param-name>https://myseconddomain\.com/</param-name>
<param-value>https://www.myseconddomain.com/</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>MyFirstRedirectFilter</filter-name>
<url-pattern>/</url-pattern>
</filter-mapping>
Note that since the expression is a regular expression that has to match a portion of the URL, the following example will achieve the same objective:
<filter>
<filter-name>MyFirstRedirectFilter</filter-name>
<filter-class>net.pieroxy.tools.j2ee.RedirectFilter</filter-class>
<init-param>
<param-name>://myfirstdomain\.com/</param-name>
<param-value>://www.myfirstdomain.com/</param-value>
</init-param>
<init-param>
<param-name>://myseconddomain\.com/</param-name>
<param-value>://www.myseconddomain.com/</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>MyFirstRedirectFilter</filter-name>
<url-pattern>/</url-pattern>
</filter-mapping>Redirect portions of a website to https
This example shows how to redirect a portion of a website to https or to http, not giving the user any choice.
With this setup:
- You can be certain that whatever call is made to /secure will either be https or will be redirected to https.
- You can be certain that whatever call is made to /catalog will either be http or will be redirected to http.
<filter>
<filter-name>MyFirstRedirectFilter</filter-name>
<filter-class>net.pieroxy.tools.j2ee.RedirectFilter</filter-class>
<init-param>
<param-name>http://myfirstdomain\.com/secure/</param-name>
<param-value>https://myfirstdomain.com/secure/</param-value>
</init-param>
<init-param>
<param-name>https://myfirstdomain\.com/catalog/</param-name>
<param-value>http://myfirstdomain.com/catalog/</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>MyFirstRedirectFilter</filter-name>
<url-pattern>/secure/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>MyFirstRedirectFilter</filter-name>
<url-pattern>/catalog/*</url-pattern>
</filter-mapping>
Another way to achieve the same result:
<filter>
<filter-name>HttpRedirect</filter-name>
<filter-class>net.pieroxy.tools.j2ee.RedirectFilter</filter-class>
<init-param>
<param-name>https://</param-name>
<param-value>http://</param-value>
</init-param>
</filter>
<filter>
<filter-name>HttpsRedirect</filter-name>
<filter-class>net.pieroxy.tools.j2ee.RedirectFilter</filter-class>
<init-param>
<param-name>http://</param-name>
<param-value>https://</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>HttpsRedirect</filter-name>
<url-pattern>/secure/*</url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>HttpRedirect</filter-name>
<url-pattern>/catalog/*</url-pattern>
</filter-mapping>
