Android字符串进阶

一、特殊字符的输入

本文按照遇到问题的思路展开：

(一) 在Res下String.xml向字符串中插入“&”符号报错

如下图所示：

翻译：在对实体的引用中，实体名必须紧跟在“&”后。

查找知道：这设计到HTML语言的字符集知识：

在网页中除了可显示常见的ASCII字符和汉字外，HTML还有许多特殊字符，它们一起构成了HTML字符集。有2种情况需要使用特殊字符，一是网页中有其特殊意义的字符，二是键盘上没有的字符。 字符集HTML字符可以用一些代码来表示，代码可以有2种表示方式。即字符代码（命名实体）和数字代码（编号实体）。字符代码以&符开始，以分号结束，其间是字符名；数字代码也以&符开始，以分号结束，其间是#号加编号。示例见下图，完整的html字符集在文后Excel附件中，并非全部，仅常用。

(二) 这涉及到了Android对此有专门的处理

文档中有专门说明，如下图所示：

字符串可以包含风格标签（styling tag），需要注意的是：你必须转码（escaping）缩写号( apostrophe即’)和引用号(quotation mark 即”或’)。你可风格化（style）和格式化（format）字符串。

1， 对缩写号和引号的处理

文档示例如下：

正确的转码是：

A:用双引号将字符串全部圈住

B:使用转义符号“\”

错误做法：

A：不处理

错误如下图所示：

正确方法见上正确转码

B：使用html的字符代码代替缩写号

错误如下图所示：

对以上错误的修正：

Note：因为xml并不是完全实时编译，所以可以错误的xml语句并不当时报错，但当项目启动时，会报错。

2， 格式化字符串（format string）

即字符串中保留参数位作为模板，可以传入变量，转换。eg，SimpleDateFormat

模板为：yyyy-MM-dd，传入Date，得到1999-10-10

String.xml文件中代码如下：

<string name="welcome_messages">Hello, %1$s! You have %2$d new messages.</string> 

Java中代码如下：

Resources res = getResources(); 
String text = String.format(res.getString(R.string.welcome_messages), username, mailCount); 

有必要说明的是：

%：产生字面值，貌似是这个意思。

1$:代表第一个参数

2$:代表第二个参数

s：参数类型是字符串

d：参数类型是数字

More：http://dlc.sun.com.edgesuite.net/jdk/jdk-api-localizations/jdk-api-zh-cn/builds/latest/html/zh_CN/api/java/util/Formatter.html#syntax

Java代码如下：

3， 在字符串中使用Html标记风格符号（Html makeup）

即Html的字符代码。一步一步，终于排除到问题的可能解答处。

1. Android支持的Html元素，如下图所示：

这三个字体标签，能够直接使用，称之为“styled text”。<b>内即为黑体字例如：

<string name="welcome">Welcome to <b>Android</b>!</string> 

但是如果将以上的“<”分解，使用Html字符代码的话，用法将有所不同，这两个字符代码：

l “&lt;”对应的字符代码为：&lt;

l “>”对应的字符代码为：&gt;

如下：

<string name="welcome_messages">Hello, %1$s! You have &lt;b>%2$d new messages&lt;/b>.</string> 

称之为“HTML-escaped”text，因为最终文本的显示要为styled text，所以需要将Html-styled text转为 styled text，调用fromHtml()方法。代码如下：

Resources res = getResources(); 
String text = String.format(res.getString(R.string.welcome_messages), username, mailCount); 
CharSequence styledText = Html.fromHtml(text); 

因为fromHtml()方法转换的对象是html-styled，所以调用此方法之前，必须使用文本格式化（formated text）和TextUtil.htmlEncode()方法，确保所有的可能html字符已经被转码（escape）。如果代码中含有特殊字符“&”“&lt;”等，必须调用以上方法。代码如下：

String escapedUsername = TextUtil.htmlEncode(username); 
 
Resources res = getResources(); 
String text = String.format(res.getString(R.string.welcome_messages), escapedUsername, mailCount); 
CharSequence styledText = Html.fromHtml(text); 
 

 

测试：如果name中含有html character，不转为html-styled，会有什么情况发生。

xml中字符串format如下：

<string name="welcome_messages">Hello, %1$s! You have &lt;b>%2$d new messages&lt;/b>.</string> 

 

测试代码如下：

