This page was saved using jaction on 2006-09-04 8:33:52.
Address: http://flexdocs.kr/docs/flex2/langref/mx/logging/Log.html
Title: mx.logging.Log (Flex™ 2 레퍼런스 가이드)  •  Size: 33968
Packagemx.logging
Classpublic class Log
InheritanceLog Inheritance Object

복수의 서식 옵션 및 출력 옵션을 가지는 의사 계층 구조의 로깅 기능을 제공합니다. 로그 시스템은, logger와 타겟이라고 하는 2 개의 주된 컴퍼넌트로 구성되어 있습니다. logger를 사용해 타겟으로 정보를 송신할 수가 있습니다. 타겟은, 로그 데이터의 포맷이나 일반적인 출력을 실시합니다.

logger는, 특정의 카테고리의 정보용으로 작성된 싱글 톤 인스턴스입니다. 통상, 카테고리는, 정보를 기록할 필요가 있는 컴퍼넌트의 패키지명입니다. 카테고리에 의해, 유저가 흥미가 있는 정보를 지정할 수 있습니다. 복수의 카테고리를 선택하거나 정규 표현으로 조합할 수가 있습니다. 이것에 의해, 광범위한 로그 정보와 좁힌 로그 정보의 양쪽 모두를 취득할 수 있습니다. 예를 들어,"mx.messaging" 패키지와 "mx.rpc" 패키지 부하의 모든 로그 정보를 취득해, 이러한 패키지의 출력을 xml 로 포맷 하고 싶다고 생각했다고 합니다. 서브 패키지나 컴퍼넌트를 포함해"mx.messaging" 카테고리 부하의 모든 로그 정보를 취득하려면 ,"mx.messaging. *" 등의 와일드 카드 표현이 필요하게 됩니다. 자세한 것은, 이하의 코드예를 참조해 주세요.

타겟은, 기록하고 있는 데이터의 출력 메카니즘을 제공합니다. 통상 이 메카니즘에는, 포맷, 전송, 보존등이 있습니다만, VM 부하의 임의의 것이 될 가능성이 있습니다. XMLLogTarget,MiniDebugTarget,DebugChannelTarget,TraceTarget 등이 다양한 타겟이 있습니다. 이러한 라이터 각각이 현재의 로그 정보를 취득해, 표시 또는 보존하는 장소에 「송신」합니다. 타겟은, 출력하는 로그 데이터도 지정합니다.


Example
  ...
import mx.logging.ILoggingTarget;
import mx.logging.Log;
import mx.logging.LogEvent;
import mx.logging.targets.TraceTarget;
// 다음과 같이 해 라이터를 설정합니다.
var traceTarget:ILoggingTarget = new TraceTarget();
traceTarget.filters = ["mx.messaging. *", "mx.rpc. *"];
traceTarget.level = LogEventLevel.DEBUG;
// 다음과 같이 해 로그 데이터의 서두를 개시합니다.
Log.addTarget(traceTarget);
// 다음과 같이 해 mx.messaging.Channel "category" 의 logger를 취득해,
// 데이터를 거기에 송신합니다.
var logger:ILogger = Log.getLogger("mx.messaging.Channel");
logger.log("Here is some channel info {0} and {1}", LogEventLevel.DEBUG, 15.4, true);
// 로그 출력은 다음과 같이 됩니다.
// Here is some channel info 15.4 and true
// 이것은, xmlTarget 가, 이 예로 기록된 데이터를 취득한다
// DEBUG 레벨의 mx.messaging 를 릿슨 하고 있기 (위해)때문에입니다.
  ...
  

See also

Logging API 의 사용


Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Public Methods
 Methods정의
  addTarget (target:ILoggingTarget ):void
[static] 지정된 타겟으로, 로그 이벤트의 통지의 수신을 개시합니다.
Log
  flush ():void
[static] 이 Methods는, 캐쉬로부터 현재의 logger를 모두 삭제합니다.
Log
  getLogger (category:String ):ILogger
[static] 지정된 카테고리에 관련지을 수 있었던 logger를 돌려줍니다.
Log
  hasIllegalCharacters (value:String ):Boolean
[static] 이 Methods에 의해, 지정된 string치에 무효인 캐릭터가 있는지 없는지가 체크됩니다.
Log
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
  isDebug ():Boolean
