{"id":19316849,"url":"https://github.com/atmosphere/nettosphere","last_synced_at":"2025-05-15T11:08:14.112Z","repository":{"id":2429317,"uuid":"3398614","full_name":"Atmosphere/nettosphere","owner":"Atmosphere","description":"A Java WebSocket/HTTP server based on the Atmosphere and Netty Framework","archived":false,"fork":false,"pushed_at":"2025-01-21T16:21:26.000Z","size":2997,"stargazers_count":323,"open_issues_count":12,"forks_count":82,"subscribers_count":31,"default_branch":"master","last_synced_at":"2025-05-15T11:08:11.792Z","etag":null,"topics":["atmosphere","java","netty-framework","reactive"],"latest_commit_sha":null,"homepage":"http://async-io.org/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Atmosphere.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":["atmosphere"]}},"created_at":"2012-02-09T16:05:45.000Z","updated_at":"2025-04-16T18:22:39.000Z","dependencies_parsed_at":"2024-11-10T01:13:07.886Z","dependency_job_id":"16d888f2-f077-46c2-a0b0-0fc865fc8248","html_url":"https://github.com/Atmosphere/nettosphere","commit_stats":{"total_commits":787,"total_committers":21,"mean_commits":"37.476190476190474","dds":0.09402795425667088,"last_synced_commit":"7482e6ad9041f7f827d26bcf44df1a0055e700d1"},"previous_names":[],"tags_count":80,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Atmosphere%2Fnettosphere","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Atmosphere%2Fnettosphere/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Atmosphere%2Fnettosphere/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Atmosphere%2Fnettosphere/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Atmosphere","download_url":"https://codeload.github.com/Atmosphere/nettosphere/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328384,"owners_count":22052632,"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":["atmosphere","java","netty-framework","reactive"],"created_at":"2024-11-10T01:12:54.631Z","updated_at":"2025-05-15T11:08:14.092Z","avatar_url":"https://github.com/Atmosphere.png","language":"Java","funding_links":["https://github.com/sponsors/atmosphere"],"categories":[],"sub_categories":[],"readme":"## Nettosphere: A Java WebSocket and HTTP server powered by the [Atmosphere Framework](http://github.com/Atmosphere/atmosphere) and the [Netty Framework](http://netty.io/)\n\nThe easiest way to get started with NettoSphere is to download a sample and start it. [Or look at the Javadoc](http://atmosphere.github.io/nettosphere/apidocs/). You can download one of our [sample](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.atmosphere.nettosphere.samples%22) distribution.\n\n```bash\n   % unzip nettosphere-\u003cname\u003e-distribution.jar\n   % chmod a+x ./bin/nettosphere.sh\n   % ./bin/nettosphere.sh\n```\n\n[Samples](https://github.com/Atmosphere/atmosphere-samples/tree/master/nettosphere-samples) are the same as the ones available in Atmosphere. Bootstrap classes looks like [Bootstrap](https://github.com/Atmosphere/atmosphere-samples/blob/master/nettosphere-samples/chat/src/main/java/org/nettosphere/samples/chat/NettosphereChat.java#L27) or [Bootstrap Jersey](https://github.com/Atmosphere/atmosphere-samples/blob/master/nettosphere-samples/jersey-chat/src/main/java/org/nettosphere/samples/chat/NettosphereJerseyChat.java#L31)\n\nDownload Nettosphere [here](http://search.maven.org/#search%7Cga%7C1%7Cnettosphere) or use Maven\n\n```xml\n     \u003cdependency\u003e\n         \u003cgroupId\u003eorg.atmosphere\u003c/groupId\u003e\n         \u003cartifactId\u003enettosphere\u003c/artifactId\u003e\n         \u003cversion\u003e3.2.7\u003c/version\u003e\n     \u003c/dependency\u003e\n```\n![jdk8](https://github.com/Atmosphere/nettosphere/workflows/jdk8/badge.svg)\n![JDK11](https://github.com/Atmosphere/nettosphere/workflows/JDK11/badge.svg)\n![JDK13](https://github.com/Atmosphere/nettosphere/workflows/JDK13/badge.svg)\n![JDK17](https://github.com/Atmosphere/nettosphere/workflows/JDK17/badge.svg)\n![JDK18](https://github.com/Atmosphere/nettosphere/workflows/JDK18/badge.svg)\n### Super Simple Web Application\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .resource(MyClass.class)\n                    .build())\n                 .build();\n    server.start();\n```\n\nor\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .resource(new Handler() {\n                        public void handle(AtmosphereResource r) {\n                            try {\n                                r.getResponse().write(\"Hello World\").write(\" from Nettosphere\").flushBuffer();\n                            } catch (IOException e) {\n                                e.printStackTrace();\n                            }\n                        }\n                    })\n                    .build())\n                 .build();\n    server.start();\n```\n[Top](#Top)\n\n### Server static and dynamic resources, use atmosphere.xml to configure NettoSphere\n\n```java\n        Config.Builder b = new Config.Builder();\n        b.resource(\"./webapps\")\n            .port(8080)\n            .host(\"127.0.0.1\")\n            .configFile(\"../conf/atmosphere.xml\")\n            .build();\n        Nettosphere s = new Nettosphere.Builder().config(b.build()).build();\n```\n[Top](#Top)\n\n### Deploy a Resource (annotated using Jersey), access it using HTTP or WebSocket\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .resource(MyResource.class)\n                    .build())\n                 .build();\n    server.start();\n```\n[Top](#Top)\n\n### Deploy an AtmosphereHandler, access it using HTTP or WebSocket\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .resource(\"/*\", MyAtmosphereHandler.class)\n                    .build())\n                 .build();\n    server.start();\n```\n\n### Deploy an AtmosphereHandler, define a WebSocket protocol\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .webSocketProtocol(JMSOverWebSocketProtocol.class)\n                    .resource(\"/*\", MyAtmosphereHandler.class)\n                    .build())\n                 .build();\n    server.start();\n```\n[Top](#Top)\n\n### Deploy a Servlet which use Meteor\n\n```java\n    Nettosphere server = new Nettosphere.Builder().config(\n                 new Config.Builder()\n                    .host(\"127.0.0.1\")\n                    .port(8080)\n                    .resource(\"/*\", MyServlet.class)\n                    .build())\n                 .build();\n    server.start();\n```\n[Top](#Top)\n\n### The Server can also be started using java\n\n```java\n    java -cp nettosphere-all.jar\n          org.atmosphere.nettosphere.Nettosphere\n                [/path/to/an/exploded/war/file] [host] [port]\n```\n[Top](#Top)\n\n### Using Maven and the Git repo\n\n    mvn exec:java -Dexec.arguments='path to your exploded war file'\n\n#### Build Status\n\n[![Build Status](https://api.travis-ci.org/Atmosphere/nettosphere.svg?branch=master)](https://travis-ci.org/Atmosphere/nettosphere)\n\n#### [Change Log](./CHANGELOG.md)\n\n* 3.0.x release Netty 4.1.21.Final and Atmosphere 2.4.20 support.\n* 2.3 release: [2.3.3](https://github.com/Atmosphere/nettosphere/issues?q=label%3A2.3.3+is%3Aclosed) [2.3.2](https://goo.gl/gaTKLZ ) [2.3.1](https://github.com/Atmosphere/nettosphere/issues?q=label%3A2.3.1+is%3Aclosed) [2.3.0](https://github.com/Atmosphere/nettosphere/issues?q=label%3A2.3.0+is%3Aclosed)\n* 2.1 release: [2.1.1](https://github.com/Atmosphere/nettosphere/issues?labels=2.1.1\u0026page=1\u0026sort=updated\u0026state=closed)\n* 2.0 release: [2.0.2](https://github.com/Atmosphere/nettosphere/issues?labels=2.0.2\u0026page=1\u0026sort=updated\u0026state=closed) [2.0.1](https://github.com/Atmosphere/nettosphere/issues?labels=2.0.1\u0026milestone=\u0026page=1\u0026sort=updated\u0026state=closed)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatmosphere%2Fnettosphere","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatmosphere%2Fnettosphere","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatmosphere%2Fnettosphere/lists"}