Anyframe Core, release 3.2.0 (2009.01)
------------------------------------------------
http://www.anyframejava.org

1. Anyframe Core 소개

Anyframe Core는 Spring을 중심으로 다양한 오픈 소스를 통합/확장한 best-of-breed JavaEE를 구성하여 JavaEE 기반 어플리케이션 개발시 겪게 되는 복잡성을 해소하고 좀 더 빠르게 개발할 수 있도록 도와주는 어플리케이션 프레임워크로, 다음과 같은 특징을 지닌다.

1)프레임워크로 인한 기본 설계와 상세 설계가 이중으로 진행되거나, 개발시 설계 모델이 구현체와 불일치 되는 것을 방지하기 위해 순수 객체 중심의(POJO) 어플리케이션 개발을 지원한다. 

2) 철저하게 인터페이스 중심의 개발을 가이드하고 객체나 컴포넌트간의 참조 관계는 Dependency Injection을 통해 처리함으로써 구현체의 변경에 따른 영향력을 최소화한다. 

3) 로깅, 트랜잭션, 예외처리 등과 같은 비기능 영역에 대한 코드가 업무 기능 개발 영역에서 분리될 수 있도록 함으로써, 개발자는 비즈니스 로직에만 집중하여 구현하도록 한다. 

4) DB 접근 및 SQL 처리, 캐쉬, WAS와 연동 등과 같은 중요 기능에 대해 재사용 가능한 기술 공통 서비스를 제공함으로써 보다 빠르고 안정적인 개발을 지원한다. 

5) 속성 정의를 통해 Transaction을 선언적으로 일괄 제어할 수 있도록 지원함으로써, 개발이 간편해지며 안정적인 어플리케이션 운영이 가능하다. 

6) 직접적인 패턴 구현없이도 Singleton, Factory 패턴 등의 실행을 지원함으로써, 어플리케이션 개발시 인스턴스의 생성 관리, 데이터 무결성 확보 등을 위해 유용한 패턴 등을 직접 구현하는 어려움을 해결해준다. 

7) Anframe Core 기반으로 어플리케이션을 개발할 때 코드 자동 생성, DB I/O 처리 등의 개발 지원 툴을 활용하여 개발 및 테스트를 수행함으로써 사전에 오류 발생을 감지할 수 있다. 

Anyframe Core 관련 문서는 포탈 사이트의 문서 메뉴를 통해 확인할 수 있으며 보다 자세한 내용에 대해서는 HTML 형태로 구성된 매뉴얼을 참조하도록 한다.

* Anyframe 포탈 사이트 : http://www.anyframejava.org
* Anyframe 매뉴얼 : http://dev.anyframejava.org/anyframe/doc/core/3.2.0

2. 배포 파일 구조 (zip)

Anyframe Core 배포 파일은 크게 2가지 유형으로 구분되며 세부 구성에 대해 살펴보면 다음과 같다.

1) Anyframe-core-x.x.x-bin.zip
   - install.xml    : Anyframe Core 설치 스크립트
   - lib/anyframe   : Anyframe의 각종 기술 공통 서비스 라이브러리 포함
   - lib/spring     : Anyframe의 기반이 되는 각종 Spring 라이브러리 포함
   - lib/3rd-party  : Anyframe Core 실행을 위해 필요한 참조 라이브러리 포함
   - lib/cxf        : Anyframe Core의 Web Services 기능 실행을 위해 필요한 Apache CXF 라이브러리 포함
   
2) Anyframe-core-x.x.x-src.zip
   - docs/api       : Anyframe Core API (JavaDOC)를 HTML 형태로 제공
   - src	    : Anyframe Core의 기술 공통 서비스 각각에 대한 소스 코드 및 JUnit 테스트 코드 포함

* 배포 파일 내에 상용 라이브러리가 포함되어 있지 않으므로, 상용툴과의 연계를 위해 추가된 일부 클래스들에 컴파일 에러가 있을 수 있다.
* Anyframe Core 설치 절차는 Anyframe 포탈 사이트를 참조하도록 한다.


3. 배포 라이브러리 (jar)

배포용 zip 파일 내의 anyframe 폴더에는 다음과 같은 jar 파일들이 존재한다. 

1) "anyframe.common" 
  - Anyframe의 모든 기술 공통 서비스에서 공통적으로 사용할 수 있는 유틸리티, Aspect, Exception 등을 지원

2) anyframe.core.cache"
  - 상태를 공유할 수 있는 객체를 캐싱할 때 사용하기 위해 opensymphony의 OSCache에 대한 Wrapper 지원

3) anyframe.core.hibernate
  - HQL(Hibernate Query Language)문을 입력 조건에 따라 Dynamic하게 생성되도록 도와주는 기능 지원

4) anyframe.core.idgen
  - Table 또는 Sequence 기반에서 유일한 ID 생성 및 UUID 생성 알고리즘 기반으로 유일한 ID 생성 지원

5) anyframe.core.locator
  - Naming Server에 접근하여 Context 객체를 가져오거나 JNDI Server에 접근하여 객체를 가져오는 기능 지원

