Tích hợp FileNet với IBM Content Manager, Phần 2 pot

Tích hợp FileNet với IBM Content Manager, Phần 2: Triển khai thực hiện
các thực thể nghiệp vụ Java và lớp cổng (gateway) cho dữ liệu trong kho lưu
trữ lưu trữ của IBM Content Manager
Một ví dụ sử dụng kịch bản "Công ty ABC"
S. H. Liu, Kỹ sư tư vấn phần mềm, IBM Japan
Dao-Quynh Dang, Kỹ sư phần mềm, IBM
Peng Shi, Kỹ sư phần mềm, Phát triển IBM Content Manager, IBM Japan
Tóm tắt: Đây là bài thứ hai trong loạt bốn bài viết cho bạn thấy cách tích hợp
FileNet® Business Process Management (FileNet BPM- Quản lý quy trình nghiệp
vụ FileNet) với IBM® DB2 ® Content Manager (IBM ECM-Nhà quản lý nội
dung DB2 của IBM) phiên bản 8. Trong bài này, hãy tìm hiểu về các trình diễn
công việc trong FileNet P8, triển khai thực hiện các thực thể nghiệp vụ Java™ và
tạo ra một lớp cổng (gateway) Java. Ngoài ra, hãy xem cách sử dụng tuần tự hóa
Java để tránh các hạn chế cụ thể
Mở đầu
Phần 1 của loạt bài này đã giới thiệu cho bạn về các kiến trúc của FileNet P8 BPM
và IBM Content Manager. Bài viết đã sử dụng một hệ thống Yêu cầu bồi thường
bảo hiểm tự động của công ty ABC hư cấu để cho bạn thấy cách tích hợp hai sản
phẩm mạnh mẽ này.
Phần 2 giới thiệu các trình diễn công việc của FileNet P8 và cho bạn thấy cách
triển khai thực hiện các thực thể nghiệp vụ Java. Bạn sẽ tìm hiểu cách tạo ra một
lớp cổng Java và xem cách sử dụng tuần tự hóa Java để tránh các hạn chế cụ thể.


Các trình diễn công việc
Để sử dụng một kho lưu trữ nội dung của bên thứ ba, FileNet Business Process
Management (BPM) cần có khả năng giao tiếp với kho lưu trữ IBM Content
Manager. Các trình diễn công việc FileNet có thể cho phép BPM tương tác với các
ứng dụng hoặc các mã của bên thứ ba.
Trong FileNet P8, các trình diễn công việc cho phép một ứng dụng thực hiện một
hoạt động hoặc một tập các hoạt động liên quan đến một dòng công việc. Thông

thường, các trình diễn công việc được thiết kế không có giao diện người dùng và
được sử dụng để thực hiện các hoạt động dòng công việc tự động, chẳng hạn như
các hoạt động được liên kết với một bước dòng công việc cụ thể trong một định
nghĩa dòng công việc. Các hoạt động trình diễn công việc được liên kết với các
bước dòng công việc bao gồm đăng nhập và thiết lập một phiên làm việc của máy
quy trình, thăm dò một hàng đợi người dùng hoặc hàng đợi hệ thống (cố gắng để
tìm các hoạt động liên quan đến một bước dòng công việc cụ thể), khóa các đối
tượng được lấy ra, xử lý công việc (cập nhật dữ liệu và v.v ) và quay ngược để
thăm dò hàng đợi. Đại khái là, các trình diễn công việc cần thiết để tương tác với
các ứng dụng của bên thứ ba.
Có hai kiểu trình diễn công việc, dựa vào trình tích hợp thành phần và dựa trên
trình tiện ích nền sau (daemon). Trình diễn công việc dựa vào nhà tích hợp thành
phần được dùng trong ví dụ này.
Các trình diễn công việc dựa vào nhà tích hợp thành phần là một thành phần được
triển khai thực hiện như một lớp Java hoặc sự kiện Java Messaging Service (JMS-
Dịch vụ gửi thông báo Java). Một thành phần Java có thể được sử dụng để thực
hiện tất cả các hoạt động liên quan đến một dòng công việc. Hình 1 minh họa kiến
trúc của nhà tích hợp thành phần:

Hình 1. Kiến trúc Nhà tích hợp thành phần FileNet P8

