Packagevegas.logging.targets
Classpublic class LineFormattedTarget
InheritanceLineFormattedTarget Inheritance AbstractTarget Inheritance CoreEventDispatcher Inheritance CoreObject
SubclassesAirLoggerTarget, FireBugTarget, LuminicTarget, SOSTarget, TextFieldTarget, TraceTarget, XPanelTarget

All logger target implementations that have a formatted line style output should extend this class. It provides default behavior for including date, time, category, and level within the output.



Public Properties
 PropertyDefined by
 Inheritedchannel : String
Indicates the channel of this dispatcher if this instance is global.
CoreEventDispatcher
 InheritedcharPlacement : String = "'*' must be the right most character."
[static] The static field used when throws an Error when the character placement failed.
AbstractTarget
 InheritedcharsInvalid : String = "The following characters are not valid: []~$^&/(){}<>+=_-`!@#%?,:;'\"
[static] The static field used when throws an Error when a character is invalid.
AbstractTarget
 InheritederrorFilter : String = "Error for filter ''{0}'"
[static] The static field used when throws an Error when filter failed.
AbstractTarget
 Inheritedfilters : Array
(read-write) Returns the filters array representation of this target.
AbstractTarget
  includeCategory : Boolean = false
Indicates if the category for this target should added to the trace.
LineFormattedTarget
  includeDate : Boolean = false
Indicates if the date should be added to the trace.
LineFormattedTarget
  includeLevel : Boolean = false
Indicates if the level for the event should added to the trace.
LineFormattedTarget
  includeLines : Boolean = false
Indicates if the line for the event should added to the trace.
LineFormattedTarget
  includeMilliseconds : Boolean = false
Indicates if the milliseconds should be added to the trace.
LineFormattedTarget
  includeTime : Boolean = false
Indicates if the time should be added to the trace.
LineFormattedTarget
 InheritedisGlobal : Boolean
(read-only) Returns the value of the isGlobal flag of this model.
CoreEventDispatcher
 Inheritedlevel : LogEventLevel
(read-write) Returns the level of this target.
AbstractTarget
  separator : String = " "
The separator string.
LineFormattedTarget
Public Methods
 MethodDefined by
  
LineFormattedTarget(bGlobal:Boolean = false, sChannel:String = null)
Creates a new LineFormattedTarget instance.
LineFormattedTarget
 Inherited
addCategory(category:String):Boolean
Insert a category in the fllters if this category don't exist.
AbstractTarget
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0.0, useWeakReference:Boolean = false):void
Allows the registration of event listeners on the event target.
CoreEventDispatcher
 Inherited
addLogger(logger:ILogger):void
Sets up this target with the specified logger.
AbstractTarget
 Inherited
addNamespace(nameSpace:String):Boolean
Add a new namespace in the filters array.
AbstractTarget
 Inherited
dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow.
CoreEventDispatcher
 Inherited
Returns the internal EventDispatcher reference.
CoreEventDispatcher
 Inherited
getIsGlobal():Boolean
Returns the value of the isGlobal flag of this model.
CoreEventDispatcher
 Inherited
Returns the internal ILogger reference of this ILogable object.
CoreObject
 Inherited
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
CoreEventDispatcher
 Inherited
hashCode():uint
Returns a hashcode value for the object.
CoreObject
 Inherited
Creates and returns the internal EventDispatcher reference (this method is invoked in the constructor).
CoreEventDispatcher
  
internalLog(message:*, level:LogEventLevel):void
Descendants of this class should override this method to direct the specified message to the desired output.
LineFormattedTarget
 Inherited
isLocked():Boolean
Returns true if the object is locked.
CoreEventDispatcher
 Inherited
lock():void
Locks the object.
CoreEventDispatcher
  
logEvent(event:LogEvent):void
This method handles a LogEvent from an associated logger.
LineFormattedTarget
 Inherited
registerEventListener(type:String, listener:Boolean, useCapture:int = false, priority:Boolean = 0, useWeakReference:* = false):void
Allows the registration of event listeners on the event target (Function or EventListener).
CoreEventDispatcher
 Inherited
removeCategory(category:String):Boolean
Remove a category in the fllters if this category exist.
AbstractTarget
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
CoreEventDispatcher
 Inherited
