출처: http://www.cyworld.com/integritian/3151805

우선 jar 파일(log4j-1.2.15.jar)을 받아서 라이브러리에 추가합니다.

log4j설정파일을 만듭니다. 최상위 폴더에다가 log4j.properties 파일을 생성합니다.

#========================================================================================================
# Log4j Setting file
log4j.rootLogger=INFO, console

# Daily file log
log4j.appender.logfile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.logfile.File=D:/Data/Log/data.log
log4j.appender.logfile.DatePattern='.'yyyy-MM-dd
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=[%d{HH:mm:ss}][%-5p](%F:%L)-%m%n

# Console log
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%-5p%l -%m%n

# log level and appender
log4j.logger.name.of.the.package.one=DEBUG, console
log4j.logger.name.of.the.package.two=INFO, logfile

#========================================================================================================


대략 내용을 살펴보면 log4j.rootLogger는 최상위 로거입니다.
모든 INFO레벨이상의 로그는 다 console로 찍겠다는 겁니다.
(레벨에는 DEBUG, INFO, WARN, ERROR, FATAL 순인데, 예를 들어 INFO레벨로 지정해두면 logger.debug로 찍는 로그는 나타나지 않습니다. INFO레벨 이상것만 나타납니다.)

console은 아래 #Console log쪽에 보시면
log4j.appender.console <- 요 이름입니다.
요 console은 자세히보면 ConsoleAppender라는 클래스입니다. 이건 말그대로 콘솔에 로그를 찍어준다는 겁니다. layout에는 PatternLayout을 지정할 수 있는데 저 패턴은 뭐 레벨이 뭐고, 클래스가 뭐고, 메시지찍고 뭐 그런 내용입니다.

그리고, 파일에다가 출력 할 수 있는데, DailyRollingFileAppender클래스를 이용합니다. 이눔은 말그대로 매일매일 다른로그를 사용하게 만듭니다. 로그이름이 위와 같이 data.log라면, 해당로그가 어제날짜인데 로그를 찍으려고 하면 기존에 있던 파일은 data.log.2008-04-17 이렇게 바꿔줍니다.

아래부분에 보면 log4j.logger. 다음에 패키지명이나 클래스명을 지정해놓고, 로그레벨과 출력할 로그를 지정할 수 있는데요. 해당 클래스나 패키지의 로그는 저걸로 찍겠다는 겁니다.

name.of.the.package.two 클래스는 logfile로 찍힌다는 겁니다.
그리고, rootLogger가 colsole로 지정되어 있기 때문에 console에도 찍힙니다.


로그를 찍어봅시다.package log;

import org.apache.log4j.Logger;

public class Main {

    protected static Logger logger = Logger.getLogger(Main.class.getName());

    public static void main(String[] args) {

        //DEBUG < INFO < WARN < ERROR < FATAL

        logger.fatal("log4j:logger.fatal()");

        logger.error("log4j:logger.error()");

        logger.warn("log4j:logger.warn()");

        logger.info("log4j:logger.info()");

        logger.debug("log4j:logger.debug()");
    }
}


자 그럼 콘솔에는
FATALlog.Main.main(Main.java:13) -log4j:logger.fatal()
ERRORlog.Main.main(Main.java:15) -log4j:logger.error()
WARN log.Main.main(Main.java:17) -log4j:logger.warn()
INFO log.Main.main(Main.java:19) -log4j:logger.info()
이렇게 출력이 될 것이고 로그파일에도 관련하여 출력될 것입니다.


만약 콘솔에 두번 찍힌다면 아마도 이유는 rootLogger도 찍고, 아래 패키지를 지정한 로그도 찍었기 때문이죠.
그리고, 파일에는 한번만 쓰였다면 이유는 파일에 쓰는건

log4j.logger.name.of.the.package.two=INFO, logfile 여기 이 two 클래스 하나이기 때문입니다.


페이지 히스토리

###############################################

# FATAL : 가장 크리티컬한 에러가 일어 났을 때 사용합니다.
# ERROR : 일반 에러가 일어 났을 때 사용합니다.
# WARN : 에러는 아니지만 주의할 필요가 있을 때 사용합니다.
# INFO : 일반 정보를 나타낼 때 사용합니다.
# DEBUG : 일반 정보를 상세히 나타낼 때 사용합니다.

################################################


 

######################################################################
#%p  debug, info, warn, error, fatal 등의 priority 가 출력된다. 
#%m  로그내용이 출력됩니다
#%d  로깅 이벤트가 발생한 시간을 기록합니다.
#  포맷은 %d{HH:mm:ss, SSS}, %d{yyyy MMM dd HH:mm:ss, SSS}같은 형태로 사용하며 SimpleDateFormat에 따른 포맷팅을 하면 된다
#%t  로그이벤트가 발생된 쓰레드의 이름을 출력합니다. 
#%%  % 표시를 출력하기 위해 사용한다. 
#%n  플랫폼 종속적인 개행문자가 출력된다. \r\n 또는 \n 일것이다. 
#%c  카테고리를 표시합니다
#  예) 카테고리가 a.b.c 처럼 되어있다면 %c{2}는 b.c가 출력됩니다.
#%C  클래스명을 포시합니다.
#  예)클래스구조가 org.apache.xyz.SomeClass 처럼 되어있다면 %C{2}는 xyz.SomeClass 가 출력됩니다
#%F  로깅이 발생한 프로그램 파일명을 나타냅니다.
#%l  로깅이 발생한 caller의 정보를 나타냅니다
#%L  로깅이 발생한 caller의 라인수를 나타냅니다
#%M  로깅이 발생한 method 이름을 나타냅니다.
#%r  어플리케이션 시작 이후 부터 로깅이 발생한 시점의 시간(milliseconds)
#%x  로깅이 발생한 thread와 관련된 NDC(nested diagnostic context)를 출력합니다.
#%X  로깅이 발생한 thread와 관련된 MDC(mapped diagnostic context)를 출력합니다.

#######################################################################


 

#최상위 카테고리에 INFO로 레벨 설정 및 appender로 stdout, rolling을 정의
 log4j.rootLogger=DEBUG, stdout, rolling

#stdout 어펜더는 콘솔에 뿌리겠다는 정의
 log4j.appender.stdout=org.apache.log4j.ConsoleAppender

#stdout 어펜더는 patternlayout을 사용하겠다는 정의
 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

#페턴은 다음과 같이 포맷팅 하겠다는 것을 정의
 log4j.appender.stdout.layout.ConversionPattern=[%d{yyyy\ub144 MM\uc6d4 dd\uc77c HH:mm(ss)}] _%-5p_ [%t] %-17c{2} (%13F:%L) %3x -->\ub0b4\uc6a9 : %m%n


 

#역시나 rolling 어펜더는 파일로 처리한다라고 정의
 log4j.appender.rolling=org.apache.log4j.DailyRollingFileAppender

#로그 파일 이름은 output.log
 log4j.appender.rolling.File=output.log

#true면 톰캣을 내렸다 올려도 파일이 리셋되지 않습니다.
 log4j.appender.rolling.Append=true

#파일 최대 사이즈는 500KB로 설정
 log4j.appender.rolling.DatePattern='.'yyyy-MM-dd

#역시나 rolling 어펜더는 패턴 레이아웃을 사용하겠다고 정의
 log4j.appender.rolling.layout=org.apache.log4j.PatternLayout

#rolling 어펜더는 패턴 레이아웃 포맷
 log4j.appender.rolling.layout.ConversionPattern=[%d{yyyy\ub144 MM\uc6d4 dd\uc77c HH:mm(ss)}] _%-5p_ [%t] %-17c{2} (%13F:%L) %3x -->\ub0b4\uc6a9 : %m%n





위 그림과 같이 Log4J를 사용하면 무슨 Sql문을 사용하는지 무슨 데이터가 parameter로 넘어오는지 DB를 갔다 왔을때 어떤 데이터를 불러오는지를 이클립스의 Consol창을 통해 한번에 알 수 있다.
스프링에서는 Log4J를 설정하는 방법이 있어서 소개해 본다.

1. http://logging.apache.org/log4j/1.2/download.html 
다음 사이트에서 apache-log4j-1.2.15.zip를 다운 받고 압축을 푼다.
그 안에 있는 log4j-1.2.14.jar 파일을 압축 풀고 이클립스의 lib폴더에 넣는다.

