Viết mã thú vị với các API FileNet P8 của IBM, Phần 1 pps

Viết mã thú vị với các API FileNet P8 của IBM, Phần 1: Hello, Document!

Bắt đầu với chương trình FileNet P8 đầu tiên của bạn

Bill Carpenter, Kiến trúc sư phần mềm ECM, IBM

Tóm tắt: Bài viết này giúp bạn khởi đầu bằng việc phát triển một ứng dụng đơn

giản, HelloDocument, với FileNet® P8 Content API (API Nội dung FileNet P8)

của IBM®. Thông qua một chuỗi các hoạt động đơn giản, hãy tìm hiểu cách sử

dụng các mô hình mã hóa để thực hiện một loạt các hoạt động riêng của bạn. Các

API P8 có thể mở rộng và để biết cách khởi đầu cần có một chút khéo léo với

những người mới bắt đầu. Bài viết này cung cấp cho bạn sự khởi đầu đó: một định

hướng và bệ phóng mà từ đó bạn có thể dễ dàng xây dựng các ứng dụng riêng của

mình. Thậm chí nếu bạn đã quen với việc phát triển P8, chắc chắn bạn sẽ tìm thấy

thông tin có ích trong bài viết này và các bài viết tiếp theo trong loạt bài này. Các

bài viết trong sắp tới trong loạt bài này đi sâu hơn về các chủ đề cụ thể trong cả hai

API quy trình và API nội dung.

Hãy làm quen với HelloDocument

Bộ e-kit (dụng cụ-điện tử) DB2 của IBM cho các người chuyên nghề cơ sở dữ

liệu

Tìm hiểu cách dễ dàng để được đào tạo và được cấp chứng chỉ với DB2 cho

Linux, UNIX và Windows với bộ e-kit DB2 của IBM cho những người chuyên

nghề cơ sở dữ liệu. Hãy đăng ký ngay bây giờ và mở rộng danh mục các kỹ năng

của bạn hoặc mở rộng sự hỗ trợ của nhà cung cấp DBMS của bạn để bao gồm cả

DB2.

Bài viết này cung cấp cho bạn một tổng quan về một ứng dụng FileNet P8 của

IBM đầy đủ, độc lập. P8 là một nền tảng của IBM về Quản lý nội dung doanh

nghiệp (ECM-Enterprise Content Management). Mặc dù hầu hết các chương trình

P8 trong thế giới thực là một phần của một khung công tác lớn hơn như J2EE hay

.Net, là một nhà phát triển, nhiều khả năng điểm bắt đầu có thể của bạn là một

chương trình độc lập. Bằng cách sử dụng một chương trình độc lập, bạn có thể tập

trung vào các chi tiết P8 mà không cần phải tập trung vào sự phức tạp của khung

công tác lớn hơn.

Ứng dụng ví dụ HelloDocument thực hiện một số nhiệm vụ, một số trong đó bạn

có thể không cần biết về nó, tuy nhiên, bạn có thể muốn làm một điều riêng biệt

nào đó trong ứng dụng đó. Ngoài ra, bạn có thể sử dụng các kỹ thuật được minh

họa trong mã này và mở rộng chúng để làm những việc phù hợp hơn với các

trường hợp sử dụng của mình. Có lẽ cũng quan trọng không kém, một khi bạn có

HelloDocument đang chạy, bạn có thể tự tin rằng môi trường của bạn được cấu

hình đúng. Điều này cho phép bạn sau đó tập trung vào các chi tiết ứng dụng của

mình mà không còn vương vấn nghi ngờ về môi trường của bạn nữa.

Để hiểu bài viết này, bạn cần có một sự hiểu biết cơ bản về Java™ và có thể làm

theo các mô tả của mã nguồn Java. Bài viết này không mô tả tất cả các dòng mã

của HelloDocument.java mà, thay vào đó, đi vào những điểm nổi bật để minh họa

các quan điểm API của Máy nội dung (CE-Content Engine). Mã này có rất nhiều

chú thích và nếu bạn thích phiêu lưu, bạn có thể bỏ qua bài viết này và đi ngay vào

chính mã nguồn của nó (xem phần Tài nguyên).

HelloDocument được cấu trúc như một tệp nguồn Java duy nhất có 400-500 dòng.

Thậm chí khi tính đến nhiều chú thích trong mã nguồn, vẫn còn rất nhiều dòng chỉ

để làm quen. Có một số thứ trong HelloDocument.java mà bạn muốn di chuyển

vào các lớp hoặc các tệp nguồn riêng biệt . Chúng được trình bày tất cả ở một chỗ

duy nhất để cho bạn có thể chắc chắn là bạn có mọi thứ. Ví dụ, chuỗi đăng nhập

Dịch vụ xác thực và ủy quyền Java (JAAS) đầy đủ, bao gồm một lớp bên trong xử

lý các cuộc gọi lại, được bao gồm trong tệp nguồn HelloDocument.java. Điều đó

chắc chắn sẽ là một sự lựa chọn khác thường với một ứng dụng thực tế. Lớp

HelloDocument triển khai thực hiện giao diện PrivilegedAction và gói hầu hết

logic nghiệp vụ của mình bên trong một phương thức chạy chỉ để dễ dàng minh

họa mô hình đăng nhập JAAS rõ ràng. Logic nghiệp vụ cho HelloDocument hóa

ra không quá 50 -100 dòng.

Bài viết này được viết khi bản phát hành hiện tại trong lĩnh vực này đã là P8 4.0.1

và P8 4.5.0 đã đến cuối chu kỳ phát triển của nó. Mã này chạy được trong cả hai

bản phát hành. (Bài viết này và các bài viết khác trong loạt bài này không dành

nhiều thời gian cho các API từ P8 3.x. Trong một số trường hợp, các API này là

hoàn toàn khác nhau). Vì các lớp API và các phương thức được dùng làm lõi cho

các API, chúng rất ổn định. Nhiều khả năng là HelloDocument sẽ chạy mà không

cần thay đổi gì trong một số chu kỳ phát hành P8 sắp tới. HelloDocument được

viết bằng Java. Vì API của Content Java P8 khác với API của Content .Net P8 chủ

yếu trong quy ước đặt tên và các lý do phụ khác, nên để viết lại HelloDocument

bằng một ngôn ngữ .Net giống như C# sẽ chỉ là một việc chuyển chữ đơn giản.

(Trong lĩnh vực xác thực có sự không giống nhau giữa hai API. Mặc dù bài viết

này bàn về xác thực Java cho HelloDocument, nhưng việc thảo luận chung về xác

thực nằm ngoài phạm vi của bài viết này.)

Vậy thì, HelloDocument thực sự làm cái gì? Nó tạo ra một tài liệu, tải nội dung từ

một tệp lên, kiểm tra tệp và đặt tệp đó trong một thư mục. Sau đó nó đọc lại tệp đó

và so sánh nội dung được tải về với nội dung tệp gốc. Theo tùy chọn, bạn có thể

cấu hình ứng dụng để bỏ qua một phần của tệp trong quá trình tải về và so sánh.

Mặc dù việc tạo và lưu các tài liệu thành tệp là phổ biến cho nhiều trường hợp sử

dụng, nhưng lại không có các bước so sánh. Trong thực tế, bạn chưa bao giờ phải

kiểm tra nội dung mà bạn đã tải lên. Các phần bổ xung trong khi tải về chỉ có

nghĩa minh họa một số khía cạnh viết mã API. HelloDocument được thiết kế để

cho bạn không phải làm bất kỳ thiết lập cụ thể nào trong Máy nội dung (CE) trước