
--- 틀 프레임워크(TLE Framework) ---

"틀 프레임워크를 사용하게 된 것을 환영합니다!"

틀 프레임워크는 MVC 패턴에 기반해서 클라이언트의 요청을 처리해주는 프레임워크로서 자바로 작성되었다.
틀 프레임워크와 관련된 문서는 틀 프레임워크 위키 사이트에서 운영되며 위키 사이트 주소는 아래와 같다.

  http://tle.madvirus.net/wiki

설치 및 틀 프레임워크가 제공하는 기본 컴포넌트의 설정 방법에 대한 문서는 위키 사이트를 참고하기 바란다.

틀 프레임워크 2.0.n 배포판과 관련된 주요 내용:
 
 * 배포판에 포함된 내용
 * 필요사항
 * 틀 프레임워크 설치하기
 * 틀 프레임워크 구성
 * 테스트 웹 어플리케이션 실행하기
 * 테스트한 어플리케이션 서버들
 * 틀 프레임워크 문서 사이트

===============================================================================
배포판에 포함된 내용
===============================================================================

틀 프레임워크 2.0.n 배포판에는 다음과 같은 것들이 포함되어 있다.

  /        틀 프레임워크 jar 파일 및 소스 포함(TLEFramework-2.0.n.jar, src.zip)
  /config  틀 프레임워크 및 기본 제공 컴포넌트의 설정 파일 예제
  /doc/api 틀 프레임워크 API 문서
  /lib     틀 프레임워크를 실행하는 데 필요한 jar 파일 포함
  /license 틀 프레임워크 및 관련 jar 파일의 라이센스 문서
  /example 예제 war 파일 (tle.war)

===============================================================================
필요사항
===============================================================================

틀 프레임워크 2.0.n을 사용하기 위해서는 다음과 같은 것들을 필요로 한다.

 * 서블릿2.3/JSP1.2 또는 서블릿2.4/JSP2.0을 지원하는 웹콘테이너

===============================================================================
틀 프레임워크 설치하기
===============================================================================

배포판을 설치하는 방법은 다음과 같다.

 1. 웹 어플리케이션 폴더를 생성한다.
 2. WEB-INF/lib 폴더에 다음의 jar 파일들을 복사한다.
   - commons-digester.jar/commons-logging.jar/commons-collections-3.1.jar
   - commons-beanutils.jar/commons-fileupload-1.0.jar
   - mx4j.jar/mx4j-remote.jar/mx4j-tools.jar
 3. TLEFramework 설정 파일을 작성한다.
 4. 각 컴포넌트의 설정 파일을 알맞게 작성한다.
 5. web.xml 파일에 틀 프레임워크 관련 설정을 추가한다.
 
틀 프레임워크의 설정 및 web.xml 파일에 관련된 자세한 내용은 다음의 사이트를 참고하기 바란다.

 'http://tle.madvirus.net/wiki/wiki.php/틀프레임워크설정'

===============================================================================
틀 프레임워크 구성
===============================================================================

틀 프레임워크의 구성에 대한 내용은 다음의 문서를 참고하기 바란다.

 http://tle.madvirus.net/wiki/wiki.php/틀프레임워크란

===============================================================================
테스트 웹 어플리케이션 실행하기
===============================================================================

틀 프레임워크 2.0.n 배포판인 TLEFramework-2.0.n.zip 파일의 압축을 풀면 /example 디렉토리에
테스트 웹 어플리케이션 파일인 tle.war가 포함된 것을 확인할 수 있다.

Tomcat의 경우 [tomcat home]/webapps 디렉토리에, Resin의 경우 [resin home]/webapps에
tle.war 파일을 복사하면 배포가 이루어진다. 그외에 다른 WAS 서버의 경우 WAS 서버에서 제공하는
웹 어플리케이션 배포툴을 사용해서 tle.war 파일을 배포하면 된다.

tle.war 파일 대신 [배포판]/examples에 있는 tle/ 폴더를 [엔진]/webapps 폴더에 복사해도 된다.

