解决Spring国际化文案占位符失效问题的方法

Z时代
2024-01-10
分类：综合

写在前面：接下来很长一段时间的文章主要会记录一些项目中实际遇到的问题及对应的解决方案，在相应代码分析时会直指问题所在，不会将无关的流程代码贴出，感兴趣的读者可以自行跟踪。同时希望大家能够将心得体会在评论区分享出来，让大家共同进步!

环境或版本：Spring 3.2.3

现象：利用Spring自带的MessageSource来处理国际化文案，us状态下的文案有部分占位符未被替换，cn状态下的正常。文案如下：

tms.pallet.order.box.qty=The total palletized boxes quantity {0} doesn't match with the received boxes quantity {1},Please double check!
tms.pallet.order.box.qty=打板总箱数件{0}，与订单收货总箱数{1}不一致。请检查！

直觉：是不是英文文案太长了，Spring处理时对长度做了限制，仔细想了想Spring应该不会设计的这么坑。

排查：断点跟踪Spring源码（入口：MessageSource的getMessage方法），最后发现了MessageFormat中这样的一段处理方法：


 // Indices for segments
  private static final int SEG_RAW   = 0;
  private static final int SEG_INDEX  = 1;
  private static final int SEG_TYPE   = 2;
  private static final int SEG_MODIFIER = 3; // modifier or subformat
/**
   * Sets the pattern used by this message format.
   * The method parses the pattern and creates a list of subformats
   * for the format elements contained in it.
   * Patterns and their interpretation are specified in the
   * <a href="#patterns" rel="external nofollow" >class description</a>.
   *
   * @param pattern the pattern for this message format
   * @exception IllegalArgumentException if the pattern is invalid
   */
  @SuppressWarnings("fallthrough") // fallthrough in switch is expected, suppress it
  public void applyPattern(String pattern) {
      StringBuilder[] segments = new StringBuilder[4];
      // Allocate only segments[SEG_RAW] here. The rest are
      // allocated on demand.
      segments[SEG_RAW] = new StringBuilder();
      int part = SEG_RAW;
      int formatNumber = 0;
      boolean inQuote = false;
      int braceStack = 0;
      maxOffset = -1;
      for (int i = 0; i < pattern.length(); ++i) {
        char ch = pattern.charAt(i);
        if (part == SEG_RAW) {
          if (ch == '\'') {
            if (i + 1 < pattern.length()
              && pattern.charAt(i+1) == '\'') {
              segments[part].append(ch); // handle doubles
              ++i;
            } else {
              inQuote = !inQuote;
            }
          } else if (ch == '{' && !inQuote) {
            part = SEG_INDEX;
            if (segments[SEG_INDEX] == null) {
              segments[SEG_INDEX] = new StringBuilder();
            }
          } else {
            segments[part].append(ch);
          }
        } else {
          if (inQuote) {       // just copy quotes in parts
            segments[part].append(ch);
            if (ch == '\'') {
              inQuote = false;
            }
          } else {
            switch (ch) {
            case ',':
              if (part < SEG_MODIFIER) {
                if (segments[++part] == null) {
                  segments[part] = new StringBuilder();
                }
              } else {
                segments[part].append(ch);
              }
              break;
            case '{':
              ++braceStack;
              segments[part].append(ch);
              break;
            case '}':
              if (braceStack == 0) {
                part = SEG_RAW;
                makeFormat(i, formatNumber, segments);
                formatNumber++;
                // throw away other segments
                segments[SEG_INDEX] = null;
                segments[SEG_TYPE] = null;
                segments[SEG_MODIFIER] = null;
              } else {
                --braceStack;
                segments[part].append(ch);
              }
              break;
            case ' ':
              // Skip any leading space chars for SEG_TYPE.
              if (part != SEG_TYPE || segments[SEG_TYPE].length() > 0) {
                segments[part].append(ch);
              }
              break;
            case '\'':
              inQuote = true;
              // fall through, so we keep quotes in other parts
            default:
              segments[part].append(ch);
              break;
            }
          }
        }
      }
      if (braceStack == 0 && part != 0) {
        maxOffset = -1;
        throw new IllegalArgumentException("Unmatched braces in the pattern.");
      }
      this.pattern = segments[0].toString();
  }

上面的这段代码写的有点让人费解，略微奇特，我们主要看第一个逻辑分支：对每一个待处理的国际化文案模板串中的字符进行遍历，当字符为"'"时，判断后一个字符是否也为“'”，如果是则将“‘”拼接到已处理的StringBuilder中，不是则将inQuote至为True，如果该字符不会‘{'且inQuote为false则将part重新置为0，并且segments[SEG_INDEX]=null的话重新创建StringBuilder对象，否则继续拼接。

原因分析：

结合我们配置的英文文案（其中一共有两个占位符，在这这两占位符之前有一个单引号），根据上面Spring的处理源码看，实际处理会是：对该字符串进行逐个字符处理，逐个拼接到已处理的StringBuilder中，当处理到‘{'时，此处part将被置为1，同时segments第1个存储位上会引用StringBuilder类型的对象，程序继续处理下面的待处理的字符，继续拼接（请自行看part！= SEG_RAW的逻辑分支），直到处理到‘}'时，part被重新赋值为0，sefgments的其他位被清空，于是继续处理下面的字符串继续拼接，处理到单引号时，inQuote被置为True，接下来就一路拼接了，不再对后面的“{“做占位符处理。