12/15/2013

Hướng dẫn sử dụng S2Container - Phần 1: Cài đặt

1. Giới thiệu

Như các bài trước mình có giời thiệu với các bạn qua về tổng quan của Seasar2 Framework. Trong bài này mình sẽ giới thiệu về các bước cài đặt để có thể sử dụng Seasar2 vào ứng dụng.
Nội dung sau được dịch từ manual của seasar.org và chỉnh sửa lại để cho người đọc có thể dễ hiểu và nắm bắt rõ nội dung.

 

2. Các bước cài đặt

#1. Trường hợp sử dụng Dolteng Plugin

 Để có thể trải nghiệm Seasar2 một cách đơn giản, thì mình khuyên các bạn sử dụng Dolteng (là plugin cho Eclipse). Để biết cách cài đặt thì các bạn hãy tham khải nội dung ở bài viết này.
Khi sử dụng Dolteng thì các bạn có thể kết hợp sử dụng các Framework cho tầng Presentation và Persistence layer như sau. Về nội dung các framework này nếu có thời gian thì mình sẽ giới thiệu sau.
Presentation Layer Persistence Layer Tóm tắt
SAStruts S2JDBC SAStruts là Framework tầng P (Presentation) được phát triển dựa trên Struts1.2 nhằm mục đích mang S2Container đến người phát triển Struts 1
Teeda S2Dao Teeda là là Framework tầng P được tạo ra dự trên JSF nhằm mục đích mang S2Container đến người lập trình JSF

 

#2. Trường hợp không sử dụng Dolteng

Trường hợp không sử dụng Dolteng thì có những cách sau để cài đặt sử dụng Seasar2

2.1 S2-Framework

Trường hợp sử dụng các chức năng căn bản của Seasar2 (S2Container, S2AOP) thì các bạn có thể download file thư viện tại trang seasar.org và hãy thêm vào CLASSPATH những thư viện như sau:
  • lib/s2-framework-2.4.x.jar
  • lib/aopalliance-1.0.jar
  • lib/commons-logging-1.1.jar
  • lib/javassist-3.4.ga.jar
  • lib/ognl-2.6.9-patch-20070624.jar
  • lib/geronimo-j2ee_1.4_spec-1.0.jar (tùy chọn, T/H sử dụng cho ứng dụng không là J2EE)
  • lib/portlet-api-1.0.jar (tùy chọn, T/H có sử dụng Portlet)
  • lib/log4j-1.2.13.jar (tùy chọn, T/H sử dụng Log4J)
  • resources/log4j.properties (tùy chọn, T/H sử dụng Log4j)
  • resources/convention.dicon (tùy chọn, T/H có sử dụng [SMART deploy])
  • resources/creator.dicon (tùy chọn, T/H có sử dụng [SMART deploy])
  • resources/customizer.dicon (tùy chọn, T/H có sử dụng [SMART deploy])

2.2 S2-Extension

Trường hợp muốn sử dụng các chức năng mở rộng của Seasar2 (S2JTA, S2DBCP, S2JDBC, S2Unit, S2Tx, S2DataSet) thì các bạn cần phải thêm các thư viện sau vào CLASSPATH:
  • lib/s2-extension-2.4.x.jar
  • lib/junit-3.8.2.jar (tùy chọn, sử dụng cho môi trường Unit Test)
  • lib/poi-3.0-FINAL.jar (tùy chọn, T/H sử dụng Excel trong Unit Test)
  • lib/geronimo-jta_1.1_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng S2JTA hoặc S2Tx)
  • lib/geronimo-jta_1.1_spec-1.0-tsr.jar (tùy chọn, tham chiếu khi sử dụng S2JTA hoặc S2Tx)
  • lib/geronimo-ejb_2.1_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng EJB với S2Tx)
  • resources/jdbc.dicon
Ngoài ra, khi chạy chương trình, thì tùy vào những trường hợp dưới đây thì cần phải thêm vào các thư viện của J2EE như sau:

- Trường hợp sử dụng S2JTA hoặc S2Tx
Tùy thuộc vào môi trường mà ứng dụng của bạn sẽ chạy mà cần phải thêm thư viện geronimo-jta_1.1_spec-1.0.jar hoặc geronimo-jta_1.1_spec-1.0-tsr.jar cụ thể như sau:
Môi trường chạy geronimo-jta_1.1_spec-1.0.jar geronimo-jta_1.1_spec-1.0-tsr.jar
Servlet Web Container
(VD: Tomcat...)
YES -
Application Server hỗ trợ J2EE1.4 - YES
Application Server hỗ trợ JavaEE5 - -
Ứng dụng độc lập
(Standard alone)
YES -