Tomcat이나 Resin의 webapps에 배포할 경우 tle 웹 어플리케이션에 다음의 주소로 접근할 수 있다.

 http://host:8080/tle
 
위의 주소로 tle 웹 어플리케이션을 실행하면 실행 결과를 볼 수 있습니다.

리눅스나 유닉스를 사용하는 경우 tle.war가 배포된 뒤에 실행하면 에러가 발생할 것이다. 그 이유는 
설정 파일의 경로값을 윈도우즈의 경로 구분자인 '\'를 사용해서 표시했기 때문이다. 따라서, 리눅스나
유닉스를 사용하는 경우에는 다음의 파일들을 열어서 경로값 '\'를 '/'로 변경해주어야 한다.

 - WEB-INF/web.xml
 - WEB-INF/config/TLEFrameworkConfig.xml
  
또한  WEB-INF/config/DefaultRequestAnalyzer.properties 파일을 열어서 다음과 같은 
부분을 리눅스나 유닉스에서 사용할 임시 폴더로 변경해주어야 한다.

 tempDir=C:\\WINDOWS\\Temp

이렇게 변경해준 뒤 다시 톰캣을 실행하면 tle 웹 어플리케이션을 실행할  수 있을 것이다.

테스트 웹 어플리케이션은 틀 프레임워크가 제공하는 기본 컴포넌트에 대한 설정 파일 예제가 포함되어
있다. 프레임워크 설정 파일 및 각 컴포넌트의 설정 파일은 다음과 같다.

  - WEB-INF/config/TLEFrameworkConfig.xml : 프레임워크 설정 파일
  - WEB-INF/config/DefaultRequestAnalyzer.properties :
           DefaultRequestAnalyzer 설정 파일
  - WEB-INF/config/DefaultRequestProcessor.xml : 
           DefaultRequestProcessor 설정 파일
  - WEB-INF/config/DefaultUICreator.xml : DefaultUICreator 설정 파일
  - WEB-INF/config/Role.xml : DefaultAAManager가 사용하는 역할 목록
  - WEB-INF/config/Service.xml : DefaultAAManager가 사용하는 권한 설정 파일

또한 DefaultAAManager를 사용할 때 구현해주어야 주어야 하는 다음의 인터페이스들에 대한
예제 구현 코드를 보여준다.

  - tle.framework.component.impl.aamanager.Authenticator
  - tle.framework.component.impl.aamanager.UserManager
  - tle.framework.component.spi.aamanager.UserAuthenticationInfo
  - tle.framework.component.spi.aamanager.User

사용자 목록은 WEB-INF/classes/userlist.properties 파일에서 찾을 수 있다. 이 파일에 사용자
아이디, 사용자 암호, 사용자가 속한 역할에 대한 정보가 기록되어 있다.

===============================================================================
테스트한 어플리케이션 서버들
===============================================================================

 다음과 같은 서버에서 틀 프레임워크 2.0.n을 테스트하였다.

 * Tomcat 5.0.xx / 5.5.xx / 4.1.xx
 * Resin 3.0.9
 * WebLogic 8.1
 * Jeus 3.3 / 4.0

 이 이외의 서버에서는 틀 프레임워크를 테스트하지 못했으므로 문제가 있을 경우 틀 프레임워크 개발 호스팅
 사이트인 http://kldp.net/projects/tle 의 게시판이나 버그 관리에 등록해주시기 바랍니다.

===============================================================================
틀 프레임워크 문서 사이트
===============================================================================

틀 프레임워크와 관련된 모든 문서는 틀 프레임워크의 위키 사이트를 통해서 관리됩니다.
틀 프레임워크의 문서를 관리하는 위키 사이트는 다음과 같습니다.

 http://tle.madvirus.net/wiki

기타 틀 프레임워크와 관련된 질문이나 건의는 다음 사이트에서 처리해주시면 됩니다.

 틀 프레임워크 개발 사이트: http://kldp.net/projects/tle
