Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

Definition

Excerpt

A container executing in the same JVM where Cargo is running

Explanation

An embedded container means that Cargo is using directly the container's Java API to control it. If you're using one of the embedded implementation you'll need to ensure that you have the container's JARs in your classpath.

Advantages of embbeded mode:

  • Faster. There's no need to start a new JVM nor new threads.
  • Simpler. There's no need to install the container in a directory.
Info
titleInstalling a container

Please note that CARGO simplifies container installation thanks to its installers; which can automatically download, extract and save the container for you.


Disadvantages of embbeded mode:

  • Potentially difficult to control: the server will inherit whatever has existed in the JVM before the launch, such as predefined properties, existing ClassLoaders, some preinitialized components (XML parsers, etc.) and others.

Here is the list of container implementations that support the embedded mode:

  • Jetty4xEmbeddedContainer: Jetty 4.x implementation
  • Jetty5xEmbeddedContainer: Jetty 5.x implementation
  • Jetty6xEmbeddedContainer: Jetty 6.x implementation
  • Jetty7xEmbeddedContainer: Jetty 7.x implementation