public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.main); 
         
        Resources rs = getResources(); 
        mTextView1 = (TextView) findViewById(R.id.textView1); 
        mTextvView2 = (TextView) findViewById(R.id.textView2); 
         
        String name = new  String("<Mike>"); 
        int count = 12345; 
 
        //未转为html-styled 
        format1 = String.format(rs.getString(R.string.welcome_messages), name,count); 
        CharSequence styledText1 = Html.fromHtml(format1); 
        mTextView1.setText(styledText1); 
         
        //转为html-styled 
        format2 = String.format(rs.getString(R.string.welcome_messages), TextUtils.htmlEncode(name),count); 
        CharSequence styledText2 = Html.fromHtml(format2); 
        mTextvView2.setText(styledText2); 
             
    } 

模拟器显示如下：

2. 进入TextUtil类中，htmlEncode()方法做格式化字符代码的转换。且Android中，只接受以上五种特殊字符。代码如下：

/** 
     * Html-encode the string. 
     * @param s the string to be encoded 
     * @return the encoded string 
     */ 
    public static String htmlEncode(String s) { 
        StringBuilder sb = new StringBuilder(); 
        char c; 
        for (int i = 0; i < s.length(); i++) { 
            c = s.charAt(i); 
            switch (c) { 
            case '<': 
                sb.append("&lt;"); //$NON-NLS-1$ 
                break; 
            case '>': 
                sb.append("&gt;"); //$NON-NLS-1$ 
                break; 
            case '&': 
                sb.append("&amp;"); //$NON-NLS-1$ 
                break; 
            case '\'': 
                sb.append("&apos;"); //$NON-NLS-1$ 
                break; 
            case '"': 
                sb.append("&quot;"); //$NON-NLS-1$ 
                break; 
            default: 
                sb.append(c); 
            } 
        } 
        return sb.toString(); 
    } 

(三) 源码中

有三处出现htmlEncode()方法。

如下图所示：

第一处：即上文提到的TextUtils类

第二处： TextUtils的测试类，暂时不知道有什么用处

第三处：XmlParser类

定位到代码，如下：

向上查看代码块描述：

显然和之上的分析吻合。这些方法是对xml的输出，输出需要标准化，即 被未来的styled text（或者是其他）准确转换convert。

(四） 流程图

 

 

 

 

(五) 单复数的处理(string format 引入的问题)

文档中说明如下：

测试各个关键字的效果如何。

Xml中定义plurals，如下：

<plurals name="numberOfSongsAvailable"> 
        <item quantity="zero">Zero song found.</item> 
        <item quantity="one">One song found.</item> 
        <item quantity="two">Two song found.</item> 
        <item quantity="few">Few song found.</item> 
        <item quantity="other">Other song found.</item> 
        <item quantity="many">Many song found.</item> 
    </plurals> 

代码中如下：

public void onCreate(Bundle savedInstanceState) { 
       super.onCreate(savedInstanceState); 
       setContentView(R.layout.main); 
        
       int count1 = 0; 
       Resources res = getResources(); 
       String songsFound1 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count1, count1); 
       TextView textView1 = (TextView) findViewById(R.id.textView1); 
       textView1.setText(songsFound1); 
        
       int count2 = 1; 
       String songsFound2 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count2, count2); 
       TextView textView2 = (TextView) findViewById(R.id.textView2); 
       textView2.setText(songsFound2); 
        
       int count3 = 2; 
       String songsFound3 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count3, count3); 
       TextView textView3 = (TextView) findViewById(R.id.textView3); 
       textView3.setText(songsFound3); 
        
       int count4 = 3; 
       String songsFound4 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count4, count4); 
       TextView textView4 = (TextView) findViewById(R.id.textView4); 
       textView4.setText(songsFound4); 
        
       int count5 = 4; 
       String songsFound5 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count5, count5); 
       TextView textView5 = (TextView) findViewById(R.id.textView5); 
       textView5.setText(songsFound5); 
        
       int count6 = 1000; 
       String songsFound6 = res.getQuantityString(R.plurals.numberOfSongsAvailable, count6, count6); 
       TextView textView6 = (TextView) findViewById(R.id.textView6); 
       textView6.setText(songsFound6); 
        
        
   } 
 

模拟器显示如下：

即在中文状态下，只支持one和other两个关键字。

 

二、字符及字符串的测量和处理

需求：实现长文字的滚动停留，所以需要将长字符串截取成指定TextView长度的字符串数组 ，然后使用ViewFilpper实现。

分割代码如下：

/* 
 * 根据要求分割字符串 
 */ 
