скачать pippo - скачать исходный код pippo

Micro Java Web Framework

Это микроам -структура с открытым исходным кодом (лицензия 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 - это простой поожо:

 public class Contact  {

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

    // getters and setters

}

Второй шаг - выбрать ваш любимый сервер, шаблонный двигатель и двигатель типа контента.
Например, я выберу Jetty в качестве сервера, Freemarker в качестве шаблонного двигателя, Jackson в качестве двигателя JSON и JAXB в качестве XML Engine.
Мой 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 запускает встроенный веб -сервер (найденный в вашем классе) и предоставляет приложение доступным на порту 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. Контроллеры подходят

Определите контроллер (ы):

 @ 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 );
    }

}

Не забывайте, что концепция Controller включена в модуль pippo-controller , поэтому вы должны добавить этот модуль в качестве зависимости в вашем проекте.