2. log4j.properties 파일을 생성한다.
log4j.properties 파일은 콘솔에 로그가 어떻게 형태로 찍힐 것인지를 세팅하는 레이아웃을 잡아준다. 이런 설정은 구글 검색을 통해서 쉽게 얻을 수 있다. 물론 아래의 내용처럼 해도 된다.
properties파일은 #으로 시작하면 주석으로 처리한다.
# For JBoss: Avoid to setup Log4J outside $JBOSS_HOME/server/default/deploy/log4j.xml!
# For all other servers: Comment out the Log4J listener in web.xml to activate Log4J.
log4j.rootCategory=DEBUG, stdout

log4j.debug=false

#Console log
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.ImmediateFlush=true
log4j.appender.stdout.Target=System.err
log4j.appender.stdout.layout.ConversionPattern=[%p] (%F) - %m%n

3. web.xml 파일에 log4j를 로딩할 Listener와 log4j.perperties 파일위치를 정해주는 설정을 해준다.

<listener>
   <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>
<context-param>
  <param-name>log4jConfigLocation</param-name>
  <param-value>/WEB-INF/config/log4j.properties</param-value>
</context-param>




=========================================================================================================
=========================================================================================================

# Log4J란

# Log4j 환경 설정하는 방법

1) 프로그래밍내에서 직접 설정
  - 프로그래밍 내에서 직접 설정  ---------->  1번


2) 설정 파일을 사용하는 방법
    - XML 형식                          ---------->   2번
    - 자바의 프로퍼티 형식           ---------->  3번

# Log4J 설치

아래의 위치에서 파일을 다운로드 받는다.

위치 : http://logging.apache.org/site/binindex.cgi 파일 : jakarta-log4j-1.2.8.zip


원하는 장소에 압축을 풀면 아래와 같은 폴더가 나타난다.


Log4J를 사용하기 위해서는, 클래스 패스에 log4j-1.2.8을 포함해야 한다. 아래의 내용을 확인하면 추가하는 방법을 알 수 있다.

1) 프로그래밍내에서 직접 설정

// Log4j에 대한 테스트 소스 (1)

import org.apache.log4j.Logger;
import org.apache.log4j.BasicConfigurator;


public class SimpleLog {
 
 // Logger 클래스의 인스턴스를 받아온다.
   static Logger logger = Logger.getLogger(SimpleLog.class);

   public SimpleLog() {}

   public static void main(String[] args) {

   /*
     콘솔로 로그 출력 위한 간단한 설정,
     이 설정이 없다면 경고 메세지가 출력되면서 실행이 중단된다.
      */
    BasicConfigurator.configure();

       logger.debug("[DEBUG] Hello log4j.");
       logger.info ("[INFO]  Hello log4j.");
       logger.warn ("[WARN]  Hello log4j.");
       logger.error("[ERROR] Hello log4j.");
       logger.fatal("[FATAL] Hello log4j.");
       //loger.log( Level.DEBUG , "debug") 와 동일하다.
   }
}


# 출력결과 및 설명

 > 0 [main] DEBUG SimpleLog - [DEBUG] Hello log4j.
    ... (생략)...
 --------------------------------------------------------
 0                             - 로깅호출로부터 경과된 시간 (밀리세컨단위)
 [main]                     - 호출한 스레드의 이름
 DEBUG                    - 로그레벨
 SimpleLog                - 클래스 이름
 [DEBUG]Hello log4j. - 로그메세지
 --------------------------------------------------------

# 로그 레벨

로그 레벨은 다음과 같다.
---------------------------------------------------------
DEBUG  : 디버그
INFO     : 정보
WARN   : 경고
ERROR : 에러
FATAL  : 심각한 오류
---------------------------------------------------------
순서는 DEBUG > INFO > WARN > ERROR > FATAL 이며,

log.properties에서 설정한 값 이후의 내역은 모두 기록된다.
즉, INFO로 설정하면, INFO, WARN, ERROR, FATAL의 내용이 로그에 기록된다.



# 중요 컴포넌트 설명 

 1. Logger : 로그의 주체 (로그 파일을 작성하는 클래스)
    - Log4j의 심장부에 위치하며, 개발자가 로그출력 여부를 런타임에 조정되도록 해준다.

      로거는 로그레벨을 가지고 있으며, 로그의 출력여부는 로그문의 레벨과 로거의 레벨을 가지고 결정된다.


    - 어플리케이션을 작성하기전 어떤 로거를 사용해야 할지 정해야 한다.
       ex) static Logger logger = Logger.getLogger(SimpleLog.class);


     [참고] Commons-Logging 는 레퍼클래스도 존재함


 2. Appender : 로그를 출력하는 위치

     -  로그를 출력하는 위치를 의미하며,

         Log4J API문서의 XXXAppender로 끝나는 클래스들의 이름을 보면, 출력위치를 어느정도 짐작할 수 있다.


 3. Layout : Appender의 출력포맷
 
    -  일자, 시간, 클래스명등 여러가지 정보를 선택하여 로그정보내용으로 지정할 수 있다.

        자세한 패턴은 아래의 클래스정보를 살펴보면 알수있다.
        http://logging.apache.org/log4j/docs/api/org/apache/log4j/PatternLayout.html

    ※ Layout의 종류


        1) DateLayout,
        2) HTMLLayout,
        3) PatternLayout, ( 일반적으로 PatternLayout을 사용하는 것이 디버깅에 가장 적합함 )
        4) SimpleLayout,
        5) XMLLayout 


패턴 레이아웃 설명

ex) "[%d{yyyy-MM-dd HH:mm:ss}] %-5p [%l] - %m%n
------------------------------------------------------------------------------------------------------------
C : 클래스명을 출력한다. {1}과 같은 설정을 추가하여 클래스 이름 또는 특정 패키지 이상만 출력하도록 설정할 수 있다.
d : 로그 시간을 출력한다. java.text.SimpleDateFormat에서 적절한 출력 포맷을 지정할 수 있다.
F : 파일 이름을 출력한다. 로그시 수행한 메소드, 라인번호가 함께 출력된다.
L : 라인 번호만 출력한다.
m : 로그로 전달된 메시지를 출력한다.
M : 로그를 수행한 메소드명을 출력한다.
n : 줄 바꿈
p : 로그 이벤트명 (DEBUG등)
r : 로그 처리시간 (milliseconds)

------------------------------------------------------------------------------------------------------------

// Log4j에 대한 테스트 소스 (2)

 

import java.io.IOException;

import org.apache.log4j.DailyRollingFileAppender;
import org.apache.log4j.Logger;
import org.apache.log4j.PatternLayout;

public class DailyLog {
 
  static Logger logger = Logger.getLogger(DailyLog.class);
 
  public static void main(String[] args) {
    String pattern = "[%d{yyyy-MM-dd HH:mm:ss}] %-5p [%l] - %m%n";
    PatternLayout layout = new PatternLayout(pattern);
   
    // 처음 생성될 로그 파일의 이름
    String filename = "DailyLog.log";
   
    // 날짜 패턴에 따라 추가될 파일 이름
    String datePattern = ".yyyy-MM-dd";
   
    DailyRollingFileAppender appender = null;
    try {
      appender = new DailyRollingFileAppender(layout, filename, datePattern);
    } catch (IOException ioe) {
      ioe.printStackTrace();
    }
   
    logger.addAppender(appender);
   
    logger.debug("Hello log4j.");
  }
}


---------- java ----------
출력 완료 (1초 경과) - 정상 종료
DailyLog.log 파일을 열어보면 아래와 같은 내용이 추가된것을 알 수 있다.

[2004-07-29 17:36:05] DEBUG [DailyLog.main(DailyLog.java:30)] - Hello log4j.


파일의 내용은 소스 코드에서 정의된 패턴인 "[%d{yyyy-MM-dd HH:mm:ss}] %-5p [%l] - %m%n" 에 따라 생성된 것이다.


출력된 것과 대조해보면 대충 어떤 의미인지 유추가 가능하다.

-----------------------------------------------------------------------------------------

1번째 : 날짜  (날짜를 나타내는 형태도 SimpleDateFormat 을 사용하는 것처럼 원하는 형태로 가능)

2번째 : 로그 레벨

3번째 : [패키지 이름.클래스 이름.메소드 이름(소스 파일 이름:소스 라인 넘버)] 

4번째 : 실제 로그 내용

-----------------------------------------------------------------------------------------

(출력 패턴은 이외에도 많은 것들이 있는데 자세한 사항은 log4j API 문서를 참고하도록 하자.)
     

2) 설정 파일을 사용하는 방법 (1) - 자바 프로퍼티 형식

# properties 파일 사용하는 법 (자바의 프로퍼티 형식)


애플리케이션에서 각 클래스는 각각의 로거를 가지거나 공통의 로거를 가질 수 있다.

