从零学Android（九）、Android资源类型之String资源

String资源比较常用，而且规范也比较多，这里稍作记录。其它资源使用都比较简单，就不记录了。

概述

字符串资源是给应用程序提供可选文本样式和格式的文本字符串。所有的字符串资源都具有使用一些样式和格式化参数的能力。它可以分为以下三种类别：

一、单一字符串String

提供单一的字符串资源。

二、字符串数组String Array

提供一个字符串数据资源。

三、区分单复数的数量字符串Quantity Strings (Plurals)

提供在单复数不同情况下的不同字符串资源。都说这个在开发中貌似没啥用，就不记录了，有兴趣的大致了解一下就行了。

1.单一字符串String

单一的字符串资源可以被应用程序代码或其它诸如布局资源XML文件引用。由于单一字符串资源的ID是name属性名，而不是XML文件的名称，所以它可以喝其它一些简单资源组合到一个XML文件中，放置到一个标签下。

文件位置：res/values/filename.xml

其中的文件名是任意的，元素的name属性取值则为资源ID。

编译后的数据类型：String

资源的引用：

在java文件代码中：R.string.string_name

在XML文件中：@string/string_name

语法：

    text_string

标签元素说明：

标签：这个属性是必须。而且它必须作为文档的根元素。

标签：可以包含样式的字符串。注意：如果字符串内容包含单引号或者双引号，必须做转义。

name属性：字符串的名称。将作为资源ID。

例子：编写res/values/strings.xml文件：

    Hello!

在XML中引用：

在java代码中使用：

String string = getString(R.string.hello);

我们也能通过使用Context的 getString(int)或者 getText(int)方法去获取字符串资源。 getText(int)方法会获取到一个富文本样式的字符串。

2.字符串数组String Array

定义了给应用程序代码使用的字符串数组资源。它和单一字符串资源一样，使用name属性作为ID，可以和其它简单资源组合在一个XML文件中。

文件位置：res/values/filename.xml

其中的文件名称任意。而元素的name属性将作为资源ID使用。

编译后的资源类型：字符串数组-String[]

资源的引用：只能在java代码中引用：R.array.string_array_name

语法：

    
        text_string
    

标签元素说明：

标签：这个属性是必须。而且它必须作为文档的根元素。

标签：定义一个字符串数组，可以包含多个元素标签。

name属性：字符串数组的名称。将作为资源ID。

标签：可以包含样式的字符串资源，它的值可以是引用自另外一个字符串资源。必须作为 标签的子元素。同样，内容总有单双引号时要做转义处理。

例子：编写res/values/strings.xml文件：

    
        Mercury
        Venus
        Earth
        Mars
    

在Java代码中的使用：

Resources res = getResources();
String[] planets = res.getStringArray(R.array.planets_array);

3.样式和格式化

3.1 转义单引号和双引号

如果在字符串内容中包含一个单引号（‘），我们必须使用反斜线去对它进行转义（\'）或者使用双引号（""）将整个内容包裹起来。比如说：

This\'ll work
"This'll also work"
This doesn't work
    

如果在字符串内容中包含双引号（”“）。我们就只能去使用转义字符了(\")。

This is a \"good string\".
This is a "bad string".
    
'This is another "bad string".'
    

3.2 格式化字符串

我们可以通过使用String.format(String, Object...)将我们的格式化参数插入到字符串资源中。如下的字符串资源：

Hello, %1$s! You have %2$d new messages.

在上面这个字符串资源中，存在两个格式化参数： %1$s代表一个字符串类型参数，%2$d则代表一个十进制数。所以我们可以在代码中这样去格式化它：

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

3.3 包含HTML标签的样式

我们可以在我们的字符串资源中添加HTML标签。比如：

    Welcome to Android!

支持的HTML标签包含：

【1】用来加粗

【2】 用来表示斜体字

【3】 用来添加下划线

有时候，我们可能需要给一些格式化的字符串资源添加样式。一般来说，样式不会对格式化资源起作用，因为String.format(String, Object...)方法会清除掉格式化字符串所有的样式信息。这个时候，我们需要将HTML标签进行一个转义操作（即使用对应的字符实体），然后再在格式化操作完成后，调用fromHtml(String)来获取字符串资源。比如说：

1.使用HTML字符实体保存我们的样式字符串：

  Hello, %1$s! You have <b>%2$d new messages.

在这个格式化字符串中，添加有一个 标签，注意其中的左括号使用了转义字符实体，即 <符号。

2.正常格式化字符串资源。然后调用fromHtml(String)方法转换HTML文本：

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

由于 fromHtml(String)方法会格式化所有的HTML实体，所以我们需要使用 htmlEncode(String)方法确认在进行格式化的过程中，那些可能存在的HTML字符都被转义了。所以，上面的代码应该修改如下：

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);

3.4 Spannables的样式

Spannable是支持使用诸如颜色和字体权重（font weight）等字体属性样式的文本对象。我们可以通过SpannableStringBuilder去创建我们的文本对象，然后使用android.text.style包下的样式应用到文本对象中。

我们可以使用下面这几个帮助方法去创建我们的文本对象：

/**
 * Returns a CharSequence that concatenates the specified array of CharSequence
 * objects and then applies a list of zero or more tags to the entire range.
 *
 * @param content an array of character sequences to apply a style to
 * @param tags the styled span objects to apply to the content
 *        such as android.text.style.StyleSpan
 *
 */
private static CharSequence apply(CharSequence[] content, Object... tags) {
    SpannableStringBuilder text = new SpannableStringBuilder();
    openTags(text, tags);
    for (CharSequence item : content) {
        text.append(item);
    }
    closeTags(text, tags);
    return text;
}

/**
 * Iterates over an array of tags and applies them to the beginning of the specified
 * Spannable object so that future text appended to the text will have the styling
 * applied to it. Do not call this method directly.
 */
private static void openTags(Spannable text, Object[] tags) {
    for (Object tag : tags) {
        text.setSpan(tag, 0, 0, Spannable.SPAN_MARK_MARK);
    }
}

/**
 * "Closes" the specified tags on a Spannable by updating the spans to be
 * endpoint-exclusive so that future text appended to the end will not take
 * on the same styling. Do not call this method directly.
 */
private static void closeTags(Spannable text, Object[] tags) {
    int len = text.length();
    for (Object tag : tags) {
        if (len > 0) {
            text.setSpan(tag, 0, len, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
        } else {
            text.removeSpan(tag);
        }
    }
}

下面 bold， italic和 color三个方法，演示了怎么通过调用上面的帮助方法去使用 android.text.style包下的样式：

/**
 * Returns a CharSequence that applies boldface to the concatenation
 * of the specified CharSequence objects.
 */
public static CharSequence bold(CharSequence... content) {
    return apply(content, new StyleSpan(Typeface.BOLD));
}

/**
 * Returns a CharSequence that applies italics to the concatenation
 * of the specified CharSequence objects.
 */
public static CharSequence italic(CharSequence... content) {
    return apply(content, new StyleSpan(Typeface.ITALIC));
}

/**
 * Returns a CharSequence that applies a foreground color to the
 * concatenation of the specified CharSequence objects.
 */
public static CharSequence color(int color, CharSequence... content) {
    return apply(content, new ForegroundColorSpan(color));
}

下面是一个应用样式的例子：

// Create an italic "hello, " a red "world",
// and bold the entire sequence.
CharSequence text = bold(italic(res.getString(R.string.hello)),
    color(Color.RED, res.getString(R.string.world)));