Konversi JS menjadi JAR

Perangkat atau program berbasis Java mungkin memerlukan package .jar, sementara source yang tersedia adalah file JavaScript .js. Solusi yang tepat bergantung pada apakah Anda hanya perlu mengarsipkan script atau perlu menulis ulang dan menjalankannya melalui JavaScript engine yang kompatibel dengan Java.

Apa itu format JS

File .js biasanya berisi source code JavaScript yang digunakan oleh web browser, Node.js, Electron, aplikasi Adobe, build system, atau Windows Script Host. JavaScript berjalan dalam engine seperti V8, SpiderMonkey, JavaScriptCore, atau GraalJS.

JavaScript dan Java adalah bahasa yang berbeda. Mengubah .js menjadi .jar, mengganti nama file, atau menempatkannya dalam ZIP archive tidak akan mengompilasinya menjadi Java class file. Browser script juga dapat bergantung pada API seperti document dan window, sementara Node.js script mungkin bergantung pada require, package npm, atau API khusus Node.

Apa itu format JAR

JAR, atau Java ARchive, adalah package berbasis ZIP untuk Java class file, library, resource, dan metadata. Aplikasi dan library Java menggunakan JAR karena JAR menggabungkan banyak file ke dalam satu package yang dapat didistribusikan, mendukung compression, dan dapat menyertakan manifest di META-INF/MANIFEST.MF. JAR juga dapat ditandatangani untuk integritas dan verifikasi publisher.

JAR dapat berisi JavaScript sebagai resource biasa, tetapi JAR yang hanya berisi script tidak otomatis dapat dieksekusi. JAR yang dapat dijalankan memerlukan Java entry class yang telah dikompilasi dan manifest entry seperti Main-Class; class tersebut kemudian harus memulai atau menginterpretasikan JavaScript.

Package file JS dalam JAR

Gunakan utility jar yang disertakan dalam JDK jika kebutuhannya hanya berupa JAR archive yang berisi script asli.

1. Instal JDK seperti Eclipse Temurin, Oracle JDK, atau distribusi kompatibel lainnya; JRE saja tidak menyediakan packaging tool yang umum digunakan.
2. Letakkan script.js dan asset-nya dalam direktori project, dengan mempertahankan path yang dirujuk oleh script.
3. Buka terminal di direktori project dan jalankan jar --create --file app.jar script.js. Tambahkan direktori atau file sesuai kebutuhan, misalnya jar --create --file app.jar script.js lib config.
4. Periksa archive dengan jar --list --file app.jar.

Pada versi JDK yang lebih lama, command yang setara adalah jar cf app.jar script.js. Proses ini mempertahankan source JavaScript dan mem-package-nya; proses ini tidak membuat java -jar app.jar mengeksekusi script tersebut.

Buat Java wrapper yang dapat dijalankan

Untuk mendistribusikan aplikasi Java yang menjalankan script, buat Java project dengan launcher class. Launcher tersebut memuat script.js dari JAR, membuat JavaScript engine context, menyediakan argument atau host object yang diperlukan, lalu mengevaluasi script.

GraalJS dapat di-embed melalui GraalVM Polyglot API dan Java dependency-nya. Tambahkan dependency GraalVM SDK dan JavaScript engine yang diperlukan melalui Maven atau Gradle, tulis launcher, kompilasi, lalu package launcher class, script, resource, dan dependency. Setup GraalJS berbeda-beda berdasarkan versi GraalVM dan dependency, jadi gunakan versi dependency yang didukung oleh runtime yang dipilih, bukan menyalin contoh Nashorn yang sudah obsolete.

Nashorn dihapus dari distribusi JDK standar mulai JDK 15. Code yang bergantung pada Nashorn harus menggunakan compatibility distribution yang dipelihara secara terpisah atau dimigrasikan ke engine lain; JDK saat ini biasanya tidak menyediakan Nashorn.

Di IntelliJ IDEA, opsi packaging desktop biasa adalah File → Project Structure → Artifacts → JAR → From modules with dependencies. Pilih launcher class sebagai main class, tentukan apakah dependency harus diekstrak ke dalam fat JAR atau tetap disimpan di samping aplikasi, lalu build artifact tersebut. Build Maven atau Gradle biasanya lebih reproducible untuk project yang memiliki banyak dependency. Jalankan package yang telah dikonfigurasi dengan benar menggunakan java -jar app.jar.

Jika file asli adalah aplikasi Node.js, mempertahankannya sebagai Node.js project biasanya merupakan pilihan yang benar secara teknis. Java wrapper dapat memulai node sebagai external process, tetapi sistem target tetap memerlukan Node.js dan hasilnya bukan konversi menjadi Java bytecode.

Opsi online dan desktop

Tidak ada online converter bereputasi baik yang dapat menerjemahkan JavaScript arbitrer secara andal menjadi Java class yang setara atau executable JAR mandiri. Online archive tool terkadang dapat membuat package mirip ZIP, tetapi tool tersebut tidak dapat menyimpulkan Java entry point, menginstal JavaScript engine, me-resolve dependency npm atau browser, atau menguji runtime behavior.

Untuk single-file archive yang tidak sensitif, online ZIP creator mungkin dapat digunakan hanya jika penerima menerima plain archive dan Anda memverifikasi isinya setelah itu; mengganti nama .zip yang diunduh menjadi .jar bukan pengganti untuk membuatnya dengan JDK. Gunakan command jar dari JDK lokal, IntelliJ IDEA, Maven, atau Gradle untuk source code dan project multi-file, serta jangan upload script proprietary ke online service.

Pemeriksaan kompatibilitas

Uji script dalam runtime yang sama persis dengan yang ditujukan untuk JAR. Browser global tidak tersedia di Node.js atau GraalJS, module Node.js tidak otomatis berfungsi di GraalJS, dan Java host access mungkin memerlukan konfigurasi eksplisit. Pastikan relative path, file permission, character encoding, native library, network access, environment variable, dan semua third-party dependency.

JAR yang hanya berisi script.js adalah archive. Package yang dapat dijalankan memerlukan Java launcher, JavaScript engine yang kompatibel, manifest entry Main-Class yang valid, dan dependency layout yang berfungsi pada JDK target.