تنزيل pippo - تنزيل رمز المصدر pippo

إطار الويب Micro Java

إنه إطار عمل مفتوح المصدر (Apache) في Java ، مع الحد الأدنى من التبعيات ومنحنى التعلم السريع.
الهدف من هذا المشروع هو إنشاء إطار ويب صغير في Java يجب أن يكون سهلاً في الاستخدام والاختراق.
يبلغ حجم pippo-core 140 كيلو بايت فقط وحجم pippo-controller (اختياري) فقط 45 كيلو بايت .

نموذج الرمز

1. نهج الطرق

أولاً ، يجب علينا إنشاء تطبيق وإضافة بعض الطرق:

 public class BasicApplication extends Application {

    @ Override
    protected void onInit () {
        // send 'Hello World' as response
        GET ( "/" , routeContext -> routeContext . send ( "Hello World" ));

        // send a file as response
        GET ( "/file" , routeContext -> routeContext . send ( new File ( "pom.xml" )));

        // send a json as response
        GET ( "/json" , routeContext -> {
            Contact contact = createContact ();
            routeContext . json (). send ( contact );
        });

        // send xml as response
        GET ( "/xml" , routeContext -> {
            Contact contact = createContact ();
            routeContext . xml (). send ( contact );
        });

        // send an object and negotiate the Response content-type, default to XML
        GET ( "/negotiate" , routeContext -> {
            Contact contact = createContact ();
            routeContext . xml (). negotiateContentType (). send ( contact );
        });

        // send a template with name "hello" as response
        GET ( "/template" , routeContext -> {
            routeContext . setLocal ( "greeting" , "Hello" );
            routeContext . render ( "hello" );
        });
    }

    private Contact createContact () {
        return new Contact ()
            . setId ( 12345 )
            . setName ( "John" )
            . setPhone ( "0733434435" )
            . setAddress ( "Sunflower Street, No. 6" );
    }

}

حيث Contact هو pojo بسيط:

 public class Contact  {

    private int id ;
    private String name ;
    private String phone ;
    private String address ;

    // getters and setters

}

الخطوة الثانية هي اختيار محرك المحرك ومحرك المحتوى المفضل لديك.
على سبيل المثال ، سأختار Jetty كخادم ، Freemarker كمحرك قالب ، Jackson كمحرك JSON و JAXB كمحرك XML.
يشبه Maven pom.xml :

< dependency >
    < groupId >ro.pippo</ groupId >
    < artifactId >pippo-core</ artifactId >
    < version >${pippo.version}</ version >
</ dependency >

< dependency >
    < groupId >ro.pippo</ groupId >
    < artifactId >pippo-jetty</ artifactId >
    < version >${pippo.version}</ version >
</ dependency >

< dependency >
    < groupId >ro.pippo</ groupId >
    < artifactId >pippo-freemarker</ artifactId >
    < version >${pippo.version}</ version >
</ dependency >

< dependency >
    < groupId >ro.pippo</ groupId >
    < artifactId >pippo-jackson</ artifactId >
    < version >${pippo.version}</ version >
</ dependency >

الخطوة الأخيرة هي بدء Pippo مع تطبيقك كمعلمة:

 public class BasicDemo {

    public static void main ( String [] args ) {
        Pippo pippo = new Pippo ( new BasicApplication ());
        pippo . start ();
    }

}

يقوم Pippo بتشغيل خادم الويب المدمج (الموجود في ClassPath الخاص بك) ويجعل التطبيق متاحًا على المنفذ 8338 (القيمة الافتراضية). افتح متصفح الإنترنت الخاص بك وتحقق من الطرق المعلنة في التطبيق:

http://localhost:8338
http://localhost:8338/file
http://localhost:8338/json
http://localhost:8338/xml
http://localhost:8338/negotiate
http://localhost:8338/template

2. نهج وحدات التحكم

تحديد وحدة التحكم (S):

 @ Path ( "/contacts" )
@ Logging
public class ContactsController extends Controller {

    private ContactService contactService ;

    public ContactsController () {
        contactService = new InMemoryContactService ();
    }

    @ GET
    @ Named ( "index" )
//    @Produces(Produces.HTML)
    @ Metered
    @ Logging
    public void index () {
        // inject "user" attribute in session
        getRouteContext (). setSession ( "user" , "decebal" );

        // send a template with name "contacts" as response
        getResponse ()
            . bind ( "contacts" , contactService . getContacts ())
            . render ( "contacts" );
    }

    @ GET ( "/uriFor/{id: [0-9]+}" )
    @ Named ( "uriFor" )
    @ Produces ( Produces . TEXT )
    @ Timed
    public String uriFor ( @ Param int id , @ Header String host , @ Session String user ) {
        System . out . println ( "id = " + id );
        System . out . println ( "host = " + host );
        System . out . println ( "user = " + user );

        Map < String , Object > parameters = new HashMap <>();
        parameters . put ( "id" , id );

        String uri = getApplication (). getRouter (). uriFor ( "api.get" , parameters );

        return "id = " + id + "; uri = " + uri ;
    }

    @ GET ( "/api" )
    @ Named ( "api.getAll" )
    @ Produces ( Produces . JSON )
    @ NoCache
    public List < Contact > getAll () {
        return contactService . getContacts ();
    }

    @ GET ( "/api/{id: [0-9]+}" )
    @ Named ( "api.get" )
    @ Produces ( Produces . JSON )
    public Contact get ( @ Param int id ) {
        return contactService . getContact ( id );
    }

}

 @ Path ( "/files" )
public class FilesController extends Controller {

    @ GET
    public void index () {
        // send a template with name "files" as response
        getRouteContext (). render ( "files" );
    }

    @ GET ( "/download" )
    public File download () {
        // send a file as response
        return new File ( "pom.xml" );
    }

    @ POST ( "/upload" )
    @ Produces ( Produces . TEXT )
    public String upload ( FileItem file ) {
        // send a text (the info about uploaded file) as response
//        return file.toString();
        return new StringBuilder ()
            . append ( file . getName ()). append ( " n " )
            . append ( file . getSubmittedFileName ()). append ( " n " )
            . append ( file . getSize ()). append ( " n " )
            . append ( file . getContentType ())
            . toString ();
    }

}

إضافة وحدة تحكم (أجهزة) في التطبيق الخاص بك:

 public class BasicApplication extends ControllerApplication {

    @ Override
    protected void onInit () {
        addControllers ( ContactsController . class ); // one instance for EACH request
        // OR
        addControllers ( new ContactsController ()); // one instance for ALL requests

        addControllers ( FilesController . class );
    }

}