Log4j는 모든 로거가 상속할 수 있는 루트 로거를 제공한다.

log4j.properties를 만들때도 맨 위에 필요한 것이 루트로거에 대한 내용이다.

#log4j.rootLogger=DEBUG, A1
log4j.rootLogger=OFF, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}] - %m%n


아래 문서는 log를 출력할 자바문서이다.

import org.apache.log4j.Logger;

import org.apache.log4j.PropertyConfigurator;


public class LogProperty {



static Logger logger = Logger.getLogger(LogProperty.class);



public static void main(String[] args) {

logger.debug("Hello log4j.");

}

}

실행
---------- java ----------
출력 완료 (1초 경과) - 정상 종료


화면에 출력되는 로그는 없다. 아래와 같이 변경한 후 다시 LogProperty를 실행한다.


log4j.rootLogger=DEBUG, A1
#log4j.rootLogger=OFF, A1


아래와 같이 결과가 나타날 것이다.

---------- java ----------
[2004-07-29 18:10:33] - Hello log4j.
출력 완료 (3초 경과) - 정상 종료



또 다른 예를 들어보자. log4j.properties 를 아래와 같이 수정한다.

log4j.rootLogger=DEBUG, A1
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=test.log
log4j.appender.A1.DatePattern='.'yyyy-mm-dd
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}] %-5p [%l] - %m%n


LogProperty.java 문서를 다시 실행하면 같은 폴더에 test.log 파일이 생성된다. test.log파일을 열어본다.



------------------------------------------------------------
Log4j의 초기화 (log4j.properties 파일을 이용한 초기화)
------------------------------------------------------------

초기화를 위한 첫번째 방법은 필요한 로깅 요소를 포함하는 log4j.properties 파일을 만들어 이를 통해 초기화 하는것입니다. 아래 예는 INFO 레벨로 oef.apache.log4j.ConsoleAppender를 사용하여 콘솔에 메시지를출력하는 설정 파일 입니다.
[Log4j.properties]

# A basic log4j configuration file that creates a single
console appender
# Create a single console appender that logs INFO and higher
log4j.rootLogger=INFO, stdout
# Configure the stdout appender to go to the console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
# Configure the stdout appender to use the PatternLayout
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
# Pattern to output the caller's filename and line number.
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n

이 설정은 하나의 Appender 즉 System.out으로만 메시지를 출력하는 ConsoleAppender를 사용 합니다.

log4j.properties 파일은 WEB-INF/classes 폴더에 설치해야 하며 다중 애플리케이션 환경일 경우 각 애플리케이션 별로 log4j.properties를 설치 할 수 있습니다.

아래의 log4j.properties 파일은 메시지의 레벨과 다른 파라미터들을 기반으로 하여 여러 Appender에 로그 메시지를 기록하도록 설정 하는 예 입니다. 콘솔에도 출력하고 out.log 파일에도 메시지를 출력 합니다.

[Log4j.properties]

# A sample log4j configuration file
# Create two appenders, one called stdout and the other called rolling
log4j.rootLogger=DEBUG, stdout, rolling

# Configure the stdout appender to go to the console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender

# Configure the stdout appender to use the PatternLayout
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

# Pattern to output the caller's filename and line number
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L)- %m%n

# Configure the rolling appender to be a RollingFileAppender
log4j.appender.rolling=org.apache.log4j.RollingFileAppender

# Configure the name of the logout for the rolling appender
log4j.appender.rolling.File=output.log

# Set up the maximum size of the rolling log file
log4j.appender.rolling.MaxFileSize=100KB

# Keep one backup file of the rolling appender
log4j.appender.rolling.MaxBackupIndex=1

# Configure the layout pattern and conversion pattern for the rolling appender
log4j.appender.rolling.layout=org.apache.log4j.PatternLayout
log4j.appender.rolling.layout.ConversionPattern=%d{ABSOLUTE} - %p %c - %m%n


3) 설정 파일을 사용하는 방법 (2) - XML 형식


# XML로 log4j 사용하는 법

------------------------------------------------------------
Log4j의 초기화 (XML 파일을 이용한 초기화)
------------------------------------------------------------


Log4j.properties 처럼 XML 파일 역시 WEB-INF/classes 폴더에 위치하면 됩니다.
그리고 파일이름은 반드시 log4j.configuration 시스템 프로퍼티에 지정하여 어떤 파일을 로딩 할것인지를 알게 해야 합니다.

Log4j.configuration 파일에서 프로퍼티를 설정 하는 방법은 다음과 같습니다.

set CATALINA_OPTS=-Dlog4j.configuration=log4j.xml

또는 자바 명령행에서 지정하는 것도 가능 합니다.

java -Dlog4j.configuration=log4j.xml


[log4j.xml]
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration
xmlns:log4j='http://jakarta.apache.org/log4j/'>
<appender name="stdout"
class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%5p [%t] (%F:%L)- %m%n"/>
</layout>
</appender>
<root>
<priority value ="INFO" />
<appender-ref ref="stdout" />
</root>
</log4j:configuration>


참고로 log4j.xml 파일의 위치를 /WEB-INF/class 에서 상대적으로 지정하지 않고 파일 시스템의 절대 경로를 사용 하기 위해서는 다음과 같이 합니다.

java -Dlog4j.configuration=file:/c:/dev/env/log4j.xml

<<소스-xml>>

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

    <!-- 콘솔로 보기(디버그) -->
    <appender name="CONSOLE-debug" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%p - %C{1}  :  %M  %m %n"/>
        </layout>
    </appender>
   
    <!-- 콘솔로 보기(인포) -->
    <appender name="CONSOLE-info" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%m ---%d %n"/>
        </layout>
    </appender>
   
    <!-- 매 날짜별 로그 파일 남기기 -->
    <appender name="LOGFILE-DAILY" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="test-daily.log"/>
        <param name="Append" value="true"/>
        <param name="DatePattern" value="'.'yyyy-MM-dd"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
        </layout>
    </appender>
   
     <!-- 매 날짜별 로그 파일 남기기(로그인) -->
    <appender name="LOGFILE-DAILY-LOGIN" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="test-daily-login.log"/>
        <param name="Append" value="true"/>
        <param name="DatePattern" value="'.'yyyy-MM-dd"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d - %m%n"/>
        </layout>
    </appender>
   
     <!-- 매 날짜별 로그 파일 남기기(가입) -->
    <appender name="LOGFILE-DAILY-JOIN" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="test-daily-join.log"/>
        <param name="Append" value="true"/>
        <param name="DatePattern" value="'.'yyyy-MM-dd"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d - %m%n"/>
        </layout>
    </appender>
   
     <!-- 매 날짜별 로그 파일 남기기(탈퇴) -->
    <appender name="LOGFILE-DAILY-JOINBREAK" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="file" value="test-daily-joinbreak.log"/>
        <param name="Append" value="true"/>
        <param name="DatePattern" value="'.'yyyy-MM-dd"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d - %m%n"/>
        </layout>
    </appender>
   
    <!-- 로그 파일 100KB마다 새로 남기기 -->
    <appender name="LOGFILE-SIZE" class="org.apache.log4j.RollingFileAppender">
        <param name="file" value="test-Size.log"/>
        <param name="Append" value="true"/>
        <param name="MaxFileSize" value="100KB"/>

       <param name="MaxBackupIndex" value="5"/>  
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
        </layout>
    </appender>
   
    <!-- XML 형태로 로그 파일 남기기 -->
    <appender name="LOGFILE-XML" class="org.apache.log4j.FileAppender">
        <param name="file" value="test-XML.log"/>
        <param name="Append" value="true"/>
        <layout class="org.apache.log4j.xml.XMLLayout"/>
    </appender>

    <logger name="org.apache">
        <level value="WARN"/>
    </logger>
   
    <root>
        <level value="INFO"/>
        <appender-ref ref="CONSOLE-debug"/>
       
        <!--<appender-ref ref="LOGFILE-DAILY"/>-->
        <!--<appender-ref ref="LOGFILE-SIZE"/>-->
        <!--<appender-ref ref="CONSOLE-info"/>-->
        <!--<appender-ref ref="LOGFILE-XML"/>-->
    </root>
</log4j:configuration>


<<소스-Properties>>
# A sample log4j configuration file

# Create two appenders, one called stdout and the other called rolling
log4j.rootCategory=INFO, stdout

log4j.debug=false


# Configure the stdout appender to go to the console
log4j.appender.stdout=org.apache.log4j.ConsoleAppender

# Configure the stdout appender to use the PatternLayout
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

