TẬP ĐOÀN VIỄN THÔNG QUÂN ĐỘI

Hệ thống Bankplus
TÀI LIỆU HƯỚNG DẪN SỬ DỤNG
THƯ VIỆN KẾT NỐI

Người lập: LÊ ĐỨC TÙNG

Hà Nội, tháng 11/2011

Hướng dẫn sử dụng thư viện Bankplus

I. Mô tả tổng quan
Tài liệu nhằm mục đích hướng dẫn người dùng sử dụng thư viện kết nối đến hệ thống
Bankplus theo đặc tả giao tiếp ISO8583:1987
II. Hướng dẫn chi tiết
1. Tài liệu đặc tả
Thông tin về đặc tả được mô tả trong file ISO8587-VT.xml
2. Tích hợp thư viện
Ngoài thư viện chính BankplusComumication, cần các thư viện được liệt kê dưới đây:

3. Tạo ra một lớp thực thi đại diện cho CLIENT

public static void main(String[] args) {

BasicConfigurator.configure();
Config.ISO_XML_PATH = "C:/etc/ISO8587-VT.xml";
try {
BankplusClient client = new BankplusClient("127.0.0.1",
8787);
client.start();
BankplusIsoObject obj = new BankplusIsoObject();
obj.setMTI("0400");
obj.setProcessCode("600000");
obj.setRequestId("1");
client.sendMsg(obj);
BankplusIsoObject res =
IoHandlerAdapter.getResponseObject(obj.getRequestId(), 100, 1000);

2/4
Hướng dẫn sử dụng thư viện Bankplus

System.out.println(res.getResponseCode());
} catch (ISOException ex) {
System.out.println(ex);
}
}

Trong ví dụ này, đối tượng obj có kiểu BankplusIsoObject. Đây chính là đối tượng bản
tin ISO. Các phương thức set của lớp này làm nhiệm vụ gán các giá trị cho các trường bản
tin tương ứng.
Để gửi bản tin đi, sử dụng phương thức sendMsg(), tham số là đối tượng obj (bản tin ISO)
Để nhận bản tin từ SERVER gửi về, sử dụng phương thức static getResponseObject() với
tham số truyền vào lần lượt là
• REQUEST_ID của bản tin đã gửi
• Thời gian đợi lấy bản tin (ms)
• Số lần quét hàng đợi bản tin trả lời
Chú ý: Chỉ đường dẫn đến file XML

4. Tạo lớp thực thi đại diện cho SERVER

public static void main(String[] args) {

BasicConfigurator.configure();
Config.ISO_XML_PATH = "C:/etc/ISO8587-VT.xml";
BankplusServer server = new BankplusServer(8787, new
ServerHandler());
server.start();
}

Đối tượng SERVER được viết trong lớp BankplusServer. Tạo một instance của đối tượng
này ta có một SERVER lắng nghe bản tin ISO

Để khởi động một SERVER lắng nghe bản tin ISO sử dụng phương thức start().

5. Tạo ra một lớp xử lý nghiệp vụ tại SERVER

package com.viettel.bankplus.lib.handler;

3/4
Hướng dẫn sử dụng thư viện Bankplus

import com.viettel.bankplus.bean.BankplusIsoObject;
import org.apache.mina.core.session.IoSession;
public class ServerHandler extends IoHandlerAdapter {

@Override
public void messageReceived(IoSession session, Object obj) throws
Exception {
if (obj instanceof BankplusIsoObject){
BankplusIsoObject res = (BankplusIsoObject)obj;
res.setResponseCode("00");
session.write(obj);
}
}
}

Mọi xử lý của SERVER viết trong phương thức messageReceived()

Để gửi bản tin về cho CLIENT, sử dụng phương thức session.write()

4/4