removeLogger(logger:ILogger):void
Stops this target from receiving events from the specified logger.
AbstractTarget
 Inherited
removeNamespace(nameSpace:String):Boolean
Removes an existing namespace in the filters array.
AbstractTarget
 Inherited
Sets the internal EventDispatcher reference.
CoreEventDispatcher
 Inherited
setGlobal(flag:Boolean = false, channel:String = null):void
Sets if the instance use a global EventDispatcher to dispatch this events, if the flag value is false the instance use a local EventDispatcher.
CoreEventDispatcher
 Inherited
setLogger(log:ILogger = null):void
Sets the internal ILogger reference of this ILogable object.
CoreObject
 Inherited
toSource(indent:int = 0):String
Returns the string representation the source code of the object.
CoreEventDispatcher
 Inherited
toString():String
Returns the string representation of this instance.
CoreObject
 Inherited
unlock():void
Unlocks the display.
CoreEventDispatcher
 Inherited
unregisterEventListener(type:String, listener:Boolean, useCapture:* = false):void
Removes a listener (Function or EventListener object) from the EventDispatcher object.
CoreEventDispatcher
 Inherited
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
CoreEventDispatcher
Protected Methods
 MethodDefined by
  
formatDate(d:Date):String
This method format the passed Date in arguments.
LineFormattedTarget
  
formatLevel(level:String):String
This method format the passed level in arguments.
LineFormattedTarget
  
formatLines():String
This method format the current line value.
LineFormattedTarget
  
formatMessage(message:*, level:String, category:String, date:Date):String
This method format the log message.
LineFormattedTarget
  
formatTime(d:Date):String
This method format the current Date passed in argument.
LineFormattedTarget
  
getDigit(n:Number):String
Returns the string representation of a number and use digit conversion.
LineFormattedTarget
Property detail
includeCategoryproperty
public var includeCategory:Boolean = false

Indicates if the category for this target should added to the trace.

includeDateproperty 
public var includeDate:Boolean = false

Indicates if the date should be added to the trace.

includeLevelproperty 
public var includeLevel:Boolean = false

Indicates if the level for the event should added to the trace.

includeLinesproperty 
public var includeLines:Boolean = false

Indicates if the line for the event should added to the trace.

includeMillisecondsproperty 
public var includeMilliseconds:Boolean = false

Indicates if the milliseconds should be added to the trace. Only relevant when includeTime is true.

includeTimeproperty 
public var includeTime:Boolean = false

Indicates if the time should be added to the trace.

separatorproperty 
public var separator:String = " "

The separator string.

Constructor detail
LineFormattedTarget()constructor
public function LineFormattedTarget(bGlobal:Boolean = false, sChannel:String = null)

Creates a new LineFormattedTarget instance.

Parameters
bGlobal:Boolean (default = false) — the flag to use a global event flow or a local event flow.
 
sChannel:String (default = null) — the name of the global event flow if the bGlobal argument is true.
Method detail
formatDate()method
protected function formatDate(d:Date):String

This method format the passed Date in arguments.

Parameters
d:Date

Returns
String
formatLevel()method 
protected function formatLevel(level:String):String

This method format the passed level in arguments.

Parameters
level:String

Returns
String
formatLines()method 
protected function formatLines():String

This method format the current line value.

Returns
String
formatMessage()method 
protected function formatMessage(message:*, level:String, category:String, date:Date):String

This method format the log message.

Parameters
message:*
 
level:String
 
category:String
 
date:Date

Returns
String
formatTime()method 
protected function formatTime(d:Date):String

This method format the current Date passed in argument.

Parameters
d:Date

Returns
String
getDigit()method 
protected function getDigit(n:Number):String

Returns the string representation of a number and use digit conversion.

Parameters
n:Number

Returns
String
internalLog()method 
public function internalLog(message:*, level:LogEventLevel):void

Descendants of this class should override this method to direct the specified message to the desired output.

Parameters
message:* — String containing preprocessed log message which may include time, date, category, etc. based on property settings, such as includeDate, includeCategory, etc.
 
level:LogEventLevel
logEvent()method 
public override function logEvent(event:LogEvent):void

This method handles a LogEvent from an associated logger. A target uses this method to translate the event into the appropriate format for transmission, storage, or display. This method will be called only if the event's level is in range of the target's level.

Parameters
event:LogEvent