# Pattern to output the caller's filename and line number
log4j.appender.stdout.layout.ConversionPattern=%5p,[%d],[%t],(%F:%L),%m%n

#-Dlog4j.configuration="file:D:\myworkspace\FrameWorkTest\src\log4j.properties --------Eclipse Connection


==========================

jeus 5 log 설정.


이 문서는 JEUS 5의 웹 관리자를 사용한 logging 설정 방법 및 customization 방법, log4j 사용법 등을 설명한다.

기본logger 파일
최초 JEUS 설치 시, JEUS log는 default로 console handler를 사용하기 때문에 JEUS manager와모든 engine container의 log message가 stdout형태로 출력된다. 또한 web container 의access log가$JEUS_HOME/logs/<노드명>/<노드명>_<컨테이너명>/servlet /accesslog/access.log 에 출력 된다.

웹관리자접속
웹 관리자에 접속하는 방법은 다음과 같다. 웹 관리자는JEUS_BASEPORT + 8 의 포트를 사용하므로 JEUS_BASEPORT 가 default 로 9736이므로 웹 관리자는9744를 사용하고, 해당 Port에 대해 방화벽이 열려 있어야 한다.


웹 관리자로 log 설정하기

1. JEUS Server log 설정
웹관리자 접속 후 노드명을 선택하면 오른쪽 화면에서 에러로그설정 항목을 볼 수있다.

Input image

로거추가를 선택하면 logging level 설정 화면이 나오는데, logging level 은 다음과 같다.
FATAL<NOTICE<INFORMATION<DEBUG<SEVERE<WARNING<INFO<CONFIG<FINE<FINER<FINEST<ALL

- default level 은 INFO
- 개발자는보통 FINE

logging level 선택 후 확인을 누르면 아래와 같이 jeus logger가 추가된 것을 볼 수 있다.

Input image

추가된 jeus logger를 선택하면 로그핸들러 생성화면을 볼 수 있는데, 핸들러의 종류는 다음과 같다.
console-handler, file-handler, smtp-handler, socket-handler, user-handler
- default 는 console-handler

사용하고자 하는 핸들러를 선택하면 아래와 같이 새 로그 핸들러 생성 화면이 나타난다. 각 항목 확인 후 생성버튼을 누르면 JEUS Server log 가 생성된다.
웹관리자에서 생성한 JEUS Server log 는 $JEUS_HOME/config/<노드명>/JEUSMain.xml 에 xml 형태로 추가된다.

<<JEUSMain.xml>>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
<node>
...
<system-logging>
          <level>INFO</level>
          <handler>
              <file-handler>
                  <name>handler1</name>
                  <level>FINEST</level>
                  <valid-day>1</valid-day>
              </file-handler>
          </handler>
      </system-logging>

위와 같이 file-handler, 1일 단위로 생성했을 경우 log 는, $JEUS_HOME/logs/<노드명> 에JeusServer_<날짜>.log 형식으로 남게 된다.<system-logging><level>의 log level은 <handler>에서 설정한<level> 보다 우선한다.  log 를 실시간으로 확인하기 위해서 tail 명령어를 사용하거나,
test:/home/main/jeus5/logs/test> tail -f JeusServer_<날짜>.log

또는 사용자 profile 에 아래와 같이 alias 를 설정하는 방법이 있다.
alias jlog='tail -f ${JEUS_HOME}/logs/`hostname`/JeusServer_`date +%Y%m%d`.log'

2. Container log 설정
Container log 는 Container 마다 별도로 log를 관리 할 수 있다는 장점이 있다.
Container log설정은 위와 마찬가지로 웹 관리자를 사용한다. 웹 관리자에 접속 후 컨테이너명을 선택하면 오른쪽 화면에서 에러 로그 설정 항목을 볼 수 있다.
logging 설정은 JEUS Server log 설정을 참고한다.

웹관리자에서 생성한 Container log는 $JEUS_HOME/config/<노드명>/JEUSMain.xml 에 xml 형태로 추가된다.

<<JEUSMain.xml>>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <node>
        <name>test</name>
        <engine-container>
            <name>container1</name>
            ...
            <system-logging>
                <level>INFO</level>
                <handler>
                    <file-handler>
                        <name>handler1</name>
                        <level>FINE</level>
                        <valid-day>1</valid-day>
                    </file-handler>
                </handler>
            </system-logging>
        </engine-container>

Containerlog 를 file-handler, 1일 단위로 생성했을 경우 log 는,$JEUS_HOME/logs/<노드명>/<노드명>_<컨테이너명> 에<노드명>_<컨테이너명>_<날짜>.log 형식으로 남게 된다.
<system-logging><level>의 log level은 <handler>에서 설정한 <level> 보다 우선한다.
log 를 실시간으로 확인하기 위해 tail 명령어를 사용하거나 사용자 profile 에 아래와 같이 alias 를 설정하는 방법이 있다.

alias clog='tail -f ${JEUS_HOME}/logs/`hostname`/`hostname`_container1/`hostname`_container1_`date +%Y%m%d`.log'
Container log에서 ConsoleHandler 를 사용할 경우 Console로 외의 JEUS Server log에 같이 출력 된다.


JEUS logging 패턴
JEUS logging 은 JDK1.4에서 포함된 java.util.logging 패키지에 있는 Logging API를 따른다.
JEUS의 logging 환경은 JEUS_HOME/bin/logging.properties 에 설정되어 있다.
logging.propertis 를 보면 JEUS는 default 로 ConsoleHandler 를 사용하고, logging level 은 INFO 임을 알 수 있다.
handler 를 추가할 경우는 다음과 같이 콤마로 분리한다.

handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

또한 console 에 출력되는 log level 은 아래의 항목에서 지정할 수 있다.
java.util.logging.ConsoleHandler.level = FINE

FileHandler 를 사용할 경우, log는 기본적으로 사용자 홈 디렉토리에 출력되지만 경로나 출력 포맷 (XMLFormatter or SimpleFormatter)등을 지정할 수 있다.

java.util.logging.FileHandler.pattern = /home/main/MyLog.log

java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

ConsoleHandler도 마찬가지로 log level 과 출력 포맷을 지정할 수 있고, 특정 class 에서의 log level 설정도 가능하다.

아래는 logging.properties 에 설정한 각 항목을 테스트 할 수 있는 예이다.

<<shbean.jsp>>
<%
        com.SHBean a = new com.SHBean();
%>


<<SHBean.java>>
package com;
import java.util.logging.*;
public class SHBean{
        Logger logger = null;
        public SHBean(){
                logger = Logger.getLogger(getClass().getName());
                logger.setLevel(Level.FINEST);

logger.info("info test");
                logger.severe("severe test");
                logger.fine("fine test");
                logger.finest("finest test");
        }
}

logging.properties 를 아래와 같이 설정할 경우,

<<logging.properties>>
handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler
java.util.logging.FileHandler.pattern = /home/star/MyLog.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
java.util.logging.ConsoleHandler.level = FINE
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
...

아래와 같은 결과를 얻을 수 있다.
<<JeusServer_20080404.log>>
...
<<JeusServer_20080404.log>>

2008. 4. 4오후 6:11:16 com.SHBean <init>
정보: info test

2008. 4. 4오후 6:11:16 com.SHBean <init>
심각: severe test

2008. 4. 4오후 6:11:16 com.SHBean <init>
자세히: fine test


access log 비활성화

별도의 설정이 없을 경우 Web Container당 1개의 access-log 가 생성된다. access log 에는Context Group에 대한 모든 요청과 사용자 접근에 관한 log가 남는다. access log의 기본 위치는,$JEUS_HOME/logs/<노드명>/<노드명>_<컨테이너명>/servlet /accesslog/<GroupName>/access.log가 기본 log file이다. 

그런데 접근이 빈번한사이트에서는 access log의 양이 클 수가 있으므로 access logging 기능을 사용하지 않는 것이 좋다.access log는 default 가 true 이기 때문에,$JEUS_HOME/config/<노드명>/<노드명>_servlet_<엔진명> /WEBMain.xml 에서 설정을 변경 할 수 있다. 아래와 같이<logging><access-log><enable>을 false 로 하면 된다.

<<WEBMain.xml>>
<web-container xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <context-group>
        ...
<logging>
<access-log>
<enable>false</enable>
...

참고해야 할 사항은 access log 는 <valid-day> 를 명시하지 않으면 하나의 파일에 남기 때문에 1일 단위로 출력하기 위해서는 위의 태그를 명시해야 한다.

log 파일경로변경

