| Overview |  |
Interface class implementing the Traceable trait, so that the instances having that trait can emit traces by whichever means is the most appropriate, whether or not they are actually full-blown class_TraceEmitter instances, or have a trace_bridge registered, or just have to rely on the most basic traces.
By providing the most lightweight way of emitting traces, such a trait favors composition over multiple inheritance; otherwise many concrete classes would derive more than once from the class_TraceEmitter one (this would be a minor nuisance) or, worse, other traits would induce in turn a class_TraceEmitter inheritance, each time they would have to send a trace (whereas interfaces introducing the use of actual classes is not felt desirable; we prefer that such interfaces derive from this Traceable one).
This interface does not define attributes or methods of its own, and does not require specific initialisation or termination (it is mostly useful thanks to its header file). As such, it could even be omitted in the declarations of superclasses and possibly any composed interfaces, although we recommend listing it explicitly, for clarity reasons.attribute_entry() = {attribute_name(), attribute_value()}
attribute_name() = wooper:attribute_name()
attribute_value() = wooper:attribute_value()
classname() = wooper:classname()
instance_pid() = pid()
message() = traces:message()
method_argument() = wooper:method_argument()
method_arguments() = wooper:method_arguments()
method_internal_result() = wooper:method_internal_result()
method_name() = wooper:method_name()
oneway_name() = wooper:oneway_name()
oneway_return() = wooper:oneway_return()
request_name() = wooper:request_name()
request_result() = any()
request_result(T) = wooper:request_result(T)
request_return(T) = wooper:request_return(T)
requests_outcome() = wooper:requests_outcome()
trace_severity() = traces:trace_severity()
ustring() = text_utils:ustring()
addKeyValueToAttribute(State::wooper:state(), AttributeName::attribute_name(), Key::table:key(), Value::table:value()) -> wooper:state()
addToAttribute(State::wooper:state(), AttributeName::attribute_name(), Value::attribute_value()) -> wooper:state()
appendToAttribute(State::wooper:state(), AttributeName::attribute_name(), Element::attribute_value()) -> wooper:state()
concatToAttribute(State::wooper:state(), AttributeName::attribute_name(), List::attribute_value()) -> wooper:state()
decrementAttribute(State::wooper:state(), AttributeName::attribute_name()) -> wooper:state()
deleteFromAttribute(State::wooper:state(), AttributeName::attribute_name(), Element::attribute_value()) -> wooper:state()
executeConstOneway(State::wooper:state(), OnewayAtom::oneway_name()) -> void()
executeConstOneway(State::wooper:state(), OnewayAtom::oneway_name(), ArgumentList::method_arguments()) -> void()
executeConstOnewayAs(State::wooper:state(), Classname::classname(), OnewayAtom::oneway_name()) -> void()
executeConstOnewayAs(State::wooper:state(), Classname::classname(), OnewayAtom::oneway_name(), ArgumentList::method_arguments()) -> void()
executeConstRequest(State::wooper:state(), RequestAtom::request_name()) -> method_internal_result()
executeConstRequest(State::wooper:state(), RequestAtom::request_name(), ArgumentList::method_arguments()) -> method_internal_result()
executeConstRequestAs(State::wooper:state(), ParentClassname::classname(), RequestAtom::request_name()) -> method_internal_result()
executeConstRequestAs(State::wooper:state(), Classname::classname(), RequestAtom::request_name(), ArgumentList::method_arguments()) -> method_internal_result()
executeOneway(State::wooper:state(), OnewayAtom::oneway_name()) -> wooper:state()
executeOneway(State::wooper:state(), OnewayAtom::oneway_name(), ArgumentList::method_arguments()) -> wooper:state()
executeOnewayAs(State::wooper:state(), ParentClassname::classname(), OnewayAtom::oneway_name()) -> wooper:state()
executeOnewayAs(State::wooper:state(), Classname::classname(), OnewayAtom::oneway_name(), ArgumentList::method_arguments()) -> wooper:state()
executeRequest(State::wooper:state(), RequestAtom::request_name()) -> {wooper:state(), method_internal_result()}
executeRequest(State::wooper:state(), RequestAtom::request_name(), ArgumentList::method_arguments()) -> {wooper:state(), method_internal_result()}
executeRequestAs(State::wooper:state(), ParentClassname::classname(), RequestAtom::request_name()) -> {wooper:state(), method_internal_result()}
executeRequestAs(State::wooper:state(), Classname::classname(), RequestAtom::request_name(), ArgumentList::method_arguments()) -> {wooper:state(), method_internal_result()}
getAttribute(State::wooper:state(), AttributeName::attribute_name()) -> attribute_value()
getAttributes(State::wooper:state(), AttributeNameList::[attribute_name()]) -> [attribute_value()]
getMaybeAttribute(State::wooper:state(), AttributeName::attribute_name()) -> maybe(attribute_value())
hasAttribute(State::wooper:state(), AttributeName::attribute_name()) -> boolean()
incrementAttribute(State::wooper:state(), AttributeName::attribute_name()) -> wooper:state()
is_wooper_debug() -> boolean()
popFromAttribute(State::wooper:state(), AttributeName::attribute_name()) -> {wooper:state(), attribute_value()}
removeAttribute(State::wooper:state(), AttributeName::attribute_name()) -> wooper:state()
send(Severity::trace_severity(), State::wooper:state(), Message::message()) -> void()
Sends a trace from that traceable instance.
Message is a plain string.
(helper)send_safe(Severity::trace_severity(), State::wooper:state(), Message::message()) -> void()
Sends a trace from that traceable instance, echoing it through basic traces as well.
Message is a plain string.
(helper)setAttribute(State::wooper:state(), AttributeName::attribute_name(), AttributeValue::attribute_value()) -> wooper:state()
setAttributes(State::wooper:state(), ListOfAttributePairs::[attribute_entry()]) -> wooper:state()
subtractFromAttribute(State::wooper:state(), AttributeName::attribute_name(), Value::attribute_value()) -> wooper:state()
swapInAttribute(State::wooper:state(), AttributeName::attribute_name(), NewAttributeValue::attribute_value()) -> {wooper:state(), attribute_value()}
to_maybe_string(State::wooper:state()) -> maybe(ustring())
Returns a textual element of description of the corresponding instance, should it implement the Traceable interface.
(exported helper)toggleAttribute(State::wooper:state(), BooleanAttributeName::attribute_name()) -> wooper:state()
wooper_destruct(State::wooper:state()) -> wooper:state()
wooper_effective_method_execution(SelectedModule::module(), MethodAtom::method_name(), State::wooper:state(), Parameters::method_arguments()) -> {wooper:state(), method_internal_result()}
wooper_execute_method(MethodAtom::method_name(), Parameters::method_arguments(), State::wooper:state()) -> {wooper:state(), method_internal_result()}
wooper_execute_method_as(ParentClassname::classname(), MethodAtom::method_name(), Parameters::method_arguments(), State::wooper:state()) -> {wooper:state(), method_internal_result()}
wooper_get_class_specific_attributes() -> [wooper_info:attribute_spec()]
wooper_handle_local_oneway_execution(OnewayAtom::method_name(), State::wooper:state(), ArgumentList::method_arguments()) -> wooper:state()
wooper_handle_local_request_execution(RequestAtom::method_name(), State::wooper:state(), ArgumentList::method_arguments()) -> {wooper:state(), method_internal_result()}
wooper_handle_remote_oneway_execution(OnewayAtom::method_name(), State::wooper:state(), ArgumentList::method_arguments()) -> wooper:state()
wooper_handle_remote_request_execution(RequestAtom::method_name(), State::wooper:state(), ArgumentList::method_arguments(), CallerPid::pid()) -> wooper:state()
wooper_main_loop(State::wooper:state()) -> deleted
Generated by EDoc