Thành phần Java hoặc JMS có thể được nhà quản lý thành phần (component
manager) quản lý. Nhà quản lý thành phần cấu hình và giao tiếp với các bộ điều
hợp dịch vụ. Trong thời gian chạy, nhà quản lý thành phần thăm dò các hàng đợi
thành phần về các mục công việc đòi hỏi JMS hoặc xử lý bởi các thành phần Java
và kết nối một mục công việc đang đòi hỏi một thành phần tới bộ điều hợp dịch vụ
thích hợp. Bộ điều hợp Java xử lý các cuộc gọi quy trình cho các đối tượng Java,
được biểu diễn đến máy quy trình như là các hoạt động trên các hàng đợi (các mục
công việc) ở nơi mỗi hoạt động được thực hiện bằng một phương thức của lớp
Java. Bộ điều hợp Java thực hiện ghép nối với thành phần Java, sau đó tự động

chờ đáp ứng từ thành phần này, cập nhật mục công việc và gửi mục công việc này
đến bước dòng công việc tiếp theo. Bộ điều hợp JMS đặt các thông báo vào Hàng
đợi JMS (Queue JMS) và gửi đi mục công việc liên quan. Bộ điều hợp JMS xử lý
quy trình gửi lên các sự kiện tới một hàng đợi thông báo (dưới dạng một sự kiện
XML dựa trên phần tử bước cho hoạt động cụ thể).


Triển khai thực hiện các thực thể nghiệp vụ Java cho Công ty ABC
Công ty ABC muốn lưu trữ tất cả dữ liệu nội dung trong IBM Content Manager
hiện có. Và nó cũng muốn sử dụng FileNet BPM để xây dựng một ứng dụng tập
trung quy trình. Vì vậy bạn cần triển khai thực hiện các trình diễn công việc trong
BPM để thao tác nội dung trong IBM Content Manager hiện có.
Bạn có thể gói logic ứng dụng bên thứ ba và trưng ra giao diện đó khi triển khai
thực hiện thành phần Java. Với trường hợp của Công ty ABC, trước tiên bạn triển
khai thực hiện các thực thể nghiệp vụ Java có thể truy cập dữ liệu trong IBM
Content Manager. Hình 2 cho thấy kiến trúc của các thực thể nghiệp vụ Java :

Hình 2. Kiến trúc các thực thể nghiệp vụ Java

Như kiến trúc này cho thấy, bạn có thể tạo các đối tượng chuyển giao dữ liệu
(DTO) và đối tượng truy cập dữ liệu (DAO) phù hợp với mỗi lớp trong biểu đồ
lớp (Phần 1; Hình 4). Khi lấy lớp "AutoClaim" làm ví dụ, chúng ta đã tạo ra một
lớp DTO AutoClaim.java và một lớp DAO AutoClaimDAO.java.
Mã Java sau đây là AutoClaim.java. Nó bao gồm các định nghĩa đặc tính và các
phương thức getter và setter có liên quan. Nó biểu diễn giá trị dữ liệu cho một mục
trong kho lưu trữ IBM Content Manager.

Liệt kê 1. DTO mẫu - AutoClaim.java

public class AutoClaim

{
public AutoClaim ()
{
}

private String claimID;
public String getClaimID()
{
return this.claimID;
}

public void setClaimID(String claimID)
{
this.claimID = claimID;
}

private Integer claimStatus;
public Integer getClaimStatus()
{
return this.claimStatus;
}

public void setClaimStatus(Integer claimStatus)
{
this.claimStatus = claimStatus;
}

private String openingDate;
public String getOpeningDate()
{

return this.openingDate;
}

public void setOpeningDate(String openingDate)
{
this.openingDate = openingDate;
}

private Integer claimAmount;
public Integer getClaimAmount() {
return claimAmount;
}

public void setClaimAmount(Integer claimAmount) {
this.claimAmount = claimAmount;
}

private String eventID;

public String getEventID() {
return this.eventID;
}

public void setEventID(String eventID) {
this.eventID = eventID;
}

private String pidString;
public String getPidString() {
return pidString;

}
public void setPidString(String pidString) {
this.pidString = pidString;
}
}


