Oracle ADF 배우기: 한 초심자의 경험담
저자 – Tom Moore
한 초심자의 학습 사례를 통해 Oracle ADF를 이용한 UI 개발 방법을 배워 보시기 바랍니다.
게시일: 2006년 11월
필자가 일하고 있는 위스콘신 대학에서는 Unisys 메인프레임에서 Cobol로 작성된 레거시 시스템의 일부를 Java/J2EE 환경으로 포팅하는 작업을 수행했습니다. 우리 IT 팀은 Eclipse, Tomcat, Spring과 같은 오픈 소스 툴을 주로 사용하고 있습니다. 하지만 최근에는 오라클 툴의 라이센싱 조건이 변경되면서 오라클 툴의 사용을 함께 고려하게 되었고, 우리는 Oracle JDeveloper 10g와 Oracle Application Development Framework (ADF)를 이용한 개발 모델을 테스트하기 위해 새로운 애플리케이션을 시험 삼아 구현해 보았습니다. 이 문서에서는 Oracle ADF를 이용하여 UI를 개발하는 방법을 간략하면서도 자세히 소개합니다. (상세한 기술 정보가 필요하신 경우 OTN의 ADF 튜토리얼과 Oracle ADF 개발자가이드, 또는 Oracle ACE Steve Muench의 Oracle JDeveloper 사용자 포럼의 커멘트들을 참고하시면 많은 도움이 될 것입니다.)
본 문서에서는 애플리케이션을 구축하는 각 단계별로 상세한 설명을 제공하지는 않습니다. 하지만 여러분에게 필요한 결정을 내리는데 충분한 정보를 전달해 드리는 것이 필자의 바램입니다. 본 문서는 Java를 잘 이해하고 있을 뿐 아니라 Eclipse, JDeveloper 환경에 친숙하고 일반적인 프로그래머로 지식을 보유한 개발자들을 대상으로 작성되었습니다.
기존에 사용해 오던 아키텍처나 개발 모델을 바꾸는 것은 결코 만만한 일이 아닙니다. 그래서 시작 부분에서는 우리가 발견한 JDeveloper와 ADF의 숨은 가치에 대해 간단히 설명을 드릴까 합니다. 또 별도 섹션을 통해 몇 가지 유용한 팁을 함께 소개하고 있습니다.
배경 정보
우리가 현재 사용 중인 애플리케이션은 Java(JDK 1.5), Spring(MVC, Web Flow, JDBC 템플릿), JSP 페이지 등을 사용하여 구현되어 있습니다. 데이터는 Oracle Database 10g Release 2 데이터베이스로 복제됩니다. 우리는 JBoss Hibernate를 오브젝트-관계형 매핑(ORM) 툴로 사용한 경험이 있었지만, 우리의 데이터 모델은 그렇게 복잡하거나 다이내믹하지 않았고 Spring JDBC Template만으로도 우리에게는 충분했습니다.
Oracle Database 10g Release 2를 운영 환경에서 사용하고 있는 우리로서는, 윈도우즈 기반 환경에 Oracle Database 10g Express Edition (XE, 오라클 데이터베이스의 무료 스타터 버전)을 설치해 보는 것이 자연스러운 선택으로 여겨졌습니다. 또 이미 오라클의 TopLink ORM 툴을 사용해 보기로 결정한 마당에 오라클 데이터베이스를 선택한 것은 당연한 결과였습니다. 테스트 케이스를 향후 운영 애플리케이션에 적용하기 위해서는 서로 다른 데이터 소스를 쉽게 매핑할 수 있는 데이터베이스가 필요했습니다. 우리는 XE의 설정을 단 한 가지만 변경했습니다. 시스템 홈 페이지에서 시스템 글로벌 영역(SGA)이 메모리를 적게 사용하도록 설정한 것이 그것입니다.
우리는 TopLink에서 우리가 기대했던 이상의 장점을 발견했습니다. Oracle TopLink는 JDBC 또는 Spring JDBC Template과 같은 인터페이스의 사용 과정에 수반되는 번거로운 과정들을 추상화해 주었습니다. (Dustin Marx가 기고한 OTN 자료–"JDBC 프로그래밍에서 Spring을 부분적으로 활용하기 " –에는 복잡한 Spring 환경 설정을 거치지 않고 JDBC Template을 활용하는 방법이 잘 설명되어 있습니다.) JBoss Hibernate도 물론 뛰어난 ORM 툴입니다. 하지만 TopLink 매핑을 엔드-투-엔드 ADF 솔루션에 통합하는 기능은 우리의 입을 벌어지게 했을 뿐 아니라 매우 생산적인 기능이기도 했습니다.
우리는 오라클이 권장하는 방법을 따라 데이터베이스 액세스를 인캡슐레이트 하기 위한 EJB 세션 빈을 생성하였습니다. 또 애플리케이션과 데이터베이스 사이에 비즈니스 로직을 필요에 따라 추가할 수 있는 계층을 구현해야 했습니다. 그리고 Session Façade 디자인 패턴이 활용되는 일반적인 환경이 그러하듯, 우리가 개발하는 애플리케이션은 별도의 상태(state) 관리를 요구하지 않았습니다.
우리는 ADF를 이용하는 표준적인 작업 단계를 따라, 데이터 리포지토리에 대한 액세스를 제공하는 데이터 컨트롤 셋을 생성하였습니다. (일반적인 쿼리, 또는 일부 업데이트/삭제 작업에서) 비즈니스 로직이 필요하지 않은 경우, UI 컨트롤로부터 정보에 직접 액세스하는 기능을 이용하여 생산성 개선을 기대할 수 있었습니다. 더 복잡한 경우에는, 세션 빈 메소드를 이용하여 비즈니스 룰을 적용하는 것도 가능했습니다. (<ADF Developer's Guide>의 Chapter 1.1에 ADF와 JSF를 연동하여 생산적인 개발 환경을 구현하는 방법이 잘 설명되어 있습니다.)
우리는 또 표준 JSF 네비게이션을 이용하여 jspx 파일들을 생성하였습니다. 우리는 Struts를 이용한 개발 경험을 보유하고 있었지만, 이번 작업에서는 Struts를 사용하지 않기로 결정했습니다. .jspx 파일은 오라클의 권장 사항에 의거하여 사용한 것입니다.
프로젝트 환경을 위한 IDE로는 JDeveloper 10.1.3이 사용되었습니다. 이것은 JDeveloper가 ADF 애플리케이션 개발 작업에서 차지하는 비중을 생각했을 때 당연한 결정이었습니다. JDeveloper는 Java 개발 툴이지만, 또 한편으로 TopLink, AD UI와 데이터 액세스 컨트롤, JSF 기능, XML/JSP 파일 뿐 아니라 테스트 구축, 데이터 액세스 환경에 관련한 기능을 포괄적으로 활용할 수 있게 합니다.
또 JDeveloper에서 파일을 편집하는 과정에서 윈도우 간에 변경 사항을 동시 전달하는 기능은 Eclipse나 다른 IDE에서는 찾아 볼 수 없는 것입니다. JDeveloper는 다양한 뷰와 편집 방법을 제공하며, 이 때문에 JDeveloper 사용법을 배우는 과정에서 다소 까다롭게 여겨지기도 합니다. 언제 더블 클릭을 해야 하는지, 언제 Structure, Data Control 윈도우를 사용해야 하는지, 언제 Property Editor에 값을 설정해야 하는지, 그리고 언제 Source 윈도우를 사용하고 Java/JSP 코드를 기록해야 하는지 배우는 과정이 필요합니다.
프로젝트
우리는 학부 학생들을 위한 간단한 은행 계좌 프로그램을 만들어 보기로 하였습니다. 이 프로그램은 기본적으로 계좌 입금/출금 기능을 제공합니다. 이 프로젝트는 ADT 튜토리얼에서 설명되고 있는 기능들을 활용하고 있으므로, SRDemo에 친숙한 분들이라면 구현된 엘리먼트들을 쉽게 이해하실 수 있을 것입니다. SRDemo는 JDeveloper의 Help 메뉴에 있는 “Check-for-update” 메커니즘을 이용하여 다운로드할 수 있는 샘플 애플리케이션입니다. SRDemo에는 전체 소스 코드가 함께 포함되어 있으며,
Phase 0: 애플리케이션 구축을 위한 초기 셋업
1 단계: JSF, EJB, TopLink 템플릿을 이용해서 새로운 웹 애플리케이션을 생성. (Oracle ADF Tutorial 1-10 참고.) 처음에 템플릿을 선택하는 과정에서는 깊이 고민할 필요가 없습니다. 처음에 선택하지 않았다 하더라도 나중에 옵션을 변경하는 것이 얼마든지 가능하빈다. 템플릿에서 애플리케이션의 백엔드와 프론트엔드를 담당할 표준 Model, ViewController 프로젝트를 생성합니다. 디폴트 패키지 네임을 설정하는 것도 중요합니다. 이 이름은 나중에 JDeveloper에서 Java 클래스를 생성할 때 디폴트 네임으로 사용됩니다.
2 단계: 데이터베이스의 셋업. 우리는 New Gallery의 Database Tier에 위치한 Offline Database Objects를 사용해 보는 것을 고려했지만, 결국 3 개의 테이블을 포함하는 스키마를 생성하기 위한 SQL을 미리 생성하는 방법을 선택했습니다. 우리는 XE 웹 인터페이스에 로그인한 후 SQL Command 페이지에서 참고로 제공하는 스크립트를 이용하여 사용자와 테이블을 생성하였습니다. 이 테이블들의 프라이머리 키를 미리 정의하는 것은 매우 중요합니다. TopLink가 복잡한 매핑을 수행하기 위해서는 프라이머리 키를 참조해야 하기 때문입니다. 생성되는 테이블이 다음과 같습니다:- Accounts 테이블은 계좌에 대한 기본적인 정보를 저장합니다.
- Details 테이블은 모든 계좌의 거래 정보를 저장합니다.
- Manager는 계좌에 관련된 직원의 명단을 관리합니다.
이 테이블에 데이터를 입력하기 위해, 우리는 DBUnit을 이용한 Java 애플리케이션을 작성한 후 레퍼런스에서 제공되는 데이터 셋을 이용하여 CampusAccounts.xml 파일을 생성하였습니다. 필요하다면 XML 엘리먼트의 클론(clone) 작업을 통해 데이터 셋을 확장할 수도 있습니다. 이것이 애플리케이션에서 처음으로 생성한 Java 애플리케이션이므로, Model 프로젝트에 New/General/Java 클래스를 생성하여 패키지가 생성될 수 있게 합니다. 그런 다음 클래스의 본문을 복사하여 새로 생성된 클래스에 붙여 넣습니다. 클래스가 이미 생성되어 있는 경우라면, File/Import 옵션을 사용하여 Java Source를 Model 프로젝트에 복사해야 합니다.
public static void main(String[] argv) throws Exception {
Class driverClass = Class.forName("oracle.jdbc.OracleDriver");
Connection jdbcConnection =
DriverManager.getConnection("jdbc:oracle:thin:@localhost:1521:XE",
"CampusAccounts", "xxxxxx");
IDatabaseConnection connection = new DatabaseConnection(jdbcConnection);
IDataSet dataSet = new FlatXmlDataSet(new File("c:\\CampusAccounts.xml"));
try {
DatabaseOperation.CLEAN_INSERT.execute(connection, dataSet);
}
finally {
connection.close();
}
}
위 코드 본문을 통해, DBUnit 기능을 사용하는 것이 얼마나 간단한지 확인할 수 있습니다. 코드에는 Oracle Database XE 데이터베이스 연결에 필요한 URL과 표준 Oracle JDBC 드라이버 네임이 표시되고 있습니다.
하지만, 코드를 컴파일 하기 위해서는 DBUnit으로부터 jar 파일을 추가하고 프로젝트에 라이브러리를 추가해 주어야 합니다. 먼저, DBUnit zip 파일 (다운로드)에서 jar 파일을 가져 옵니다. Model 프로젝트의 Properties에서 Libraries/Add Jar를 선택하고 DBUnit jar 파일을 프로젝트에 추가합니다. Model 속성에서 Libraries/Add Library를 선택하여 (Oracle JDBC 드라이버를 포함하는) Oracle JDBC 라이브러리를 추가할 수 있습니다. jar 파일과 라이브러리를 추가했다면, JDeveloper의 Alt-Enter 코드 완료 옵션을 이용하여 필요한 임포트 작업을 자동으로 추가할 수 있습니다. (이때 java.sql.Connection을 임포트하는 것을 잊지 마시기 바랍니다.) Java 애플리케이션을 실행하려면 Application 윈도우의 파일을 선택하고 초록색 화살표를 클릭합니다. 연결을 생성하고 난 뒤의 단계는 무척 간단하게 진행됩니다.
Phase 1: 초기 Model의 생성
3 단계: 스키마를 생성한 후 TopLink O-R 매핑을 생성합니다. (Oracle ADF Tutorial 1-8, 2-2를 참고하십시오.) TopLink를 사용하기 전에 연결이 먼저 생성되어 있어야 합니다. 윈도우가 열려 있지 않은 경우 View/Connection Navigator를 선택합니다. New Connection on Database를 선택하고 이름을 정한 다음, Oracle(JDBC) 타입이 선택되어 있는지 확인합니다. 스키마 네임과 패스워드를 입력합니다. XE를 사용하고 있다면 sid를 XE로 변경합니다. 그리고 연결을 테스트합니다.
다시 Applications 윈도우로 돌아와 Model을 클릭하고 Tables에서 New/Business Tier/TopLink/Java Objects를 선택합니다.맵의 이름을 정하고 필요한 경우 연결을 변경합니다.2 단계의 스키마를 조회하여 전체 테이블을 가져옵니다. 그리고 패키지 네임을 확인합니다.지정된 패키지에 각 테이블 당 하나씩 데이터 액세스 오브젝트(DAO)가 생성되어 있음을 확인할 수 있습니다.또 Model의 TopLink 폴더의 맵을 열면 각 스키마 테이블의 필드 매핑을 확인할 수 있습니다.Structure 윈도우의 테이블을 선택한 경우, Map 윈도우는 매핑의 다른 뷰를 보여 줍니다.이러한 작업을 한 번 수행해 봄으로써, JDeveloper의 윈도우 간에 변경 사항이 어떻게 연동되는지 감을 잡으실 수 있을 것입니다.
Detail 맵의 Queries 탭을 선택하고 TopLink에 의해 각 테이블별로 findAll 쿼리가 자동으로 생성되어 있음을 확인합니다.테이블 로우의 일부를 조회하는 간단한 쿼리를 추가하기 위해, Named Queries에서 Add를 선택하고 쿼리의 이름을 입력합니다.그런 다음 Parameters 윈도우에서 Add를 선택하고 "fully qualified” Java 클래스 네임(예: java.lang.Integer)를 사용하여 매개변수 타입을 설정합니다. 그리고 Name 컬럼을 클릭하여 매개변수 이름을 변경합니다.정의해야 하는 각 매개변수별로 Add를 선택합니다.본 문서의 예에서는 특정 계좌 번호를 갖는 계좌에 대한 모든 로우를 가져오기 위해 Detail 매핑에 findAccountTransactionsByAccount()를 추가하고, 계좌 번호와 일련 번호의 쌍으로 구분되는 특정 거래 정보를 조회하기 위해서 Details 매핑에 findOneTransaction()을 추가합니다. findOneTransaction()은 ReadObjectQuery인 반면 findAccountTransactionsByAccount()는 ReadAllQuery입니다:
Format 탭을 이용하면 TopLink 에디터에서 쿼리를 생성하거나 쿼리 구문을 입력할 수 있습니다. Query Expression Builder를 사용하려면 Expression/Edit를 선택합니다. Query Expression Builder에서 Add를 선택하고 방금 생성한 매개변수의 Second Argument를 변경합니다. 또 다른 매개변수가 있다면, Add를 다시 선택합니다. 그러면 AND 구문이 자동으로 삽입됩니다:
미리 생성한 연결에 대응되는 디폴트 TopLink 세션이 생성되었습니다. sessions.xml 파일을 열고 Structure 윈도우에서 Default를 선택하여 디폴트 설정을 검토할 수 있습니다. 로깅과 같은 옵션을 변경하는 작업은 매우 간단하게 수행할 수 있습니다.
4 단계: EJB 세션의생성 (Oracle ADF Tutorial 2-14 참고) Model에서 New/Business Tier/EJB/Session 빈을 선택합니다. Remote Interface가 필요하지 않다는 사실만 제외하면 디폴트 설정에는 별 문제가 없습니다생성된 빈을 검토하는 과정에서, 테이블 로우에 대한 merge, persist, refresh, remove 메소드가 생성되어 있음을 확인할 수 있을 것입니다. 또 생성된 각각의 네임드 쿼리별로 하나씩 메소드가 생성되어 있음을 확인할 수 있습니다. EJB 마법사에 의해 자동으로 생성된 Java 코드에 의해 메소드 내에 세션 트랜잭션이 생성됩니다. 이 코드를 필요에 따라 수정할 수도 있습니다. 빈을 재생성할 때 기존 메소드의 텍스트를 덮어 쓰지 않도록 설정하는 것도 가능합니다.
5 단계: ADF Data Control의 생성 (Oracle ADF Tutorial 2-16 참고) ADF Data Control은 앞 단계에서 생성한 세션 빈과 DAO에 대한 인터페이스를 제공합니다. ADF Data Control은 데이터베이스를 연결하는 사용자 인터페이스 컨트롤을 생성하는 시점에 활용됩니다. View 메뉴의 Data Control 팔레트를 열어 보면, 정의된 내용이 하나도 없음을 확인할 수 있습니다. 세션 빈을 마우스 오른쪽 버튼으로 클릭하고 마지막 항목, Create Data Control을 선택합니다. 이제 Data Control에 데이터가 입력됩니다:
이것으로 프로젝트의 백엔드를 생성하기 위한 1차적인 작업이 완료되었습니다. 놀랄 만큼 간단한 작업만으로 전체 과정을 완료할 수 있었습니다. 하지만 ADF Control과 같은 기능이 제공하는 진정한 혜택은 페이지를 실제로 구현해 본 뒤에 확인할 수 있을 것입니다.
Phase 2: 초기 View의 생성
6 단계: 초기에 생성된 faces-config.xml 파일에 대한 작업. Web Content/WEB-INF 폴더와 (애플리케이션이 처음 오픈될 때 생성된) faces-config.xml 파일을 엽니다. 다른 이유로 config 파일이 미리 생성되지 않았다면 ViewController 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 New/Web Tier/JSF/JSF Page Flow & Configuration을 선택합니다. 이때 faces-config.xml의 디폴트 네임을 그대로 사용합니다. Overview 탭을 클릭하면 config 파일에 대한 뷰가 비어 있음을 확인할 수 있습니다:
이 뷰는 JSF 애플리케이션의 설정 파일을 중앙 집중적으로 관리하는 중요한 역할을 담당합니다. 사용자가 Faces 애플리케이션의 특정 페이지에서 다른 페이지로 전환하는 방법을 기술하는 XML 엘리먼트들과 별도로, 사용자와 인터페이스 컨트롤(backing bean)의 인터액션 과정에서 호출되는 메소드를 포함하는 빈, 그리고 사용자 상태 정보 등을 장기적으로 저장하기 위해 사용되는 빈을 위한 엘리먼트가 별도로 존재합니다.
7 단계: 초기 네비게이션 맵과 관련 페이지의 생성. (Oracle ADF Tutorial 3-2 참고) 이제 SRDemo의 페이지 템플릿을 기반으로 생성된 페이지들을 사용할 때가 되었습니다. 또 사용자가 특정 페이지에서 다른 페이지로 전환하는 방법을 정의하는 네비게이션 룰이 필요합니다. faces-config.xml 파일을 위한 Diagram 탭을 선택합니다. Configuration 팔레트가 열려 있는지 확인하고, JSF Page 중 하나를 Configuration Diagram으로 끌어다 놓습니다. 이 과정에서 config 파일의 네비게이션 엘리먼트가 생성됩니다. (하지만 페이지는 아직 생성되지 않습니다.)
‘Untitled’ 페이지 아이콘을 더블 클릭하여 파일을 실제로 생성하기 위한 마법사를 시작합니다. 페이지의 이름을 index로, 파일 확장자를 jspx로 변경합니다(오라클이 권장하는 확장자 이름입니다). 이 페이지에 대해 UI 컴포넌트가 자동으로 공개되지 않았음을 확인합니다. 그리고 ADF Faces Component, JSF Core, ADF Faces, JSF HTML 라이브러리를 가져 옵니다. 원하는 HTML 버전을 선택합니다. (우리 팀은 4.0.1 Transitional을 선택했습니다.
index.jspx 페이지는 애플리케이션에서 실제로 사용되는 첫 번째 페이지로 리다이렉트 됩니다. 이것은 웹 애플리케이션을 생성하는 표준적인 방법이기도 합니다. 그리고 권장되는 방법은 아니지만, index.jspx의 Source 윈도우로 이동하여 f:view 태그를 아래 scriptlet으로 변경합니다. 이 때 페이지를 관리하기 위한 디렉토리 구조가 생성됨을 참고하시기 바랍니다. administration 디렉토리에는 전체 애플리케이션의 전체 페이지가 저장되며, campusaccounts 서브디렉토리에는 이 프로젝트에 관련된 모든 페이지가 저장됩니다. scriptlet을 index.jspx 파일에 삽입한 뒤에 파일을 저장합니다.
<jsp:scriptlet>
response.sendRedirect("faces/administration/welcome.jspx");
</jsp:scriptlet>
Component 팔레트에서 다른 JSF 페이지를 faces-config.xml 다이어그램으로 끌어옵니다. 아이콘을 더블 클릭하여 jsp 페이지 셋업을 위한 마법사를 실행합니다. 이름을 welcome으로, 파일 타입을 jspx로 수정합니다. 또 필요한 디렉토리를 설정하고 서브디렉토리를 생성합니다. 예제 애플리케이션의 경우 디렉토리를 ../public_html/administration으로 설정하여 sendRedirect에 대응될 수 있도록 하였습니다. 그런 다음 index.jspx의 경우와 마찬가지로 라이브러리들을 가져옵니다. HTML 버전도 동일하게 설정합니다.
Diagram, Property Editor, Structure 윈도우의 사용법에 익숙해 졌다면 JSP 페이지에 컨텐트를 추가하는 작업을 간단하게 완료할 수 있을 것입니다. 경우에 따라서는 Source 윈도우에서 페이지를 편집할 수도 있습니다. Structure 윈도우에서 faces 뷰 엘리먼트를 열고 디폴트 f:view 태그를 수정한 후 아래의 (panel 페이지를 포함하는) 텍스트로 대체합니다. 패널 페이지(panel page)는 도움말, 각주, 저작권 관련 섹션 등을 위한 글로벌 컨트롤과 헤더를 포함하는 복잡한 UI 컨트롤입니다. 이 페이지를 사용하면서, 표준 인터페이스 컴포넌트를 이용하여 복잡한 페이지를 생성하는 작업이 실제로 무척 간단함을 확인하실 수 있을 것입니다. 텍스트를 붙여 놓는 가장 쉬운 방법은 Source 윈도우를 이용하는 것입니다. 커서가 파일 시작 부분의 3 번째 jsp 태그 뒤에 놓여 있는지 확인하시기 바랍니다.
<f:view>
<f:loadBundle basename="edu.uwec.financial.resources.UIResources"
var="res"/>
<af:document title="#{res['uacct.campusAccounts.title']}"
initialFocusId="start">
<af:form>
<af:panelPage>
<!-- Page Content End -->
<f:facet name="branding">
<af:panelHorizontal>
<af:objectImage source="/images/banner.jpg"/>
</af:panelHorizontal>
</f:facet>
<f:facet name="menu1">
<af:menuTabs var="menuTab" value="#{menuModel.model}">
<f:facet name="nodeStamp">
<af:commandMenuItem text="#{menuTab.label}"
action="#{menuTab.getOutcome}"
rendered="#{menuTab.shown and menuTab.type=='default'}"
disabled="#{menuTab.readOnly}"/>
</f:facet>
</af:menuTabs>
</f:facet>
<f:facet name="menu2">
<af:menuBar/>
</f:facet>
<f:facet name="menuGlobal">
<af:menuButtons>
<af:commandMenuItem text="#{res['uacct.menu.logout']}"
action="GlobalLogout" immediate="true"
icon="../images/blafIcons/logout.gif"/>
<af:commandMenuItem text="#{res['uacct.menu.help']}"
action="GlobalHelp" immediate="true"
icon="../images/blafIcons/help.gif"/>
</af:menuButtons>
</f:facet>
<f:facet name="messages">
<af:messages/>
</f:facet>
<f:facet name="appCopyright">
<!--Copyright msg-->
<h:panelGroup>
<af:objectSpacer width="10" height="10" id="objectSpacer4"/>
<af:panelHorizontal halign="center">
<af:outputText value="#{res['uacct.copyright']}"/>
</af:panelHorizontal>
</h:panelGroup>
</f:facet>
<f:facet name="appAbout">
<!-- The About this Application Link-->
<af:panelHorizontal halign="center">
<af:commandLink text="#{res['uacct.about']}" action="GlobalAbout"
immediate="true"/>
</af:panelHorizontal>
</f:facet>
<f:facet name="infoUser">
<!-- Show the Logged in user -->
<h:outputFormat value="#{res['uacct.connectedUser']}"
rendered="#{userInfo.authenticated}" escape="false">
<f:param value="#{userInfo.userName}"/>
</h:outputFormat>
</f:facet>
</af:panelPage>
</af:form>
</af:document>
</f:view>
Structure 윈도우에 에러가 표시됨을 확인할 수 있을 것입니다. 이 에러는 다음 단계에서 처리하기로 합니다.
8 단계데모 파일 가져오기. (Oracle ADF Tutorial 4-2 참고) 애플리케이션 생성 작업을 간단히 완료하기 위해 SRDemo에서 몇 가지 파일을 가져오는 방법을 추천 드립니다.리소스 파일을 사용하는 방법이 간단하기 때문에, 우리는 모든 UI 컴포넌트에 대해 (심지어 Submit과 같은 버튼에도) 리소스 파일을 일관성 있게 적용하기로 했습니다. 우리 팀은 대규모 인트라넷 애플리케이션을 위한 i18n의 필요성을 별 달리 느끼고 있지 않지만, 매우 좋은 선례가 될 수 있는 설계 원칙임에는 분명합니다.
또 ADFUtils, JSFUtils와 같은 클래스도 매우 유용하므로 데모 파일에서 가져오는 것을 권장합니다. JSF와 ADF 프레임워크에 저장된 변수를 Java 코드에서 접근하는 작업은 다소 까다롭습니다.오라클이 사용하는 바인딩/네이밍 표준을 이해하고 있다면, 이 유틸리티 클래스들을 이용하여 작업을 훨씬 쉽게 수행할 수 있을 것입니다.이미지 폴더를 임포트하는 것도 도움이 됩니다. 이미지 폴더에는 인터페이스에서 사용되는 브라우저 룩앤필(BLAF, browser look-and-feel) 폴더와 여러 가지 아이콘이 저장되어 있습니다.
파일의 임포트를 위해 ViewController 프로젝트를 선택하고 File/Import/Java Source를 가져옵니다. 그런 다음 SRDemo 프로젝트의 클래스들을 조회합니다. SRDemo의 전체 경로는 mywork과 동일한 레벨로 설정되어 있습니다. samples/SRDemo/UserInterface/src/oracle/srdemo/view 디렉토리를 확인하시기 바랍니다. ADFUtils와 JSFUtils를 util 디렉토리로 가져오고 패키지 스트럭처에 복사합니다. (예: src 폴더의 edu/uwec/financial/util) ResourceAdapter와 ULResources는 resources에 복사합니다(예: deu/uwec/financial/resources). 그리고 MenuItem, MenuModelAdapter, MenuTreeModelAdapter를 menu로 복사합니다(예: edu/uwec/financial/menu). Java 파일을 임포트한 후, 디렉토리 구조에 맞게 패키지 네임을 수정해야 할 수 있음을 참고하시기 바랍니다.
표준 이미지들을 임포트 하려면 File/Import/Web Source를 선택한 후 UserInterface/public_html을 조회하고 이미지를 가져옵니다. 이미지 폴더는 public_html 폴더로 복사되어야 합니다. 이 과정은 조금 까다로울 수 있습니다. 브라우징 과정에서 너무 깊이 들어가지 않도록 주의해야 합니다:
이제 jspx 파일에 관련한 에러 메시지가 사라졌음을 확인할 수 있습니다. 하지만 패널 페이지의 엘리먼트들을 수정해 주어야 합니다(예: branding facet에 포함되어야 하는 이미지). 페이지 상단에 인클루드 처리할 이미지가 있는 경우, 이미지를 ViewController 프로젝트의 images 폴더에 WebContent로 임포트합니다. Structure 윈도우의 패널 페이지에서 branding/panelHorizontal을 선택합니다. 그런 다음 Properties 윈도우에서 오브젝트 이미지를 리셋합니다. 로그아웃, 도움말과 같은 페이지 아이콘이 올바른 Source 속성을 갖고 있는지 확인하는 작업이 필요할 수도 있습니다. Property 윈도우의 Source 속성에서 각 아이콘과 ... 버튼을 선택하고 Source 윈도우의 이미지를 검색합니다. 이때 패키지 구조와 매칭시키기 위해 welcome.jspx 파일의 loadBundle 태그와 같은 항목을 수정해 주어야 합니다.
샘플 속성 파일은 welcome.jspx에서 참조되는 속성과 매칭되지 않습니다. 새로 추가해 주어야 하는 이름/값이 아래와 같습니다:
uacct.about=About MyBlugold
uacct.copyright=\u00a9 2006 University of Wisconsin - Eau Claire
uacct.menu.help=Help
uacct.menu.logout=Logout
uacct.menu.campusAccounts=Campus Accounts
uacct.campusAccounts.title=Campus Accounts
uacct.connectedUser=Logged in as <b>{0}</b>
ADFUtils 클래스는 추가로 라이브러리가 필요하기 때문에 아직 컴파일할 수 없습니다. ViewController 프로젝트의 Properties를 열고 ADF Model Runtime 라이브러리를 추가합니다.
index.jspx를 선택하고 (초록색 화살표를 눌러) 애플리케이션을 실행하면, 아래와 같은 화면을 확인할 수 있을 것입니다.
Welcome 페이지에는 Help, Logout과 같은 버튼이 포함되어 있습니다.
9 단계: 메뉴의 생성.이 섹션에서는 메뉴 생성을 위해 SRDemo에서 가져온 코드에 대해 설명합니다. 학습 과정을 짧게 완료하고 싶다면 이 섹션을 생략해도 무방합니다.
탑 레벨 메뉴의 관리에 필요한 태그와 Java 코드가 프로젝트에 추가되었지만, faces-config.xml 파일에 관련 항목을 추가하는 작업이 아직 수행되지 않았습니다. 일반적으로 JDeveloper가 이 항목들을 자동으로 생성하거나, faces-config.xml 파일을 열고 Overview 탭에서 직접 빈(bean) 정의를 추가하게 됩니다. 또 다른 방법으로 Source 윈도우를 이용하여 아래 샘플 코드를 복사할 수도 있습니다. 이때 managed-bean 엘리먼트를 다른 유사한 빈을 위한 모델로 사용하게 됩니다(bean comment 태그를 참고하십시오).
<!-- Global menu tab for logout (we also added a tab for help -->
<managed-bean>
<managed-bean-name>menuItem_GlobalLogout</managed-bean-name>
<managed-bean-class>edu.uwec.financial.menu.MenuItem</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
<managed-property>
<property-name>label</property-name>
<value>#{resources['uacct.menu.logout']}</value>
</managed-property>
<managed-property>
<property-name>icon</property-name>
<value>/images/logout.gif</value>
</managed-property>
<managed-property>
<property-name>type</property-name>
<value>global</value>
</managed-property>
<managed-property>
<property-name>viewId</property-name>
<value>/administration/Logout.jsp</value>
</managed-property>
<managed-property>
<property-name>outcome</property-name>
<value>GlobalLogout</value>
</managed-property>
</managed-bean>
<!-- Campus Accounts menu tab (we also added tabs for Purchasing and Accounting) -->
<managed-bean>
<managed-bean-name>menuItem_CampusAccounts</managed-bean-name>
<managed-bean-class>edu.uwec.financial.menu.MenuItem</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
<managed-property>
<property-name>label</property-name>
<value>#{resources['uacct.menu.campusAccounts']}</value>
</managed-property>
<managed-property>
<property-name>viewId</property-name>
<value>/administration/campusaccounts/CampusAccounts.jspx</value>
</managed-property>
<managed-property>
<property-name>outcome</property-name>
<value>GlobalCampusAccounts</value>
</managed-property>
</managed-bean>
<!-- create the main menu menuModel bean, only one needed -->
<managed-bean>
<managed-bean-name>menuModel</managed-bean-name>
<managed-bean-class>edu.uwec.financial.menu.MenuModelAdapter</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
<managed-property>
<property-name>viewIdProperty</property-name>
<value>viewId</value>
</managed-property>
<managed-property>
<property-name>instance</property-name>
<value>#{menuTreeModel.model}</value>
</managed-property>
</managed-bean>
<!-- create the main menu menuTreeModel bean, only one needed -->
<managed-bean>
<managed-bean-name>menuTreeModel</managed-bean-name>
<managed-bean-class>edu.uwec.financial.menu.MenuTreeModelAdapter</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
<managed-property>
<property-name>childProperty</property-name>
<value>children</value>
</managed-property>
<managed-property>
<property-name>listInstance</property-name>
<list-entries>
<value-class>edu.uwec.financial.menu.MenuItem</value-class>
<value>#{menuItem_GlobalLogout}</value>
<value>#{menuItem_GlobalHelp}</value>
<value>#{menuItem_CampusAccounts}</value>
<value>#{menuItem_Purchasing}</value>
<value>#{menuItem_Accounting}</value>
</list-entries>
</managed-property>
</managed-bean>
<managed-bean>
<managed-bean-name>resources</managed-bean-name>
<managed-bean-class>edu.uwec.financial.resources.ResourceAdapter</managed-bean-class>
<managed-bean-scope>application</managed-bean-scope>
</managed-bean>
빈은 resources 파일을 참조하므로, faces-config.xml에 이에 관련한 항목을 추가해 주어야 합니다. application 태그에서 (default—ender-kit과 별도로) 아래와 같이 xml 엘리먼트를 추가합니다:
<message-bundle>edu.uwec.financial.resources.UIResources</message-bundle>
다시 index.jspx 파일을 실행하면 아래와 같은 페이지가 표시됩니다. (Purchasing, Help 등을 위한 매니지드 빈을 추가하지 않았다면, 아래 페이지에 Campus Accounts 탭만이 디스플레이될 것입니다):
10 단계: 첫 번째 입력 페이지의 생성.이제 처음으로 “쓸 만한” 페이지를 만들어 보겠습니다. 계좌 관리의 첫 번째 단계로 사용자가 계좌 번호를 입력하는 페이지입니다. faces-config.xml 다이어그램을 열고 이 다이어그램에 새로운 페이지를 끌어다 놓습니다. 그런 다음 아이콘을 더블 클릭하여 페이지를 편집합니다. 우리 팀은 campusaccounts에 새로운 레벨을 추가하기를 원했습니다. 그래서 /administration/campusaccounts에 .jspx를 생성하였습니다. (publuc_html 뒷부분에 \administration\campusaccounts을 추가합니다.) 그런 다음, 우리는 JDeveloper가 두 번째 단계의 매니지드 빈을 자동 생성하도록 하였습니다.choose.jspx의 'backing bean'의 이름은 자동으로 Choose.java로 명명되며, 모든 사용자 인터페이스 컴포넌트를 위한 필드를 포함하게 됩니다.따라서 spacer와 같은 간단한 컴포넌트를 추가할 때마다, 해당되는 getter, setter를 갖는 필드가 표시됩니다.이러한 기능은 ‘height’ 정보와 같은 spacer 속성의 사이즈를 변경하는 Java 코드를 변경할 때 유용합니다. 또 복잡한 ‘backing bean’을 생성할 수도 있습니다.이러한 경우에는 자동으로 생성된 backing bean을 가지고 시작하는 편이 좋습니다.
Structure 윈도우에서 태그를 welcome.jspx의 view 태그로 대체합니다. (결국, Welcome 페이지를 일종의 템플릿으로 활용하는 셈입니다.)choose.jspx의 Structure 윈도우에서 view 태그를 삭제한 뒤 welcome.jspx의 view 태그를 복사하여 choose.jspx에 복사합니다. Source 윈도우에서 같은 변경 작업을 수행하는 경우에는 jspx가 backing bean을 갖는 다는 html 커멘트가 삭제되지 않도록 주의합니다:
<!--oracle-jdev-comment:auto-binding-backing-bean-name:backing_administration_campusaccounts_choose-->
faces config 파일에 네비게이션 룰을 추가하고, 인터페이스가 GlobalCampusAccounts에서 애플리케이션의 첫 번째 페이지로 네비게이션하도록 설정합니다. 이것은 글로벌 룰로 분류됩니다. 애플리케이션의 어느 위치에서든 탭을 선택하여 CampusAccounts로 변경할 수 있습니다. faces-config.xml에 입력되는 태그가 아래와 같습니다.
<navigation-rule>
<navigation-case>
<from-outcome>GlobalCampusAccounts
<to-view-id>/administration/campusaccounts/choose.jspx
</navigation-case>
</navigation-rule>
commandMenuItems의 Logout, Home 아이콘 속성을 편집하여, 아이콘에 blaf 폴더의 gif 파일이 사용되도록 변경해 주어야 합니다.
또 패널 페이지에 PanelHorizontal을 삽입하여 입력 텍스트 컴포넌트가 사용될 수 있게 합니다. 이 작업은 Structure 페이지에서 보다 쉽게 수행할 수 있습니다. PanelPage 엘리먼트를 마우스 오른쪽 버튼으로 클릭하고 ADF Faces 컴포넌트를 선택하면 됩니다. 하지만 같은 작업을 Component 팔레트에서 수행할 수도 있습니다. ADF 폼이 PanelPage를 포함하므로, html 폼 엘리먼트가 사용되어야 함을 참고하시기 바랍니다. Horizontal Panel에 InputText 컴포넌트를 추가합니다. Properties 윈도우에서, 리소스 파일에 저장된 속성을 사용하도록 레이블을 변경합니다. resources 파일을 편집하고 property를 추가한 후, Structure 윈도우의 inputText 엘리먼트를 더블 클릭합니다. 그리고 JSF Object에서 Bind를 선택하고 방금 입력한 속성 값을 선택합니다. 리소스에 접근하기 위한 EL 포맷을 사용하는 경우, Property Editor에서 속성 값을 쉽게 입력할 수 있습니다. 입력 텍스트의 뒷부분의 Horizontal Panel에 CommandButton을 추가하고, resource 파일에 정의된 다른 속성을 사용하도록 이름을 변경합니다. 이때에도 Structure 윈도우를 사용하는 것이 권장됩니다.
버튼을 더블클릭하여 backing bean으로 이동합니다. InputText 컴포넌트에서 텍스트를 가져온 후 user state로 저장하여, 사용자가 CampusAccounts 애플리케이션의 옵션에 액세스할 때마다 활용될 수 있게 합니다.
public String commandButton1_action() {
Object text = getInputText1().getValue();
UserSystemState.storeCurrentAcctNum(new Integer(acctNum));
return "list";
}
N여기서 아무런 검증 작업이 수행되고 있지 않음을 참고하시기 바랍니다. 검증을 불필요하게 하려면 Faces 컴포넌트의 옵션을 사용해야 합니다. InputText 엘리먼트에 필요한 속성을 설정하였다면, 이제 사용자는 값의 입력을 요구 받게 됩니다. InputText 태그 내에 ValidateRegExp 밸리데이터(validator)를 삽입하고 패턴 [0-9]+를 추가한 경우, 사용자는 계좌 번호의 숫자 중 최소한 하나를 입력해야 합니다.
예제 애플리케이션에서는 SRDemo로부터 UserSystemState를 추가하고, 이것을 모델로 하여 계좌 번호 저장을 위한 정적 함수를 생성하였습니다. 또 faces-config.xml 파일의 매니지드 빈의 이름으로 userSystemState(여기서 ‘u’는 소문자입니다)를 추가합니다. managed-bean-class 필드로부터 정의된 패키지 네임을 가져올 수 있습니다. JDeveloper가 제공하는 faces-config.xml 파일 관리 기능 중에서도 특별히 돋보이는 기능으로, 코드 컴파일 또는 패키지 네임의 정의 과정에서 문제가 발생한 경우 태그에서 경고를 확인할 수 있다는 점을 들 수 있습니다. JDeveloper는 xml 설정 파일을 매우 적극적으로 파싱합니다.
<managed-bean>
<managed-bean-name>userSystemState</managed-bean-name>
<managed-bean-class>edu.uwec.financial.view.backing.UserSystemState</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
Command 버튼에서 사용되는 정적 함수를 생성하기 위한 UserSystemState의 초기 코드가 아래와 같습니다. 이 코드는 SRDemo의 모든 필드와 메소드를 대체합니다. 패키지 네임을 확인하는 것을 잊지 마시기 바랍니다:
private HashMap _settings = new HashMap();
private static final String CURRENT_ACCT_NUM = "CURRENT_ACCT_NUM";
public Integer getCurrentAcctNum() {
return (Integer)_settings.get(CURRENT_ACCT_NUM);
}
public void setCurrentAcctNum(Integer acctNum) {
_settings.put(CURRENT_ACCT_NUM, acctNum);
System.out.println("setCurrentAcctNum:"+acctNum); // some old fashioned testing
}
public static void storeCurrentAcctNum(Integer acctNum) {
JSFUtils.setManagedBeanValue("userSystemState.currentAcctNum", acctNum);
}
public static void retrieveCurrentAcctNum() {
JSFUtils.getManagedBeanValue("userSystemState.currentAcctNum");
}
이 코드에는 한 가지 트릭이 숨어있습니다. userSystemState.currentAcctNum은 UserSystemState의 특정 필드를 참조하는 것으로 보이지만, 실제로 그 이름을 가진 필드는 존재하지 않습니다. JSFUtils.getManagedBeanValue 함수 호출의 매개변수는 getter 메소드를 통해 확인됩니다. userSystemState.currentAcctNum은 getCurrentAcctNum()을 호출합니다.
CampusAccounts 탭에서 index.jspx를 실행하면 아래와 같은 페이지를 확인할 수 있습니다:
11 단계: 첫 번째 ADF Data Control의 생성 . (Oracle ADF Tutorial 5-2 참고) 이제 진짜 재미 있는 부분이 시작됩니다. 이제 ADF가 제공하는 진정한 가치를 확인할 수 있을 것입니다. 사용자가 계좌 번호를 입력하기 위한 페이지를 생성한 후에는, 해당 계좌 번호에 관련된 모든 거래 정보(Deposit과 Expenditure)를 조회하기 위한 페이지를 생성해야 합니다.
faces 네비게이션 다이어그램에서 /administration/campusaccounts/list.jspx라는 이름의 페이지를 생성하고, list.jspx를 편집하는 과정에서 UI 컴포넌트가 자동으로 공개될 수 있도록 합니다. 그리고 9 단계에서처럼 welcome.jspx에서 view 태그를 복사합니다.
이제 리스트 페이지가 Detail 테이블(또는 Detail DAO)의 적절한 로우를 디스플레이할 수 있도록 작업해 주어야 합니다. ADF Data Control은 ADF 애플리케이션 구축 작업의 가장 중심적인 부분임을 명심하십시오. 먼저 Data Control 팔레트를 엽니다.
findAccountTransactionsByAccount() 함수를 드래그-앤-드롭 방식으로 리스트 페이지로 가져올 수 있습니다. (이 방법을 사용하여 Command 버튼, 매개변수 폼과 같은 컴포넌트를 생성할 수 있을 것입니다.).
여기서는 그 대신으로 panelPage에 Detail을 드래그-앤-드롭 하여, Detail 테이블로부터 디스플레이될 수 있는 로우를 생성하는 방법을 사용하기로 합니다. 여기에는 매우 긴 컴포넌트 목록이 포함될 수 있을 것입니다. Tables/ADF Read-only Table...을 선택합니다. Action Binding Editor가 표시됩니다. Choose 페이지에서 계좌 번호에 저장된 값을 가져 온 후 findAccountTransactionsByAccount를 위해 사용할 값으로 바인딩할 수 있습니다:
모든 필드를 표시하고 selection, sorting을 활성화합시다. 또는 Structure 윈도우에서 각 컬럼을 더블 클릭하여 sorting을 선택적으로 활성화/비활성화하도록 컬럼 속성을 편집하고, 컬럼 헤딩을 변경할 수도 있습니다. 예제 애플리케이션의 경우, resource 파일에 컬럼 헤딩을 추가하고 HeaderText를 #{res['uacct.campusAccounts.account']}와 같은 레퍼런스에 바인딩하였습니다. (또 Structure 윈도우의 컴포넌트를 더블 클릭하여 테이블의 selection facet의 텍스트를 리셋할 수 있습니다.) 이를 위해 Bind 버튼이 유용하게 활용됩니다.
애플리케이션을 실행하고 올바른 계좌 번호를 입력하면, 아래와 같은 화면이 표시되어야 할 것입니다:
하지만 account number로 1000을 입력하고 나면, 여전히 choose 페이지에 머물러 있음을 확인할 수 있습니다.choose 페이지에서 list 페이지로 전환하는 방법이 설정되어 있지 않기 때문입니다. faces-config.xml 파일에서 Design 윈도우를 열고 Component 팔레트가 열려 있는지 확인합니다. JSF Navigation Case를 선택한 후, choose, list 페이지를 순서대로 클릭합니다.Transition label을 편집하여 Choose.java의 Command 버튼 액션에 의해 반환되는 값에 대응하여 list 페이지로 전환되도록 합니다. 이제 데이터가 list 페이지에 표시될 것입니다.
Details 데이터베이스 테이블에서 값을 조회하여 페이지에 표시하는 작업이 아주 간단하게 완료되었습니다.인터페이스 컴포넌트로는 ADF JSF 컴포넌트가 사용됩니다. 따라서 페이지네이션(pagination), 밴딩(banding, 각각의 로우를 다른 색상으로 표시), 라디오 버튼을 이용한 로우 선택 기능을 포함하는 복잡한 디스플레이 오브젝트를 쉽게 활용할 수 있습니다. 페이지의 룩앤필은 디폴트 오라클 스킨을 사용하고 있습니다. 하지만 컴포넌트 태그의 정의를 위해 사용된 CSS 파일을 변경함으로써 색상, 폰트, 아이콘 등을 변경할 수도 있습니다.
또, ADF가 제공하는 정교한 데이터 컨트롤을 이용하여 데이터 액세스 과정을 매우 쉽게 구현할 수 있었습니다.ADF 읽기 전용 테이블을 페이지에 드롭하는 경우, 반환된 헬퍼 오브젝트의 타입(Detail.java)이 참조되며 자동으로 적절한 컬럼이 생성됩니다. ‘Rowset behavior(한 번에 10 개의 로우를 표시)’가 제공되며, 기존 데이터베이스 테이블로부터 얻어진 메타데이터를 기준으로 타입을 결정하게 됩니다.
12 단계: Edit 페이지의생성. (Oracle ADF Tutorial 10-2 참고)List 페이지에서 선택을 위한 Table facet은 Command 버튼을 갖는 af:tableSelectOne 태그를 포함하고 있습니다.Command 버튼을 더블 클릭하면, backing bean을 실행하여 선택된 로우에 대한 데이터를 가져오는 헬퍼 함수를 호출하고 다음 페이지에서 표시하기 위해 저장해 둘 수 있습니다.
public String commandButton1_action() {
setCurrentTransactionIdFromRow();
return "edit";
}
The helper function in List.java looks like this: private void setCurrentTransactionIdFromRow() {
FacesContext ctx = FacesContext.getCurrentInstance();
JUCtrlValueBindingRef tableRowRef = (JUCtrlValueBindingRef) this.getTable1().getRowData();
Integer transId = (Integer)tableRowRef.getRow().getAttribute("cdPostSequence");
UserSystemState.storeCurrentTransId(transId);
}
9 단계의 storeCurrentAcctNum()을 모델로 사용하여 UserSystemState에 storeCurrentTransId()를 추가해야 합니다.
지금까지 편집할 로우를 선택하는데 필요한 변경 작업에 대해 설명하였습니다. 이제 편집에 사용할 새로운 jspx 페이지를 생성할 차례입니다. faces-config.xml 파일에서 jsp 페이지를 추가하고 이름을 edit.jspx로 변경합니다. Component 팔레트에서 JSF Navigation Case를 선택한 후 Design 윈도우의 transition 레이블을 Command 버튼에 명시된 반환 값과 매치되도록 수정합니다.edit.jspx 페이지를 선택하고 Data Control 팔레트에서 findOneTransaction/Detail을 선택한 후, Forms/ADF Form을 이용하여 패널 페이지에 드래그합니다. Submit 버튼을 추가하고 필요한 경우 필드 순서를 변경합니다. JSF Object의 값으로 매개변수를 변경하여 UserSystemState의 acctNum과 transId를 사용할 수 있게 합니다. 액션 바인딩이 완료되었다면, 사용자가 편집할 수 없는 필드에 대해 readOnly 속성을 true로 설정할 수 있습니다. Structure 윈도우에서 각 inputText 필드를 더블 클릭하고 resource 파일을 참조하여 레이블을 설정합니다. 이때 resource 필드의 값을 먼저 편집하는 것이 더 쉬울 것입니다. 그리고 edit 페이지에 Cancel 기능을 추가하는 것이 바람직할 것입니다. Submit 버튼을 PanalGroup으로 묶고 Submit 버튼의 앞 또는 뒤에 다른 CommandButton을 추가합니다. 이제 이 버튼을 선택하고 반환 값을 추가해야 할 것입니다. Cancel 버튼의 경우, 버튼과 대응되는 함수를 호출할 필요가 없습니다. action 속성을 편집하여 적절한 네이게이션 전환 값을 설정해 주면 됩니다. Cancel 버튼에 대해서 “cancel”을 설정합니다. faces-config.xml Design 윈도우의 submit 반환 값을 위해 jsf 네비게이션 케이스를 추가하여, edit 페이지에서 list 페이지로 돌아갈 수 있게 합니다. 또 다른 대안으로, faces-config.xml 파일에 네비게이션 값을 먼저 설정할 수 있습니다. 이 경우 버튼의 action 속성의 값을 선택할 때 값이 옵션으로 표시됩니다.
아직 edit 페이지에서 수행한 변경 작업을 저장하기 위한 과정이 남았습니다. 여기에서도 ADF 개발 패러다임이 사용됩니다. 다시 말해, backing bean에 코드를 직접 작성하는 대신 JDeveloper/ADF 마법사가 변경 사항의 저장을 위한 코드를 생성해 줍니다. 또 초기에 ORM을 생성하거나 세션 빈을 생성할 때 자동으로 생성된 mergeEntity() 함수를 사용하게 됩니다.
ADF Tutorial의 Chapter 10에 기술된 방법대로, edit.jspx 페이지에 대해 Design 윈도우를 열고 Data Control 팔레트를 엽니다. mergeEntity() 메소드를 Submit 버튼에 드롭합니다. 그런 다음 Bind Existing CommandButton을 선택합니다. 이제 Action Binding Editor 페이지가 표시됩니다. 마법사의 다음 단계에서 값 상자를 더블 클릭(또는 ... 버튼을 클릭)하고 ADF Binding의 바인딩을 엽니다. 바인딩은 ADF에서 사용 가능한 모든 바인딩을 참조함을 명심하시기 바랍니다. findOneTransactionlter 노드를 열고 currentRow에서 dataprovider를 선택합니다. 현재 레코드에 대한 표현식은 ${bindings.findOneTransactionIter.currentRow.dataProvider}입니다. Submit 버튼의 ActionListener 속성이 #{bindings.mergeEntity.execute}로 리셋되었음을 참고하시기 바랍니다.<0} {0><}0{>action 속성을 “list”로 설정하여 데이터베이스 변경 작업이 완료되면 인터페이스가 list 페이지로 돌아올 수 있게 합니다. 변경 가능한 각 텍스트 필드에 대해 immediate 속성을 true로 설정합니다. 완성된 edit 페이지가 아래와 같습니다:
앞에서 설명한 것처럼, ADF를 이용하면 거래 내역을 편집하는 기능을 매우 쉽게 추가할 수 있습니다. 여기에서는 설명하지 않았지만, mergeEntity를 호출하기 전에 편집된 필드에 비즈니스 룰을 적용하기 위해 세션 빈에 다른 함수를 추가할 수도 있습니다.
설명되지 않은 내용
위 예제에서 다루어지지 않은 내용이 많습니다. 튜토리얼 또는 개발자 가이드를 참고하시면 자세한 정보를 확인하실 수 있습니다:
- 허가된 사용자만이 기록을 추가/편집할 수 있도록 보장하기 위한 보안 기능을 애플리케이션에 추가하지 않았습니다. 가장 간단한 보안 대책으로 사용자 이름을 대신 null 값을 출력하는 기능을 추가할 수 있을 것입니다.
- 에러 또는 예외적 상황의 처리를 위한 기능이 구현되지 않았습니다.
- ADF의 검증 기능이 활용되지 않았습니다. 예를 들어, 사용자가 새로운 거래 기록을 입력할 때 입력 텍스트 박스가 빈 상태인지 아닌지 확인하는 것이 의미가 있을 것입니다.
- 사용자가 Deposit, Expenditure를 삭제하는 기능을 추가하지 않았습니다.
하지만 이 모든 것을 다 설명하기에는 지면이 너무도 부족할 것입니다!
결론
JDeveloper 기능에 관한 설명 부분을 검토해 준 JDeveloper 팀원 여러분께 감사 드립니다. 앞에서도 말했다시피, 본 문서에서 설명되지 않은 JDeveloper의 기능은 오라클 제품 문서에서 확인하실 수 있습니다.
서론에서 언급한 것처럼, 특정 방법론 또는 개발 환경에 익숙한 상태에서 새로운 테크놀로지로 전환하는 것은 쉬운 일이 아닙니다. 필자가 속한 조직의 경우, Spring JDBC 템플릿을 이용한 데이터 모델링, Spring MVC와 Spring Web Flow를 이용한 네비게이션, 그리고 Eclipse를 이용한 개발 환경에 익숙한 상태였습니다. 우리는 우리가 이미 알고 있는 방법론을 새로운 환경에서 어떻게 구현할 수 있을 것인지에 관심을 가졌습니다. backing bean과 같은 옵션이 필요했던 것도 그 때문이었습니다. 애초에 우리는 TopLink를 사용할 계획이 없었으며, ADF Control을 위한 다른 대안을 검토 중이었습니다. 그러던 중 오라클의 고객 사례를 접하게 되었고, ADF가 제공하는 추가적인 기능을 활용해 보기로 결정하게 된 것입니다.
ADF는 분명 매력적인 대안입니다. 또 Spring과 같은 다른 애플리케이션 개발 프레임워크를 훌륭히 보완해 줄 수 있습니다. 우리는 앞으로도 ADF와 JDeveloper를 이용한 여러 가지 대안을 검토할 예정입니다.
- 기존 백엔드의 Spring 기반 서비스를 ADF Faces 인터페이스에서 호출할 수 있는 웹 서비스의 형태로 구현 이러한 대안을 선택하기 까지는 Oracle ACE Lucas Jellema의 블로그가 많은 도움이 되었습니다.
- Oracle XML Publisher를 이용한 리포팅 페이지의 구현.s
- BPEL Plug-in for JDeveloper를 이용한 비즈니스 프로세스 상의 사용자 개입 과정 모델링. (오늘날 BPEL은 비즈니스 프로세스 관리 영역에서, SQL이 데이터 관리 영역에서 갖는 의미만큼이나 중요하게 고려되고 있습니다.
오라클이 제공하는 개발 툴은 우리가 갖는 요구 사항에 적절한 방식으로 대응하고 있습니다.
팁과 주의 사항
|
Tom Moore 는 위스콘신 대학의 Learning and Technology Services 팀에서 선임 컨설턴트로 일하고 있습니다. 탐은 위스콘신 대학에서 컴퓨터 과학 석사 학위를 취득하였으며, Struts, Spring과 같은 Java 및 오픈 소스 제품을 적극적으로 사용해 왔습니다. 탐은 오라클 개발 툴 및 프레임워크에 관심을 돌리기 전까지 위스콘신 대학의 컴퓨터 과학 학부 회원으로 오랜 기간 활동해 왔습니다.
출처 : 오라클 Developer - Java
'DataBase > Oracle' 카테고리의 다른 글
| [OCP 오라클(Oracle)]오라클자격증 OCP의 13가지 팁 (0) | 2008.09.22 |
|---|---|
| Oracle ERP에서 사용하는 DB관련 작업 (0) | 2008.09.18 |
| 오라클 관계형 데이터베이스의 소개 (0) | 2008.09.17 |
| [Scrap] Oracle Data Pump (Oracle 10g) (0) | 2008.08.29 |
| Oracle Online Study Site (0) | 2008.08.19 |
| Oracle Forms 설치. (0) | 2008.08.11 |
| Oracle Application Development Framework(ADF) 개요 (0) | 2008.07.14 |
| [scrap] HINT 사용하기 ( /* */ ) (출처:sqler.pe.kr) (0) | 2008.04.28 |
| [scrap] 데이터 베이스 문자 안깨지도록 windows에서 nls-lang 변경하기 (0) | 2008.04.28 |
| [scrap] 'TOAD, 아는 만큼 사용할 수 있는 툴 (0) | 2008.04.28 |