Berkenalan dengan ISO 8583 Menggunakan Java
License Redistribution and use in textual and binary forms, with or without modification, are permitted provided Redistribution that the following conditions are met: 1. Redistributions of this book must retain the above copyright notice, this list of conditions and the following disclaimer. 2. The names of the authors may not be used to endorse or promote products derived from this book without specific prior written permission. THIS BOOK IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS BOOK, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Published by Martinus Ady H on November 9th, 2010
Tentang Buku Ini
Latar Belakang Pembaca
Pembaca diasumsikan telah memahami dasar-dasar pemrograman Java dan pemrograman jaringan pada Java menggunakan Socket. Konsep CLASSPATH juga harus dimengerti. Buku ini tidak mewajibkan editor tertentu. Pembaca diharapkan sudah mahir mengoperasikan editor favoritnya masing-masing dan tahu bagaimana meletakkan kode program dan pustaka (jar) yang digunakan pada tempat yang benar.
Aturan Penulisan
Beberapa aturan penulisan yang digunakan pada buku ini kurang lebih sebagai berikut :
Penulisan Kode Program
Seluruh kode program maupun isi file konfigurasi pada buku ini ditulis seperti dibawah ini :
Perintah Command Prompt
Sedangkan perintah command prompt ditulis dengan menggunakan huruf seperti dibawah ini : mkdir coba
Output Eksekusi Perintah
Output dari hasil eksekusi perintah pada command prompt terlihat seperti dibawah ini :
Penulisan Nama File Untuk penulisan nama file yang digunakan pada buku ini ditandai dengan huruf yang berwarna
hijau seperti berikut : /etc/rc.d/rc.httpd
Catatan Beberapa bagian pada buku ini mungkin berisi dengan catatan-catatan khusus. Catatan pada buku ini dibagi menjadi beberapa bagian yaitu :
1. Bahaya, biasanya catatan ini muncul untuk menghindari menghindari penggunaan perintah
atau suatu aksi yang mempunyai akibat sangat fatal. Tampilan dari catatan bahaya ini contohnya adalah seperti dibawah ini : - Jangan mengetikkan perintah rm -rf / pada sistem operasi GNU/Linux atau Unix anda, jika tidak ingin semua data anda hilang. 2. Tips, biasanya catatan ini muncul untuk memberitahu cara tercepat atau shortcut dari suatu perintah. Sedangkan tampilan dari catatan tips ini adalah seperti dibawah ini : - Ketikkan perintah cd ~/ untuk menuju ke /home direktori anda secara cepat. 3. Informasi, catatan ini digunakan untuk menunjukkan referensi saja.
Pendahuluan
Supaya memudahkan pemahaman, pada tulisan ini penulis akan mencoba menjelaskan tahap demi tahap kepada para pembaca. Dimulai dari perkenalan apa itu ISO ( International Organization for Standardization) 8583, pengenalan format data atau pesan ( message) pada ISO 8583, bagaimana membuat sebuah implementasi sederhana ISO 8583 dalam bahasa pemrograman Java menggunakanServerSocket menggunaka nServerSocket dan Socket sampai bagaimana membuat sebuah implementasi ISO 8583 8 583 dengan menggunakan pustaka (library ) jPOS. Sebagai awal pembahasan, pada bab ini kita akan membahas topik-topik dasar yaitu :
Apa Itu ISO 8583 ?
Apa itu ISO 8583 ? ISO 8583 ini adalah sebuah standart internasional untuk transaksi finansial. Dan standart atau protokol ini sudah sejak lama digunakan oleh perbankan untuk menjembatani komunikasinya (walaupun tidak menutup kemungkinan pihak selain bank menggunakan protokol ISO 8583), dengan adanya sebuah standart komunikasi seperti ini maka tidak menutup kemungkinan transaksi dapat tetap dilakukan antar pihak yang terkait walaupun menggunakan sistem atau bahasa pemrograman yang berbeda.
Sedangkan dimana kita dapat melihat penggunaan nyata ISO 8583 ini ? Penggunaan ISO 8583 ini dapat kita lihat secara nyata yaitu pada mesin-mesin EDC seperti dibawah ini :
Selain pada mesin EDC, penggunaan ISO 8583 ini juga banyak diterapkan pada komunikasi antar bank ataupun antara Switcher dengan Biller.
Tipe Message ISO 8583
ISO 8583 ini sebenarnya dibagi menjadi 3 buah komponen yaitu :
1. Message Header, ini dapat digunakan sebagai penanda awal dari sebuah message. 2. Application Data, ini adalah inti dari ISO 8583. Semua format dan definisi message terdapat pada bagian ini. 3. Message Trailer, ini dapat digunakan sebagai penanda akhir dari sebuah message. dan jika digambarkan, struktur diatas akan terlihat seperti gambar dibawah ini untuk sebuah message lengkap ISO 8583 :
Dalam beberapa kasus, kadang-kadang dalam setiap message kita hanya menjumpai penggunaan Message Header atau Message Trailer saja. Penggunaan Message Header dan Message Trailer ini sepenuhnya tergantung pada setiap pihak yang berkepentingan dan harusnya informasi ini tertulis jelas pada dokumen spesifikasi teknis yang telah dimusyawarahkan dan disepakati bersama oleh kedua belah pihak atau lebih.
Karena Message Header dan Message Trailer hanya digunakan sebagai penanda saja, maka sekarang mari kita bahas tentang apa itu Application Data yang terdapat dalam ISO 8583 ini. Sama seperti struktur ISO 8583 diatas, Application Data ini juga dibagi menjadi beberapa bagian yang kurang lebih seperti berikut : 1. MTI (Message Type Indicator ), adalah 4 digit karakter yang digunakan sebagai penanda awal dari message utama ISO 8583. 2. Bitmap, adalah 8 bytes data binari atau 16 digit nilai hexadecimal yang digunakan sebagai penanda bit-bit atau data element mana saja yang aktif. (16 digit disini merupakan panjang standart dari Primary Bitmap saja, silahkan lihat penjelasan pada bab tentang Bitmap). 3. Data Element (DE) , adalah bit-bit yang berisi informasi yang sebenarnya pada transaksi itu sendiri.
Message Type Indicator
Seperti yang sudah dijelaskan pada bab sebelum-nya, MTI (Message Type Indicator ) ini terdiri dari 4 digit karakter yang digunakan sebagai awal message utama ISO 8583 itu sendiri. MTI ( Message Type Indicator ) ini sendiri dibagi menjadi seperti gambar dibawah ini :
Keterangan Tiap Karakter MTI Sebagai contoh sederhana, MTI 0110 bisa dijelaskan seperti dibawah ini :
Keterangan MTI (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Untuk lebih jelasnya, sekarang mari kita masuk kedalam pembahasan tiap-tiap komponen yang terdapat dalam MTI (Message Type Indicator ) beserta contoh-contoh-nya yang akan dijelaskan pada bab-bab dibawah ini :
Versi ISO 8583
Posisi pertama atau digit pertama dari MTI (Message Type Indicator ) ini digunakan sebagai penanda versi ISO 8583 yang digunakan. Sedangkan versi yang terdapat dalam ISO 8583 adalah sebagai berikut :
Versi ISO 8583 (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Message Class
Sedangkan pada posisi kedua atau digit kedua dari MTI (Message Type Indicator ) ini digunakan untuk tujuan apa pesan itu secara keseluruhan. Dan kode atau nilai yang standart digunakan untuk mengisi digit kedua ini dapat dilihat pada gambar dibawah ini :
Keterangan Message Class Pada MTI (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Message Function
Posisi ketiga atau digit ketiga dari MTI (Message Type Indicator ) ini digunakan untuk mendifinisikan fungsi dari sebuah message apakah itu request , response ataupun advice. Dan kode atau nilai yang standart digunakan untuk mengisi digit ketiga ini dapat dilihat pada gambar dibawah ini :
Keterangan Message Function Pada MTI (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Message Origin
Posisi keempat atau digit terakhir dari MTI (Message Type Indicator ) ini digunakan untuk mendefinisikan dari mana message ini berasal (lokasi pengirim pesan). Dan kode atau nilai yang standart digunakan untuk mengisi digit keempat ini dapat dilihat pada gambar dibawah ini :
Keterangan Message Origin Pada MTI (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Contoh Message Type indicator
Setelah mengetahui setiap komponen yang terdapat pada MTI (Message Type Indicator ), sekarang mari kita lihat beberapa contoh MTI (Message Type Indicator ) yang standart digunakan seperti gambar dibawah ini (walaupun tidak semua implementasi MTI ISO 8583 mempunyai arti dan makna yang sama) :
Beberapa Contoh MTI (Diambil dari http://en.wikipedia.org/wiki/ISO_8583)
Bitmap
Seperti yang sudah sedikit dibahas pada bab Tipe Message ISO 8583 didepan, komponen kedua dari Application Data yang terdapat dalam ISO 8583 ini adalah Bitmap. Apasih sebenarnya Bitmap ini ? Bitmap ini adalah sebuah komponen yang mempunyai panjang 16 karakter (atau lebih, tergantung apakah Secondary atau Tertiary Bitmap aktif atau tidak) dalam hexadecimal, dan nilai yang terdapat dalam bitmap ini digunakan untuk me-representasikan field atau Data Element keberapa yang aktif. Sebuah message ISO 8583 kurang lebih pasti mempunyai satu bitmap yang biasa disebut sebagai Primary Bitmap, yang menandakan bahwa Data Element 1 sampai 64 aktif. Sedangkan Secondary Bitmap akan muncul jika Data Element 65 sampai 128 aktif, begitu juga untuk Tertiary/Third Bitmap digunakan jika Data Element 129 sampai 192 aktif walaupun jarang sekali sebuah messagesampai menggunakan Tertiary Bitmap. Bitmap ini bisa merupakan 8 bytes data binari ataupun 16 karakter hexadecimal dari 0-9, A-F pada ASCII atau EBCDIC karakter, sebuah field atau Data Element akan aktif jika nilai bitmap ini bernilai
TRUE (ditandai dengan nilai 1). Sedangkan untuk field atau Data Element yang tidak aktif, akan bernilai FALSE (ditandai dengan nilai 0 [nol]) pada bitmap.
Agar lebih memudahkan penjelasan, sekarang mari kita masuk ke pembahasan yang lebih detail tentang bitmap pada sub-bab dibawah ini :
Cara Menghitung Bitmap
Pada penjelasan sebelum-nya kita sudah mengetahui ciri-ciri sebuah Bitmap, dan untuk kepentingan menghitung sebuah Bitmap ada beberapa poin penting yang harus selalu di ingat ketika ingin membaca atau membuat sebuah Bitmap. Poin-poin penting yang perlu dicatat yaitu :
1.
Ada 3 macam Bitmap, yaitu :
Primary Bitmap, semua message ISO Element yang aktif adalah 1-64.
8583 pasti
mempunyai
ini. Field atau Data
2. Secondary Bitmap, ini digunakan jika field atau Data Element yang aktif adalah 65-128. Ciri-ciri adanya Secondary Bitmap ini adalah bit pertama dari PRIMARY BITMAP pasti bernilai 1 atau TRUE 3. Tertiary/Third Bitmap, ini digunakan jika field atau Data Element yang aktif adalah 129-192. Identitas adanya Tertiary/Third Bitmap ini adalah aktif-nya field atau Data Element ke 65.
Seluruh field atau Data Element yang TIDAK AKTIF AKAN BERNILAI 0 (NOL/FALSE) DAN UNTUK YANG AKTIF AKAN BERNILAI 1 (TRUE)
Bitmap dapat berisi 8 byte data binary, atau
16 karakter hexadecimal (0-9 dan A-F) pada ASCII atau EBCDIC (lihat pada penjelasan informasi dibawah ini)
Untuk mengetahui field atau Data Element mana yang aktif, kita harus mengkonversi nilai hexadecimal ke binary.
Jika dalam 1 message yang aktif hanya Primary Bitmap saja, maka panjang Bitmap tersebut adalah 64 bit. Dimana 8 Byte Primary Bitmap == 64 Bit (Ingat 1 byte = 8 bits) Jika Secondary Bitmap aktif, maka panjang Bitmap akan menjadi 64*2 yaitu 128 bit atau bisa juga disebut menjadi 32 karakter hexadecimal. Begitu juga jika Tertiary Bitmapaktif.
Setelah mengetahui beberapa poin penting dalam menghitung sebuah Bitmap dan sebelum mulai untuk melakukan konversi, ada baiknya kita segarkan dulu pikiran kita kembali ke bangku kuliah yang membahas tentang konversi dari HEXA to BINARY to DECIMAL . Mungkin ada yang masih ingat tentang tabel konversi dibawah ini ?? Karena tabel dibawah ini akan kita jadikan sebagai acuan untuk mengetahui field atau Data Element mana yang aktif :
Tabel Konversi Decimal to HexaDecimal to Binary
Semua perlengkapan sudah siap, sekarang bagaimana jika kita mempunyai sebuah Bitmap seperti ini 5030004100010000 ? Field atau Data Element berapakah yang akan aktif ?? Untuk menghitung-nya, sekarang pecahkan 16 digit nilai Bitmap tersebut menjadi masing-masing 2 digit dan konversikan tiap 1 digit hexadecimal tersebut menjadi sebuah nilai binary seperti dibawah ini :
Hasil Konversi dari HexaDecimal ke Binary
Nah jika sudah, sekarang rangkailah kembali nilai binary yang dihasilkan dari proses konveri dari hexa tersebut secara ber-urutan dari angka 50,30, 00, 41, 00, 01, 00 dan 00 tersebut menjadi seperti gambar dibawah ini :
Rangkaian Bitmap Dalam Binary
Dari gambar diatas, kita sudah bisa mengatahui field atau Data Element mana saja yang aktif. Dan karena pada Bitmap diatas kita tidak melihat adanya Secondary Bitmap maka kita akan melakukan pengecekan dari field ke 1 sampai field ke 64 yang bisa kita lihat seperti dibawah ini :
Dan hasil akhir dari field atau Data Element yang aktif adalah sebagai berikut :
Hasil Akhir Data Element Yang Aktif
Secondary Bitmap
Sekarang, bagaimana caranya untuk mengetahui atau meng-identifikasi adanya Secondary Bitmap ? Seperti yang sudah dijelaskna diatas, cara paling mudah identifikasi-nya yaitu 1 digit setelah 4 digit MTI (karakter pertama dari bitmap), jika dikonversikan ke binary digit awal-nya pasti bernilai 1 (TRUE) dan jika nilai-nya adalah 1 (TRUE) maka panjang Bitmap yang harus diambil adalah 32 karakter untuk keperluan melihat field atau Data Element yang aktif. Sebagai contoh, sekarang mari kita tambahkan beberapa field atau Data Element yang sudah kita ketahui diatas menjadi seperti dibawah ini :
Contoh Data Element Dengan Secondary Bitmap
Setelah mengetahui Data Element yang aktif, sekarang mari kita coba konversikan menjadi sebuah Bitmap dengan mengisi 0 (nol) untuk Data Element yang tidak aktif, dan 1 (satu) untuk Data Element yang aktif. Dan hasil-nya kurang lebih menjadi seperti dibawah ini :
Karena Secondary Bitmap kita aktif, sekarang rubahlah BIT PERTAMA dari Bitmap dibawah ini dengan angka 1 hingga hasil-nya menjadi seperti dibawah ini :
Sekarang dari nilai binary yang sudah kita dapatkan, konversikan menjadi nilai hexadecimal dan kita akan mendapatkan nilai Bitmap yang kurang lebih hasilnya akan seperti gambar dibawah ini :
Bitmap Dengan Secondary Bitmap
Data Element
Data Element Standart ISO 8583
ISO-Defined Data Elements
Diambil dari http://en.wikipedia.org/wiki/ISO_8583
Contoh Menyusun Message Lengkap ISO 8583
Setelah mengetahui apa itu MTI, Bitmap dan Data Element, sekarang mari kita mulai dengan sebuah contoh bagaimana cara menyusun sebuah message ISO 8583 yang lengkap sampai siap untuk dikirimkan ke client/server. Sebagai contoh kita mempunyai tugas untuk membuat sebuah Network Management Request Message yang menggunakan ISO 8583 versi 1993 dengan Data Element yang aktif adalah DE ke3,7,11,12,13,48 dan 70 dengan konfigurasi tiap-tiap Data Element adalah sebagai berikut :
Tahapan yang perlu dilakukan yaitu adalah :
Pembuatan Message Type Identifier, yang diminta adalah Network Management Request
Message dengan versi 1993. Jadi nilai MTI yang cocok adalah sebagai berikut : 1800 dengan penjelasan :
Digit pertama bernilai 1 (satu) berarti menggunakan versi 1993 dari ISO 8583
Digit kedua bernilai 8 (delapan) berarti Network Management Message
Digit ketiga bernilai 0 (nol) berarti Request
Digit keempat bernilai 0 (nol) berarti ini adalah Acquirer
Pembuatan Bitmap, pembuatan Bitmap dapat dilakukan dengan cara sebagai berikut :
Konversi Data Element 3,7,11,12,13,48 dan 70 menjadi binary dengan cara sebagai berikut :
Karena Secondary Bitmap aktif (adanya Data Element ke 70), maka ganti nilai bit pertama bitmap dengan nilai 1 (satu) seperti dibawah ini :
Konversi nilai 1010001000111000000000000000000000000000000000010000000000000000000001000 0000000000000000000000000000000000000000000000000000000menjadi nilai hexadecimal dengan cara sebagai berikut :
Dari hasil konversi dari binary ke hexadecimal, didapatkan nilai Bitmap sebagai berikut : A2380000000100000400000000000000
Pengabungan Data Element , sedangkan penggabungan nilai Data Element menghasilkan nilai sebagai berikut 123456201009141234560110300914009ECHO TEST001
:
Setelah semua proses perhitungan selesai dilakukan, sekarang mari kita gabungkan antara MTI, BITMAP dan Application Data menjadi satu yang hasil akhirnya adalah seperti dibawah ini : 1800A2380000000100000400000000000000123456201009141234560110300914009ECHO TEST001
Implementasi Menggunakan Java
Nah setelah kita mengetahui format message ISO 8583, sekarang bagaimana mengimplementasikan-nya pada bahasa pemrograman Java ? Sebelum kita menulis kode, yang harus kita lakukan pertama kali yaitu adalah menyusun spesifikasi yang akan kita gunakan untuk berkomunikasi. Pada kenyataan-nya, spesifikasi ini sangat penting peranan-nya dan ada kemungkin tiap vendor mempunyai spesifikasi yang berbeda antara satu dengan yang lain. Sebagai catatan, perhatikan betul-betul spesifikasi yang sudah disepakati bersama. Dan sekarang, bagaimanakah cara membuat sebuah spesifikasi untuk message ISO 8583 dan implementasi-nya pada bahasa pemrograman Java akan kita bahas pada bab-bab dibawah ini :
Pembuatan Spesifikasi Message Network Management
Agar komunikasi antara server dan client dapat berjalan dengan sukses, maka diperlukan sebuah kesepakatan yang harus ditaati oleh kedua belah pihak. Beberapa persyaratan tersebut yaitu mencakup tentang :
Message Protokol, protokol yang akan digunakan dalam contoh kasus ini adalah ISO 8583:1993 yang ditandai dengan angka 1 (satu) pada MTI (Message Type Indicator) .
Connection Type, mode koneksi yang akan digunakan adalah mode connectionoriented dimana client membuka koneksi ke server sekali dan mengirimkan banyak message (connect once -> many transaction)
Message System, untuk seluruh message yang dikirimkan ke server harus menggunakan 4 bit header sebagai penanda panjang message yang dikirimkan
Dan dibawah ini adalah format message Network Management Request/Response : NETWORK MANAGEMENT REQUEST
Message Type Identifier : 1800
Sender : Client
Purpose : Request network management action to Server
NETWORK MANAGEMENT RESPONSE
Message Type Identifier : 1810
Sender : Server
Purpose : Response network management action for Client
Pembuatan spesifikasi untuk message Network Management sudah selesai, sekarang mari kita implementasikan dengan membuat sebuah aplikasi server-nya dahulu.
Pembuatan Aplikasi Server
Sekarang buatlah sebuah project Java biasa pada NetBeans IDE dan berilah nama project tersebut contohnya Implementasi, dan buatlah sebuah package dahulu dengan nama id.web.martinusadyh.iso8583.helper. Didalam package yang telah kita buat, buatlah sebuah helper class dengan nama DecimalHexBinaryConverter.java yang mempunyai fungsi sebagai konverter ketika kita ingin menghitung nilai Bitmap yang kurang lebih seperti kode dibawah ini :
id.web.martinusadyh.iso8583.helper.DecimalHexBinaryConverter.java
package id.web.martinusadyh.iso8583.helper; public class DecimalHexBinaryConverter { public static String decimalToHexa(Integer decimalNumber) { return Integer.toHexString(decimalNumber); } public static String decimalToBinary(Integer decimalNumber) { StringBuilder binaryNumber = new StringBuilder(); StringBuilder sbBinary = new StringBuilder(); String binaryString = Integer.toBinaryString(decimalNumber); char[] binary = binaryString.toCharArray(); int counter = 0; // ambil dari index karakter terakhir for (int i=binary.length-1; i>=0; i--) { counter++; sbBinary.append(binary[i]); // reset counter ke nol jika berhasil mengambil 4 digit karakter if (counter == 4) counter = 0; } // 4 adalah panjang karakter tiap blok di binary // ex: dec [100] == binary [0110 0100] for (int i=0; i<4-counter; i++) { if (counter > 0) sbBinary.append("0"); } // sekarang dibalik for (int i=sbBinary.length()-1; i>=0;i--) { binaryNumber.append(sbBinary.toString().charAt(i)); } return binaryNumber.toString(); } public static Integer binaryToDecimal(String binaryNumber) {
return Integer.parseInt(binaryNumber, 2); } public static String binaryToHexa(String binaryNumber) { return decimalToHexa(binaryToDecimal(binaryNumber)); } public static Integer hexaToDecimal(String hexaNumber) { return Integer.parseInt(hexaNumber, 16); } public static String hexaToBinary(String hexaNumber) { return decimalToBinary(hexaToDecimal(hexaNumber)); } } Setelah selesai membuat konverter dari HexaToBinary dan sebalik-nya, sekarang buatlah sebuah Helper Class lagi yang fungsinya kali ini lebih berkaitan dengan field-field yang terdapat dalam format ISO 8583 seperti mencari panjang bitmap yang sebenar-nya, mencari data element yang aktif dalam sebuah message dan lain-lain. Sekarang buatlah sebuah Java Class dengan nama ISOUtildidalam package id.web.martinusadyh.iso8583.helper yang isinya kurang lebih adalah sebagai berikut :
id.web.martinusadyh.iso8583.helper.ISOUtil.java
package id.web.martinusadyh.iso8583.helper; public class ISOUtil { /** Mencari panjang dari Bitmap 16 karakter atau 32 karakter, jika bit pertama * nilai-nya == 1 (active/TRUE) maka secondary bitmap active dan otomatis * panjang bitmap menjadi 32 karakter. * @param originalMsg message asli ISO beserta dengan MTI-n ya * @return panjang bitmap yang harus di potong / diambil. */ public static Integer findLengthOfBitmap(String originalMsg) { // ambil 1 digit bitmap setelah MTI String bitPertama = originalMsg.substring(4,5); int panjangBitmap = 0; // cek nilai binary-nya if (DecimalHexBinaryConverter.hexaToBinary(bitPertama).substring(0, 1).equalsIgnoreCase("1")) { panjangBitmap = 32; } else { panjangBitmap = 16; }
return panjangBitmap; } public static String getHexaBitmapFromActiveDE(int[] activeDE) { StringBuilder finalHexaBitmap = new StringBuilder(); StringBuilder binaryBitmapForReply = new StringBuilder(); boolean secondarBitmapActive = false; int panjangBitmap = 16; // pengecekan secondary bitmap for (int i=0; i
64) { secondarBitmapActive = true; panjangBitmap = 32; } } // x4 untuk mendapatkan jumlah seluruh data elemen panjangBitmap *= 4; int counterBitmap=0; String active = ""; for (int i=0;i
sb = new StringBuilder(); counter=0; } } return finalHexaBitmap.toString(); } public static String findMTI(String findMTI(String originalMsg) { return originalMsg.substring(0, 4); } public static String findBinaryBitmapFromHexa(String findBinaryBitmapFromHexa(String hexaBitmap) { StringBuilder binaryBitmap = new StringBuilder(); StringBu ilder(); char[] rawBitmap = hexaBitmap.toCharArray(); for (int i=0; i
id.web.martinusadyh.iso8583.socket.ServerISO.java
package id.web.martinusadyh.iso8583.socket; import id.web.martinusadyh.iso8583.helper.ISOUtil; import java.io.IOException; import java.io.InputStreamReader; import java.io.PrintWriter; import java.net.ServerSocket; import java.net.Socket; import java.util.HashMap; import java.util.Map; /** * * @author Martinus Ady H */ public class ServerISO { private static final Integer PORT = 12345; private static final Map Integer> mappingDENetworkMsg = new HashMap(); /* Method ini berfungsi untuk menginisialisasi data element dan panjan g tiap * -tiap data element yang aktif */ private static void initMappingDENetworkRequest() { /* [data-element] [panjang data element] */ mappingDENetworkMsg.put("3", 6); mappingDENetworkMsg.put("7", 8); mappingDENetworkMsg.put("11", 6); mappingDENetworkMsg.put("12", 6); mappingDENetworkMsg.put("13", 4); mappingDENetworkMsg.put("39", 3); mappingDENetworkMsg.put("48", 999); mappingDENetworkMsg.put("70", 3); } /** * @param args the command line arguments */ public static void main(String[] args) throws IOException { initMappingDENetworkRequest(); ServerSocket serverSocket = new ServerSocket(PORT); System.out.println("Server siap menerima koneksi pada port ["+PORT+"]"); Socket socket = serverSocket.accept(); InputStreamReader inStreamReader = new InputStreamReader(socket.getInputStream()); PrintWriter sendMsg = new PrintWriter(socket.getOutputStream() PrintWriter(socket.getOutputStream()); );
int data; StringBuffer sb = new StringBuffer(); int counter = 0; // tambahan 4 karakter karena msg header adalah 4 digit msg length int lengthOfMsg = 4; while((data = inStreamReader.read()) != 0) { counter++; sb.append((char) data); if (counter == 4) lengthOfMsg += Integer.valueOf(sb.toString()); // klo panjang msg dari MTI sampai END OF MSG sama dengan nilai // header maka lanjutkan ke method processingMsg(); if (lengthOfMsg == sb.toString().length()) { System.out.println("Rec. Msg ["+sb.toString()+"] len ["+sb.toString().length() ["+sb.toString().length()+"]"); +"]"); processingMsg(sb.toString(), sendMsg); sendMsg); } } } /** Memproses msg yang dikirim oleh client berdasarkan nilai MTI. * @param data request msg yang berisi be risi [header 4byte][MTI][BITMAP][DATA ELEMENT] ELEMENT] * @param sendMsg object printWriter untuk menuliskan msg ke network stream */ private static void processingMsg(String processingMsg(String data, PrintWriter sendMsg) { // msg.asli tanpa 4 digit msg.header String origMsgWithoutMsgHeader = data.substring(4, data.length()); // cek nilai MTI if (ISOUtil.findMTI(origMsgWithoutMsgHeader).equalsIgnoreCase("1800")) { handleNetworkMsg(origMsgWithoutMsgHeader, handleNetworkMsg(origMsgWithoutMs gHeader, sendMsg); } } /** Method ini akan memproses network management request dan akan menambahkan * 1 data element yaitu data element 39 (response code) 000 ke client/sender * @param networkMsg request msg yang berisi [header 4b yte][MTI][BITM yte][MTI][BITMAP][DATA AP][DATA ELEMENT] * @param sendMsg object printWriter untuk menuliskan msg ke network stream */ private static void handleNetworkMsg(String networkMsg, PrintWriter PrintWriter sendMsg) { int panjangBitmap = ISOUtil.findLengthOfBitmap(networkMsg); String hexaBitmap = networkMsg.substring(4, 4+panjangBitmap); // hitung bitmap String binaryBitmap = ISOUtil.findBinaryBitmapFromHexa(hexaBitmap) ISOUtil.findBinaryBitmapFromHexa(hexaBitmap);;
String[] activeDE = ISOUtil.findActiveDE(binaryBitmap).split(";"); StringBuilder networkResp = new StringBuilder(); // setting MTI untuk reply network request networkResp.append("1810"); // untuk reply, DE yang aktif adalah DE[3,7,11,12,13,39,48 dan 70] String bitmapReply = ISOUtil.getHexaBitmapFromActiveDE(new int[] {3,7,11,12,13,39,48, 70}); networkResp.append(bitmapReply); // index msg dimulai dr (4 digit MTI+panjang bitmap = inde x DE ke 3) int startIndexMsg = 4+ISOUtil.findLengthOfBitmap(networkMsg); int nextIndex = startIndexMsg; String sisaDefaultDE = ""; // ambil nilai DE yang sama dulu for (int i=0;i
// ambil dulu var.len utk DE 48 int varLen = Integer.valueOf(networkMsg.substring(startIndexMsg, (startIndexMsg+3))); // 3 digit utk variabel len varLen += 3; nextIndex += varLen; sisaDefaultDE += networkMsg.substring(startIndexMsg, nextIndex); debugMessage(48, networkMsg.substring(startIndexMsg, nextIndex)); } else if(activeDE[i].equalsIgnoreCase("70")) { startIndexMsg = nextIndex; nextIndex += mappingDENetworkMsg.get(activeDE[i]); sisaDefaultDE += networkMsg.substring(startIndexMsg, nextIndex); debugMessage(70, networkMsg.substring(startIndexMsg, nextIndex)); } } // kasih response kode 39 success networkResp.append("000"); // tambahkan sisa default DE networkResp.append(sisaDefaultDE); // tambahkan length 4 digit utk msg.header String msgHeader = ""; if (networkResp.length() < 10) msgHeader = "000" + networkResp.length(); if (networkResp.length() < 100 && networkResp.length() >= 10) msgHeader = "00" + networkResp.length(); if (networkResp.length() < 1000 && networkResp.length() >= 100) msgHeader = "0" + networkResp.length(); if (networkResp.length() >= 1000) msgHeader = String.valueOf(networkResp.length()); String finalMsg = msgHeader + networkResp.toString(); // send to client sendMsg.print(finalMsg); sendMsg.flush(); } private static void debugMessage(Integer fieldNo, String msg) { System.out.println("["+fieldNo+"] ["+msg+"]"); } } Sampai disini proses pembuatan implementasi Server ISO 8583 kita sudah selesai, sekarang mari kita lanjutkan dengan membuat implementasi untuk client-nya.
Pembuatan Aplikasi Client
Penulisan kode untuk implementasi client ini lebih mudah, karena kita hanya akan mencoba mengirimkan request message saja. Sekarang mari kita buat sebuah Java Class dengan namaClientISO.java yang kode-nya seperti dibawah ini :
id.web.martinusadyh.iso8583.socket.ClientISO.java
package id.web.martinusadyh.iso8583.socket; import id.web.martinusadyh.iso8583.helper.ISOUtil; import java.io.IOException; import java.io.InputStreamReader; import java.io.PrintWriter; import java.net.Socket; import java.net.UnknownHostException; import java.text.SimpleDateFormat; import java.util.Date; /** * * @author Martinus Ady H */ public class ClientISO { private final static Integer PORT_SERVER = 12345; /** * @param args the command line arguments */ public static void main(String[] args) throws UnknownHostException, IOException { Socket clientSocket = new Socket("localhost", PORT_SERVER); String networkRequest = buildNetworkReqMessage(); PrintWriter outgoing = new PrintWriter(clientSocket.getOutputStream()); InputStreamReader incoming = new InputStreamReader(clientSocket.getInputStream()); outgoing.print(networkRequest); outgoing.flush(); int data; StringBuffer sb = new StringBuffer(); int counter = 0; // tambahan 4 karakter karena msg header adalah 4 digit msg length int lengthOfMsg = 4; while((data = incoming.read()) != 0) { counter++;
sb.append((char) data); if (counter == 4) lengthOfMsg += Integer.valueOf(sb.toString()); // klo panjang msg dari MTI sampai END OF MSG sama dengan nilai // header maka lanjutkan ke method processingMsg(); if (lengthOfMsg == sb.toString().length()) { System.out.println("Rec. Msg ["+sb.toString()+"] len ["+sb.toString().length()+"]"); } } outgoing.close(); incoming.close(); clientSocket.close(); } private static String buildNetworkReqMessage() { StringBuilder networkReq = new StringBuilder(); // MTI 1800 networkReq.append("1800"); // untuk request, DE yang aktif adalah DE[3,7,11,12,13,48 dan 70] String bitmapReq = ISOUtil.getHexaBitmapFromActiveDE(new int[] {3,7,11,12,13,48,70}); networkReq.append(bitmapReq); // DE 3 processing code networkReq.append("000001"); // DE 7 transmission date and time networkReq.append(new SimpleDateFormat("yyyyMMdd").format(new Date())); // DE 11 system trace audit number networkReq.append("000001"); // DE 12 local time transaction networkReq.append(new SimpleDateFormat("HHmmss").format(new Date())); // DE 13 local time transaction networkReq.append(new SimpleDateFormat("MMdd").format(new Date())); // DE 48 Additional Private Data final String clientID = "CLNT001"; // length de 48 String lengthBit48 = ""; if (clientID.length() < 10) lengthBit48 = "00" + clientID.length(); if (clientID.length() < 100 && clientID.length() >= 10) lengthBit48 = "0" + clientID.length(); if (clientID.length() == 100) lengthBit48 = String.valueOf(clientID.length()); networkReq.append(lengthBit48); networkReq.append(clientID); // DE 70 Network Information Code networkReq.append("001");
// tambahkan 4 digit length of msg sbg header String msgHeader = ""; if (networkReq.toString().length() < 10) msgHeader = "000" + networkReq.toString().length(); if (networkReq.toString().length() < 100 && networkReq.toString().length() >= 10) msgHeader = "00" + networkReq.toString().length(); if (networkReq.toString().length() < 1000 && networkReq.toString().length() >= 100) msgHeader = "0" + networkReq.toString().length(); if (networkReq.toString().length() >= 1000) msgHeader = String.valueOf(networkReq.toString().length()); StringBuilder finalNetworkReqMsg = new StringBuilder(); finalNetworkReqMsg.append(msgHeader); finalNetworkReqMsg.append(networkReq.toString()); return finalNetworkReqMsg.toString(); } } Jika sudah, sekarang lakukan-lah proses Clean and Build pada NetBeans dengan menekan kombinasi tombol SHIFT+F11 dan harusnya tidak ada pesan kesalahan yang akan ditimbulkan
Testing
Pembuatan aplikasi server dan client sudah selesai dilakukan, sekarang langkah terakhir yang harus kita lakukan yaitu adalah mencoba untuk menjalankan kedua aplikasi tersebut. Sekarang jalankanlah dahulu aplikasi server-nya dengan cara klik kanan pada file ServerISO.java kemudian pilihlah Run Dan jika tidak ada pesan kesalahan, maka pada pallete output NetBeans akan muncul tulisan seperti dibawah ini :
Jika sudah menjumpai tampilan seperti diatas, sekarang jalankan-lah file ClientISO.java dengan cara klik kanan kemudian pilih menu Run. Jika tidak pesan kesalahan, maka pada sisi client akan muncul tulisan seperti dibawah ini :
Dan kita juga bisa melihat respon yang diberikan server ketika terjadi request dari client dengan melihat tampilan output-nya yang kurang lebih seperti dibawah ini :
Sampai disini, proses request / response telah terjadi dengan baik antara sisi server dan sisi client. Bagaimana ? tidak susah bukan ? Nah pada bab selanjut-nya, kita akan membahas salah satulibrary di Java yang sudah meng-otomatisasikan proses-proses yang telah kita lakukan secara manual diatas.
Pengenalan JPOS
Pada bab-bab awal implementasi, kita menggunakan class ServerSocket dan Socket dimana untuk melakukan parsing harus kita lakukan secara manual satu-persatu. Beruntunglah kita sebagai programmer Java , karena di bahasa pemrograman Java terdapat 1 library yang cukup bagus yaitu jPOS. Meskipun library jPOS ini opensource, tapi untuk dokumentasi-nya (jPOS Programmer’s Guide) kita diharuskan membeli sebesar $ 50 saja (sebuah harga yang tidak terlalu mahal bukan ?) Sedangkan untuk source code jPOS sendiri, bisa kita download menggunakan anonymous subversion pada alamat https://jpos.svn.sourceforge.net/svnroot/jpos (untuk pengembangan menggunakan library jPOS, sangat dianjurkan untuk mendownload source code ini sebagai bahan referensi). Apasih kelebihan dari library jPOS ini ? Yang jelas adalah, library ini memangkas semua proses manual yang harus kita lakukan ketika kita menggunakan Socket biasa. Selain itu, jPOS juga mendukung beberapa protokol-protokol yang biasa digunakan dalam implementasi ISO 8583. Untuk dapat menggunakan jpos ada beberapa hal dasar yang harus kita ketahui yaitu :
ISOPackager
Packager atau ISOPackager pada library library jPOS ini digunakan sebagai definisi panjang dan tipe data tiap-tiap Data Element yang akan digunakan dalam komunikasi. Ada banyak contohpackager yang dapat kita lihat dalam direktori jpos/dist/cfg/packager yang salah satu contoh-nya yaitu packager untuk iso93ascii.xml seperti dibawah ini:
packager/iso93ascii.xml
id="17" length="4" name="Date, Capture" class="org.jpos.iso.IFA_NUMERIC"/>
length="4" name="Card acceptor business code" class="org.jpos.iso.IFA_NUMERIC"/>
name="Track 2 data" class="org.jpos.iso.IFA_LLCHAR"/>
class="org.jpos.iso.IFA_LLCHAR"/>
id="63" length="999" name="Reserved for private use" class="org.jpos.iso.IFA_LLLCHAR"/>
length="999" name="Data record" class="org.jpos.iso.IFA_LLLCHAR"/>
name="Authorizations, number" class="org.jpos.iso.IFA_NUMERIC"/>
class="org.jpos.iso.IFA_NUMERIC"/>
id="109" length="84" name="Credits, Fee amounts" class="org.jpos.iso.IFA_LLCHAR"/>
length="999" name="Reserved for national use" class="org.jpos.iso.IFA_LLLCHAR"/>
name="Reserved for private use" class="org.jpos.iso.IFA_LLLCHAR"/> Selain menggunakan file xml, packager juga dapat dikonfigurasikan melalui file java dengan ketentuan kita harus meng-extends class ISOBasePackager seperti dibawah ini :
id.web.martinusadyh.iso8583.jpos.CustomPackager
package id.web.martinusadyh.iso8583.jpos; import org.jpos.iso.IFA_AMOUNT; import org.jpos.iso.IFA_BINARY; import org.jpos.iso.IFA_BITMAP; import org.jpos.iso.IFA_LLCHAR; import org.jpos.iso.IFA_LLLCHAR; import org.jpos.iso.IFA_LLNUM; import org.jpos.iso.IFA_NUMERIC; import org.jpos.iso.IFB_BINARY; import org.jpos.iso.IF_CHAR; import org.jpos.iso.ISOBasePackager; import org.jpos.iso.ISOFieldPackager; /** * * @author Martinus Ady H */ public class CustomPackager extends ISOBasePackager { public CustomPackager() { setFieldPackager(new ISOFieldPackager[]{ /*000*/new IFA_NUMERIC(4, "Message Type Indicator"), /*001*/ new IFA_BITMAP(16, "BIT MAP"), /*002*/ new IFA_LLNUM(19, "PAN - PRIMARY ACCOUNT NUMBER"), /*003*/ new IFA_NUMERIC(6, "PROCESSING CODE"), /*004*/ new IFA_NUMERIC(12, "AMOUNT, TRANSACTION"), /*005*/ new IFA_NUMERIC(12, "AMOUNT, SETTLEMENT"), /*006*/ new IFA_NUMERIC(12, "AMOUNT, CARDHOLDER BILLING"), /*007*/ new IFA_NUMERIC(10, "TRANSMISSION DATE AND TIME"), /*008*/ new IFA_NUMERIC(8, "AMOUNT, CARDHOLDER BILLING FEE"), /*009*/ new IFA_NUMERIC(8, "CONVERSION RATE, SETTLEMENT"),
/*010*/ new IFA_NUMERIC(8, "CONVERSION RATE, CARDHOLDER BILLING"), /*011*/ new IFA_NUMERIC(6, "SYSTEM TRACE AUDIT NUMBER"), /*012*/ new IFA_NUMERIC(6, "TIME, LOCAL TRANSACTION"), /*013*/ new IFA_NUMERIC(4, "DATE, LOCAL TRANSACTION"), /*014*/ new IFA_NUMERIC(4, "DATE, EXPIRATION"), /*015*/ new IFA_NUMERIC(4, "DATE, SETTLEMENT"), /*016*/ new IFA_NUMERIC(4, "DATE, CONVERSION"), /*017*/ new IFA_NUMERIC(4, "DATE, CAPTURE"), /*018*/ new IFA_NUMERIC(4, "MERCHANTS TYPE"), /*019*/ new IFA_NUMERIC(3, "ACQUIRING INSTITUTION COUNTRY CODE"), /*020*/ new IFA_NUMERIC(3, "PAN EXTENDED COUNTRY CODE"), /*021*/ new IFA_NUMERIC(3, "FORWARDING INSTITUTION COUNTRY CODE"), /*022*/ new IFA_NUMERIC(3, "POINT OF SERVICE ENTRY MODE"), /*023*/ new IFA_NUMERIC(3, "CARD SEQUENCE NUMBER"), /*024*/ new IFA_NUMERIC(3, "NETWORK INTERNATIONAL IDENTIFIEER"), /*025*/ new IFA_NUMERIC(2, "POINT OF SERVICE CONDITION CODE"), /*026*/ new IFA_NUMERIC(2, "POINT OF SERVICE PIN CAPTURE CODE"), /*027*/ new IFA_NUMERIC(1, "AUTHORIZATION IDENTIFICATION RESP LEN"), /*028*/ new IFA_AMOUNT(9, "AMOUNT, TRANSACTION FEE"), /*029*/ new IFA_AMOUNT(9, "AMOUNT, SETTLEMENT FEE"), /*030*/ new IFA_AMOUNT(9, "AMOUNT, TRANSACTION PROCESSING FEE"), /*031*/ new IFA_AMOUNT(9, "AMOUNT, SETTLEMENT PROCESSING FEE"), /*032*/ new IFA_LLNUM(11, "ACQUIRING INSTITUTION IDENT CODE"), /*033*/ new IFA_LLNUM(11, "FORWARDING INSTITUTION IDENT CODE"), /*034*/ new IFA_LLCHAR(28, "PAN EXTENDED"), /*035*/ new IFA_LLNUM(37, "TRACK 2 DATA"), /*036*/ new IFA_LLLCHAR(104, "TRACK 3 DATA"), /*037*/ new IF_CHAR(12, "RETRIEVAL REFERENCE NUMBER"), /*038*/ new IF_CHAR(6, "AUTHORIZATION IDENTIFICATION RESPONSE"), /*039*/ new IF_CHAR(2, "RESPONSE CODE"), /*040*/ new IF_CHAR(3, "SERVICE RESTRICTION CODE"), /*041*/ new IF_CHAR(8, "CARD ACCEPTOR TERMINAL IDENTIFICACION"), /*042*/ new IF_CHAR(15, "CARD ACCEPTOR IDENTIFICATION CODE"), /*043*/ new IF_CHAR(40, "CARD ACCEPTOR NAME/LOCATION"), /*044*/ new IFA_LLCHAR(25, "ADITIONAL RESPONSE DATA"), /*045*/ new IFA_LLCHAR(76, "TRACK 1 DATA"), /*046*/ new IFA_LLLCHAR(999, "ADITIONAL DATA - ISO"), /*047*/ new IFA_LLLCHAR(999, "ADITIONAL DATA - NATIONAL"), /*048*/ new IFA_LLLCHAR(999, "ADITIONAL DATA - PR IVATE"), /*049*/ new IF_CHAR(3, "CURRENCY CODE, TRANSACTION"), /*050*/ new IF_CHAR(3, "CURRENCY CODE, SETTLEMENT"), /*051*/ new IF_CHAR(3, "CURRENCY CODE, CARDHOLDER BILLING"), /*052*/ new IFB_BINARY(8, "PIN DATA"),
/*053*/ new IFA_NUMERIC(16, "SECURITY RELATED CONTROL INFORMATION"), /*054*/ new IFA_LLLCHAR(120, "ADDITIONAL AMOUNTS"), /*055*/ new IFA_LLLCHAR(999, "RESERVED ISO"), /*056*/ new IFA_LLLCHAR(999, "RESERVED ISO"), /*057*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL"), /*058*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL"), /*059*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL"), /*060*/ new IFA_LLLCHAR(999, "RESERVED PR IVATE"), /*061*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE"), /*062*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE"), /*063*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE"), /*064*/ new IFA_BINARY(8, "MESSAGE AUTHENTICATION CODE FIELD"), /*065*/ new IFA_BINARY(8, "BITMAP, EXTENDED"), /*066*/ new IFA_NUMERIC(1, "SETTLEMENT CODE"), /*067*/ new IFA_NUMERIC(2, "EXTENDED PAYMENT CODE"), /*068*/ new IFA_NUMERIC(3, "RECEIVING INSTITUTION COUNTRY CODE"), /*069*/ new IFA_NUMERIC(3, "SETTLEMENT INSTITUTION COUNTRY CODE"), /*070*/ new IFA_NUMERIC(3, "NETWORK MANAGEMENT INFORMATION CODE"), /*071*/ new IFA_NUMERIC(4, "MESSAGE NUMBER"), /*072*/ new IFA_NUMERIC(4, "MESSAGE NUMBER LAST"), /*073*/ new IFA_NUMERIC(6, "DATE ACTION"), /*074*/ new IFA_NUMERIC(10, "CREDITS NUMBER"), /*075*/ new IFA_NUMERIC(10, "CREDITS REVERSAL NUMBER"), /*076*/ new IFA_NUMERIC(10, "DEBITS NUMBER"), /*077*/ new IFA_NUMERIC(10, "DEBITS REVERSAL NUMBER"), /*078*/ new IFA_NUMERIC(10, "TRANSFER NUMBER"), /*079*/ new IFA_NUMERIC(10, "TRANSFER REVERSAL NUMBER"), /*080*/ new IFA_NUMERIC(10, "INQUIRIES NUMBER"), /*081*/ new IFA_NUMERIC(10, "AUTHORIZATION NUMBER"), /*082*/ new IFA_NUMERIC(12, "CREDITS, PROCESSING FEE AMOUNT"), /*083*/ new IFA_NUMERIC(12, "CREDITS, TRANSACTION FEE AMOUNT"), /*084*/ new IFA_NUMERIC(12, "DEBITS, PROCESSING FEE AMOUNT"), /*085*/ new IFA_NUMERIC(12, "DEBITS, TRANSACTION FEE AMOUNT"), /*086*/ new IFA_NUMERIC(16, "CREDITS, AMOUNT"), /*087*/ new IFA_NUMERIC(16, "CREDITS, REVERSAL AMOUNT"), /*088*/ new IFA_NUMERIC(16, "DEBITS, AMOUNT"), /*089*/ new IFA_NUMERIC(16, "DEBITS, REVERSAL AMOUNT"), /*090*/ new IFA_NUMERIC(42, "ORIGINAL DATA ELEMENTS"), /*091*/ new IF_CHAR(1, "FILE UPDATE CODE"), /*092*/ new IF_CHAR(2, "FILE SECURITY CODE"), /*093*/ new IF_CHAR(5, "RESPONSE INDICATOR"), /*094*/ new IF_CHAR(7, "SERVICE INDICATOR"), /*095*/ new IF_CHAR(42, "REPLACEMENT AMOUNTS"),
/*096*/ new IFA_BINARY(8, "MESSAGE SECURITY CODE"), /*097*/ new IFA_AMOUNT(17, "AMOUNT, NET SETTLEMENT"), /*098*/ new IF_CHAR(25, "PAYEE"), /*099*/ new IFA_LLNUM(11, "SETTLEMENT INSTITUTION IDENT CODE"), /*100*/ new IFA_LLNUM(11, "RECEIVING INSTITUTION IDENT CODE"), /*101*/ new IFA_LLCHAR(17, "FILE NAME"), /*102*/ new IFA_LLCHAR(28, "ACCOUNT IDENTIFICATION 1"), /*103*/ new IFA_LLCHAR(28, "ACCOUNT IDENTIFICATION 2"), /*104*/ new IFA_LLLCHAR(100, "TRANSACTION DESCRIPTION"), /*105*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*106*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*107*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*108*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*109*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*110*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*111*/ new IFA_LLLCHAR(999, "RESERVED ISO USE"), /*112*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*113*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*114*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*115*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*116*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*117*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*118*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*119*/ new IFA_LLLCHAR(999, "RESERVED NATIONAL USE"), /*120*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*121*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*122*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*123*/ new IFA_LLLCHAR(999, "RESERVED PR IVATE USE"), /*124*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*125*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*126*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*127*/ new IFA_LLLCHAR(999, "RESERVED PRIVATE USE"), /*128*/ new IFA_LLLCHAR(999, "MAC 2") }); } } Sedangkan cara penggunaan-nya adalah sebagai berikut :
ISO Channel
Class ISOChannel atau Channel pada library jPOS ini digunakan untuk membungkus detail implementasi dari protokol-protokol yang digunakan oleh setiap vendor. Selain itu ISOChannel ini juga digunakan untuk mengirimkan dan menerima object ISOMsg. Beberapa Channel yang telah didukung oleh library jPOS ini antara lain :
Channel atau ISOChannel disini mempunyai peran yang sangat penting sekali dalam proses tersambung atau tidak-nya antara vendor yang satu dengan yang lain dan biasanya implementasi tiap vendor berbeda-beda. Sedangkan pada library jPOS, penggunaan Channel ini sangat mudah seperti terlihat pada potongan kode dibawah ini :
ISOServer dan ISOMUX
Jika pada implementasi sebelum-nya kita menggunakan class ServerSocket sebagai implementasi sebuah server dan class Socket sebagai implementasi sebuah client, pada library jPOS kita dapat menggunakan class ISOServer sebagai implementasi Server-nya dan class ISOMUX sebagai implementasi client-nya. Agar message yang kita kirimkan ke server tidak tertukar dengan message yang lain, maka ketika kita melakukan inisialisasi pada ISOMUX overridelah method getKey(ISOMsg isoMsg) seperti contoh dibawah ini : CONTOH PENGGUNAAN ISOMUX :
Sedangkan cara untuk menggunakan class ISOServer adalah sebagai berikut :
ISOMsg
Class ISOMsg pada library jPOS ini adalah merupakan inti dari message yang akan kita kirim dan kita terima. Dibandingkan dengan cara manual yang telah kita lakukan pada tahap implementasi di bab sebelum-nya, untuk mengisi nilai pada data element tertentu pada class ISOMsg dapat kita lakukan secara langsung dengan cara seperti dibawah ini :
CONTOH PENGGUNAAN CLASS ISOMSG :
Sedangkan untuk mengirimkan-nya pada sebuah server, kita dapat membungkus ISOMsg kedalam object ISORequest dan mengirimkan object ISORequest tersebut ke method queue(ISORequest isoRequest) pada class ISOMUX seperti contoh dibawah ini : CARA MENGIRIMKAN MESSAGE MELALUI ISOREQUEST :
Dan untuk mendapat respon dari server, kita bisa menggunakan method getResponse(Integer TIMEOUT) dari class ISORequest seperti kode dibawah ini : CARA MENGAMBIL RESPON MELALUI ISOREQUEST :
Sampai disini pembahasan tentang apa itu jPOS sudah bisa dikatakan selesai. Nah sekarang bagaimanakah implementasi menggunakan jPOS ? Mari kita lihat pada bab selanjut-nya.
IMPLEMENTASI MENGGUNAKAN JPOS
Setelah kita mengetahui apa itu library jPOS, sekarang bagaimana penggunaan-nya secara nyata ? Pada bab kali ini, kita akan menulis ulang spesifikasi Network Management yang sebelum-nya sudah di implementasikan menggunakan Socket biasa. Nah untuk memulai-nya ada beberapa persiapan yang harus kita lakukan yaitu :
Persiapan Project
Sebagai langkah awal, tambahkanlah dahulu 2 buah library yaitu jdom-1.0.jar dan jpos.jar yang dapat diambil dari direktori jpos (yang bisa kita download melalui subversion) kedalam project. Setelah itu, buatlah 1 buah direktori dengan nama packager didalam direktori project dan pastekan kedua file dibawah ini : genericpackager.dtd
iso93ascii.xml
2 3 4 5 6 7 12 17 22 27 32 37 42
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91
class="org.jpos.iso.IFA_NUMERIC"/>
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183
id="26" length="4" name="Card acceptor business code" class="org.jpos.iso.IFA_NUMERIC"/>
184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229
length="37" name="Track 2 data" class="org.jpos.iso.IFA_LLCHAR"/>
230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275
name="Additional response data" class="org.jpos.iso.IFA_LLCHAR"/>
276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321
class="org.jpos.iso.IFA_LLBINARY"/>
322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367
368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413
id="72" length="999" name="Data record" class="org.jpos.iso.IFA_LLLCHAR"/>
414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459
length="10" name="Authorizations, number" class="org.jpos.iso.IFA_NUMERIC"/>
460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505
name="Authorizations, reversal number" class="org.jpos.iso.IFA_NUMERIC"/>
506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551
class="org.jpos.iso.IFA_LLCHAR"/>
552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597
598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643
id="118" length="999" name="Reserved for national use" class="org.jpos.iso.IFA_LLLCHAR"/>
644 length="999" 645 name="Reserved for private use" 646 class="org.jpos.iso.IFA_LLLCHAR"/> 647 652 Jika sudah, harusnya tampilan dari NetBeans akan tampak seperti gambar dibawah ini :
Tampilan Struktur Project
Pembuatan Aplikasi Server
Sekarang buatlah sebuah class baru dan beri nama JPosServer dan simpan pada package id.web.martinusadyh.iso8583.jpos. Karena kita menggunakan library jPOS, maka implementasi Server kita tidak serumit yang pertama. Dan inilah implementasi server kita yang menggunakan library jPOS :
id.web.martinusadyh.iso8583.jpos.JPosServer.java
package id.web.martinusadyh.iso8583.jpos; import java.io.IOException; import java.util.logging.Level; import java.util.logging.Logger; import org.jpos.iso.BaseChannel; import org.jpos.iso.ISOException; import org.jpos.iso.ISOMsg; import org.jpos.iso.ISOPackager; import org.jpos.iso.ISORequestListener; import org.jpos.iso.ISOServer; import org.jpos.iso.ISOSource; import org.jpos.iso.ServerChannel; import org.jpos.iso.channel.ASCIIChannel; import org.jpos.iso.packager.GenericPackager; /** * * @author Martinus Ady H */ public class JPosServer implements ISORequestListener { /** * @param args the command line arguments */ public static void main(String[] args) throws ISOException { String hostname = "localhost"; int portNumber = 12345; // membuat sebuah packager ISOPackager packager = new GenericPackager("packager/iso93ascii.xml"); // membuat channel ServerChannel channel = new ASCIIChannel(hostname, portNumber, packager); // membuat server ISOServer server = new ISOServer(portNumber, channel, null); server.addISORequestListener(new JPosServer());
new Thread(server).start(); System.out.println("Server siap menerima koneksi pada port [" + portNumber+"]"); } public boolean process(ISOSource isoSrc, ISOMsg isoMsg) { try { System.out.println("Server menerima koneksi dari ["+((BaseChannel)isoSrc).getSocket().getInetAddress().getHostAddress()+"]"); if (isoMsg.getMTI().equalsIgnoreCase("1800")) { acceptNetworkMsg(isoSrc, isoMsg); } } catch (IOException ex) { Logger.getLogger(JPosServer.class.getName()).log(Level.SEVERE, null, ex); } catch (ISOException ex) { Logger.getLogger(JPosServer.class.getName()).log(Level.SEVERE, null, ex); } return false; } private void acceptNetworkMsg(ISOSource isoSrc, ISOMsg isoMsg) throws ISOException, IOException { System.out.println("Accepting Network Management Request"); ISOMsg reply = (ISOMsg) isoMsg.clone(); reply.setMTI("1810"); reply.set(39, "00"); isoSrc.send(reply); } }
Melihat perbedaan antara penulisan menggunakan library jPOS dengan menggunakan Socket biasa ??? Jika belum, mari kita lihat bagaimana implementasi untuk client-nya.
Pembuatan Aplikasi Client
Pembuatan aplikasi untuk client-nya pun tidak begitu susah , sekarang buatlah sebuah class baru dengan nama JPosClient dan simpan pada package id.web.martinusadyh.iso8583.jpos. Setelah itu, pastekan kode dibawah ini :
id.web.martinusadyh.iso8583.jpos.JPosClient.java
package id.web.martinusadyh.iso8583.jpos; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import org.jpos.iso.ISOException; import org.jpos.iso.ISOMUX; import org.jpos.iso.ISOMsg; import org.jpos.iso.ISOPackager; import org.jpos.iso.ISORequest; import org.jpos.iso.channel.ASCIIChannel; import org.jpos.iso.packager.GenericPackager; /** * * @author Martinus Ady H */ public class JPosClient { /** * @param args the command line arguments */ public static void main(String[] args) throws IOException, ISOException { String hostname = "localhost"; int portNumber = 12345; // membuat sebuah packager ISOPackager packager = new GenericPackager("packager/iso93ascii.xml"); // membuat channel ASCIIChannel channel = new ASCIIChannel(hostname, portNumber, packa ger); ISOMUX isoMux = new ISOMUX(channel) { @Override protected String getKey(ISOMsg m) throws ISOException { return super.getKey(m); } }; new Thread(isoMux).start(); // bikin network request ISOMsg networkReq = new ISOMsg(); networkReq.setMTI("1800"); networkReq.set(3, "123456"); networkReq.set(7, new SimpleDateFormat("yyyyMMdd").format(new Date()));
networkReq.set(11, "000001"); networkReq.set(12, new SimpleDateFormat("HHmmss").format(new Date())); networkReq.set(13, new SimpleDateFormat("MMdd").format(new Date())); networkReq.set(48, "Tutorial ISO 8583 Dengan Java"); networkReq.set(70, "001"); ISORequest req = new ISORequest(networkReq); isoMux.queue(req); ISOMsg reply = req.getResponse(50*1000); if (reply != null) { System.out.println("Req ["+new String(networkReq.pack()) + "]"); System.out.println("Res ["+new String(reply.pack()) + "]"); } } }
Bagaimana tidak susah bukan ? Kode kita terlihat makin sederhana Nah jika sudah, sekarang coba lakukan proses Clean and Build dan jalankanlah JPosServer hingga muncul tampilan seperti dibawah ini :
Jika sudah menjumpai tampilan seperti diatas, sekarang jalankanlah aplikasi client-nya yaitu JPosClient. Jika tidak ada pesan kesalahan, maka kita akan melihat tampilan seperti dibawah ini pada sisi client :
Dan tampilan seperti ini pada sisi server :
Sekarang cobalah secara bergantian jalankan server yang menggunakan class ServerSocket biasa dengan client yang menggunakan library jPOS. Begitu juga sebaliknya, client dari class Socket dan server yang menggunakan library jPOS. Seharus-nya sudah tidak ada masalah lagi.
REFERENSI Dibawah ini adalah referensi-referensi yang penulis gunakan ketika menyusun buku ini, semoga
bisa menjadi bahan referensi jika tulisan saya dirasa masih membingungkan.
Secondary Bitmap in jPOS Bit and Byte Conversion Wikipedia ISO 8583 Introduction to ISO 8583 Wikipedia Hexadecimal
