/**
 * Copyright 2005-2016 Red Hat, Inc.
 *
 * Red Hat 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 io.fabric8.karaf.core.properties;

import java.util.Dictionary;
import java.util.Map;

public interface PlaceholderResolver {

    String resolve(String value);

    String replace(String value);

    boolean replaceIn(StringBuilder value);

    boolean replaceAll(Dictionary<String, Object> dictionary);

    boolean replaceAll(Map<String, Object> dictionary);
}

@@ -760,187 +760,1241 @@
 r %7B%0A
-%0A    String resolve(String value);%0A%0A    String replace(String value);%0A%0A    boolean replaceIn(StringBuilder value);%0A%0A    boolean replaceAll(Dictionary%3CString, Object%3E dictionary);%0A
+   /**%0A     * Resolve a placeholder using the strategy indicated by the prefix%0A     *%0A     * @param value the placeholder to resolve%0A     * @return the resolved value, default the input value%0A     */%0A    String resolve(String value);%0A%0A   /**%0A     * Replaces all the occurrences of variables with their matching values from the resolver using the given source string as a template.%0A     *%0A     * @param source the string to replace in%0A     * @return the result of the replace operation%0A     */%0A    String replace(String value);%0A%0A    /**%0A     * Replaces all the occurrences of variables within the given source builder with their matching values from the resolver.%0A     *%0A     * @param value the builder to replace in%0A     * @rerurn true if altered%0A     */%0A    boolean replaceIn(StringBuilder value);%0A%0A    /**%0A     * Replaces all the occurrences of variables within the given dictionary%0A     *%0A     * @param dictionary the dictionary to replace in%0A     * @rerurn true if altered%0A     */%0A    boolean replaceAll(Dictionary%3CString, Object%3E dictionary);%0A%0A    /**%0A     * Replaces all the occurrences of variables within the given dictionary%0A     *%0A     * @param dictionary the dictionary to replace in%0A     * @rerurn true if altered%0A     */
 %0A   

Add Javadoc to PlaceholderResolver