| /* |
| * Copyright 2008 Google Inc. |
| * |
| * Licensed 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 com.google.gwt.uibinder.rebind; |
| |
| import java.util.ArrayList; |
| import java.util.HashMap; |
| import java.util.List; |
| import java.util.Map; |
| |
| /** |
| * Methods to dispense unique text tokens to be stitched into text, and to help |
| * replace the tokens with arbitrary content. Multiple tokenators can be used |
| * across the same body of text without fear of the tokens they vend colliding |
| * with each other. |
| * <p> |
| * A arbitrary metadata object ("info") can be associated with each token. |
| */ |
| public class Tokenator { |
| /** |
| * Resolves a token to its literal value. |
| */ |
| public interface Resolver { |
| String resolveToken(String token); |
| } |
| |
| /** |
| * Return values for {@link Tokenator#getOrderedValues(String)}. |
| */ |
| public static class ValueAndInfo { |
| public final String value; |
| public final Object info; |
| |
| private ValueAndInfo(String value, Object info) { |
| this.value = value; |
| this.info = info; |
| } |
| } |
| |
| private static final String TOKEN = "--token--"; |
| private static final String TOKEN_REGEXP = "\\-\\-token\\-\\-"; |
| private static int curId = 0; |
| |
| public static String detokenate(String betokened, Resolver resolver) { |
| StringBuilder detokenated = new StringBuilder(); |
| |
| int index = 0, nextToken = 0; |
| while ((nextToken = betokened.indexOf(TOKEN, index)) > -1) { |
| detokenated.append(betokened.substring(index, nextToken)); |
| |
| int endToken = betokened.indexOf(TOKEN, nextToken + TOKEN.length()); |
| String token = betokened.substring(nextToken, endToken + TOKEN.length()); |
| detokenated.append(resolver.resolveToken(token)); |
| |
| index = endToken + TOKEN.length(); |
| } |
| |
| detokenated.append(betokened.substring(index)); |
| return detokenated.toString(); |
| } |
| |
| public static boolean hasToken(String s) { |
| return s.matches(".*" + TOKEN_REGEXP + "\\d+" + TOKEN_REGEXP + ".*"); |
| } |
| |
| private static String nextToken() { |
| return TOKEN + (curId++) + TOKEN; |
| } |
| |
| private final Map<String, Object> infoMap = new HashMap<String, Object>(); |
| |
| private Map<String, String> tokenToResolved = new HashMap<String, String>(); |
| |
| /** |
| * Given a string filled with tokens created by |
| * {@link #nextToken(Object, String)}, returns it with the tokens replaced by |
| * the original strings. |
| */ |
| public String detokenate(String betokened) { |
| return detokenate(betokened, new Resolver() { |
| public String resolveToken(String token) { |
| return tokenToResolved.get(token); |
| } |
| }); |
| } |
| |
| /** |
| * Returns a list of the values represented by tokens in the given string, and |
| * the info objects corresponding to them. |
| */ |
| public List<ValueAndInfo> getOrderedValues(String betokened) { |
| return getOrderedValues(betokened, new Resolver() { |
| public String resolveToken(String token) { |
| return tokenToResolved.get(token); |
| } |
| }); |
| } |
| |
| /** |
| * Returns a token that can be used to replace the given String, to be |
| * restored by a later call to {@link #detokenate(String)}. Associates |
| * the token with the given info object. |
| * |
| * @param info An arbitrary object to associate with this token. Mmm, metadata |
| * @param resolved The value to replace this token with in later calls to |
| * {@link #detokenate(String)} |
| * @return the token |
| */ |
| public String nextToken(Object info, final String resolved) { |
| String token = nextToken(); |
| tokenToResolved.put(token, resolved); |
| infoMap.put(token, info); |
| return token; |
| } |
| |
| /** |
| * Like {@link #nextToken(String)} with no info. |
| */ |
| public String nextToken(String resolved) { |
| return nextToken(null, resolved); |
| } |
| |
| private List<ValueAndInfo> getOrderedValues(String betokened, Resolver resolver) { |
| List<ValueAndInfo> values = new ArrayList<ValueAndInfo>(); |
| |
| int index = 0, nextToken = 0; |
| while ((nextToken = betokened.indexOf(TOKEN, index)) > -1) { |
| int endToken = betokened.indexOf(TOKEN, nextToken + TOKEN.length()); |
| String token = betokened.substring(nextToken, endToken + TOKEN.length()); |
| values.add(new ValueAndInfo(resolver.resolveToken(token), infoMap.get(token))); |
| |
| index = endToken + TOKEN.length(); |
| } |
| |
| return values; |
| } |
| } |