shio rs

Shio

O Shio é um micro-quadro de micro-web rápido, simples e assíncrono para ferrugem.

• Assíncrono . Os manipuladores são tratados de forma assíncrona e podem ser assíncronos . Um shio::Handler recebe um tokio_core::reactor::Handle , que pode ser usado para agendar um trabalho adicional no loop de eventos locais de threads.

• Multithreaded . Por padrão, as solicitações são tratadas por vários threads, cada um executando um loop de evento alimentado por tokio .

• Estabilidade . Shio está totalmente comprometido em trabalhar e continuar trabalhando com ferrugem estável .

Uso

[ dependencies ]
shio = " 0.2.0 " 

 extern crate shio ;

use shio :: prelude :: * ;

fn hello_world ( _ : Context ) -> Response {
    Response :: with ( "Hello World! n " )
}

fn hello ( ctx : Context ) -> Response {
    Response :: with ( format ! ( "Hello, {}! n " , & ctx . get :: < Parameters > ( ) [ "name" ] ) )
}

fn main ( ) {
    Shio :: default ( )
        . route ( ( Method :: GET , "/" , hello_world ) )
        . route ( ( Method :: GET , "/{name}" , hello ) )
        . run ( ":7878" ) . unwrap ( ) ;
} 

Exemplos

Estado

Um manipulador de solicitação é um valor que implementa o traço shio::Handler .

Os manipuladores não são clonados em cada solicitação e, portanto, podem conter estado. Observe que quaisquer campos devem ser Send + Sync .

 extern crate shio ;

use std :: thread ;
use std :: sync :: atomic :: { AtomicUsize , Ordering } ;
use shio :: prelude :: * ;

# [ derive ( Default ) ]
struct HandlerWithState {
    counter : AtomicUsize ,
}

impl shio :: Handler for HandlerWithState {
    type Result = Response ;

    fn call ( & self , _ : Context ) -> Self :: Result {
        let counter = self . counter . fetch_add ( 1 , Ordering :: Relaxed ) ;

        Response :: with ( format ! (
            "Hi, #{} (from thread: {:?}) n " ,
            counter ,
            thread :: current ( ) . id ( )
        ) )
    }
}

Ainda mais exemplos

Muitos outros exemplos de uso/ estão incluídos no shio.

• Modelos de renderização com Askama
• Transmita uma solicitação HTTP com hiper
• PostGres com Tokio-PostGres

Exemplos podem ser executados com cargo run -p <example name> . Por exemplo, para executar o exemplo hello , use:

$ cargo run -p hello

Licença

Licenciado sob qualquer um de

• Licença Apache, versão 2.0 (licença-apache ou http://www.apache.org/license/license-2.0)
• MIT Licença (licença-mit ou http://opensource.org/license/mit)

por sua opção.

Contribuição

A menos que você declare explicitamente o contrário, qualquer contribuição intencionalmente enviada para inclusão no trabalho por você, conforme definida na licença Apache-2.0, será licenciado como acima, sem termos ou condições adicionais.