1. log home 변경
log home디렉토리 위치 변경은 $JEUS_HOME/bin/jeus 에서 -Djeus.log.home 을 추가하고 원하는 log 위치를 명시한다.
-Djeus.log.home=/home/main/logs      \
 
2. handler가 사용할 file name설정
JEUS4 버전까지는 전체적인 log home 경로 변경만 가능하였지만, JEUS 5에서는 사용자가 세부적인 log에 대한 위치를 정할수 있다. 다음과 같이<file-name>태그를 통하여 handler가 사용할 file name을 설정할 수 있다.

<<JEUSMain.xml>>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
<node>
...
<system-logging>
          <level>INFO</level>
          <handler>
              <file-handler>
                  <name>handler1</name>
                  <level>FINEST</level>
                  <valid-day>1</valid-day>
<file-name>7/home/main/Mylog.log</file-name>
              </file-handler>
          </handler>
      </system-logging>


log4j API를이용한 logging
JEUS에서 log4j를 사용할 경우 log4j-1.xxx.jar 파일은 위치는 통상적으로 다음 경로에 올 수 있다.
- $JEUS_HOME/lib/application  ... ①
- context 아래의 WEB-INF/lib ... ②
- 임의의경로 : /home/main/log4j/log4j-1.xxx.jar

임의의경로에넣을경우, JEUSMain.xml 의 <user-class-path> 태그에위경로를설정함 ... ③

그리고 log4j.properties는 classpath에 포함되는 디렉토리에 위치시키는데 다음과 같이 올 수 있다.

- $JEUS_HOME/lib/application  ... ①
- context 아래의 WEB-INF/classes ... ②
- 파일위치 : /home/main/log4j/log4j.properties

임의의경로에넣을경우, JEUSMain.xml 의 <user-class-path> 태그에위경로를설정함 ... ③
예를 들어 ①과 ② 경로에 모두 log4j.properties 가 있는 경우 ①의 위치한 log4j.properties 가 실행된다.

log4j.properties 에서 아래와 같이 로그파일의 경로를 상대경로로 설정할 경우, JEUS를 restart 할 때마다 파일의 위치는 가변적이다. 즉, restart 한 시점의 경로에 로그파일이 발생하게 된다.

<<log4j.properties>>
...
log4j.appender.dailyfile.Threshold = DEBUG
log4j.appender.dailyfile = org.apache.log4j.DailyRollingFileAppender
log4j.appender.dailyfile.File = logfile.log
log4j.appender.dailyfile.layout = org.apache.log4j.PatternLayout




예) XML Property : java -Dlog4j.configuration=log4j.xml
===============================================================================================
===============================================================================================
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration>

<appender name="A1" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
    </layout>
</appender>

<root>
    <priority value ="debug" />
    <appender-ref ref="A1"/>
</root>

</log4j:configuration>


예) XML Property
===============================================================================================
===============================================================================================
<?xml version="1.0" encoding="euc-kr" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<!--
파일에 로그를 기록하는 샘플입니다.
기본적으로 로그파일의 이름을 기록할 수 있으며,
해당설정은 root logger에 설정되어 있는 내용을 참조하여 설정이 가능합니다.
아래의 설정파일은 매일로그를 남길수 있는 형태여서 형태가 다양하게 나타날수 있습니다.
날짜변경이 되면 자동으로 로그가 바뀝니다.
-->
<log4j:configuration>

<appender name="A1" class="org.apache.log4j.DailyRollingFileAppender">
    <param name="File" value="ienvyou.log"/>
    <param name="Append" value="false"/>
    <param name="DatePattern" value="'.'yyyy-MM-dd"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
    </layout>
</appender>

<root>
    <priority value ="debug" />
    <appender-ref ref="A1"/>
</root>

</log4j:configuration>


예) XML Property
===============================================================================================
===============================================================================================
<?xml version="1.0" encoding="euc-kr" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<!--
File에 로그를 계속적으로 쌓이게 하는 방법입니다.
기본적으로 로그파일의 이름을 기록할 수 있으며,
해당설정은 root logger에 설정되어 있는 내용을 참조하여 설정이 가능합니다.
-->
<log4j:configuration>

<appender name="A1" class="org.apache.log4j.FileAppender">
    <param name="File" value="ienvyou.log"/>
    <param name="Append" value="false"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
    </layout>
</appender>

<root>
    <priority value ="debug" />
    <appender-ref ref="A1"/>
</root>

</log4j:configuration>


예) XML Property
===============================================================================================
===============================================================================================
<?xml version="1.0" encoding="euc-kr" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<!--
출력을 XML포맷의 파일로 하는 방법입니다.
기본적으로 로그파일의 이름을 기록할 수 있으며
해당설정은 root logger에 설정되어 있는 내용을 참조하여 설정이 가능합니다.
출력은 XML형태의 파일로 저장됩니다.
-->
<log4j:configuration>

<appender name="A1" class="org.apache.log4j.FileAppender">
    <param name="File" value="ienvyou.log"/>
    <param name="Append" value="false"/>
    <layout class="org.apache.log4j.xml.XMLLayout"/>
</appender>

<root>
    <priority value ="debug" />
    <appender-ref ref="A1"/>
</root>

</log4j:configuration>


예) XML Property
===============================================================================================
===============================================================================================
<?xml version="1.0" encoding="euc-kr" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<!--
파일이 일정용량(예제:100KB) 이 되면 xxx.log.1, xxx.log.2의 형태로 변경시키는 방법입니다.
기본적으로 로그파일의 이름을 기록할 수 있으며
해당설정은 root logger에 설정되어 있는 내용을 참조하여 설정이 가능합니다.
아래의 설정파일은 일정파일사이즈가 되면 파일변경
-->
<log4j:configuration>

<appender name="A1" class="org.apache.log4j.RollingFileAppender">
    <param name="File" value="ienvyou.log"/>
    <param name="Append" value="false"/>
    <param name="MaxFileSize" value="100KB"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d %-5p [%t] %-17c{2} (%13F:%L) %3x - %m%n"/>
    </layout>
</appender>

<root>
<priority value ="debug" />
<appender-ref ref="A1"/>
</root>

</log4j:configuration>
클라이언트와 지속적인 연결을 유지하지 못하는 것이 http protocol의 특징이므로, 이전 요청한 클라이언트와의 연결을 유지하기 위해서 Session을 사용한다.
컨테이너(톰캣) 단에서 Session ID를 발행하고, 해당 Session ID와 Cookie를 맵핑 한 다음 해당 쿠키를 클라이언트에서 사용하도록 하면 클라이언트를 구분해서 받을 수 있다.

* 세션 ID는 다음과 같은 방법으로 사용할 수 있다.

HttpSession session = request.getSession();

위와 같이 하게 되면, request로부터 세션 ID를 가지고 올 수 있고, 제일 처음 요청이라면 response 객체에 보낼 쿠키도 생성하게 된다.

* 세션이 이미 있는지, 아니면 처음 요청으로 새롭게 만들게 되었는지를 확인하려면 다음과 같이 하면 된다.

HttpSession session = request.getSession();

if(session.isNew()) {
    out.println("This is a new session");
} else {
    out.println("Welcome back!");
}

* 클라이언트가 쿠키를 사용하지 않을 경우에는 세션 ID를 URL 뒤에 붙여 보내줘서 쿠키 대신에 URL을 파싱해서 클라이언트를 구분하기도 한다.
URL 뒤에 세션 아이디를 붙여 보내기 위해서는 다음과 같이 하면 된다.

HttpSession session = reqeust.getSession();

out.printl("<a href=\"" + response.encodeURL("/BeerTest.do") + "\">click me</a>");

세션을 유지하면서 요청을 다른 서블릿이나 JSP로 보내고 싶은 경우에는 encodeRedirectURL()을 사용하면 된다.

* 오래된 세션은 세션 타임아웃을 web.xml에 설정하여 전체 세션에 적용해서 사용하거나, 메소드를 사용하여 특정 세션에서만 사용할 수 있다.
사용 방법은 다음과 같다.

web.xml에서 사용하는 방법

  <session-config>
      <session-timeout>15</session-timeout>
  </session-config>

특정 세션에서만 사용하는 방법

session.setMaxInactiveInterval(20*60);

web.xml에서는 분 단위로 적을 수 있고, setMaxInactiveInterval의 인자값으로 사용할 경우에는 초 단위로 사용할 수 있다.
위의 경우에는 15분 또는 20분이라는 의미이다.

예전에 사용하다가 한참 놓아둔 이클립스 프로젝트를 다시 수행시키니까.

(정확히 말하자면 새 프로젝트에 기존 프로젝트 소스와 jar.파일들을 추가시켜서 동일한 환경으로 만들고)


