BidiFormatter

public final class BidiFormatter
extends Object

实用程序类用于格式化文本，以便在潜在的反方向性上下文中显示，而不会造成混淆。 上下文的方向性是在格式化器创建时设置的，文本的方向性可以在知道时估计或传递。

要支持低于 JELLY_BEAN_MR2版本，可以使用支持库的 BidiFormatter类。

这些API提供以下功能：

1.双向打包当一种语言的文本以另一种相反方向的语言混合到文档中时，例如，当某些希伯来语文本中嵌入了英文公司名称时，插入的字符串及其周围的文本可能会显示不正确，除非插入的字符串显式地与“包装器”中的周围文本分开：

- 声明其方向性，以便字符串正确显示。 这可以通过Unicode双向格式化代码unicodeWrap(String)和类似的方法完成。

- 隔离字符串的方向性，因此不会不当地影响周围的内容。 目前，只能使用与上下文（LRM或RLM）相同方向的不可见的Unicode字符，除了上面的方向性声明外，还可以将方向性重置为上下文的方向性。 “重置”可能需要在字符串的两端完成。 没有字符串后的“重置”，字符串将“粘”到一个数字或逻辑上分离的反向文本，而这些文本恰好在内联（即使用空格和标点符号等中性内容分隔）。 没有字符串之前的“重置”，同样的事情可能会发生，但只有更多的反向文本，而不是数字。 一种方法是仅在每个字符串之后“重置”方向，理论上如果前面的相反方向文本本身是双向包装的，则在它将防止粘连之后的“重置”。 （仅在每个字符串确实无法工作之前执行“重置”，因为我们不想要求双向打包数字，而双向打包的反向字符串可以后跟一个数字。）但最安全的策略是请在每个字符串的两端执行“重置”，因为RTL邮件翻译通常包含未翻译的拉丁字母品牌名称和技术术语，其中一个可以后跟一个双向包装插入值。 另一方面，当有消息时，最好在消息翻译本身中手动执行“重置”，因为消息的反方向文本后面可以跟随一个插入的数字，我们不会双向打包无论如何。 因此，仅在字符串是当前默认值之后“重置”。 除了“重置”之外，最近增加的HTML，CSS和Unicode标准允许隔离成为方向性声明的一部分。 这种隔离形式比“重置”更好，因为它占用更少的空间，不需要知道上下文方向性，具有比“重置”更温和的效果，并且可以保护字符串的两端。 但是，我们尚未允许使用它，因为所需的平台尚不支持它。

提供这些包装服务是比迪格式化程序的基本目的。

2.方向性估计如何知道一个要插入周围文本的字符串是否具有相同的方向性？ 那么，在很多情况下，人们知道在编写插入代码时必定会出现这种情况，例如，将本地化消息插入本地化页面时。 在这种情况下，完全不需要使用双向格式化器。 在其他一些情况下，它不需要与上下文相同，但要么是常量（例如，URL总是LTR），要么是已知的。 在其余的情况下，例如，当字符串是用户输入的或来自数据库的时候，字符串的语言（以及它的方向性）不是先验已知的，必须在运行时估计。 双向格式化程序可以使用默认的第一强估计算法自动执行此操作。 它也可以配置为使用自定义方向性估计对象。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public methods

BidiFormatter getInstance ()

BidiFormatter getInstance (boolean rtlContext)

BidiFormatter getInstance (Locale locale)

boolean getStereoReset ()

boolean isRtl (String str)

boolean isRtlContext ()

String unicodeWrap (String str, 
                boolean isolate)

String unicodeWrap (String str, 
                TextDirectionHeuristic heuristic)

String unicodeWrap (String str, 
                TextDirectionHeuristic heuristic, 
                boolean isolate)

String unicodeWrap (String str)