reactor netty

Реактор Нетти

Reactor Netty предлагает неблокирующиеся и готовые к противодавлению клиенты и серверы TCP / HTTP / UDP / QUIC на основе платформы Netty .

Получение этого

Для работы Reactor Netty требуется Java 8 или +.

С Gradle из репозитория repo.spring.io или Maven Central (только стабильные версии):

    repositories {
      // maven { url 'https://repo.spring.io/snapshot' }
      maven { url ' https://repo.spring.io/milestone ' }
      mavenCentral()
    }

    dependencies {
      // compile "io.projectreactor.netty:reactor-netty-core:1.2.2-SNAPSHOT"
      compile " io.projectreactor.netty:reactor-netty-core:1.2.1 "
      // compile "io.projectreactor.netty:reactor-netty-http:1.2.2-SNAPSHOT"
      compile " io.projectreactor.netty:reactor-netty-http:1.2.1 "
    }

См. справочную документацию для получения дополнительной информации о ее получении (например, с помощью Maven или о том, как получить вехи и снимки).

Начиная

Впервые в Reactor Netty ? Ознакомьтесь с этим семинаром Reactor Netty и справочной документацией.

Вот очень простой HTTP сервер и соответствующий пример HTTP клиента.

 HttpServer . create ()   // Prepares an HTTP server ready for configuration
          . port ( 0 )    // Configures the port number as zero, this will let the system pick up
                      // an ephemeral port when binding the server
          . route ( routes ->
                      // The server will respond only on POST requests
                      // where the path starts with /test and then there is path parameter
                  routes . post ( "/test/{param}" , ( request , response ) ->
                          response . sendString ( request . receive ()
                                                     . asString ()
                                                     . map ( s -> s + ' ' + request . param ( "param" ) + '!' )
                                                     . log ( "http-server" ))))
          . bindNow (); // Starts the server in a blocking fashion, and waits for it to finish its initialization 

 HttpClient . create ()             // Prepares an HTTP client ready for configuration
          . port ( server . port ())  // Obtains the server's port and provides it as a port to which this
                                // client should connect
          . post ()               // Specifies that POST method will be used
          . uri ( "/test/World" )   // Specifies the path
          . send ( ByteBufFlux . fromString ( Flux . just ( "Hello" )))  // Sends the request body
          . responseContent ()    // Receives the response body
          . aggregate ()
          . asString ()
          . log ( "http-client" )
          . block ();

Получение помощи

Возникли проблемы с Reactor Netty ? Мы хотели бы помочь!

• Если вы выполняете обновление, прочтите примечания к выпуску, чтобы получить инструкции по обновлению и новые интересные функции.
• Задайте вопрос — мы отслеживаем stackoverflow.com на предмет вопросов, отмеченных тегом reactor-netty . Вы также можете пообщаться с сообществом Gitter.
• Сообщайте об ошибках Reactor Netty на сайте github.com/reactor/reactor-netty/issues.
• Подробнее о политиках поддержки и прекращения поддержки

Отчеты о проблемах

Reactor Netty использует интегрированную систему отслеживания проблем GitHub's для регистрации ошибок и запросов функций. Если вы хотите поднять проблему, следуйте приведенным ниже рекомендациям:

• Прежде чем регистрировать ошибку, выполните поиск в системе отслеживания проблем, чтобы узнать, не сообщал ли кто-нибудь уже о проблеме.
• Если проблема еще не существует, создайте новую проблему.
• Пожалуйста, предоставьте как можно больше информации в отчете о проблеме. Нам хотелось бы знать версию Reactor Netty , которую вы используете, а также версию вашей Operating System и JVM .
• Если вы хотите сообщить об уязвимости безопасности, ознакомьтесь с нашей Политикой безопасности для получения более подробной информации.

Содействие

Информацию о том, как внести свой вклад в Reactor Netty , см. в нашем Руководстве для участников.

Сборка из исходного кода

Вам не нужно выполнять сборку из исходного кода, чтобы использовать Reactor Netty (бинарные файлы в repo.spring.io), но если вы хотите опробовать новейшую и лучшую версию, Reactor Netty можно легко собрать с помощью оболочки gradle. Вам также понадобится JDK 1.8.

$ git clone https://github.com/reactor/reactor-netty.git
$ cd reactor-netty
$ ./gradlew build

Если вы хотите опубликовать артефакты в локальном репозитории Maven используйте:

$ ./gradlew publishToMavenLocal

Javadoc

https://projectreactor.io/docs/netty/release/api/

Путеводители

• https://projectreactor.io/docs/netty/release/reference/index.html
• https://violetagg.github.io/reactor-netty-workshop/

Лицензия

Reactor Netty — это программное обеспечение с открытым исходным кодом, выпущенное по лицензии Apache 2.0.