- Trường hợp sử dụng S2Tx với EJB
Tùy theo vào môi trường chạy ứng dụng mà sẽ cần hoặc không thư việ geronimo-ejb_2.1_spec-1.0.jar. (Các bạn có thể sử dụng Kijimuna là  plugin dành cho S2Container để tự động hóa việc này)
※Ghi chú: trường hợp sử dung S2-Tiger thì không cần thư viện này.
Môi trường chạy geronimo-ejb_2.1_spec-1.0.jar
Web Container hỗ trợ Servlet
(VD: Tomcat...)
YES
Application Server hỗ trợ J2EE1.4 -
Application Server hỗ trợ JavaEE5 -
Ứng dụng độc lập
(Standard alone)
YES


2.3 S2-Tiger

Trường hợp muốn sử dụng các chức năng hỗ trợ Java5, thì hãy sử dụng S2Tiger-2.4.x và thêm vào CLASSPATH những thư viện sau:
  • lib/s2-tiger-2.4.x.jar
  • lib/geronimo-annotation_1.0_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng @Resource)
  • lib/geronimo-jpa_3.0_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng S2JDBC hoặc JPA)
  • lib/geronimo-ejb_3.0_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng EJB3)
  • lib/geronimo-interceptor_3.0_spec-1.0.jar (tùy chọn, tham chiếu khi sử dụng EJB3)
Với các thư viện tùy chọn ở trên, trường hợp muốn sử dụng các chức năng của S2JDBC và EJB3, JPA mà môi trường chạy không hỗ trợ JavaEE5 thì phải bắt buộc thêm các thư viện trên vào CLASSPATH, cụ thể như sau:

- Trường hợp sử dụng @Resource
Tùy theo môi trường chạy ứng dụng mà sẽ cần hoặc không thư viện geronimo-annotation_1.0_spec-1.0.jar
Môi trường chạy geronimo-annotation_
1.0_spec-1.0.jar
Web Container hỗ trợ Servlet2.4
(VD: Tomcat5.x...)
YES (JavaSE6 trở lên thì không cần)
Web Container hỗ trợ Servlet2.5
(VD: Tomcat6...)
-
Application Server hỗ trợ J2EE1.4 YES
(JavaSE6 trở lên thì không cần)
Application Server hỗ trợ JavaEE5 -
Ứng dụng độc lập
(Standard alone)
YES
(JavaSE6 trở lên thì không cần)

- Trường hợp sử dụng S2JDBC hoặc JPA
Tùy theo môi trường chạy ứng dụng mà sẽ cần hoặc không thư viện gegeronimo-jpa _3.0_spec-1.0.jar
Môi trường chạy geronimo-jpa _3.0_spec-1.0.jar
Web Container hỗ trợ Servlet
(VD: Tomcat...)
YES
Application Server hỗ trợ J2EE1.4 YES
Application Server hỗ trợ JavaEE5 -
Ứng dụng độc lập
(Standard alone)
YES

- Trường hợp sử dụng EJB3
Tùy theo môi trường chạy ứng dụng mà sẽ cần hoặc không thư viện geronimo-ejb_3.0_spec-1.0.jar, geronimo-interceptor_3.0_spec-1.0.jar
Môi trường chạy geronimo-ejb_
3.0_spec-1.0.jar
geronimo-interceptor_
3.0_spec-1.0.jar
Web Container hỗ trợ Servlet2.4
(VD: Tomcat5.x...)
YES YES
Web Container hỗ trợ Servlet2.5
(VD: Tomcat6...)
YES YES
Application Server hỗ trợ J2EE1.4 YES YES
Application Server hỗ trợ JavaEE5 - -
Ứng dụng độc lập
(Standard alone)
YES YES


Như vậy các bạn đã biết cách để thêm đúng thư viện của Seasar2 vào ứng dụng của mình. Hẹn gặp lại ở phần tiếp theo của serie về Hướng dẫn sử dụng S2Container.

Không có nhận xét nào:

Đăng nhận xét

Bạn thấy nội dung bài viết thế nào?