[static] DEBUG 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.
Log
  isError ():Boolean
[static] ERROR 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.
Log
  isFatal ():Boolean
[static] FATAL 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.
Log
  isInfo ():Boolean
[static] INFO 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.
Log
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  isWarn ():Boolean
[static] WARN 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.
Log
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  removeTarget (target:ILoggingTarget ):void
[static] 지정된 타겟으로, 로그 이벤트의 통지의 수신을 정지합니다.
Log
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
Methods의 상세
addTarget()Methods
public static function addTarget(target:ILoggingTarget ):void

지정된 타겟으로, 로그 이벤트의 통지의 수신을 개시합니다.

Parameters
target:ILoggingTarget — 로그 이벤트를 capther 하는 특정의 타겟입니다.
flush()Methods 
public static function flush():void

이 Methods는, 캐쉬로부터 현재의 logger를 모두 삭제합니다. getLogger() Methods를 계속해 호출하면, 같은 카테고리의 전의 인스턴스가 아니고, logger의 새로운 인스턴스가 돌려주어집니다. 이 Methods는, 디버그 전용에 사용합니다.

getLogger()Methods 
public static function getLogger(category:String ):ILogger

지정된 카테고리에 관련지을 수 있었던 logger를 돌려줍니다. 지정된 카테고리가 존재하지 않는 경우, logger의 새로운 인스턴스가 돌려주어져 그 카테고리와 관련지을 수 있습니다. 카테고리의 길이는 1 캐릭터 이상으로, 공백을 포함한 다음의 캐릭터는 사용할 수 없습니다. []~$^&\/(){}<>+=`! #%?,:;'"@ 지정된 카테고리의 형식이 올바르지 않은 경우는, 이 Methods에 의해 InvalidCategoryError 가 슬로우 됩니다.

Parameters
category:String — 돌려줄 필요가 있는 logger의 카테고리입니다.

반환값
ILogger — 지정된 이름 loggerobject의 인스턴스입니다. 그 이름이 존재하지 않는 경우, 지정된 이름을 가지는 새로운 인스턴스가 돌려주어집니다.
hasIllegalCharacters()Methods 
public static function hasIllegalCharacters(value:String ):Boolean

이 Methods에 의해, 지정된 string치에 무효인 캐릭터가 있는지 없는지가 체크됩니다.

Parameters
value:String — 무효인 캐릭터를 체크하는 string입니다. 다음의 캐릭터는 유효하지는 않습니다. []~$^&\/(){}<>+=`! #%?,:;'"@

반환값
Boolean — 무효인 캐릭터가 검출되었을 경우는 true 로, 그 이외의 경우는 false 가 됩니다.
isDebug()Methods 
public static function isDebug():Boolean

DEBUG 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.

반환값
Boolean — DEBUG 레벨의 로그 이벤트가 기록되는 경우는 true 로, 그 이외의 경우는 false 입니다.
isError()Methods 
public static function isError():Boolean

ERROR 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.

반환값
Boolean — ERROR 레벨의 로그 이벤트가 기록되는 경우는 true 로, 그 이외의 경우는 false 입니다.
isFatal()Methods 
public static function isFatal():Boolean

FATAL 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.

반환값
Boolean — FATAL 레벨의 로그 이벤트가 기록되는 경우는 true 로, 그 이외의 경우는 false 입니다.
isInfo()Methods 
public static function isInfo():Boolean

INFO 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.

반환값
Boolean — INFO 레벨의 로그 이벤트가 기록되는 경우는 true 로, 그 이외의 경우는 false 입니다.
isWarn()Methods 
public static function isWarn():Boolean

WARN 레벨의 로그 이벤트를 로그 타겟으로보다 처리할지 어떨지를 나타냅니다.

반환값
Boolean — WARN 레벨의 로그 이벤트가 기록되는 경우는 true 로, 그 이외의 경우는 false 입니다.
removeTarget()Methods 
public static function removeTarget(target:ILoggingTarget ):void

지정된 타겟으로, 로그 이벤트의 통지의 수신을 정지합니다.

Parameters
target:ILoggingTarget — 로그 이벤트를 capther 하는 특정의 타겟입니다.






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/logging/Log.html