java.lang.NoSuchMethodError

 

에러가 났다.


아무리 생각해도 딱히 원인이 없었다.

메소드도 다 있었고..

잘 돌아가야하는데..


정확한 해결책인지는 알 수 없으나,

BuildPath를 보니까 다른 위치에서 온 동일한 jar.파일들이 여러개 추가되어있었다.


그래서 같은 jar라고 생각되는 것들은 삭제하고 하나씩만 추가했더니 수정됐다.

-- 세션(Session)


 - 정의
   . 서버와 클라이언트간의 연결을 유지하기 위한방법중 하나
   . 클라이언트가 처음 접속하면 세션아이디를 부여하고 서버에 저장하며 클라이언트가 접속했을 때 세션아이디로 구분
   . 자세히 보면 세션도 쿠키(세션아이디를 클라이언트에게 부여할 때 request+쿠키를 이용)

 

 - 세션과 쿠키의 차이점 

구분
쿠키
세션
저장되는
클라이언트
서버
저장되는 형식
텍스트
Object
만료시점
쿠키 저장 설정 가능
(설정하지 않을 경우 브라우저 종료 소멸)
클라이언트가 로그아웃 하거나 설정 시간 동안 반응이 없을 경우
리소스
클라이언트의 리소스 사용
서버의 리소스 사용
용량 제한
도메인 20
쿠키 하나당 4KB
300
서버가 허용하는 용량


 - 세션 생성
   HttpSession session = request.getSession(true);  //request.getSession(true)는 request.getSession() 과 동일


 - jsp페이지
   .세션사용
   <
%@page session="true"%>
   .세션 아이디 출력
   <%=session.getId()%>
   .생성시간 출력
   <%=new java.util.Date(session.getCreationTime()).toString()%>
   .마지막 접속시간 출력
   <%=new java.util.Date(session.getLastAccessedTime()).toString()%>
   .세션 Active시간 출력
   <%=session.getMaxInactiveInterval()%>


 - 세션의 생명주기와 종료
   //세션의 생명주기를 10분으로 설정(10분동안 사용이 없다면 세션정보삭제)
   session.setMaxInactiveInterval(60*10);
   //강제종료
   session.invalidate();

'Java' 카테고리의 다른 글

Session 관리  (0) 2010.07.26
java.lang.NoSuchMethodError  (0) 2010.07.22
HttpServletRequest, HttpServletResponse의 개요  (0) 2010.07.20
Java API 한글 문서 Java / 공부나하죠?  (0) 2010.07.20
스프링 AOP  (0) 2010.07.16

클라이언트의 요청을 받아 서블릿 컨테이너가 HttpServletRequest객체를 만들고 이 객체를 service메서드에 전달하게 됩니다. service메서드는 doGet과 doPost를 호출하면서 매개변수형식으로 넘겨주게 됩니다. 일단, 자동으로 이루어지기 때문에 여러분은 그냥 사용하면 되는 것입니다. HttpServletRequest로 할 수 있는 일은 다양합니다. 그것을 정리해 보면 다음과 같습니다. HttpServletRequest는 ServletRequest로부터 상속받고 HttpServletReponse는 ServletResponse로부터 상속 받습니다. 물론, ServletRequest와 SevletResponse를 Http프로토콜에 맞게 변형한 것이 바로 HttpServletRequest와 HttpServletResponse입니다. 이 두 인터페이스가 할 수 있는 일을 알아보면 다음과 같습니다.

 

HttpServletRequest

n        클라이언트의 모든 요청 정보 보유

n        request header

n        form data, query parameter

n        InputStream(클라이언트로부터 전송되어지는 데이터)

n        기타 클라이언트 정보얻기 à 세션 정보, 쿠키, path ...

 

HttpServletResponse

n        클라이언트에게 보내지는 모든 정보 보유

n        response header

n        OutputStream (클라이언트에게 보내지는 데이터)

n        쿠키 설정

n        세션 설정

http://download.oracle.com/docs/cd/E17409_01/javase/6/docs/api/index.html
Java API(Application Programming Interface) 문서란


자바 라이브러리의 클래스와 메소드를 나열해 놓은 목록입니다.


자바 프로그램을 짜다 보면은 많은 수의 클래스와 메소드를 사용하게 되는데


그런 클래스와 메소드를 설명해주는 좋은 문서입니다.


처음에는 Java API 문서가 영어로 되어 있어서 찾고 쓰기가 힘들었는데


한글로 번역된 것이 나와 Tip정도로 알고 있으면 좋을거 같아 소개합니다.

 

1. AOP 소개

  □ AOP 소개
    ■ AOP (Aspect Oriented Programming)

      - 문제를 해결하기 위한 핵심 관심 사항(core concern, 핵심 로직)과 전체에 적용되는 공통 관심 사항(cross-cutting concern,
        공통 기능)을 기준으로 프로그래밍함으로써 공통 모듈을 여러 코드에 쉽게 적용할 수 있도록 해 줌.
    ■ 공통 관심 사항을 구쳔한 코드를 핵심 로직을 구현한 코드 안에 삽입

      - 핵심 로직을 구현한 코드에서 공통 기능을 직접적으로 호출하지 않음.
      - 핵심 로직을 구현한 코드를 컴파일하거나, 컴파일된 클래스를 로딩하거나, 로딩된 클래스의 객체를 생성할 때 AOP가 적용되어

        핵심 로직 구현 코드 안에 공통 기능이 삽입됨.
      - 공통 기능이 변경되더라도 핵심 로직을 구현한 코드를 변경할 필요가 없음.
        (공통 기능 코드를 변경한 뒤 핵심 로직 구현 코드에 적용만 하면 됨.)

  □ AOP 용어
    ■ Advice
      - 언제 공통 관심 기능을 핵심 로직에 적용할지를 정의.
      - 예로, '메서드를 호출하기 전'(언제)에 '트랜잭션을 시작한다'(공통 기능) 기능을 적용한다는 것을 정의.
    ■ Joinpoint
      - Advice를 적용 가능한 지점을 의미.
      - 메서드 호출, 필드 값 변경 등이 Joinpoint에 해당.
    ■ Pointcut
      - Joinpoint의 부분 집합으로써 실제로 Advice가 적용되는 Joinpoint를 나타냄.
      - 스프링에서는 정규 표현식으나 AspectJ의 문법을 이용하여 Pointcut을 정의.
    ■ Weaving
      - Advice를 핵심 로직 코드에 적용하는 것을 의미.
      - 공통 코드를 핵심 로직 코드에 삽입하는 것.
    ■ Aspect
      - 여러 객체에 공통으로 적용되는 공통 관심 사항을 의미.
      - 트랜잭션이나 보안 등이 해당.

  □ 세 가지 Weaving 방식

    ■ Advice를 Weaving하는 방식
      - 컴파일 시에 Weaving 하기.
      - 클래스 로딩 시에 Weaving 하기.
      - 런타임 시에 Weaving 하기.
    ■ 컴파일 방식
      - AspectJ에서 사용하는 방식.
      - 핵심 로직을 구현한 자바 소스 코드를 컴파일할 때에 알맞은 위치에 공통 코드를 삽입. (AOP가 적용된 클래스 파일이 생성.)
      - 컴파일 방식을 제공하는 AOP 도구는 공통 코드를 알맞은 위치에 삽입할 수 있도록 도와주는 컴파일러나 IDE를 함께 제공.
    ■ 클래스 로딩 방식
      - AOP 라이브러리는 JVM이 클래스를 로딩할 때 클래스 정보를 변경할 수 있는 에이전트를 제공.
      - 에이전트는 로딩한 클래스의 바이너리 정보를 변경하여 알맞은 위치에 공통 코드를 삽입한 새로운 클래스 바이너리 코드를 사용.
      - 원본 클래스 파일은 변경하지 않고 클래스를 로딩할 때에 JVM이 변경된 바이트 코드를 사용하도록 함으로써 AOP를 적용.
      - AspectJ 5 버전이 컴파일 방식과 더불어 클래스 로딩 방식을 함께 지원.
    ■ 런타임 방식
      - 소스 코드나 클래스 정보 자체를 변경하지 않음.
      - 프록시를 이용하여 AOP를 적용.
      - 핵심 로직을 구현한 객체에 직접 접근하는 것이 아니라 중간에 프록시를 생성하여 프록시를 통해서 핵심 로직을 구현한 객체에
        접근.
      ○ 프록시 기반의 AOP 적용 과정
        - 프록시는 핵심 로직을 실행하기 전 또는 후에 공통 기능을 적용하는 방식으로 AOP를 적용.
        - 메서드가 호출될 때에만 Advice를 적용할 수 있기 때문에 필드 값 변경과 같은 Joinpoint에 대해서는 적용할 수 없는 한계가 있음.

