Asumsi:
- Pengguna telah mempunyai minimal Java 1.8 di dalam sistem operasi nya.
Langkah Menjalankan Program:
- Melakukan clone atau mengunduh zip dari repositori ini (jika mengunduh zip, lakukan ekstraksi dari zip yang telah diunduh)
- Membuka folder hasil clone atau ekstraksi.
- Membuka folder out
- Menjalankan aplikasi peer2peer-collaborative-editing.jar dengan menekan ikon aplikasi sebanyak 2 kali secara cepat.
- Memasukkan nama dan memilih Create pada Radio button, lalu menekan OK
- Menjalankan aplikasi peer2peer-collaborative-editing.jar lainnya dengan menekan ikon aplikasi sebanyak 2 kali secara cepat.
- Memasukkan nama dan memilih Join pada Radio button.
- Memasukkan alamat IP dan Port pada Text field berdasarkan alamat IP dan Port yang ditampilkan oleh program sebelumnya
- Mengetik tulisan pada Text Area untuk melihat CRDT program.
| Nama | NIM | Persentase | Deskripsi |
|---|---|---|---|
| Shandy | 13516097 | 33.33% | UI, Controller, deletion buffer, Laporan |
| Jessin D. | 13516112 | 33.33% | CRDT, Version Vector |
| I Kadek Yuda B. G. | 13516115 | 33.33% | Messenger, Peer2Peer, laporan |
Program akan menampilkan sebuah tampilan antarmuka berisi text editor dan daftar username dari program-program lain yang telah terkoneksi. Setiap masukan pengguna ke dalam text editor akan diterima oleh MainUIController dan dilanjutkan dengan memanggil fungsi localInsert dari kelas CDRTController yang akan memperbaharui struktur CDRT serta men-trigger kelas Messenger untuk mengirimkan masukan pengguna tersebut ke program-program lain.
Pemrosesan kiriman akan berbeda sesuai dengan jenis perintah dari kiriman tersebut. Jika perintah kiriman yakni melakukan penambahan karakter pada text editor maka program penerima akan menerima kiriman tersebut dan menverifikasikannya dengan kelas Version Vector yang dimiliki. Jika verifikasi berhasil, maka karakter dari kiriman tersebut akan ditampilkan ke text editor. Akan tetapi, jika perintah kiriman yakni melakukan penghapusan karakter pada text editor, program menerima akan memasukkannya ke dalam sebuah deletion buffer. Deletion buffer akan diproses jika program menerima kiriman dari program lain untuk di cek jika karakter yang bersangkutan pernah ditambahkan ke text editor dan jika pernah, karakter tersebut akan dihapus.
Setiap peer dalam sistem ini berkomunikasi dengan sistem jaringan Peer To Peer yang bertindak sebagai Messenger sekaligus penerima koneksi baru. Apabila suatu peer (client) ingin masuk ke dalam sistem, maka peer tersebut harus menyambungkan dirinya dengan salah satu peer yang sudah terhubung untuk ikut dalam jaringan dan mendapatkan isi dari editor sebelum peer tersebut masuk. Jika peer sudah terhubung, maka komunikasi antar peer dapat dilakukan dengan melakukan penukaran data CRDTLog untuk mensinkronisasi perubahan yang terjadi pada tiap peer;
Arsitektur program terbagi menjadi dua bagian besar, yakni Frontend dan Backend. Frontend mengelola tampilan antarmuka serta menerima masukan dari pengguna. Selain itu, frontend juga melakukan pembaharuan (update) setiap masuknya informasi dari program lain sedangkan Backend mengatur pemrosesan informasi di belakang layar. Backend mengatur struktur data program melalui package CRDT, mengelola koneksi program dengan program lain melalui package P2PServer dan mengatur perubahan antarmuka melalui package UI.
Berikut adalah Class Diagram program:
Pada program ini, CRDT adalah sebuah package yang berisi kelas CRDTChar, kelas CRDTController, dan kelas CRDTLog. Sedangkan Version Vector dan Deletion Buffer menjadi Member Variables dari kelas CDRTController dalam bentuk ArrayList ber-elemen CRDTLog.
Aplikasi CRDT pada program ini yakni CRDTChar sebagai tipe data yang akan direplikasikan pada komputer-komputer di dalam jaringan, kelas CRDTController berfungsi mengatur struktur data dari kumpulan CRDTChar, dan kelas CRDTLog sebagai entri log dari setiap operasi yang dilakukan secara lokal ataupun remote.
Aplikasi Version Vector pada program ini yakni menyimpan log yang berisi operasi-operasi yang pernah dilakukan terhadap file yang sedang dibuka sehingga operasi LocalInsert, LocalDelete, RemoteInsert, dan Remote Delete akan menambahkan sebuah entri log pada Version Vector. Selain itu, isi dari Version Vector juga akan diperiksa setiap kali operasi RemoteDelete dari Deletion Buffer akan dieksekusi. Jika RemoteDelete akan menghapus CRDTChar yang pernah ditambahkan maka operasi akan berjalan hingga sukses. Akan tetapi, jika CRDTChar yang diinnginkan tidak ditemukan, maka operasi RemoteControl tersebut akan diabaikan.
Aplikasi Deletion Buffer pada program ini yakni menyimpan operasi-operasi RemoteDelete yang sedang dalam keadaan pending. Program akan mengeksekusi RemoteDelete dari Deletion Buffer secara FIFO (First In First Out) selayaknya antrian. RemoteDelete yang akan dieksekusi hanyalah RemoteDelete yang akan menghapus CRDT yang pernah di-insert ke file.
Analisa yang dapat dibuat berdasarkan program yang telah dikembangkan yakni kurangnya fitur editor pada program. Tidak adanya remote cursors pada text area sehingga pengguna tidak mengetahui posisi caret pengguna lain. Selain itu, text area juga belum mendukung fitur-fitur editor seperti cut, copy, paste, dan lain-lain.
Kasus Pengujian:
- Pengguna 1 dan Pengguna 2 melakukan insert karakter di posisi cursor yang berbeda secara bersamaan.
- Pengguna 1 dan Pengguna 2 melakukan delete karakter di posisi cursor yang berbeda.
- Pengguna 1 dan Pengguna 2 melakukan insert karakter di posisi cursor yang sama.
- Pengguna 1 dan Pengguna 2 melakukan delete karakter di posisi cursor yang sama.
Hasil Pengujian: Program tidak bekerja di dua komputer berbeda sehingga pengujian konkurensi tidak bisa dilakukan
Kasus Pengujian:
Hasil Pengujian: Program berjalan dengan baik
Kasus Pengujian:
- Pengguna 1 melakukan delete karakter.
- Pengguna 2 tidak melakukan operasi (karena operasi RemoteDelete masuk ke deletion buffer)
- Pengguna 1 melakukan insert karakter baru.
- Pengguna 2 melakukan Remote Delete kemudian melakukan RemoteInsert sesuai dari Pengguna 1
Hasil Pengujian: Program berjalan dengan baik
Kasus Pengujian:
- Pengguna 1 melakukan delete karakter.
- Pengguna 2 tidak melakukan operasi (karena operasi RemoteDelete masuk ke deletion buffer)
- Pengguna 1 melakukan insert karakter baru.
- Pengguna 2 melakukan Remote Delete kemudian melakukan RemoteInsert sesuai dari Pengguna 1
Hasil Pengujian: Program berjalan dengan baik
Berikut adalah screenshot dari program:
