本文按照遇到问题的思路展开:
(一) 在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”。内即为黑体字例如:
- <string name="welcome">Welcome to <b>Androidb>!string>
但是如果将以上的“<”分解,使用Html字符代码的话,用法将有所不同,这两个字符代码:
l “<”对应的字符代码为:<
l “>”对应的字符代码为:>
如下:
- <string name="welcome_messages">Hello, %1$s! You have <b>%2$d new messages</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)。如果代码中含有特殊字符“&”“<”等,必须调用以上方法。代码如下:
- 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 <b>%2$d new messages</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("
" ); - 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("<"); //$NON-NLS-1$
- break;
- case '>':
- sb.append(">"); //$NON-NLS-1$
- break;
- case '&':
- sb.append("&"); //$NON-NLS-1$
- break;
- case '\'':
- sb.append("'"); //$NON-NLS-1$
- break;
- case '"':
- sb.append("""); //$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两个关键字。
The End!