6) anyframe.core.properties
  - 외부 파일이나 환경 정보에 구성되어 있는 key, value의 쌍을 기반으로 특정 key에 대한 value 접근 지원

7) anyframe.core.query
  - 쿼리문이나 객체의 입력만으로 DB 데이터 조작 지원
  - 테이블 단위의 CRUD 개발을 용이하게 하기 위한 공통 기능 지원
  - 이전 ExtendedQueryService에서 제공하던 기능을 QueryService에서 지원하고 ExtendedQueryService 제거됨

8) anyframe.core.query.ria
  - anyframe.core.query를 이용하여 상용 X-Internet 제품(MiPlatform, Gauce)과의 연계 기능을 지원하기 위해
    anyframe.core.query.ria.gauce, anyframe.core.query.ria.mip에서 공통적으로 참조

9) anyframe.core.query.ria.gauce
  - anyframe.core.query의 확장판으로 상용 X-Internet 제품(Gauce)과의 연계된 Query 서비스 기능 지원

10) anyframe.core.query.ria.mip
  - anyframe.core.query의 확장판으로 상용 X-Internet 제품(MiPlatform)과의 연계된 Query 서비스 기능 지원

11) anyframe.core.remoting
  - 일관된 형태의 서버와 클라이언트 구현을 가능하게 하는 Web Services 기능 지원
    
* 최신 배포 라이브러리는 Anyframe의 Artifactory를 통해 다운로드 할 수 있다.
  - http://dev.anyframejava.org/artifactory

4. Anyframe Core 프로젝트 빌드 절차

1) Maven 설치 
   - 2.0.9 버전 이상의 Maven을 설치하도록 한다.
   - 다운로드 URL :http://maven.apache.org/download.html

2) settings.xml 설정
   - Maven 설치 폴더/conf/settings.xml 파일에 아래와 같이 <profile>을 추가한 후, <activeProfile>에 등록하도록     
     한다.
   ############################settings.xml############################
   <profile>
      <id>anyframeprofile</id>
      <repositories> 
         <repository>
            <id>central</id>
            <name>repository for Anyframe</name>                 
            <url>http://dev.anyframejava.org/artifactory/anyframe-repository</url>
            <snapshots>
               <enabled>true</enabled>
            </snapshots>
         </repository>                                    
      </repositories>   
      <pluginRepositories>
         <pluginRepository>
            <id>central</id> 
            <name>Internal Mirror of Central Plugins Repository</name>       
            <url>http://www.ibiblio.org/maven2/plugins</url>           
         </pluginRepository>
         <pluginRepository>
            <id>remote</id> 
            <name>Internal Mirror of Central Plugins Repository</name>       
            <url>http://repo1.maven.org/maven2</url>           
         </pluginRepository>    
      </pluginRepositories>
   </profile>
   <activeProfiles>
      <activeProfile>anyframeprofile</activeProfile>
   </activeProfiles>
   ####################################################################
   * Anyframe Maven Repository 내에 상용 라이브러리가 포함되어 있지 않으므로, 일부 프로젝트에는 컴파일 오류가 
     존재한다. Anyframe Maven Repository 내에 배포되지 않은 상용 라이브러리는 해당 프로젝트의 pom.xml 파일의 
     내에 정의된 상용 라이브러리의 group id, artifact id, version을 참고하여 개인 Local Respository 내에 
     배포하도록 한다.

3) 환경변수 PATH에 Maven 설치 폴더/bin을 추가한다.

4) 명령창을 오픈하고, 각 프로젝트의 Root 폴더(pom.xml 파일이 존재하는 폴더)에서 mvn clean compile을 수행함
   으로써, 필요한 라이브러리를 Maven Repository로부터 다운로드할 수 있도록 한다.

5) 각 프로젝트를 패키징하고자 할 경우, mvn package를 수행하면 해당 프로젝트의 target 폴더 내에 패키징된
   라이브러리를 생성시킬 수 있다.

5. 라이센스 정책

