https://github.com/cometd/cometd

The CometD project, a scalable comet (server push) implementation for web messaging.
https://github.com/cometd/cometd

Last synced: 10 months ago
JSON representation

The CometD project, a scalable comet (server push) implementation for web messaging.

• Host: GitHub
• URL: https://github.com/cometd/cometd
• Owner: cometd
• License: apache-2.0
• Created: 2011-05-18T11:55:11.000Z (almost 15 years ago)
• Default Branch: 8.0.x
• Last Pushed: 2025-05-12T13:37:57.000Z (10 months ago)
• Last Synced: 2025-05-12T14:55:13.211Z (10 months ago)
• Language: Java
• Homepage: https://cometd.org
• Size: 26.5 MB
• Stars: 573
• Watchers: 51
• Forks: 206
• Open Issues: 58
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-java - CometD

README

          
## The CometD Project

Welcome to the [CometD](https://cometd.org) Project, a scalable comet (server push) implementation for the web.

### CometD Versions

| CometD Version | Min Java Version | Min Jetty Version | Servlet APIs             |

|----------------|------------------|-------------------|--------------------------|

| `8.0.x`        | Java 17          | Jetty 12.0.x      | EE10 `jakarta.servlet.*` |

| `7.0.x`        | Java 11          | Jetty 11.0.x      | EE9  `jakarta.servlet.*` |

| `6.0.x`        | Java 11          | Jetty 10.0.x      | EE8  `javax.servlet.*`   |

| `5.0.x`        | Java 8           | Jetty 9.4.x       | EE7  `javax.servlet.*`   |

### CometD License

The CometD source code is released under the Apache 2.0 License.

### Project Directory Layout

    cometd-archetypes    - The Maven archetypes for quick application development

    cometd-demo          - Demo of the Java server and of the ES6/jQuery clients

    cometd-documentation - The CometD documentation

    cometd-java          - The Java server and java client libraries

    cometd-javascript    - The JavaScript (ES6/jQuery) client libraries

### Running the CometD Demo

If you have [downloaded](https://download.cometd.org) the release bundle, then the CometD is already built for you.

To run the demonstration with Maven, unzip the release bundle and execute:

    $ cd cometd-demo

    $ mvn jetty:run

then point your browser at http://localhost:8080

Alternately you can deploy the CometD demo war file into

any Servlet 2.5 or later server (e.g. jetty, tomcat, glassfish)

with commands like:

    $ cp cometd-demo/target/cometd-demo/target/cometd-demo-*.war  $MY_SERVER/webapps/cometd.war

    cd $MY_SERVER

    

### Reporting Issues

Issues, bugs and requests for enhancements should be filed at https://bugs.cometd.org

### Building CometD

If you have cloned the source release, follow the instructions at

https://docs.cometd.org/current/reference/#_build, or just do:

    $ mvn install

### CometD Benchmark

The [CometD Benchmark](https://docs.cometd.org/current/reference/#_benchmarking) can be run interactively or in batch mode.

To run the server interactively, open a terminal window and type:

    $ cd cometd-java/cometd-java-benchmark/cometd-java-benchmark-server/

    $ mvn exec:exec

Then follow the instructions printed in the terminal.

To run the client interactively, open another terminal window (potentially on another machine), and type:

    $ cd cometd-java/cometd-java-benchmark/cometd-java-benchmark-client/

    $ mvn exec:exec

Then follow instructions printed on the terminal to generate the load.