在真实的工程开发中，一个富文本编辑器，不是仅仅可以编辑显示，还需要处理富文本的转换与解析，方便传输与存储。一般来说，HTML文本是比较理想的网络传输格式。如何将安卓的span式富文本和HTML文本之间进行互转，是本篇介绍的重点。
首先，介绍富文本转成HTML。我们需要做的，是遍历文本中的span对象，并用合适的html标签来修饰span对象对应的文本。示例代码如下：
public static String convertSpannedToRichText(Spanned spanned) {
List<CharacterStyle> spanList =
Arrays.asList(spanned.getSpans(0, spanned.length(), CharacterStyle.class));
SpannableStringBuilder stringBuilder = new SpannableStringBuilder(spanned);
for (CharacterStyle characterStyle : spanList) {
int start = stringBuilder.getSpanStart(characterStyle);
int end = stringBuilder.getSpanEnd(characterStyle);
if (start >= 0) {
String htmlStyle = handleCharacterStyle(characterStyle,
stringBuilder.subSequence(start, end).toString());
if (htmlStyle != null) {
stringBuilder.replace(start, end, htmlStyle);
}
}
}
return stringBuilder.toString();
}
private static String handleCharacterStyle(CharacterStyle characterStyle, String text) {
if (characterStyle instanceof BoldSpan) {
return String.format("<b>%s</b>", text);
} else if (characterStyle instanceof UrlSpan) {
UrlSpan span = (UrlSpan) characterStyle;
return String.format("<a href=\"%s\">%s</a>", span.getValue(), text);
} else if (characterStyle instanceof EmojiSpan) {
EmojiSpan span = (EmojiSpan) characterStyle;
return String.format("<img src=\"%s\" alt=\"[%s]\" class=\"yiqiFace\"/>",
span.getUrl(), span.getName());
} else if (characterStyle instanceof FakeImageSpan) {
FakeImageSpan span = (FakeImageSpan) characterStyle;
return String.format("<img src=\"%s\" />", span.getValue());
} if (characterStyle instanceof ImageSpan) {
ImageSpan span = (ImageSpan) characterStyle;
return String.format("<img src=\"%s\" />", TextUtils.isEmpty(span.getUrl()) ?
span.getFilePath() : span.getUrl());
}
return null;
}
注：上述代码在处理一些复杂的span嵌套情况时，可能会有问题。如果要考虑到span嵌套的情况，可能需要全新的思路和写法。后续如果有改进会再更新。
下面介绍如何将HTML转化为安卓富文本。这里使用了一个开源库：TagSoup，来处理Html内容的解析。TagSoup是一个解析HTML的java开源库，一般用作HTML的正则化。TagSoup的介绍可以参考网上其它文章，这里不再赘述。而我们要做的，是实现自己的SAX内容处理器，实现org.xml.sax.ContentHandler接口，并set到TagSoupParser中。具体代码都在:RichTextConvertor这个类中。下面节选几个比较重要的方法：
@Override
public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException {
handleStartTag(localName, atts);
}
@Override
public void endElement(String uri, String localName, String qName) throws SAXException {
handleEndTag(localName);
}
@Override
public void characters(char[] ch, int start, int length) throws SAXException {
StringBuilder sb = new StringBuilder();
for (int i = 0; i < length; i++) {
char c = ch[i + start];
sb.append(c);
}
mResult.append(sb);
}
// ****************************************** Handle Tags *******************************************
private void handleStartTag(String tag, Attributes attributes) {
if (tag.equalsIgnoreCase("a")) {
startAHref(attributes);
} else if (tag.equalsIgnoreCase("img")) {
startImg(attributes);
} else if (tag.equalsIgnoreCase("b") || tag.equalsIgnoreCase("strong")) {
start(new Bold());
}
}
private void handleEndTag(String tag) {
if (tag.equalsIgnoreCase("a")) {
endAHref();
} else if (tag.equalsIgnoreCase("b")|| tag.equalsIgnoreCase("strong")) {
end(Bold.class, new BoldSpan());
}
}
private void startAHref(Attributes attributes) {
String href = attributes.getValue("", "href");
int len = mResult.length();
mResult.setSpan(new Href(href), len, len, Spanned.SPAN_MARK_MARK);
}
private void start(Object mark) {
int len = mResult.length();
mResult.setSpan(mark, len, len, Spanned.SPAN_MARK_MARK);
}
private void endAHref() {
int len = mResult.length();
Object obj = getLast(Href.class);
int where = mResult.getSpanStart(obj);
mResult.removeSpan(obj);
if (where != len) {
Href h = (Href) obj;
if (h.mHref != null) {
mResult.setSpan(new UrlSpan(h.mHref),
where, len, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
}
}
}
private void end(Class<? extends Object> kind, Object repl) {
int len = mResult.length();
Object obj = getLast(kind);
int where = mResult.getSpanStart(obj);
mResult.removeSpan(obj);
if (where != len) {
// Note: use SPAN_EXCLUSIVE_EXCLUSIVE, the TemporarySpan will be replaced by a SPAN_EXCLUSIVE_INCLUSIVE span
mResult.setSpan(new TemporarySpan(repl), where, len, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
}
}
private Object getLast(Class<? extends Object> kind) {
/*
* This knows that the last returned object from getSpans()
* will be the most recently added.
*/
Object[] objs = mResult.getSpans(0, mResult.length(), kind);
return objs.length == 0 ? null : objs[objs.length - 1];
}
private void startImg(Attributes attributes) {
int len = mResult.length();
String alt = attributes.getValue("", "alt");
String src = attributes.getValue("", "src");
String classString = attributes.getValue("", "class");
// Unicode Character 'OBJECT REPLACEMENT CHARACTER' (U+FFFC)
// see http://www.fileformat.info/info/unicode/char/fffc/index.htm
mResult.append("\uFFFC");
FakeImageSpan imageSpan = new FakeImageSpan(src);
mResult.setSpan(imageSpan, len, len + 1, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
}
private static class Bold {
}
这里需要分三种情况进行讨论：
- 对于img这种标签，我们取出其中的属性，就可以进行替换（有的读者可能发现，在img标签的处理上，我使用了一个叫做FakeImageSpan的类。这时因为在传输、存储过程中，图片都是使用了url远程路径或者本地路径，需要先进行下载或加载，才可以使用真正的ImageSpan进行替换）；
- 对于href这种标签，需要先读取内容，直到出现截止标签，再用真正的URL内容替换掉占位span；
- 对于b和strong这样的标签，先用占位span占位后，在替换成TemporarySpan，并采用SPAN_EXCLUSIVE_EXCLUSIVE格式。在后面处理完所有输入后，统一替换成相应得span，并采取SPAN_EXCLUSIVE_INCLUSIVE格式，这样后续的输入都会采用相同的格式。具体的处理请参考RichTextConvertor。
