/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.catalina.valves.rewrite;

public interface RewriteMap {

    public String setParameters(String params);

    public String lookup(String key);
}

@@ -845,87 +845,1314 @@
 e;%0A%0A
-public interface RewriteMap %7B%0A%0A    public String setParameters(String params);%0A
+/**%0A * Interface for user defined lookup/replacement logic that can be defined in%0A * a %7B@code rewrite.config%7D file by a %7B@code RewriteMap%7D directive. Such a map%0A * can then be used by a %7B@code RewriteRule%7D defined in the same file.%0A * %3Cp%3E%0A * An example %7B@code rewrite.config%7D file could look like:%0A * %3Ccode%3E%0A * %3Cpre%3E%0A * RewriteMap uc example.UpperCaseMap%0A *%0A * RewriteRule %5E/(.*)$ $%7Buc:$1%7D%0A * %3C/pre%3E%0A * %3C/code%3E%0A *%0A * One parameter can be optionally appended to the %7B@code RewriteMap%7D directive.%0A * This could be used &ndash; for example &ndash; to specify a name of a file, that%0A * contains a lookup table used by the implementation of the map.%0A */%0Apublic interface RewriteMap %7B%0A%0A    /**%0A     * Optional parameter that can be defined through the %7B@code RewriteMap%7D%0A     * directive in the %7B@code rewrite.config%7D file.%0A     *%0A     * @param params the optional parameter%0A     * @return value is currently ignored%0A     */%0A    public String setParameters(String params);%0A%0A    /**%0A     * Maps a key to a replacement value.%3Cbr%3E%0A     * The method is free to return %7B@code null%7D to indicate, that the default%0A     * value from the %7B@code RewriteRule%7D directive should be used.%0A     *%0A     * @param key used by the actual implementation to generate a mapped value%0A     * @return mapped value or %7B@code null%7D%0A     */
 %0A   

Add javadoc for RewriteMap