{"id":13487659,"url":"https://github.com/reactor/reactor-netty","last_synced_at":"2025-05-12T05:23:06.045Z","repository":{"id":37430882,"uuid":"66030306","full_name":"reactor/reactor-netty","owner":"reactor","description":"TCP/HTTP/UDP/QUIC client/server with Reactor over Netty","archived":false,"fork":false,"pushed_at":"2025-05-12T02:24:32.000Z","size":27585,"stargazers_count":2673,"open_issues_count":48,"forks_count":669,"subscribers_count":107,"default_branch":"main","last_synced_at":"2025-05-12T02:40:17.193Z","etag":null,"topics":["flux","http","ipc","mono","netty","quic","reactive","reactive-streams","reactor","reactor3","tcp","udp"],"latest_commit_sha":null,"homepage":"https://projectreactor.io","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reactor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-08-18T20:58:56.000Z","updated_at":"2025-05-12T01:26:51.000Z","dependencies_parsed_at":"2023-10-22T05:33:19.182Z","dependency_job_id":"bf2357cd-c5b7-4846-9b0d-4082fb5c319d","html_url":"https://github.com/reactor/reactor-netty","commit_stats":{"total_commits":3830,"total_committers":131,"mean_commits":"29.236641221374047","dds":0.7407310704960836,"last_synced_commit":"b6650cb82981b62cdd937d0376c4c1d8c593ed80"},"previous_names":[],"tags_count":192,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactor%2Freactor-netty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactor%2Freactor-netty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactor%2Freactor-netty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reactor%2Freactor-netty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reactor","download_url":"https://codeload.github.com/reactor/reactor-netty/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253672698,"owners_count":21945480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flux","http","ipc","mono","netty","quic","reactive","reactive-streams","reactor","reactor3","tcp","udp"],"created_at":"2024-07-31T18:01:01.751Z","updated_at":"2025-05-12T05:23:05.996Z","avatar_url":"https://github.com/reactor.png","language":"Java","readme":"# Reactor Netty\n\n[![Join the chat at https://gitter.im/reactor/reactor-netty](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/reactor/reactor-netty)\n\n[![Reactor Netty](https://img.shields.io/maven-central/v/io.projectreactor.netty/reactor-netty.svg?colorB=brightgreen)](https://mvnrepository.com/artifact/io.projectreactor.netty/reactor-netty)\n\n[![publish](https://github.com/reactor/reactor-netty/actions/workflows/publish.yml/badge.svg)](https://github.com/reactor/reactor-netty/actions/workflows/publish.yml) [![CodeQL](https://github.com/reactor/reactor-netty/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/reactor/reactor-netty/actions/workflows/codeql-analysis.yml)\n\n`Reactor Netty` offers non-blocking and backpressure-ready `TCP`/`HTTP`/`UDP`/`QUIC`\nclients \u0026 servers based on `Netty` framework.\n\n## Getting it\n`Reactor Netty` requires Java 8 or + to run.\n\nWith `Gradle` from [repo.spring.io](https://repo.spring.io) or `Maven Central` repositories (stable releases only):\n\n```groovy\n    repositories {\n      //maven { url 'https://repo.spring.io/snapshot' }\n      mavenCentral()\n    }\n\n    dependencies {\n      //compile \"io.projectreactor.netty:reactor-netty-core:1.3.0-SNAPSHOT\"\n      compile \"io.projectreactor.netty:reactor-netty-core:1.3.0-M2\"\n      //compile \"io.projectreactor.netty:reactor-netty-http:1.3.0-SNAPSHOT\"\n      compile \"io.projectreactor.netty:reactor-netty-http:1.3.0-M2\"\n    }\n```\n\nSee the [Reference documentation](https://projectreactor.io/docs/netty/release/reference/index.html#getting)\nfor more information on getting it (eg. using `Maven`, or on how to get milestones and snapshots).\n\n\n## Getting Started\nNew to `Reactor Netty`? Check this [Reactor Netty Workshop](https://violetagg.github.io/reactor-netty-workshop/)\nand the [Reference documentation](https://projectreactor.io/docs/netty/release/reference/index.html)\n\nHere is a very simple `HTTP` server and the corresponding `HTTP` client example\n\n```java\nHttpServer.create()   // Prepares an HTTP server ready for configuration\n          .port(0)    // Configures the port number as zero, this will let the system pick up\n                      // an ephemeral port when binding the server\n          .route(routes -\u003e\n                      // The server will respond only on POST requests\n                      // where the path starts with /test and then there is path parameter\n                  routes.post(\"/test/{param}\", (request, response) -\u003e\n                          response.sendString(request.receive()\n                                                     .asString()\n                                                     .map(s -\u003e s + ' ' + request.param(\"param\") + '!')\n                                                     .log(\"http-server\"))))\n          .bindNow(); // Starts the server in a blocking fashion, and waits for it to finish its initialization\n```\n\n```java\nHttpClient.create()             // Prepares an HTTP client ready for configuration\n          .port(server.port())  // Obtains the server's port and provides it as a port to which this\n                                // client should connect\n          .post()               // Specifies that POST method will be used\n          .uri(\"/test/World\")   // Specifies the path\n          .send(ByteBufFlux.fromString(Flux.just(\"Hello\")))  // Sends the request body\n          .responseContent()    // Receives the response body\n          .aggregate()\n          .asString()\n          .log(\"http-client\")\n          .block();\n\n```\n\n## Getting help\nHaving trouble with `Reactor Netty`? We'd like to help!\n* If you are upgrading, read the [release notes](https://github.com/reactor/reactor-netty/releases)\n  for upgrade instructions and *new and noteworthy* features.\n* Ask a question - we monitor [stackoverflow.com](https://stackoverflow.com) for questions\n  tagged with [`reactor-netty`](https://stackoverflow.com/questions/tagged/reactor-netty). You can also chat\n  with the community on [Gitter](https://gitter.im/reactor/reactor-netty).\n* Report bugs with `Reactor Netty` at [github.com/reactor/reactor-netty/issues](https://github.com/reactor/reactor-netty/issues).\n* More about [Support and Deprecation policies](https://github.com/reactor/.github/blob/main/SUPPORT.adoc)\n\n## Reporting Issues\n`Reactor Netty` uses `GitHub’s` integrated issue tracking system to record bugs and feature requests.\nIf you want to raise an issue, please follow the recommendations below:\n* Before you log a bug, please [search the issue tracker](https://github.com/reactor/reactor-netty/search?type=Issues)\n  to see if someone has already reported the problem.\n* If the issue doesn't already exist, [create a new issue](https://github.com/reactor/reactor-netty/issues/new/choose).\n* Please provide as much information as possible with the issue report, we like to know\n  the version of `Reactor Netty` that you are using, as well as your `Operating System` and\n  `JVM` version.\n* If you want to raise a security vulnerability, please review our [Security Policy](https://github.com/reactor/reactor-netty/security/policy) for more details.\n\n## Contributing\nSee our [Contributing Guide](https://github.com/reactor/.github/blob/main/CONTRIBUTING.md) for information about contributing to `Reactor Netty`.\n\n## Building from Source\nYou don't need to build from source to use `Reactor Netty` (binaries in\n[repo.spring.io](https://repo.spring.io)), but if you want to try out the latest and\ngreatest, `Reactor Netty` can be easily built with the\n[gradle wrapper](https://docs.gradle.org/current/userguide/gradle_wrapper.html). You also need JDK 1.8.\n\n```shell\n$ git clone https://github.com/reactor/reactor-netty.git\n$ cd reactor-netty\n$ ./gradlew build\n```\n\nIf you want to publish the artifacts to your local `Maven` repository use:\n\n```shell\n$ ./gradlew publishToMavenLocal\n```\n\n## Javadoc\nhttps://projectreactor.io/docs/netty/release/api/\n\n## Guides\n\n* https://projectreactor.io/docs/netty/release/reference/index.html\n* https://violetagg.github.io/reactor-netty-workshop/\n\n## License\n`Reactor Netty` is Open Source Software released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)\n","funding_links":[],"categories":["Java","网络编程"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freactor%2Freactor-netty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freactor%2Freactor-netty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freactor%2Freactor-netty/lists"}