Mã Java sau đây là AutoClaimDAO.java là một đối tượng truy cập dữ liệu. Nó
chứa tất cả các phương thức gọi OOAPI của IBM Content Manager để xử lý dữ
liệu trong IBM Content Manager.

Liệt kê 2. DAO mẫu - AutoClaimDAO.java

public class AutoClaimDAO
{

private String itemType;

public AutoClaimDAO()
{
itemType = "AutoClaim";
}

public String create(AutoClaim autoClaim) throws DKException, Exception
{
String pidString = null;
DKDatastoreICM dsICM = SConnectDisconnectICM.connect();
DKDDO ddo = dsICM.createDDO("AutoClaim",
DKConstant.DK_CM_ITEM);
setAttrToDDO(ddo, autoClaim);

ddo.add();
pidString = ddo.getPidObject().pidString();
dsICM.disconnect();
return pidString;
}

public AutoClaim retrieveAutoClaimByClaimID(String claimID)
throws DKUsageError, DKException, Exception
{
AutoClaim autoClaim = null;
String queryString = "/AutoClaim[@Claim=\""+claimID+"\"]";
DKDatastoreICM dsICM = SConnectDisconnectICM.connect();
dkIterator dkIter =
(dkIterator) SConnectDisconnectICM.search(dsICM, queryString, 0, true);
if(dkIter.more())
{
autoClaim = new AutoClaim();
DKDDO ddo = (DKDDO)dkIter.next();
ddo.retrieve(DKConstant.DK_CM_CONTENT_ITEMTREE +
DKConstant.DK_CM_CONTENT_NO);
setValueToAutoClaim(ddo, autoClaim);
autoClaim.setPidString( ddo.getPidObject().pidString() );
}
dsICM.disconnect();
return autoClaim;
}

public void update(String pidString, AutoClaim autoClaim)
throws DKUsageError, DKException, Exception
{

DKDatastoreICM dsICM = SConnectDisconnectICM.connect();
DKDDO ddo= dsICM.createDDO(pidString);
ddo.retrieve(DKConstant.DK_CM_CONTENT_ITEMTREE +
DKConstant.DK_CM_CONTENT_NO);

DKDatastoreExtICM ext = new DKDatastoreExtICM(dsICM);
if(!ext.isCheckedOut(ddo))
{
ext.checkOut(ddo);
}
setAttrToDDO(ddo, autoClaim);
dsICM.updateObject(ddo, DKConstant.DK_CM_CHECKIN);
dsICM.disconnect();
}

public void delete(String pidString) throws DKUsageError, DKException, Exception
{
DKDatastoreICM dsICM = SConnectDisconnectICM.connect();
DKDDO ddo = dsICM.createDDO(pidString);
ddo.del();
dsICM.disconnect();
}

public void setAttrToDDO(DKDDO ddo, AutoClaim autoClaim) throws DKUsageError

{
if(autoClaim.getClaimID()!=null)

ddo.setData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,"ClaimID"),
autoClaim.getClaimID());

if(autoClaim.getClaimStatus()!=null)

ddo.setData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,"ClaimStatus"),
autoClaim.getClaimStatus());
if(autoClaim.getOpeningDate()!=null)

ddo.setData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,"OpeningDate"),

autoClaim.getOpeningDate());
if(autoClaim.getClaimAmount()!=null)

ddo.setData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,"ClaimAmount"),

autoClaim.getClaimAmount());
if( autoClaim.getEventID() != null )
ddo.setData( ddo.dataId( DKConstant.DK_CM_NAMESPACE_ATTR,
"EventID" ),
autoClaim.getEventID() );
}

public void setValueToAutoClaim(DKDDO ddo, AutoClaim autoClaim)
throws DKUsageError
{
Object attr = null;
attr = ddo.getData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,
"ClaimID"));
if(attr!=null)
{
autoClaim.setClaimID((String)attr);
attr = null;

}
attr = ddo.getData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,
"ClaimStatus"));
if(attr!=null)
{
autoClaim.setClaimStatus((Integer)attr);
attr = null;
}
attr = ddo.getData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,
"OpeningDate"));
if(attr!=null)
{
autoClaim.setOpeningDate((String)attr);
attr = null;
}
attr = ddo.getData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,
"ClaimAmount"));
if(attr!=null)
{
autoClaim.setClaimAmount((Integer)attr);
attr = null;
}
attr = ddo.getData(ddo.dataId(DKConstant.DK_CM_NAMESPACE_ATTR,
"EventID"));
if(attr!=null)
{
autoClaim.setEventID( (String) attr );
attr = null;
}
}

}