왜 프레임워크인가?

엔터프라이즈 환경의 프로젝트에서 각 프레임워크가 도입되는 이유는 무엇인가?
가장 큰 이유는 개발 현장의 개발생산성의 향상과 고품질이 보장된 어플리케이션의 개발을 위해서이다.

다양한 요구사항을 만족할 수 있는 유연하고 풍부한 기능을 제공하는 프레임워크구축, 개발 생산성 향상과 고품질의 시스템 개발을 위한 프레임워크의 필요성이 대두되면서, Struts, Spring, WebWork와 같은 프레임웍이 등장하기 시작했다.

왜 스프링인가?

다양한 프레임워크가 나와있고, 그 중에 J2EE기반에서 가장 두각을 나타내는 프레임웍이 Spring이 아닌가 싶다.
이는, 각 레이어를 느슨한 Interface의 결합과 설정의 외부화를 통해 개발이 보다 더 유연하고 견고해지기도 이기도 하지만, 일관된 방법으로 기존 기술들을 편하게 사용할 수 있도록 도와주고, 비즈니스 객체들을 효과적으로 구성하고 관리하는데에 가장 큰 장점이 있기

때문이다. 더불어 막강한 JDBC 자원 관리가 개발자들에게 혁신적인 소스 코딩량의 절약을 가능케 해준다는게 강점 중 하나라고 본다.


왜 LightWeight 라고 하는가?

Spring은 하나의 프레임워크이다. 그런데 왜 Spring 컨테이너, IoC 컨테이너라는 말을 사용할까? 그렇다면 컨테이너의 정의는 무엇을까?

Servlet 컨테이너, EJB 컨테이너라는 말하는 것을 종종 들어봤을 것이다. 컨테이너. 우리들이 흔하게 사용하고 있지만 도대체 컨테이너가 뭐란 말인가?
정확한 사전적인 정의는 아니지만  "인스턴스의 생명주기를 관리하며, 생성된 인스턴스들에게 추가적인 기능들을 제공"하는 역할을 하는 녀석이라고 보면 될거같다.

Servlet 컨테이너는 Servlet의 생성, 생성 후 초기화, 서비스 실행, 소멸에 관한 모든 권한을 가지고 있다. 개발자들이 직접 Servlet을 생성하고 서비스하지는 않다. 이처럼 컨테이너는 Servlet 인스턴스에 대한 생명주기를 관리하는 기능을 가진다. 또한 Servlet 컨테이너의 web.xml을 보면 JSP/Servlet 접근 권한에 대한 추가적인 서비스도 지원하고 있다. 이는 Servlet의 구현과는 별도록 각 JSP/Servlet에 대한 Security를 관리해주는 기능을 한다.

스프링 아키텍쳐


기본적으로 스프링 아키텍쳐는 모듈단위의 계층구조로 되어있고 각 모듈들은 독립적으로 분리,사용이 가능하다.
뿐만 아니라 각각의 모듈은 일관된 방법으로 사용할 수 있기 때문에 한번 익숙해지고 나면 사용이 무척 쉽다.
더불어 각 레이어의 다양한 프레임웍과 조합이 가능하고, 다양한 개발환경에 최적의 조합을 유도할 수 있다.

스프링은 전체 프로젝트의 설정을 관리할 수 있는 일관된 방법을 제공함으로써, 개발자들이 각종 프로퍼티 파일을 작성하지

않도록 유도한다.
이것은 IoC라는 스프링의 특징 때문인데, 객체들간의 의존성이 따로 관리됨으로써 비즈니스 로직이 EJB로 개발되었건 일반 자바 객체로 개발되었건 동일한 방법으로 해당 로직을 이용할 수 있는 이점도 추가된다.

IoC(Inversion of Control : 제어의 역행) 혹은 DI(Dependency Injection : 의존성주입)이라고 불리우는 이 개념과, AOP (Aspect-oriented programming : 관점지향프로그래밍) 개념을 이해한다면, Spring Framework의 전반적인 내용을 이해하고 개발할 수 있다고 생각한다.

개념설명에 앞서, 스프링이 갖는 장점에 대해서 알아본다.

Spring Framework 장점

  • 다양한 형태의 Transaction을 선언적으로 사용

  • 개발자는 필요한 Transaction에 대한 메소드명만으로 Transaction 구현에서 해방 Remote EJB 사용의 간편성

  • 설정 파일에서 Remote EJB가 필요한 객체에 매핑하는 것으로 Local Object 사용하듯이 사용 다양한 Framework과의 통합

  • 많이 사용되고 있는 웹 프레임워크와 ORM 프레임워크에 대한 탁월한 지원

  • AOP를 보다 쉽게 적용

  • Business Logic외에 logging, exception 처리등을 선언적으로 사용할 수 있는 기반 제공

  • Transaction을 선언적으로 사용하는 이유도 AOP의 강력한 지원으로 가능

  • Covention over configuration 의 결합으로 설정의 최소화

  • Spring framework의 불편함으로 지적되던 XML 설정을 Convention over Configuration 도입으로 최소할 할 수 있음

  • Unit Test 지원 - 견고한 코드 관리를 위한 Unit Test Case의 작성 지원

  • 설정 관리의 단일화 - Application 설정 관련 부분을 Spring Framework으로 단일화해서 관리

  • Object Pool을 기본적으로 가지고 있어서 Object 생성 제거의 Overhead 최소화

    • 기본적으로 Singleton형태로 Object가 사용됨

    • 호출시 매번 생성되는 형태도 가능

  • 분산시스템 구성시 비용 최소화
    • RMI 지원

    • Caucho's Hessian and Burlap 지원

    • Spring's HttpInvoker 지원

    • Web service 지원

    • JMS 지원

    • Enterprise Application 개발을 위한 Full Stack 지원

Spring Framework 단점

  • Spring Framework에 대한 막연한 거리감.

  • IOC, AOP등 새로운 개념에 대해 모두 잘 알아야 할거라는 부담감을 가지고 있음

  • 설정 파일 다루기와 Object 재사용에 관한 이해 부족

  • Spring Framework의 장점을 살릴 수 있는 도구 제공이 미흡

  • Spring Framework 도입으로 인한 추가 작업

  • 설정 파일 관리

    • 서비스간의 연결을 담당하는 XML관리가 필요 다만, Convention over Configuration의 활용과 generator등을 통해 작업 최소화가 가능

  • Interface생성
    • 각 Layer간 연결이 Interface를 통해 이루지기때문에 Interface생성이 필요

    • Overhead 작업으로 볼수도 있지만, Layer간 loosed coupling을 위해서는 Spring Framework을 사용하지 않을 경우에도 필요

Spring Framework을 사용하기 앞서, 각 Jar파일들이 어떻게 구성되어 있는지 살펴본다.

Spring Framework 배포본을 다운로드하여 압축을 풀면 dist 폴더가 존재한다.
여기에는 spring framework의 라이브러리가 jar파일 형태로 제공되는데 필요에 따라서 이들 파일들을 선택적으로 가져다가 이용하게 된다. 이 jar 파일들의 정보를 요약하면 다음과 같다 :

Full Jar (/dist)

  • "spring.jar" (~1915 KB)
    • 모든 표준 모듈들을 결합한 파일 (modules 폴더의 모든 jar 파일들을 합한 것이다.)

    • Note: extension 폴더의 jar 파일들은 포함하지 않았다.

