Rocket adalah kerangka kerja web async untuk karat dengan fokus pada kegunaan, keamanan, ekstensibilitas, dan kecepatan.
#[macro_use] roket peti luar;#[get ("/<name>/<mua>")] fn halo (nama: & str, usia: u8) -> string {format! ("halo, {} tahun bernama bernama {}! ", Usia, Nama)}#[Luncurkan] fn rocket () -> _ {rocket :: build (). mount ("/hello ", rute! [halo])}
Mengunjungi localhost:8000/hello/John/58
, misalnya, akan memicu rute hello
yang menghasilkan string Hello, 58 year old named John!
dikirim ke browser. Jika string <age>
dilewatkan yang tidak dapat diuraikan sebagai u8
, rute tidak akan dipanggil, menghasilkan kesalahan 404.
Roket didokumentasikan secara luas:
Ikhtisar: Pandangan singkat tentang apa yang membuat roket istimewa.
QuickStart: Cara memulai secepat mungkin.
Memulai: Cara Memulai Proyek Roket Pertama Anda.
Panduan: Panduan terperinci dan referensi ke roket.
Dokumentasi API: "RustDocs".
Dokumentasi untuk cabang master
tersedia di https://rocket.rs/master dan https://api.rocket.rs/master.
Dokumentasi untuk versi rilis utama ${x}
tersedia di https://[api.]rocket.rs/v${x}
. Misalnya, dokumen V0.4 tersedia di https://rocket.rs/v0.4 dan https://api.rocket.rs/v0.4.
Akhirnya, API Docs for Active Git Branches tersedia di https://api.rocket.rs/${branch}
. Misalnya, dokumen API untuk cabang master
tersedia di https://api.rocket.rs/master. Cabang RustDocs dibangun dan dikerahkan pada setiap komit.
Direktori Contoh berisi peti lengkap yang menampilkan fitur dan penggunaan roket. Setiap contoh dapat dikompilasi dan dijalankan dengan kargo. Misalnya, urutan perintah berikut membangun dan menjalankan contoh hello
:
CD Contoh/Halo lari kargo
Jika Anda membutuhkan bantuan di luar dokumentasi, Anda dapat:
Ajukan pertanyaan melalui pertanyaan diskusi GitHub.
Obrolan dengan kami di #rocket:mozilla.org
di matriks (bergabunglah melalui elemen).
Kontribusi benar -benar, disambut secara positif dan didorong! Jika Anda tertarik untuk berkontribusi, silakan baca terlebih dahulu berkontribusi untuk pedoman lengkap. Selain itu, Anda bisa:
Kirimkan permintaan fitur atau laporan bug sebagai masalah.
Mintalah dokumentasi yang lebih baik sebagai masalah.
Komentari masalah yang membutuhkan umpan balik.
Menjawab pertanyaan dalam pertanyaan diskusi github.
Bagikan proyek dalam Diskusi GitHub Show & Tell.
Rocket dilisensikan di bawah salah satu dari yang berikut, atas pilihan Anda:
Lisensi Apache, Versi 2.0, (lisensi-apache atau https://www.apache.org/licenses/license-2.0)
Lisensi MIT (lisensi-mit atau https://opensource.org/licenses/mit)
Kecuali jika Anda secara eksplisit menyatakan sebaliknya, kontribusi apa pun secara sengaja diserahkan untuk dimasukkan dalam roket oleh Anda akan dilisensikan ganda di bawah lisensi MIT dan lisensi Apache, versi 2.0, tanpa syarat atau ketentuan tambahan.
Dokumen situs web roket dilisensikan dengan persyaratan terpisah. Kontribusi apa pun secara sengaja diserahkan untuk dimasukkan dalam dokumen situs web Rocket oleh Anda akan dilisensikan berdasarkan Ketentuan tersebut.