Rocket es un marco web asíncrono para el óxido con un enfoque en la usabilidad, la seguridad, la extensibilidad y la velocidad.
#[Macro_use] Extern Crate Rocket;#[get ("/<Name>/<Age>")] Fn Hello (Nombre: & Str, Age: U8) -> String {Format! ("Hello, {} año Nombrado {}! ", edad, nombre)}#[lanzamiento] fn Rocket () -> _ {Rocket :: Build (). Mount ("/Hello ", Rutas! [Hola])}
Visitando localhost:8000/hello/John/58
, por ejemplo, activará la ruta hello
que resulta en la cadena Hello, 58 year old named John!
siendo enviado al navegador. Si se pasó una cadena <age>
que no se puede analizar como un u8
, la ruta no se llama, lo que resulta en un error 404.
Rocket está ampliamente documentado:
Descripción general: una breve mirada a lo que hace que Rocket sea especial.
QuickStart: cómo comenzar lo más rápido posible.
Comenzando: cómo comenzar su primer proyecto de cohete.
Guía: una guía detallada y referencia al cohete.
Documentación de API: los "Rustdocs".
La documentación para la rama master
está disponible en https://rockete.rs/master y https://api.rocket.rs/master.
La documentación para la versión de lanzamiento mayor ${x}
está disponible en https://[api.]rocket.rs/v${x}
. Por ejemplo, los documentos V0.4 están disponibles en https://rocket.rs/v0.4 y https://api.rocket.rs/v0.4.
Finalmente, los documentos de API para las ramas Git activas están disponibles en https://api.rocket.rs/${branch}
. Por ejemplo, los documentos de API para la rama master
están disponibles en https://api.rocket.rs/master. La rama Rustdocs se construye y se despliega en cada confirmación.
El directorio de ejemplos contiene cajas completas que muestran las características y el uso de Rocket. Cada ejemplo se puede compilar y ejecutar con carga. Por ejemplo, la siguiente secuencia de comandos construye y ejecuta el ejemplo hello
:
Ejemplos de CD/Hola carrera de carga
Si se encuentra con la necesidad de ayuda fuera de la documentación, puede:
Haga preguntas a través de preguntas de discusiones de GitHub.
Chatea con nosotros en #rocket:mozilla.org
en Matrix (Únete a través del elemento).
¡Las contribuciones son absolutamente bienvenidas y alentadas positivamente! Si está interesado en contribuir con código, primero lea la contribución de las pautas completas. Además, podrías:
Envíe una solicitud de función o informe de errores como un problema.
Solicite una mejor documentación como un problema.
Comente sobre temas que requieren comentarios.
Responde preguntas en las preguntas de discusiones de Github.
Comparta un proyecto en Github Discussions Show & Tell.
Rocket tiene licencia bajo cualquiera de los siguientes, a su opción:
Licencia Apache, versión 2.0, (licencia-apache o https://www.apache.org/licenses/license-2.0)
Licencia MIT (licencia-mit o https://opensource.org/licenses/Mit)
A menos que declare explícitamente lo contrario, cualquier contribución presentada intencionalmente para su inclusión en Rocket por usted tendrá licencia dual bajo la licencia MIT y la licencia Apache, versión 2.0, sin ningún término o condiciones adicionales.
Los documentos del sitio web de Rocket tienen licencia en términos separados. Cualquier contribución presentada intencionalmente para su inclusión en los documentos del sitio web de Rocket tendrá licencia bajo esos términos.