Home > Class Reference > %SYS namespace > %Net.MQTT.Tracer


class %Net.MQTT.Tracer extends %Net.MQTT.Logger

This class allows tracing to performed of the calls made within the paho-c library. One instantiates an instance of the tracer and attaches an instance of %Net.MQTT.Logger by setting the Logger property. The Tracer class then delegates log requests to the Logger class. If you don't provide a Logger instance then the default implementation uses this class (which is itself a logger) to perform the logging with a default implementation that just writes to the console.

Property Inventory (Including Private)

Method Inventory (Including Private)


parameter DOMAIN = %ObjectErrors;
Error Text Domain

Properties (Including Private)

property Logger as %Net.MQTT.Logger [ InitialExpression = $this ];
Logger delegate, initially is self
Property methods: LoggerGet(), LoggerGetSwizzled(), LoggerIsValid(), LoggerNewObject(), LoggerSet()
property TraceLevel as %Integer [ InitialExpression = $$$MQTTCLIENTTRACEFATAL ];
This is the trace level required
Property methods: TraceLevelDisplayToLogical(), TraceLevelGet(), TraceLevelIsValid(), TraceLevelLogicalToDisplay(), TraceLevelNormalize(), TraceLevelSet()

Methods (Including Private)

method %OnNew() as %Status [ Language = objectscript ]
Inherited description: This callback method is invoked by the %New() method to provide notification that a new instance of an object is being created.

If this method returns an error then the object will not be created.

It is passed the arguments provided in the %New call. When customizing this method, override the arguments with whatever variables and types you expect to receive from %New(). For example, if you're going to call %New, passing 2 arguments, %OnNew's signature could be:

Method %OnNew(dob as %Date = "", name as %Name = "") as %Status If instead of returning a %Status code this returns an oref and this oref is a subclass of the current class then this oref will be the one returned to the caller of %New method.

private method DecodeError(list As %String) as %Status [ Language = objectscript ]
Private, Decode an error reported by the library and form status
method Log(level As %Integer, message As %String) [ Language = objectscript ]
Minimal implementation, normally would delegate
method LoggerSet(logger As %Net.MQTT.Logger) as %Status [ Language = objectscript ]
Property setter, attach a delegate
method Start() as %Status [ Language = objectscript ]
Start tracing
method Stop() as %Status [ Language = objectscript ]
Stop tracing
method TraceLevelSet(level As %Integer) as %Status [ Language = objectscript ]
Set the trace level (see %Net.MQTT.inc for appropriate values)

Inherited Members

Inherited Methods (Including Private)