Belajar SOAP - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar SOAP! Series ini akan membawa kalian menguasai SOAP — protokol XML web services berstandar W3C — untuk integrasi B2B dan sistem enterprise: banking, healthcare, telecom, dan government. Total ada 23 episode yang tersusun dalam enam fase, dari fondasi konsep sampai production readiness.

Sebelum mengirim request SOAP pertama, ada skill dasar dan perangkat yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena SOAP tidak seperti REST yang "begitu saja" — ia adalah XML dengan aturan ketat: namespace harus benar, struktur envelope harus valid, dan kontrak WSDL menentukan segalanya. Tanpa memahami HTTP, XML namespace, dan konsep pemrograman backend, kalian akan tersesat di episode 3 (WSDL) dan episode 7 (XSD) yang menjadi jantung SOAP.

Episode 0 ini adalah peta jalan kalian: kita akan memastikan skill dasar, menyiapkan runtime dan tool testing, lalu memverifikasi instalasi untuk pertama kali. Setelah episode ini selesai, seluruh series bisa diikuti dengan nyaman.

#Skill Dasar yang Wajib Dimiliki

#HTTP dan Request-Response

SOAP berjalan di atas transport — paling umum HTTP/HTTPS. Kalian wajib memahami request dan response: metode POST (SOAP hampir selalu POST), header HTTP seperti Content-Type: text/xml atau application/soap+xml, serta status code (200, 400, 500). SOAP adalah pesan, bukan resource seperti REST — URL service hanyalah titik masuknya.

#XML: Struktur, Namespace, dan Well-Formedness

SOAP adalah XML murni. Kalian wajib paham elemen bersarang, atribut, dan — yang paling penting — namespace (xmlns). Perbedaan qualified name (QName) vs local name akan menentukan apakah service menerima pesan kalian atau menolaknya. Cek cepat pemahaman kalian:

<?xml version="1.0" encoding="UTF-8"?>
<order xmlns="urn:example:orders">
  <id>INV-1001</id>
  <total currency="IDR">1500000</total>
</order>

Jika kalian bingung dengan xmlns atau atribut currency, luangkan waktu mempelajarinya — episode 7 akan membahas namespace dan XSD secara mendalam.

#Pemrograman Backend di Satu Bahasa

Sepanjang series kita akan menulis service SOAP di Java (episode 4), lalu melihat PHP, .NET, dan Python (episode 5). Kalian tidak harus menguasai semuanya, tetapi wajib nyaman di minimal satu bahasa dan paham konsep yang dibawa oleh bahasa lain: interface sebagai kontrak, serialisasi data, dan exception handling.

#Perangkat Software yang Disiapkan

#Java (JDK 17+) — Disarankan

Series ini menjadikan Java sebagai bahasa utama karena ekosistem JAX-WS, Apache CXF, dan WSS4J adalah referensi industri. Install JDK 17 atau lebih baru:

Cek versi Java

java -version
javac -version

java -version harus menampilkan versi mayor 17 atau lebih tinggi. Jika belum ada, gunakan paket distro kalian (sudo apt install openjdk-17-jdk di Debian/Ubuntu) atau SDKMAN untuk mengelola versi.

#PHP 8 / .NET (Opsional)

Untuk episode 5, siapkan minimal salah satu dari runtime berikut:

php -v
dotnet --list-sdks

PHP 8 punya ekstensi soap bawaan (aktifkan via php.ini jika belum), sedangkan .NET memakai dotnet-svcutil untuk generate client dari WSDL.

#SoapUI dan Postman

SoapUI adalah tool wajib untuk developer SOAP — ia mengimpor WSDL, membangkitkan request, menjalankan assertions, dan bahkan bisa menjadi MockService. Postman juga bisa mengirim raw SOAP/XML meski tidak sedalam SoapUI. Install keduanya:

sudo snap install soapui

Alternatif: unduh installer dari situs resmi SmartBear. Untuk Postman, unduh paket resminya atau gunakan versi web/desktop.

#Server Aplikasi untuk Lab

Kita akan menjalankan service di Tomcat (Java) pada episode 4. Untuk keperluan lab, cukup siapkan direktori kerja kosong:

mkdir -p ~/soap-lab/wsdl ~/soap-lab/requests ~/soap-lab/scripts
echo "lab siap" > ~/soap-lab/README.txt

#Verifikasi Environment

Sebelum lanjut ke episode 1, jalankan verifikasi menyeluruh:

java -version
php -v
dotnet --list-sdks
curl --version

curl --version penting karena kita akan sering mengirim raw SOAP XML via curl — dan itu latihan paling jujur untuk memahami protokolnya. Jika semua perintah mencetak versi, environment kalian siap.

#Ringkasan Prasyarat

Rangkuman yang sudah kalian siapkan di episode 0:

• Skill: HTTP request-response, XML namespace & well-formedness, pemrograman backend minimal satu bahasa.
• Runtime: JDK 17+ (wajib), PHP 8 dan/atau .NET (opsional untuk episode 5).
• Tools: SoapUI dan Postman untuk mengetes service, curl untuk uji raw.
• Lab: direktori ~/soap-lab/ dengan subfolder wsdl, requests, dan scripts.

Jika ada yang belum terpenuhi, berhenti dulu dan lengkapi sebelum melanjutkan. Perjalanan 22 episode ke depan akan jauh lebih lancar dengan pijakan yang kuat ini.

#Penutup

Di episode 0 ini kalian sudah menyiapkan pijakan untuk seluruh series: memahami skill HTTP, XML, dan backend yang dibutuhkan, menginstall JDK 17+, menyiapkan SoapUI dan Postman, serta memverifikasi environment.

Inti yang harus dibawa pulang:

• SOAP adalah XML dengan aturan ketat; fondasinya adalah HTTP, XML namespace, dan pemahaman kontrak.
• Wajib punya JDK 17+ karena Java adalah bahasa utama series ini.
• SoapUI adalah tool utama untuk testing SOAP; siapkan juga curl untuk uji raw.
• Direktori lab ~/soap-lab/ siap dipakai sepanjang series.

Di episode 1 selanjutnya kita akan membahas sejarah, latar belakang, dan mengapa SOAP masih relevan di 2026 — dari kelahiran SOAP 1.0 oleh Microsoft/IBM pada 1998, penetapan SOAP 1.2 sebagai W3C Recommendation pada 2003, hingga era WS-* dan alasan transaksi triliunan dollar per hari masih berjalan di atasnya. Pastikan environment kalian sudah siap, karena perjalanan Belajar SOAP baru saja dimulai!