Đối với các lớp khác trong biểu đồ lớp, có các lớp Java tương tự như
AutoPolicy.java và AutoPolicyDAO.java. Bạn có thể tải về dự án Eclipse có chứa
tất cả mã nguồn của lớp Java này.


Triển khai thực hiện lớp cổng cho các thực thể nghiệp vụ Java
Bây giờ bạn đã có một tập hợp các thực thể nghiệp vụ Java và cũng có rất nhiều
phương thức hoạt động trong các thực thể này. Nhưng trong phần FileNet
Component Integrator (Nhà tích hợp thành phần FileNet), một hàng đợi thành
phần chỉ có thể trưng ra một phương thức của lớp Java. Và bạn nên tuân theo các
quy tắc sau đây:
 Lớp phải có một hàm tạo không có bất kỳ tham số nào.
 Các phương thức phải được công khai.
 Các phương thức có thể chỉ chứa các kiểu tham số hoạt động thành phần
cho phép. Hãy tham chiếu các kiểu tham số hoạt động thành phần.
Nếu bạn muốn tương tác với nhiều lớp Java từ một ứng dụng của bên thứ ba và
muốn đăng ký chỉ có một hàng đợi thành phần cho ứng dụng này, thì bạn nên bọc
tất cả các phương thức của các lớp Java trong một lớp cổng (gateway). Vì thế với
hệ thống Yêu cầu bồi thường bảo hiểm tự động của Công ty ABC, bạn nên bọc tất
cả các phương thức hoạt động DAO trong một lớp cổng ICMOperation.java
thể hiện trong mã Java sau.

Liệt kê 3. Lớp của trình bao bọc mẫu - ICMOperation.java

public class ICMOperation
{
public void createAutoClaim(String claimID,Integer claimStatus,
String openingDate,Integer claimAmount, String eventID) throws Exception
{
AutoClaim autoClaim = new AutoClaim();
autoClaim.setClaimID(claimID);
autoClaim.setClaimStatus(claimStatus);
autoClaim.setOpeningDate(openingDate);
autoClaim.setClaimAmount(claimAmount);
autoClaim.setEventID( eventID );
AutoClaimDAO dao = new AutoClaimDAO();
dao.create( autoClaim );
}

public Integer retrieveClaimStatusByClaimID(String claimID) throws
Exception
{
AutoClaim autoClaim = getAutoClaim( claimID );
return autoClaim.getClaimStatus();
}

public void updateClaimStatusByClaimID( String claimID, Integer claimStatus
)
throws Exception
{
AutoClaimDAO dao = new AutoClaimDAO();
AutoClaim autoClaim = dao.retrieveAutoClaimByClaimID( claimID );
autoClaim.setClaimStatus( claimStatus );
dao.update( autoClaim );

}

private AutoClaim getAutoClaim( String claimID ) throws Exception
{
return new AutoClaimDAO().retrieveAutoClaimByClaimID( claimID );
}



}




Một cách giải quyết sử dụng các tham số đối tượng Java khác trong Component
Integrator
FileNet P8 Component Integrator (Nhà tích hợp thành phần FileNet P8) chỉ hỗ trợ
một số kiểu tham số nguyên thủy. Nhưng nói chung, một số đối tượng Java luôn
được sử dụng như các tham số trong một phương thức hoạt động. Ở đây, chúng ta
đã giới thiệu một giải pháp để khắc phục hạn chế này: sự tuần tự hóa Java. Hình 3
cho thấy giải pháp này.

Hình 3. Giải pháp tuần tự hóa Java

Khi sử dụng tuần tự hóa Java, bạn có thể tuần tự hóa đối tượng Java ban đầu thành
một chuỗi trong bộ nhớ. Khi bạn cần nhận đối tượng Java ban đầu, bạn có thể
không tuần tự hóa chuỗi đó thành đối tượng Java ban đầu. Hãy lấy
AutoClaimDAO.java làm ví dụ. Nếu bạn muốn sử dụng DTO AutoClaim.java làm
tham số trong các phương thức hoạt động, bạn cần phải viết hai phương thức tiện
dụng. Một phương thức là để tuần tự hóa đối tượng Java AutoClaim thành một

