Package com.bytedesk.service.queue_settings

Class QueueTipTemplateUtils

java.lang.Object

com.bytedesk.service.queue_settings.QueueTipTemplateUtils

public class QueueTipTemplateUtils
extends Object

排队提示语模板变量工具类

用于将排队提示语模板中的变量替换为实际值

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_AVG_WAIT_TIME_PER_PERSON
static final String	VAR_POSITION
static final String	VAR_QUEUE_SIZE
static final String	VAR_WAIT_MINUTES
static final String	VAR_WAIT_SECONDS
static final String	VAR_WAIT_TIME

Constructor Summary

Constructors

Modifier	Constructor	Description
private	QueueTipTemplateUtils()

Method Summary

Modifier and Type	Method	Description
static String	formatWaitTime(int waitSeconds)	格式化等待时间为人性化描述
static String	getDefaultTemplate()	获取默认的排队提示语模板
static String	getTemplateVariablesDescription()	获取支持的模板变量说明
static boolean	isValidTemplate(String template)	验证模板是否有效
static String	resolveTemplate(QueueSettingsEntity settings, int position, int queueSize)	解析排队提示语模板（基于 QueueSettings 设置）
static String	resolveTemplate(QueueSettingsEntity settings, int position, int queueSize, int avgWaitTimePerPerson)	解析排队提示语模板（基于 QueueSettings 设置并自定义平均等待时长）
static String	resolveTemplate(String template, int position, int queueSize)	解析排队提示语模板（使用默认每人等待时间）
static String	resolveTemplate(String template, int position, int queueSize, int avgWaitTimePerPerson)	解析排队提示语模板，替换模板变量为实际值
static String	resolveTemplate(String template, String queueReadyTip, int position, int queueSize, int avgWaitTimePerPerson)	解析排队提示语模板，替换模板变量为实际值 当 position 为 0 时，使用 queueReadyTip（即将接入提示语）

Methods inherited from class java.lang.Object

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

Field Details

VAR_POSITION

public static final String VAR_POSITION

See Also:

• Constant Field Values

VAR_QUEUE_SIZE

public static final String VAR_QUEUE_SIZE

See Also:

• Constant Field Values

VAR_WAIT_SECONDS

public static final String VAR_WAIT_SECONDS

See Also:

• Constant Field Values

VAR_WAIT_MINUTES

public static final String VAR_WAIT_MINUTES

See Also:

• Constant Field Values

VAR_WAIT_TIME

public static final String VAR_WAIT_TIME

See Also:

• Constant Field Values

DEFAULT_AVG_WAIT_TIME_PER_PERSON

public static final int DEFAULT_AVG_WAIT_TIME_PER_PERSON

See Also:

• Constant Field Values

Constructor Details

QueueTipTemplateUtils

private QueueTipTemplateUtils()

Method Details

resolveTemplate

public static String resolveTemplate(String template,
 int position,
 int queueSize,
 int avgWaitTimePerPerson)

解析排队提示语模板，替换模板变量为实际值

Parameters:

template - 排队提示语模板

position - 当前排队位置（从1开始）

queueSize - 当前队列总人数

avgWaitTimePerPerson - 每人平均等待时长（秒），用于计算预估等待时间

Returns:

替换变量后的提示语

resolveTemplate

public static String resolveTemplate(String template,
 String queueReadyTip,
 int position,
 int queueSize,
 int avgWaitTimePerPerson)

解析排队提示语模板，替换模板变量为实际值 当 position 为 0 时，使用 queueReadyTip（即将接入提示语）

Parameters:

template - 排队提示语模板

queueReadyTip - 即将接入提示语（position 为 0 时使用）

position - 当前排队位置（从1开始，0表示即将接入）

queueSize - 当前队列总人数

avgWaitTimePerPerson - 每人平均等待时长（秒），用于计算预估等待时间

Returns:

替换变量后的提示语

resolveTemplate

public static String resolveTemplate(String template,
 int position,
 int queueSize)

解析排队提示语模板（使用默认每人等待时间）

Parameters:

template - 排队提示语模板

position - 当前排队位置

queueSize - 当前队列总人数

Returns:

替换变量后的提示语

resolveTemplate

public static String resolveTemplate(QueueSettingsEntity settings,
 int position,
 int queueSize)

解析排队提示语模板（基于 QueueSettings 设置）

Parameters:

settings - 队列设置

position - 当前排队位置

queueSize - 当前队列总人数

Returns:

替换变量后的提示语

resolveTemplate

public static String resolveTemplate(QueueSettingsEntity settings,
 int position,
 int queueSize,
 int avgWaitTimePerPerson)

解析排队提示语模板（基于 QueueSettings 设置并自定义平均等待时长）

Parameters:

settings - 队列设置

position - 当前排队位置

queueSize - 当前队列总人数

avgWaitTimePerPerson - 每人平均等待时长（秒）

Returns:

替换变量后的提示语

formatWaitTime

public static String formatWaitTime(int waitSeconds)

格式化等待时间为人性化描述

Parameters:

waitSeconds - 等待秒数

Returns:

格式化的等待时间描述

getTemplateVariablesDescription

public static String getTemplateVariablesDescription()

获取支持的模板变量说明

Returns:

模板变量说明

isValidTemplate

public static boolean isValidTemplate(String template)

验证模板是否有效

Parameters:

template - 模板字符串

Returns:

如果模板包含至少一个有效变量或不为空则返回 true

getDefaultTemplate

public static String getDefaultTemplate()

获取默认的排队提示语模板

Returns:

默认模板