Anyframe Core 프로젝트는 라이센스 정책으로 Apache Licence (http://www.apache.org), Version 2.0을 채택하고 있다.

6. 외부 오픈 소스 라이센스 정책

Anyframe Core 프로젝트 내에 사용된 외부 오픈 소스의 경우 원 오픈 소스의 라이센스 정책을 따른다. 아래는 각 외부 오픈 소스의 정보(라이센스, 소스 코드 및 라이브러리 다운로드 등)를 얻을 수 있는 사이트 URL이므로 참고하도록 한다.

1) Spring Framework 2.5.6 : http://www.springsource.org/
2) Hibernate 3.2.6.ga : http://www.hibernate.org/
3) Apache Commons BeanUtils 1.8.0 : http://commons.apache.org/beanutils/
4) Apache Commons DBCP 1.2.1 : http://commons.apache.org/dbcp/
5) Apache Commons Collections 3.2 : http://commons.apache.org/collections/
6) Apache Commons Logging 1.0.4 : http://commons.apache.org/logging/
7) Apache Commons Digester 1.8 : http://commons.apache.org/digester/
8) Apache Commons Pool 1.3 : http://commons.apache.org/pool/
9) OSCache 2.4 : http://www.opensymphony.com/oscache
10) Quartz 1.5.0 : http://www.opensymphony.com/quartz
11) Log4j 1.3alpha8 : http://logging.apache.org/log4j
12) HSQLDB 1.8.0.10 : http://www.hsqldb.org/
13) JUnit 3.8.1 : http://www.junit.org/
14) Oracle JDBC Driver 14 : http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
15) Velocity 1.5 : http://velocity.apache.org/, http://repo1.maven.org/maven/velocity/
16) SLF4J 1.5.3 : http://www.slf4j.org/
17) JSR 250 API : https://jsr250.dev.java.net/
18) Joda Time 1.1 : http://joda-time.sourceforge.net/
19) Java Transaction API (JTA) 1.1 : http://java.sun.com/javaee/technologies/jta/index.jsp
20) ProxyToys 0.1 : http://proxytoys.codehaus.org/ quartz
21) Xalan-Java 2.7.1 : http://xml.apache.org/xalan-j/
22) Xerces Java Parser 2.6.2 : http://xerces.apache.org/xerces-j/
23) XJB 0.1 : http://xjb.codehaus.org/
24) xml-commons 1.0.b2 : http://xml.apache.org/commons/
25) Infrared 2.4.1 : http://infrared.sourceforge.net/versions/latest
26) Antlr 2.7.6 : http://www.antlr2.org/
27) log4jdbc3 1.1 : http://log4jdbc.sourceforge.net
28) O/R Broker 2.0.3 : http://orbroker.sourceforge.net
29) AOP Alliance 1.0 : http://aopalliance.sourceforge.net
30) ASM 2.2.2 : http://asm.objectweb.org
31) AspectJ 1.5.4 : http://www.eclipse.org/aspectj
32) c3p0 0.9.1 : http://www.mchange.com/projects/c3p0
33) Apache Avalon 4.0 : http://avalon.apache.org
34) dom4j 1.6.1 : http://www.dom4j.org
35) EasyMock 2.2.2 : http://www.easymock.org
36) ehcache 1.2.3 : http://ehcache.sourceforge.net
37) cglib 2.2 : http://cglib.sourceforge.net
38) p6spy 1.3 : http://www.p6spy.com
39) Excalibur DataSource 2.1 : http://excalibur.apache.org/
40) Apache CXF 2.1.3 : http://cxf.apache.org/
41) Apache Abdera 0.4.0-incubating : http://incubator.apache.org/abdera/
42) Apache Ant 1.6.5 : http://ant.apache.org/
43) Apaceh Axiom 1.2.7 : http://ws.apache.org/commons/axiom/
44) Apache Commons Codec 1.3 : http://commons.apache.org/codec/
45) Apache Commons HttpClient 3.1 : http://hc.apache.org/httpclient-3.x/
46) Fast Infoset 1.2.2 : https://fi.dev.java.net/
47) Apache Geronimo 1.0~1.2 : http://geronimo.apache.org/
48) Caucho Hessian 3.1.3 : http://hessian.caucho.com/
49) HTML Parser 1.0.5 : http://htmlparser.sourceforge.net/
50) Java Architecture for XML Binding (JAXB) 2.1.7 : https://jaxb.dev.java.net/
51) Jetty 6.1.9 : http://www.mortbay.org/jetty/
52) Jaxen 1.1 : http://jaxen.org/
53) JDOM 1.0 : http://www.jdom.org/
54) Jettison (A JSON StAX Implementation) 1.0 : http://jettison.codehaus.org/
55) SOAP with Attachments API for JavaTM 1.3.2 : http://java.sun.com/webservices/saaj/reference/index.html
56) JRA(Java REST Annotations) 1.0-alpha-4 : http://jra.codehaus.org/
57) JSR 311 0.8 : https://jsr311.dev.java.net, [Download] https://jersey.dev.java.net/
58) Apache Neethi 2.0.4 : http://ws.apache.org/commons/neethi/
59) OpenSAML 1.1 : http://www.opensaml.org/
60) stax-utils 20060502 : https://stax-utils.dev.java.net/
61) The Web Services Description Language for Java Toolkit (WSDL4J) 1.6.2  : https://olex.openlogic.com/packages/wsdl4j#157
62) Web Services Security (WS-Security) 1.5.4 : http://ws.apache.org/wss4j/#Where_can_I_download_WSS4J
63) High-performance XML processor 3.2.6 : http://woodstox.codehaus.org/
64) A technology for accessing XML by binding it to Java types 2.3.0 : http://xmlbeans.apache.org/
65) Apache XML Project : http://xml.apache.org/mirrors.cgi
66) A lightweight schema object model 1.4.2  : http://ws.apache.org/commons/XmlSchema/
67) XML Security 1.4.0 : http://xml.apache.org/security/index.html