minum

Kerangka Web Minum

Saat Anda membutuhkan bagian bergerak paling sedikit

Program Minum paling sederhana (lihat lebih banyak sampel kode di bawah):

 public class Main {
    public static void main ( String [] args ) {
        var minum = FullSystem . initialize ();
        var wf = minum . getWebFramework ();
        wf . registerPath ( GET , "" ,
                r -> Response . htmlOk ( "<p>Hi there world!</p>" ));
        minum . block ();
    }
}

Apa ini?

Kerangka kerja web ini, "Minum", memberikan fondasi minimalis bertenaga penuh untuk aplikasi web. Untuk TDD, oleh TDD.

• Memiliki server web sendiri, perutean titik akhir, penebangan, mesin templating, parser html, kerangka kerja penegasan, dan database
• Sekitar 100% cakupan tes yang berjalan dalam 30 detik tanpa pengaturan khusus ( make test_coverage )
• Hampir 100% kekuatan uji mutasi menggunakan alat paling pitest. ( make mutation_test )
• Tidak bergantung pada tidak ada dependensi selain Java 21 SDK - IE No Netty, Jetty, Tomcat, Log4j, Hibernate, MySQL, dll.
• Terdokumentasi dengan baik
• Tidak menggunakan refleksi
• Tidak membutuhkan anotasi
• Tidak ada sihir
• Memiliki contoh penggunaan kerangka kerja:
  • proyek kecil, sebagai dasar untuk memulai
  • proyek kecil, menunjukkan beberapa kasus penggunaan minimal
  • aplikasi lengkap yang menunjukkan penggunaan realistis

Minum adalah lima ribu baris kode - pesaing "minimalis" berkisar dari 400.000 hingga 700.000 baris ketika memperhitungkan dependensi mereka. Saya belum menemukan proyek serupa.

Menerapkan pendekatan minimalis memungkinkan debugging, pemeliharaan, dan biaya keseluruhan yang lebih mudah. Sebagian besar kerangka kerja perdagangan start-up lebih cepat dengan biaya keseluruhan yang lebih tinggi. Jika Anda membutuhkan kualitas berkelanjutan, perangkat lunak harus diuji dengan baik dan didokumentasikan sejak awal. Sebagai contoh, kemampuan proyek ini untuk mencapai cakupan uji yang tinggi sangat dimungkinkan oleh paradigma minimalisme.

Memulai

Ada awal yang cepat, atau jika Anda memiliki sedikit lebih banyak waktu, pertimbangkan untuk mencoba tutorial

Maven

< dependency >
    < groupId >com.renomad</ groupId >
    < artifactId >minum</ artifactId >
    < version >8.0.5</ version >
</ dependency >

Fitur:

• Secure TLS 1.3 HTTP/1.1 Server Web
• Database dalam memori dengan kegigihan disk
• Templating sisi server
• Kerangka Pencatatan
• Kerangka Pengujian
• HTML Parsing
• Prosesor antrian latar belakang

Perbandingan Ukuran:

Ukuran yang dikompilasi: 200 kilobytes.

Lini Kode Produksi (termasuk dependensi yang diperlukan)

Minum	Javalin	Boot musim semi
5.335	141.048	1.085.405

Lihat detailnya

Pertunjukan:

• 19.000 respons server web HTTP per detik. Detail
• 2.000.000 pembaruan basis data per detik. Detail
• 31.717 templat yang diterjemahkan per detik. Lihat "test_templating_performance" di sini. Juga, lihat tolok ukur perbandingan ini, dengan kode Minum diwakili di sini.

Lihat Perbandingan Kinerja Kerangka

Dokumentasi:

• Buku Pegangan Pengembangan
• Javadocs
• Cakupan Kode
• Laporan Tes Mutasi
• Berbagai laporan

Contoh proyek yang menunjukkan penggunaan:

Lihat tautan berikut untuk proyek sampel yang menggunakan kerangka kerja ini.

Yang paling kecil

Proyek ini sangat berharga untuk melihat aplikasi minimal yang dapat dibuat. Ini mungkin titik awal yang baik untuk penggunaan minum pada proyek baru.

---

Contoh

Ini adalah contoh yang baik untuk melihat proyek dasar dengan berbagai fungsionalitas. Ini menunjukkan banyak kasus penggunaan khas dari kerangka kerja minum.

---

Proyek Memoria

Ini adalah proyek pohon keluarga. Ini menunjukkan jenis pendekatan kerangka kerja ini dimaksudkan untuk dibina.

Sampel kode

Instantiating database baru:

 var db = new Db <>( foosDirectory , context , new Foo ());

Menambahkan objek baru ke database:

 var foo = new Foo ( 0L , 42 , "blue" );
db . write ( foo );    

Memperbarui objek dalam database:

 foo . setColor ( "orange" );
db . write ( foo );    

Menghapus dari database:

 db . delete ( foo );    

Menulis Pernyataan Log:

 logger . logDebug (() -> "hello" );

Menguras dokumen HTML:

 List < HtmlParseNode > results = new HtmlParser (). parse ( "<p></p>" );

Mencari elemen dalam grafik parsed:

 HtmlParseNode node ;
List < HtmlParseNode > results = node . search ( TagName . P , Map . of ());

Membuat penangan web baru (fungsi yang menangani permintaan HTTP dan mengembalikan respons):

 public Response myHandler ( Request r ) {
  return Response . htmlOk ( "<p>Hi world!</p>" );
}

Mendaftarkan titik akhir itu:

 webFramework . registerPath ( GET , "formentry" , sd :: formEntry );

Membangun dan membuat templat:

 TemplateProcessor foo = TemplateProcessor . buildProcessor ( "hello {{ name }}" );
String rendered = foo . renderTemplate ( Map . of ( "name" , "world" ));

Mendapatkan parameter kueri dari permintaan:

 String id = r . requestLine (). queryString (). get ( "id" );

Mendapatkan parameter tubuh dari permintaan, sebagai string:

 String personId = request . body (). asString ( "person_id" );

Dapatkan parameter jalur dari permintaan sebagai string:

 Pattern requestRegex = Pattern . compile ( ".well-known/acme-challenge/(?<challengeValue>.*$)" );
final var challengeMatcher = requestRegex . matcher ( request . requestLine (). getPathDetails (). isolatedPath ());
// When the find command is run, it changes state so we can search by matching group
if (! challengeMatcher . find ()) {
    return new Response ( StatusLine . StatusCode . CODE_400_BAD_REQUEST );
}
String tokenFileName = challengeMatcher . group ( "challengeValue" );

Mendapatkan parameter tubuh dari permintaan, sebagai array byte:

 byte [] photoBytes = body . asBytes ( "image_uploads" );

Memeriksa pesan log selama pengujian:

 assertTrue ( logger . doesMessageExist ( "Bad path requested at readFile: ../testingreadfile.txt" ));