public static String[] getLineStrs(String content, Paint paint, float width, float textSize) { 
    paint.setTextSize(textSize);//Note1：测量的工具首先需要定义单位 
 
    int index = 0; 
    int start = 0; 
    int end = 0; 
     
    float textLength = paint.measureText(content); 
 
    int lineNum = (int) Math.ceil(1.5*textLength / width) ;//Note2：计算行数因为判断的不准确，所以增加余量1.5倍，最后处理 
    String[] mSplitTextParts = new String[lineNum]; 
     
    for (int i = 0; i <= content.length(); i++) { 
        end = i; 
 
        float measureLength = paint.measureText(content, start, end);//Note3:[start,end)范围的字符串 
 
        if (measureLength >= width) { 
                mSplitTextParts[index] = content.substring(start, end);//Note4:[start,end)范围的字符串 
                start = end; 
                index++;     
        } 
 
        if (end == content.length()) { 
            mSplitTextParts[index] = content.substring(start, end); 
            return Arrays.copyOf(mSplitTextParts, index);//Note5：因为行数判断的不准确，所以需要清除掉未赋值的null值字符串 
        } 
} 
    return null; 
  

猜测分割不准的原因是：中英文混杂。可能是半角全角的问题。

测试后发现：

1， 全英文状态下，半角全角计算的标准行数（未经过1.5倍的余量修正）都ok。

2， 全中文状态下，半角全角计算的标准行数（未经过1.5倍的余量修正）都ok。

3， 在中英文混杂状态下，计算的标准行数比实际截取的行数要大。在这里存疑。有知道的朋友，请留言。

三、字体属性及测量（FontMetrics）

最近的一个模块正好用到字体的相关内容，整理出来。

(一) 字体的几个参数 ，以Android API文档定义为准，见下图

要点如下：

1. 基准点是baseline

2. Ascent是baseline之上至字符最高处的距离

3. Descent是baseline之下至字符最低处的距离

4. Leading文档说的很含糊，其实是上一行字符的descent到下一行的ascent之间的距离

5. Top指的是指的是最高字符到baseline的值，即ascent的最大值

6. 同上，bottom指的是最下字符到baseline的值，即descent的最大值

 

Note:网上有很多错误的图，如果有疑问，就参看文档，区分对错。

 

为了帮助理解，我特此搜索了不同的示意图。对照示意图，会很容易理解FontMetrics的参数。

pic-1

 

pic-2

 

pic-3

 

pic-4

 

pic-5

pic-6

(二) 测试

 1，测试的代码直接使用网上的代码，因为重复着众多，无所给出原始出处，故不注出。

我增加了Bitmap作为输出显示，完整代码如下：

public class FontMetricsDemoActivity extends Activity { 
    private Canvas canvas; 
 
    /** Called when the activity is first created. */ 
    @Override 
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.main); 
         
        Paint textPaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
        textPaint.setTextSize( 55); 
        textPaint.setColor( Color.WHITE); 
 
        // FontMetrics对象 
        FontMetrics fontMetrics = textPaint.getFontMetrics(); 
        String text = "abcdefghijklmnopqrstu"; 
         
         
 
        // 计算每一个坐标 
        float baseX = 0; 
        float baseY = 100; 
        float topY = baseY + fontMetrics.top; 
        float ascentY = baseY + fontMetrics.ascent; 
        float descentY = baseY + fontMetrics.descent; 
        float bottomY = baseY + fontMetrics.bottom; 
        float leading = baseY + fontMetrics.leading; 
         
         
        Log.d("fontMetrics", "baseX    is:" + 0); 
        Log.d("fontMetrics", "baseY    is:" + 100); 
        Log.d("fontMetrics", "topY     is:" + topY); 
        Log.d("fontMetrics", "ascentY  is:" + ascentY); 
        Log.d("fontMetrics", "descentY is:" + descentY); 
        Log.d("fontMetrics", "bottomY  is:" + bottomY); 
        Log.d("fontMetrics", "leading  is:" + leading); 
 
         
         
        Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.fontmetrics); 
        Bitmap mutableBitmap = bitmap.copy(Bitmap.Config.ARGB_8888, true); 
         
        canvas  = new Canvas(mutableBitmap); 
         
         
 
        // 绘制文本 
        canvas.drawText(text, baseX, baseY, textPaint); 
 
        // BaseLine描画 
        Paint baseLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
         
        baseLinePaint.setColor( Color.RED); 
        canvas.drawLine(0, baseY, canvas.getWidth(), baseY, baseLinePaint); 
 
        // Base描画 
        canvas.drawCircle( baseX, baseY, 5, baseLinePaint); 
 
        // TopLine描画 
        Paint topLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
        topLinePaint.setColor( Color.LTGRAY); 
        canvas.drawLine(0, topY, canvas.getWidth(), topY, topLinePaint); 
 
        // AscentLine描画 
        Paint ascentLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
        ascentLinePaint.setColor( Color.GREEN); 
        canvas.drawLine(0, ascentY, canvas.getWidth(), ascentY, ascentLinePaint); 
 
        // DescentLine描画 
        Paint descentLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
        descentLinePaint.setColor( Color.YELLOW); 
        canvas.drawLine(0, descentY, canvas.getWidth(), descentY, descentLinePaint); 
 
        // ButtomLine描画 
        Paint bottomLinePaint = new Paint( Paint.ANTI_ALIAS_FLAG); 
        bottomLinePaint.setColor( Color.MAGENTA); 
        canvas.drawLine(0, bottomY, canvas.getWidth(), bottomY, bottomLinePaint);  
         
        ImageView imageView = (ImageView) findViewById(R.id.imageView1); 
        imageView.setImageBitmap(mutableBitmap); 
         
    } 
} 

 log显示如下：

