程序包 com.darra.ethercat.logging

类 LogManager

java.lang.Object

com.darra.ethercat.logging.LogManager

public class LogManager
extends Object

日志管理器 - 接收 DLL 回调, 推送到 LogView

使用示例:

 LogManager.LogView logs = master.getLogs();

 // 只看错误和警告
 logs.setFilter(LogCategory.ERROR, LogCategory.WARNING);

 // 监听数据变化
 logs.setUpdatedListener(() -> System.out.println("日志更新, 共 " + logs.getCount() + " 条"));

 // 遍历日志
 for (LogEntry entry : logs.getAll()) {
     System.out.println(entry);
 }
 

嵌套类概要

嵌套类

修饰符和类型	类	说明
static enum	LogManager.LogCategory	日志类别 - 与 DLL 中的 LogCategory 对应
static class	LogManager.LogEntry	日志条目 - 包含时间戳、类别和消息
static class	LogManager.LogView	实时日志视图 - 只读列表, 由日志系统内部自动维护 特点: 1.

方法概要

修饰符和类型	方法	说明
void	addLog(int categoryValue, String message)	添加日志条目 (使用 DLL 回调的 int 类别值)
void	addLog(LogManager.LogCategory category, String message)	添加日志条目 (由 DLL 回调或内部调用)
void	clear()	清空所有日志
LogManager.LogView	getDefaultView()	获取默认日志视图
static LogManager	getInstance()	获取单例实例
boolean	isMailboxTraceEnabled()	Mailbox 帧追踪是否启用 (默认 false)。
boolean	isPdoTraceEnabled()	PDO 高频追踪是否启用 (默认 false)。
void	setMailboxTraceEnabled(boolean enabled)	启用/禁用 Mailbox 帧追踪。
void	setPdoTraceEnabled(boolean enabled)	启用/禁用 PDO 高频追踪。

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

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

方法详细资料

getInstance

public static LogManager getInstance()

获取单例实例

getDefaultView

public LogManager.LogView getDefaultView()

获取默认日志视图

isPdoTraceEnabled

public boolean isPdoTraceEnabled()

PDO 高频追踪是否启用 (默认 false)。对齐 C# LogManager.PdoTraceEnabled。

setPdoTraceEnabled

public void setPdoTraceEnabled(boolean enabled)

启用/禁用 PDO 高频追踪。

isMailboxTraceEnabled

public boolean isMailboxTraceEnabled()

Mailbox 帧追踪是否启用 (默认 false)。对齐 C# LogManager.MailboxTraceEnabled。

setMailboxTraceEnabled

public void setMailboxTraceEnabled(boolean enabled)

启用/禁用 Mailbox 帧追踪。

addLog

public void addLog(LogManager.LogCategory category,
 String message)

添加日志条目 (由 DLL 回调或内部调用)

参数:

category - 日志类别

message - 日志消息 roundLOGSEP1: 在 sink 处按级别收敛 (对齐 C# LogManager.AddLog), 判据=是否对用户使用有影响: - DEBUG: 默认丢弃 (生产行为); 仅 -Ddarra.sdk.debug=true 启动时保留。 - PDO / MAILBOX: 协议细节/高频, 默认禁用; 仅 pdoTraceEnabled/mailboxTraceEnabled 打开才放行。 - ERROR/WARNING/MESSAGE/LOCAL: 事件/状态/真错误, 始终保留。

addLog

public void addLog(int categoryValue,
 String message)

添加日志条目 (使用 DLL 回调的 int 类别值)

参数:

categoryValue - 类别数值

message - 日志消息

clear

public void clear()

清空所有日志