Module Jar (/dist/modules)

  • "spring-core.jar" (~145 KB)
    • Contents: core utilities

    • Dependencies: Commons Logging, (Log4J)

  • "spring-beans.jar" (~295 KB)
    • Contents: JavaBeans support, bean container

    • Dependencies: spring-core, (CGLIB)

  • "spring-aop.jar" (~270 KB)
    • Contents: AOP framework, source-level metadata support, AOP Alliance interfaces

    • Dependencies: spring-core, (spring-beans, CGLIB, Commons Attributes)

  • "spring-context.jar" (~140 KB)
    • Contents: application context, validation, JNDI, UI context support, scripting

    • Dependencies: spring-beans, (Velocity, FreeMarker, JasperReports)

  • "spring-dao.jar" (~105 KB)
    • Contents: DAO support, transaction infrastructure

    • Dependencies: spring-core, (spring-beans, spring-aop, spring-context, JTA)

  • "spring-jdbc.jar" (~215 KB)
    • Contents: JDBC support, iBATIS SQL Maps support

    • Dependencies: spring-dao, spring-beans, (iBATIS SQL Maps)

  • "spring-support.jar" (~190 KB)
    • Contents: JMX support, JCA support, scheduling support, mail support, caching support

    • Dependencies: spring-beans, (spring-context, spring-dao, spring-jdbc, JMX, Quartz, JavaMail, EHCache)

  • "spring-web.jar" (~155 KB)
    • Contents: web application context, multipart resolver, Struts support, JSF support, web utilities

    • Dependencies: spring-context, Servlet, (JSP, JSTL, Commons FileUpload, COS, Struts, JSF)

  • "spring-webmvc.jar" (~250 KB)
    • Contents: framework servlets, web MVC framework, web controllers, web views

    • Dependencies: spring-web, (Tiles, iText, POI, Velocity, FreeMarker, JasperReports)

  • "spring-remoting.jar" (~170 KB)
    • Contents: remoting support, EJB support, JMS support

    • Dependencies: spring-beans, spring-aop, (spring-context, spring-web, Hessian, Burlap, JAX-RPC, EJB, JMS)
      Extension Module Jar (/dist/extmodules)

  • "spring-portlet.jar" (~110 KB)
    • Contents: framework portlets, portlet MVC

    • Dependencies: spring-web, spring-webmvc, (Portlet)

  • "spring-jdo.jar" (~65 KB)
    • Contents: JDO 1.0/2.0 support

    • Dependencies: spring-dao, spring-jdbc, JDO, (spring-web, spring-portlet)

  • "spring-jpa.jar" (~45 KB)
    • Contents: JPA 1.0 support

    • Dependencies: spring-dao, spring-jdbc, JPA, (spring-web, spring-portlet)

  • "spring-hibernate2.jar" (~90 KB)
    • Contents: Hibernate 2.1 support

    • Dependencies: spring-dao, spring-jdbc, Hibernate2, (spring-web, spring-portlet)

  • "spring-hibernate3.jar" (~110 KB)
    • Contents: Hibernate 3.0/3.1 support

    • Dependencies: spring-dao, spring-jdbc, Hibernate3, (spring-web, spring-portlet)

  • "spring-toplink.jar" (~55 KB)
    • Contents: TopLink support

    • Dependencies: spring-dao, spring-jdbc, TopLink

  • "spring-ojb.jar" (~30 KB)
    • Contents: OJB 1.0 support

    • Dependencies: spring-dao, spring-jdbc, OJB

  • "spring-mock.jar" (~75 KB)
    • Contents: JNDI mocks, Servlet API mocks, Portlet API mocks, JUnit support

    • Dependencies: spring-core

Aspects Jar (/dist/aspects)

  • "spring-aspects.jar" (~10 KB)
    • Contents: AspectJ aspects, for explicitly linking aspects into an IDE (Eclipse AJDT)

    • Not needed for deployment, since its classes are also in "spring" and "spring-aop"

정리하면 다음과 같다 :

    • 그냥 편하게 사용하려면 /dist/spring.jar 만을 사용한다.
      좀 따져서 꼼꼼하게 필요한 것만 사용하려면 /dist/spring.jar를 사용하지 말고 /dist/modules 폴더의 필요한 jar 파일들만 선택하여 사용한다.

    • /dist/extmodules 파일들은 필요한 것만 골라서 사용한다.

    • /dist/aspects 의 jar 파일은 eclipse로 AspectJ를 사용하려고 할 때만 필요하다. 실제 배포시에는 필요없다.

DI의 개념

일반적으로 어플리케이션은 컴포넌트들을 조합하여 이루어진다고 가정하자. 컴포넌트란 소프트웨어 모듈로서 더 이상의 수정이 없이도 사용할 수 있는 라이브러리를 뜻한다. 이 때, 어플리케이션을 구성하는 과정에서 각 컴포넌트들 사이의 결합은 서로가 서로를 호출하는 형태로 이루어진다.
이러한 컴포넌트들간의 연관관계(혹은 Dependency)는 여러가지 문제점을 가진다. 이러한 문제점은 시스템의 구동과정에서의 문제를 의미하는 것이 아니라, 개발과정에서의 여러가지 형태의 변경과정, 유지, 보수, 업그레이드 과정에서 발생하는 문제를 의미한다.
여러 컴포넌트들 가운데 특정 컴포넌트를 변경하려고 하면, 혹은 교체하려고 하면, 이 컴포넌트와 연관된 컴포넌트들에도 변경이 불가피하게 된다.

발상의 전환점은 바로 여기에 있다. 그렇다면, 컴포넌트들 간의 연관관계를 더 느슨하게 혹은 외부에서 할 수는 없을까? 그렇다. 연관관계를 컴포넌트들간에 이루어지도록 하지 말고, 컴포넌트들을 가지는 컨테이너가 연관관계를 규정하도록 하자. 그렇게 하면, 컴포넌트들 사이에는 연관관계가 발생하지 않으므로 위에서 언급된 문제들이 해결될 것이다. 이것이 바로 Inversion of Control / Dependency Injection의 핵심 개념이다.


그림1과 그림2를 비교해보면, 그림1에서는 클래스 CA가 클래스 IBImpl을 생성한다. IBImpl 클래스가 다른 클래스로 변경되면 CA에도 변경이 필요하게 된다. 반면에, 그림2에서 클래스 CA는 클래스 IBImpl과 연관관계가 없다. 단지, 인터페이스 IB만을 호출한다. 그러므로 IBImpl 클래스가 다른 클래스로 변경되어도 CA에 변경이 가해질 일이 없게 된다.

즉, DI가 갖게 되는 장점은 아래와 같다.

  • 코드의 단순화

  • 종속적인 코드의 최소화 (인프라 코드와 비즈니스 코드 분리)

  • 어플리케이션을 더 쉽게 유지관리

이렇게 컨테이너에게 제어권이 넘어간것을 IoC라고 하며, 용어자체의 문제로 인해 보통은 DI라고 부르는게 요즘의 추세라고 본다.
기존 코드가 코드안에서 객체의 생성과 소멸을 했다고 한다면, DI 개념 안에서는 객체를 생성, 파괴와 객체간의 의존관계를 컨테이너에 의해서 제어함한다는것이 핵심인것이다. 컨테이너가 객체를 제어하는 방식은 XML이 될 수도 있고 Properties로도 할 수도 있다. 스프링에서는 간단한 컨벤션 룰을 통해서 XML로 관리한다고 보면 될 것이다.

IoC의 구현방법에는 두가지가 있다. 첫째는 Dependency Lookup이다. 이 것은 컨테이너가 callback을 통해서 제공하는 lookup context를 이용해서 필요한 리소스나 오브젝트를 얻는 방식이다. EJB와 Apache Avalon의 구현방법이다. 둘째는 Dependency Injection이다. 우리가 해야할 부분은 바로 이 DI 부분이다. 이것은 비즈니스 오브젝트에 look up 코드를 사용하지 않고 컨테이너가 직접 의존구조를 오브젝트에 설정할 수 있도록 지정 해주는 방법이다. DI는 다시 Setter Injection과 Constructor Injection으로 나뉜다.

Dependency Lookup은 JNDI등을 이용하는데 오브젝트간에 decoupling을 해주는 면에서 장점이 있기는 하다. 하지만 이렇게 만들어진 오브젝트는 컨테이너 밖에서 실행 할 수 없고 JNDI외의 방법을 사용할 경우 JNDI관련 코드를 오브젝트내에 일일히 변경해 줘야 하며 테스트하기 매우 어렵고 코드양이 매우 증가하고 Strong typed가 아니므로 Object로 받아서 매번 Casting해야 하고 (그래서 primitive type은 wrapper class를 써야 하고) NamingException같은 checked exception을 처리하기 위해서 exception처리구조가 매우 복잡해지는 단점이 있다.

Dependency Injection은 각 오브젝트가 자신이 의존적인 resource와 collaborator에 대한 lookup의 책임을 가지지 않고 대신 컨테이너가 그 일을 담당하고 오브젝트 내에 주입해주는 방식이다.
따라서 lookup과 관련된 코드들이 오브젝트 내에서 완전히 사라지고 컨테이너에 의존적이지 않은 코드를 작성할 수 있다.
이는 오브젝트가 컨테이너의 존재여부를 알 필요조차도 없기 때문이다. 또 특별한 인터페이스 구현나 클래스의 상속의 필요가 없다.


=========================================================================================================================

출처 : http://okjsp.pe.kr 의 Quick 님이 만드신 자료입니다.

=========================================================================================================================

+ Recent posts