Note1：注意到各个数值都是整数，这是建立在baseY=100的情况下，去掉baseY,重新运行代码，log如下：

Note2: 参照线为baseline，即baseline=0的情况下，其他各线的数值。leading = 0,即行间距=0

2，以上是根据paint设置，获取相关的FontMetrics属性，并且只绘制了一行字符串，我们猜想，如果是多行，是否可以获得行间距leanding，代码如下：

//test_multiply_lines 
        TextView textView = (TextView) findViewById(R.id.textView1); 
        String textMultiLines = "abcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstuabcdefghijklmnopqrstu"; 
        textView.setTextSize(55); 
        textView.setText(textMultiLines); 
         
        FontMetrics fontMetrics2 = textView.getPaint().getFontMetrics(); 
         
         
 
        // 计算每一个坐标 
 
        float topY = fontMetrics2.top; 
        float ascentY = fontMetrics2.ascent; 
        float descentY =  fontMetrics2.descent; 
        float bottomY = fontMetrics2.bottom; 
        float leading =  fontMetrics2.leading; 
         
         
 
        Log.d("fontMetrics", "topY     is:" + topY); 
        Log.d("fontMetrics", "ascentY  is:" + ascentY); 
        Log.d("fontMetrics", "descentY is:" + descentY); 
        Log.d("fontMetrics", "bottomY  is:" + bottomY); 
        Log.d("fontMetrics", "leading  is:" + leading); 

log如下：

Note：显然，即使是多行的情况下，仍不能获得leading。

3，如果text是单行，获得各个属性将会怎样，代码如下：

String text = "abcdefghijklmnopqrstu"; 
        TextView textView = (TextView) findViewById(R.id.textView1); 
        textView.setTextSize(55); 
        textView.setText(text); 
         
        FontMetrics fontMetrics = textView.getPaint().getFontMetrics(); 
 
        // 计算每一个坐标 
        float baseX = 0; 
        float baseY = 100; 
        float topY = baseY + fontMetrics.top; 
        float ascentY = baseY + fontMetrics.ascent; 
        float descentY = baseY + fontMetrics.descent; 
        float bottomY = baseY + fontMetrics.bottom; 
        float leading =  fontMetrics.leading; 
         
         
 
        Log.d("fontMetrics", "topY     is:" + fontMetrics.top); 
        Log.d("fontMetrics", "ascentY  is:" + fontMetrics.ascent); 
        Log.d("fontMetrics", "descentY is:" + fontMetrics.descent); 
        Log.d("fontMetrics", "bottomY  is:" + fontMetrics.bottom); 
        Log.d("fontMetrics", "leading  is:" + fontMetrics.leading); 

log如下图所示：

Note：与多行获得的属性都相同。

 

结论：

A:虽然paint和textView所设置的textSize均为55，且为相同的字符串，但是两个获得的FontMetrics属性值并不相同。但是，我们发现，做除法之后，均为1.5倍关系。做出猜测，即Paint下，为mdpi对应的size，而TextView的size已经关联到了显示屏幕本身的320dip。所以获得属性值均为整1.5倍数

B:各种情况下，均未获得leading值。

本文出自 “小新专栏” 博客，请务必保留此出处http://mikewang.blog.51cto.com/3826268/864801