jaguar

Jaguar

Jaguar adalah kerangka kerja server http siap produksi penuh yang dibangun agar cepat, sederhana dan intuitif.

Memulai

Cara yang akrab untuk menulis rute

Jaguar Class menyediakan metode get , put , post , delete dan options untuk dengan cepat menambahkan penangan rute untuk metode HTTP tertentu.

 main () async {
  final server = Jaguar ();  // Serves the API at localhost:8080 by default
  // Add a route handler for 'GET' method at path '/hello'
  server. get ( '/hello' , ( Context ctx) => 'Hello world!' );
  await server. serve ();
}

Pencocokan rute yang kuat

Mudah mendefinisikan dan mengakses parameter jalur

Segmen jalur diawali dengan : dapat mencocokkan nilai apa pun dan juga ditangkap sebagai variabel jalur. Variabel jalur dapat diakses menggunakan pathParams Anggota Objek Context .

 main ( List < String > args) async {
  final quotes = < String > [
    'But man is not made for defeat. A man can be destroyed but not defeated.' ,
    'When you reach the end of your rope, tie a knot in it and hang on.' ,
    'Learning never exhausts the mind.' ,
  ];

  final server = Jaguar ();
  server. get ( '/api/quote/:index' , (ctx) { // The magic!
    final int index = ctx.pathParams. getInt ( 'index' , 1 );  // The magic!
    return quotes[index + 1 ];
  });
  await server. serve ();
}

• Jalur dapat memiliki beberapa variabel jalur.
• Variabel jalur dapat muncul pada posisi apa pun di jalur.
• Variabel jalur dapat dicocokkan dengan ekspresi reguler.
• Metode getInt , getDouble , getNum dan getBool dapat digunakan untuk dengan mudah mengetik variabel jalur.
• Menggunakan * sebagai segmen jalur akhir menangkap/mencocokkan semua segmen berikut.

Parameter Kueri Mengakses Mudah

Parameter kueri dapat diakses menggunakan anggota queryParams dari objek Context .

 main ( List < String > args) async {
  final quotes = < String > [
    'But man is not made for defeat. A man can be destroyed but not defeated.' ,
    'When you reach the end of your rope, tie a knot in it and hang on.' ,
    'Learning never exhausts the mind.' ,
  ];

  final server = Jaguar ();
  server. get ( '/api/quote' , (ctx) {
    final int index = ctx.queryParams. getInt ( 'index' , 1 ); // The magic!
    return quotes[index + 1 ];
  });
  await server. serve ();
}

Metode getInt , getDouble , getNum dan getBool dapat digunakan untuk dengan mudah mengetik parameter kueri ke dalam jenis yang diinginkan.

Satu liner untuk mengakses formulir

Satu baris adalah semua yang diperlukan untuk mendapatkan formulir sebagai Map<String, String> menggunakan metode bodyAsUrlEncodedForm pada objek Request .

 main ( List < String > arguments) async {
  final server = Jaguar (port : 8005 );

  server. postJson ( '/api/add' , (ctx) async {
      final Map < String , String > map = await ctx.req. bodyAsUrlEncodedForm (); // The magic!
      contacts. add ( Contact . create (map));
      return contacts. map ((ct) => ct.toMap). toList ();
    });


  await server. serve ();
}

Satu liner untuk menyajikan file statis

Metode staticFiles menambahkan file statis ke Jaguar Server. Argumen pertama menentukan permintaan URI bahwa banyak yang cocok dan argumen kedua menentukan direktori dari mana file target diambil.

 main () async {
  final server = Jaguar ();
  server. staticFiles ( '/static/*' , 'static' ); // The magic!
  await server. serve ();
}

Serialisasi JSON dengan sedikit usaha

Decoding Permintaan JSON tidak bisa lebih sederhana daripada menggunakan salah satu metode bodyAsJson , bodyAsJsonMap atau bodyAsJsonList pada objek Request .

 Future < void > main ( List < String > args) async {
  final server = Jaguar ();
  server. postJson ( '/api/book' , ( Context ctx) async {
    // Decode request body as JSON Map
    final Map < String , dynamic > json = await ctx.req. bodyAsJsonMap ();
    Book book = Book . fromMap (json);
    return book; // Automatically encodes Book to JSON
  });

  await server. serve ();
}

Dukungan sesi out-of-the-box

 main () async {
  final server = Jaguar ();
  server. get ( '/api/add/:item' , (ctx) async {
    final Session session = await ctx.req.session;
    final String newItem = ctx.pathParams.item;

    final List < String > items = (session[ 'items' ] ?? '' ). split ( ',' );

    // Add item to shopping cart stored on session
    if ( ! items. contains (newItem)) {
      items. add (newItem);
      session[ 'items' ] = items. join ( ',' );
    }

    return Response . redirect ( '/' );
  });
  server. get ( '/api/remove/:item' , (ctx) async {
    final Session session = await ctx.req.session;
    final String newItem = ctx.pathParams.item;

    final List < String > items = (session[ 'items' ] ?? '' ). split ( ',' );

    // Remove item from shopping cart stored on session
    if (items. contains (newItem)) {
      items. remove (newItem);
      session[ 'items' ] = items. join ( ',' );
    }

    return Response . redirect ( '/' );
  });
  await server. serve ();
}