| Package | mx.logging |
| Interface | public interface ILoggingTarget |
| Implementors | AbstractTarget |
| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
| Property | Defined By | ||
|---|---|---|---|
| filters : Array
In addition to the level setting, filters are used to
provide a psuedo-hierarchical mapping for processing only those events
for a given category. | ILoggingTarget | ||
| level : int
Provides access to the level this target is currently set at. | ILoggingTarget | ||
| Method | Defined By | ||
|---|---|---|---|
Sets up this target with the specified logger. | ILoggingTarget | ||
Stops this target from receiving events from the specified logger. | ILoggingTarget | ||
filters | property |
filters:Array| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
In addition to the level setting, filters are used to
provide a psuedo-hierarchical mapping for processing only those events
for a given category.
Each logger belongs to a category.
By convention these categories map to the fully qualified class name
in which the logger is used.
For example, a logger that is logging messages for the
mx.rpc.soap.WebService class would use
"mx.rpc.soap.WebService" as the parameter
to the Log.getLogger() call.
When messages are sent under this category only those targets that have
a filter which matches that category will receive notification of those
events.
Filter expressions may include a wildcard match, indicated with an
asterisk.
The wildcard must be the right most character in the expression.
For example: rpc*, mx.*, or *.
If an invalid expression is specified a InvalidFilterError
will be thrown.
No spaces or any of the following characters are valid within a filter
expression: []~$^&\/(){}<>+=`!#%?,:;'"@.
Implementation
public function get filters():Array public function set filters(value:Array):voidExample
How to use this example
var traceLogger:ILoggingTarget = new TraceTarget();
traceLogger.filters = [ "mx.rpc.*", "mx.messaging.*" ];
Log.addTarget(traceLogger);
level | property |
level:int| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Provides access to the level this target is currently set at. Value values are:
LogEventLevel.FATALdesignates events that are very harmful and will eventually lead to application failureLogEventLevel.ERRORdesignates error events that might still allow the application to continue running.LogEventLevel.WARNdesignates events that could be harmful to the application operationLogEventLevel.INFOdesignates informational messages that highlight the progress of the application at coarse-grained level.LogEventLevel.DEBUGdesignates informational level messages that are fine grained and most helpful when debugging an application.LogEventLevel.ALLintended to force a target to process all messages.
Implementation
public function get level():int public function set level(value:int):voidaddLogger | () | method |
public function addLogger(logger:ILogger):void| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Sets up this target with the specified logger. This allows this target to receive log events from the specified logger.
Note: This method is called by the framework and should not be called by you directly.
Parameters
logger:ILogger — The ILogger that this target listens to.
|
removeLogger | () | method |
public function removeLogger(logger:ILogger):void| Language Version: | ActionScript 3.0 |
| Product Version: | Flex 3 |
| Runtime Versions: | Flash Player 9, AIR 1.1 |
Stops this target from receiving events from the specified logger.
Note: This method is called by the framework and should not be called by you directly.
Parameters
logger:ILogger — The ILogger that this target ignores.
|
Mon Nov 28 2011, 06:48 AM -08:00