config-servlet/src/main/java/org/ocpsoft/rewrite/servlet/config/Redirect.java
public static Redirect permanent(final String location)
   {
      return new Redirect(location, RedirectType.PERMANENT) {
         @Override
         public String toString()
         {
            return "Redirect.permanent(\"" + location + "\")";
         }
      };
   }
public static Redirect permanent(final String location)
   {
      return new Redirect(location, RedirectType.PERMANENT) {
         @Override
         public String toString()
         {
            return "Redirect.permanent(\"" + location + "\")";
         }
      };
   }
Create an {@link Operation} that issues a permanent {@link Redirect} ( 301
{@link HttpServletResponse#SC_MOVED_PERMANENTLY} ) to the given location. If the given location is not the same as
{@link HttpServletRewrite#getAddress()}, this will change the browser {@link URL} and result in a new request.

<p>
Note that in order to redirect to a resource within the {@link ServletContext}, you must prepend the
{@link ServletContext#getContextPath()}.

<p>
For example:<br/>
<code>
Redirect.permanent(contextPath + "/example/location.html") <br>
</code>

<p>
The given location may be parameterized:
<p>
<code>
/store/global
/store/{category} <br>
/store/{category}/item/{itemId} <br>
...
</code>
<p>

@param location {@link ParameterizedPattern} specifying the target location.

@see ConfigurationRuleParameterBuilder#where(String)