chuỗi, trong khi phương thức kia là không tuần tự hóa chuỗi đó thành đối tượng
Java AutoClaim ban đầu. Các đoạn mã Java dưới đây cho thấy hai phương thức
này.

Liệt kê 4. Mã mẫu về tuần tự hóa và không tuần tự hóa

public AutoClaim parseStringToAutoClaim( String autoClaimString )
throws IOException, ClassNotFoundException
{
ObjectInputStream objInput = null;
try
{
objInput = new ObjectInputStream( new ByteArrayInputStream(
new BASE64Decoder().decodeBuffer( autoClaimString ) ) );
return (AutoClaim) objInput.readObject();
}
finally
if( objInput != null )
{
objInput.close();
}
}
}

public String parseAutoClaimToString( AutoClaim autoClaim ) throws
IOException
{
ByteArrayOutputStream byteOutput = new ByteArrayOutputStream();
ObjectOutputStream objOutput = null;
try

{
objOutput = new ObjectOutputStream( byteOutput );
objOutput.writeObject( autoClaim );
return new BASE64Encoder().encode( byteOutput.toByteArray() );
}
finally
{
byteOutput.close();
if( objOutput != null )
{
objOutput.close();
}
}
}


Sau đó bạn nên làm cho AutoClaim có thể tuần tự hóa được. Điều cần thiết duy
nhất là để cho AutoClaim triển khai thực hiện giao diện java.io.Serializable. Mã
sau đây cho thấy AutoClaim có thể tuần tự hóa.

Liệt kê 5. Mã mẫu triển khai thực hiện tuần tự hóa

public class AutoClaim implements Serializable{
private static final long serialVersionUID = 4599855634813333505L;

}

Bây giờ bạn có thể đăng ký phương thức sử dụng chuỗi để biểu diễn đối tượng
Java. Và trong ứng dụng khách, bạn nên sử dụng phương thức không tuần tự hóa
để nhận đối tượng Java ban đầu. Hãy xem đoạn mã sau. Chúng ta sử dụng một

phương thức trong lớp ICMOperation đã đăng ký để lấy ra đối tượng Java
AutoClaim. Sau khi có kết quả, đầu tiên sử dụng phương thức tuần tự hóa để tuần
tự hóa đối tượng Java AutoClaim thành một đối tượng chuỗi, sau đó trả về chuỗi
cho một máy khách. Một khi máy khách nhận được chuỗi đó, sử dụng phương
thức không tuần tự hóa để không tuần tự hóa chuỗi đó thành một đối tượng
AutoClaim.

Liệt kê 6. Mã mẫu xem xét xung quanh sự hạn chế tham số

public String retrieveAutoClaimByClaimID( String claimID ) throws Exception

{
AutoClaim autoClaim = getAutoClaim( claimID );
return new AutoClaimDAO().parseAutoClaimToString( autoClaim );
}


Bây giờ chúng ta có các thực thể nghiệp vụ Java và một lớp cổng Java trưng ra tất
cả các phương thức hoạt động. Bạn có thể tải về tất cả các mã nguồn trong một dự
án Java của Eclipse. Lưu ý rằng mức tuân thủ của trình biên dịch nên được đặt là
1.4 khi tạo các tệp jar tương ứng do sự tương thích của nhà tích hợp thành phần.


Kết luận
Trong Phần 2 của loạt bài này, bạn đã xem xét các trình diễn công việc của
FileNet và đã thấy trình diễn công việc dựa trên nhà tích hợp thành phần chi tiết.
Bạn đã tạo ra các thực thể nghiệp vụ Java và đã chuẩn bị một lớp cổng Java.
Chúng ta cũng đã giới thiệu một giải pháp để vượt qua sự hạn chế tham số của nhà
tích hợp thành phần của FileNet.
Phần 3 mô tả cách triển khai thực hiện các trình diễn công việc cho hệ thống yêu

cầu bồi thường bảo hiểm tự động của Công ty ABC.