iBATOR - Giới thiệu
iBATOR là trình tạo mã cho iBATIS. iBATOR xem xét bên trong một hoặc nhiều bảng cơ sở dữ liệu và tạo ra các tạo tác iBATIS có thể được sử dụng để truy cập các bảng.
Sau đó, bạn có thể viết mã SQL tùy chỉnh hoặc quy trình được lưu trữ để đáp ứng yêu cầu của bạn. iBATOR tạo ra các tạo tác sau:
- Tệp XML SqlMap
- Các lớp Java để khớp với khóa chính và các trường của (các) bảng
- Các lớp DAO sử dụng các đối tượng trên (tùy chọn)
iBATOR có thể chạy dưới dạng tệp JAR độc lập, hoặc dưới dạng tác vụ Ant hoặc như một plugin Eclipse. Hướng dẫn này mô tả cách đơn giản nhất để tạo tệp cấu hình iBATIS từ dòng lệnh.
Tải xuống iBATOR
Tải xuống JAR độc lập nếu bạn đang sử dụng IDE không phải Eclipse. JAR độc lập bao gồm một nhiệm vụ Ant để chạy iBATOR hoặc bạn có thể chạy iBATOR từ dòng lệnh của mã Java.
Bạn có thể tải xuống tệp zip từ Tải xuống iBATOR .
Bạn có thể kiểm tra tài liệu trực tuyến - Tài liệu iBATOR .
Tạo tệp cấu hình
Để chạy iBATOR, hãy làm theo các bước sau:
Bước 1
Tạo và điền vào tệp cấu hình ibatorConfig.xml một cách thích hợp. Tối thiểu, bạn phải chỉ định -
A <jdbcConnection> phần tử để chỉ định cách kết nối với cơ sở dữ liệu đích.
A <javaModelGenerator> phần tử để chỉ định gói mục tiêu và dự án mục tiêu cho các đối tượng mô hình Java được tạo.
A <sqlMapGenerator> phần tử để chỉ định gói mục tiêu và dự án mục tiêu cho các tệp bản đồ SQL được tạo.
A <daoGenerator> phần tử để chỉ định gói mục tiêu và dự án mục tiêu cho các giao diện và lớp DAO được tạo (bạn có thể bỏ qua phần tử <daoGenerator> nếu bạn không muốn tạo DAO).
Ít nhất một cơ sở dữ liệu <table> thành phần
NOTE −Xem trang Tham chiếu tệp cấu hình XML để biết ví dụ về tệp cấu hình iBATOR.
Bước 2
Lưu tệp ở một vị trí thuận tiện, ví dụ, tại: \ temp \ ibatorConfig.xml.
Bước 3
Bây giờ chạy iBATOR từ dòng lệnh như sau:
java -jar abator.jar -configfile \temp\abatorConfig.xml -overwrite
Nó sẽ yêu cầu iBATOR chạy bằng tệp cấu hình của bạn. Nó cũng sẽ yêu cầu iBATOR ghi đè bất kỳ tệp Java hiện có nào có cùng tên. Nếu bạn muốn lưu bất kỳ tệp Java hiện có nào, hãy bỏ qua−overwrite tham số.
Nếu có xung đột, iBATOR sẽ lưu tệp mới tạo với một tên duy nhất.
Sau khi chạy iBATOR, bạn cần tạo hoặc sửa đổi tệp cấu hình iBATIS tiêu chuẩn để sử dụng mã mới tạo của bạn. Điều này được giải thích trong phần tiếp theo.
Nhiệm vụ sau khi chạy iBATOR
Sau khi chạy iBATOR, bạn cần tạo hoặc sửa đổi các tạo tác cấu hình iBATIS khác. Các nhiệm vụ chính như sau:
- Tạo hoặc sửa đổi tệp SqlMapConfig.xml.
- Tạo hoặc sửa đổi tệp dao.xml (chỉ khi bạn đang sử dụng iBATIS DAO Framework).
Mỗi nhiệm vụ được mô tả chi tiết bên dưới:
Cập nhật Tệp SqlMapConfig.xml
iBATIS sử dụng tệp XML, thường được đặt tên là SqlMapConfig.xml, để chỉ định thông tin cho kết nối cơ sở dữ liệu, sơ đồ quản lý giao dịch và tệp XML ánh xạ SQL được sử dụng trong phiên iBATIS.
iBATOR không thể tạo tệp này cho bạn vì nó không biết gì về môi trường thực thi của bạn. Tuy nhiên, một số mục trong tệp này liên quan trực tiếp đến các mục do iBATOR tạo.
Các nhu cầu cụ thể của iBATOR trong tệp cấu hình như sau:
- Không gian tên báo cáo phải được kích hoạt.
- Các tệp XML Bản đồ SQL do iBATOR tạo phải được liệt kê.
Ví dụ: giả sử iBATOR đã tạo tệp XML Bản đồ SQL có tên MyTable_SqlMap.xml và tệp đó đã được đặt trong gói test.xml của dự án của bạn. Tệp SqlMapConfig.xml phải có các mục sau:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sqlMapConfig PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN" "http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
<!-- Statement namespaces are required for Abator -->
<settings useStatementNamespaces="true" />
<!-- Setup the transaction manager and data source that are
appropriate for your environment
-->
<transactionManager type="...">
<dataSource type="...">
</dataSource>
</transactionManager>
<!-- SQL Map XML files should be listed here -->
<sqlMap resource="test/xml/MyTable_SqlMap.xml" />
</sqlMapConfig>
Nếu có nhiều hơn một tệp SQL Map XML (như khá phổ biến), thì các tệp có thể được liệt kê theo thứ tự bất kỳ với các phần tử <sqlMap> lặp lại sau phần tử <transactionManager>.
Cập nhật tệp dao.xml
Khung công tác iBATIS DAO được định cấu hình bởi một tệp xml thường được gọi là dao.xml.
Khuôn khổ iBATIS DAO sử dụng tệp này để kiểm soát thông tin kết nối cơ sở dữ liệu cho các DAO và cũng để liệt kê các lớp triển khai DAO và giao diện DAO.
Trong tệp này, bạn nên chỉ định đường dẫn đến tệp SqlMapConfig.xml của mình và tất cả các lớp triển khai và giao diện DAO do iBATOR tạo.
Ví dụ: giả sử iBATOR đã tạo một giao diện DAO được gọi là MyTableDAO và một lớp triển khai có tên MyTableDAOImpl và các tệp đã được đặt trong gói test.dao của dự án của bạn.
Tệp dao.xml phải có các mục sau:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE daoConfig PUBLIC "-//ibatis.apache.org//DTD DAO Configuration 2.0//EN" "http://ibatis.apache.org/dtd/dao-2.dtd">
<daoConfig>
<context>
<transactionManager type="SQLMAP">
<property name="SqlMapConfigResource" value="test/SqlMapConfig.xml"/>
</transactionManager>
<!-- DAO interfaces and implementations should be listed here -->
<dao interface="test.dao.MyTableDAO" implementation="test.dao.MyTableDAOImpl" />
</context>
</daoConfig>
NOTE − Bước này chỉ bắt buộc nếu bạn đã tạo DAO cho khung iBATIS DAO.