Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/puniverse/comsat-examples

Comsat Examples
https://github.com/puniverse/comsat-examples

Last synced: 4 days ago
JSON representation

Comsat Examples

Host: GitHub
URL: https://github.com/puniverse/comsat-examples
Owner: puniverse
Created: 2014-01-21T20:07:45.000Z (almost 11 years ago)
Default Branch: master
Last Pushed: 2015-10-22T12:38:42.000Z (about 9 years ago)
Last Synced: 2024-04-16T07:14:43.893Z (7 months ago)
Language: Java
Size: 15.5 MB
Stars: 48
Watchers: 11
Forks: 15
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# COMSAT Examples

This project includes some examples that makes use of an embedded Jetty servers and several others that are packaged into WAR files and can be deployed to servlet containers.

## Running the Jetty examples

In the shell:

```sh
gradle :comsat-examples-embeddedjetty:run
```

A Jetty web actors example can be run with:

```sh
gradle :comsat-examples-jetty-webactor:run
```

A Dropwizard example can be run with:

```sh
gradle :comsat-examples-dropwizard:runSimple
```

## Non-web examples

```sh
gradle :comsat-examples-db:runSimple
gradle :comsat-examples-retrofit:runSimple
```

## Running the WAR examples

For convenience, we've included a tiny program (`embedded-tomcat`) that runs a Tomcat server, creates a database, and compiles and deploys all WAR examples.

In the shell, type:

```sh
gradle :embedded-tomcat:run
```

Then, in a web browser, access any of the following links:

* [http://localhost:8080/comsat-examples-servlet/fiberservlet](http://localhost:8080/comsat-examples-servlet/fiberservlet) - a servlet that runs in a fiber.
* [http://localhost:8080/comsat-examples-jaxrs/rest/myresource](http://localhost:8080/comsat-examples-jaxrs/rest/myresource) - a JAX-RS REST service that runs in a fiber (the first time this is accessed, it will take a while as Jersey is initialized).
* [http://localhost:8080/comsat-examples-webactors/webactor](http://localhost:8080/comsat-examples-webactors/webactor) - a WebActors example

### Hot Code Swapping

1. Open an new shell and build the upgrade module:

```sh
gradle :comsat-examples-webactors-codeswap:jar
```

2. Run and access [http://localhost:8080/comsat-examples-webactors/webactor](http://localhost:8080/comsat-examples-webactors/webactor) as explained above.

3. Copy the upgrade module jar file into the `modules/` directory:

```sh
cp comsat-examples-webactors-codeswap/build/libs/comsat-examples-webactors-codeswap.jar modules
```

You will now see the new actor behave differently in the test web page.

## Running Spaceships

Stop the server if running and uncomment the following line in `embedded-tomcat/build.gradle`:

```
from project(":comsat-examples-spaceships").war
```

Restart the server with:

```sh
gradle :embedded-tomcat:run
```

Then, open [http://localhost:8080/comsat-examples-spaceships/login](http://localhost:8080/comsat-examples-spaceships/login) in your browser.

## License

These examples are released under the [MIT license](http://opensource.org/licenses/MIT).