io.polaris.core.msg

类 MessageFormat

java.lang.Object

io.polaris.core.msg.MessageFormat

public class MessageFormat
extends Object

消息格式化工具类

该类提供了强大的消息格式化功能，支持参数替换、数字格式化、日期格式化等。 格式化模式语法类似于java.text.MessageFormat，但提供了更多灵活性。 支持以下格式：

• 简单参数替换: {0}, {1}, {-1} (负数表示从末尾开始计数)
• 数字格式化: {0,number}, {1,number,currency}, {2,number,percent}
• 日期格式化: {0,date}, {1,time,short}, {2,date,yyyy-MM-dd}
• 嵌套格式化: {0,number,{1}}, 其中第二个参数决定第一个参数的格式
• 默认值: {0:-默认值}, 当参数为空时显示默认值

从以下版本开始:

Jul 24, 2025

作者:

Qt

构造器概要

构造器

构造器和说明
MessageFormat(String pattern) 使用指定的模式创建消息格式化器
MessageFormat(String pattern, Locale locale) 使用指定的模式和区域设置创建消息格式化器

方法概要

限定符和类型	方法和说明
static String	format(Locale locale, String pattern, Object... arguments) 使用指定区域设置、模式和参数直接格式化消息
String	format(Object... arguments) 格式化消息，使用提供的参数替换模式中的占位符
static String	format(String pattern, Object... arguments) 使用指定模式和参数直接格式化消息
static String	formatWithEmpty(Locale locale, String pattern, String emptyMsg, Object... arguments) 使用指定区域设置、模式、空占位符默认消息和参数直接格式化消息
String	formatWithEmpty(String emptyMsg, Object... arguments) 格式化消息，针对空占位符指定特定的默认消息
static String	formatWithEmpty(String pattern, String emptyMsg, Object... arguments) 使用指定模式、空占位符默认消息和参数直接格式化消息
Locale	getLocale()
static MessageFormat	newInstance(Locale locale, String pattern) 使用指定区域设置创建一个新的消息格式化器实例
static MessageFormat	newInstance(String pattern) 创建一个新的消息格式化器实例
String	toString()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

MessageFormat

public MessageFormat(String pattern)

使用指定的模式创建消息格式化器

参数:

pattern - 格式化模式字符串，不能为空

MessageFormat

public MessageFormat(String pattern,
                     Locale locale)

使用指定的模式和区域设置创建消息格式化器

参数:

pattern - 格式化模式字符串，不能为空

locale - 区域设置，用于数字、日期等本地化格式化

方法详细资料

toString

public String toString()

覆盖:

toString 在类中 Object

getLocale

public Locale getLocale()

format

public String format(Object... arguments)

格式化消息，使用提供的参数替换模式中的占位符

参数:

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串

formatWithEmpty

public String formatWithEmpty(String emptyMsg,
                              Object... arguments)

格式化消息，针对空占位符指定特定的默认消息

参数:

emptyMsg - 空占位符对应的默认消息

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串

newInstance

public static MessageFormat newInstance(String pattern)

创建一个新的消息格式化器实例

参数:

pattern - 格式化模式字符串

返回:

新的消息格式化器实例

newInstance

public static MessageFormat newInstance(Locale locale,
                                        String pattern)

使用指定区域设置创建一个新的消息格式化器实例

参数:

locale - 区域设置

pattern - 格式化模式字符串

返回:

新的消息格式化器实例

format

public static String format(String pattern,
                            Object... arguments)

使用指定模式和参数直接格式化消息

参数:

pattern - 格式化模式字符串

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串

format

public static String format(Locale locale,
                            String pattern,
                            Object... arguments)

使用指定区域设置、模式和参数直接格式化消息

参数:

locale - 区域设置

pattern - 格式化模式字符串

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串

formatWithEmpty

public static String formatWithEmpty(String pattern,
                                     String emptyMsg,
                                     Object... arguments)

使用指定模式、空占位符默认消息和参数直接格式化消息

参数:

pattern - 格式化模式字符串

emptyMsg - 空占位符使用的默认消息

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串

formatWithEmpty

public static String formatWithEmpty(Locale locale,
                                     String pattern,
                                     String emptyMsg,
                                     Object... arguments)

使用指定区域设置、模式、空占位符默认消息和参数直接格式化消息

参数:

locale - 区域设置

pattern - 格式化模式字符串

emptyMsg - 空占位符使用的默认消息

arguments - 用于替换占位符的参数数组

返回:

格式化后的消息字符串