meecrowave-doc/src/main/jbake/content/start.adoc

= Quick start
:jbake-date: 2016-10-24
:jbake-type: page
:jbake-status: published
:jbake-meecrowavepdf:
:jbake-meecrowavecolor: body-green
:icons: font

== Your first application

=== Dependencies

Just add in any Maven `pom.xml` - or gradle `build.gradle` the following dependency:

[source,xml]
----
<dependency>
  <groupId>org.apache.meecrowave</groupId>
  <artifactId>meecrowave-core</artifactId>
  <version>${meecrowave.version}</version>
</dependency>
----

If you intend to reuse our `Cli` main you should also add:

[source,xml]
----
<dependency>
  <groupId>commons-cli</groupId>
  <artifactId>commons-cli</artifactId>
  <version>1.4</version>
</dependency>
----

=== Runtime

Meecrowave relies on JAX-RS and CDI so to start you just need to write a JAX-RS endpoint:

[source,java]
----
@Path("kitchen")
@ApplicationScoped
public class HelloKitchen {
    @GET
    public String getMenu() {
        return "good things";
    }
}
----

Then booting Meecrowave is as easy as launching - or reuse `org.apache.meecrowave.runner.Cli` provided main:

[source,java]
----
try (final Meecrowave meecrowave = new Meecrowave().bake()) {
    new Scanner(System.in).nextLine();
}
----

You should get some output containing:

[source]
----
[19:54:55.397][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup] REST Application: / -> org.apache.cxf.cdi.DefaultApplication
[19:54:55.399][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup]      Service URI: /kitchen  -> org.app.HelloKitchen
[19:54:55.401][INFO][main][.meecrowave.cxf.CxfCdiAutoSetup]               GET /kitchen/ ->      String getMenu()
----

And you can check it works doing:

[source]
----
curl http://localhost:8080/kitchen
----

== You're in a hurry? Use groovy!

IMPORTANT: this feature is supported starting from version 0.3.0 only.

Create a file called `hello.groovy`:

[source,java]
----
@Grab('org.apache.meecrowave:meecrowave-core:0.3.0')

import org.apache.meecrowave.Meecrowave

import javax.ws.rs.GET
import javax.ws.rs.Path
import javax.enterprise.context.ApplicationScoped

@Path("hello")
@ApplicationScoped
class Hello {
    @GET
    hi() {
        "hi"
    }
}

new Meecrowave().bake().await()
----

then

[source,bash]
----
groovy hello.groovy
----

Finally you can test it:

[source,bash]
----
curl http://localhost:8080/hello
----

== And my war?

See link:meecrowave-core/deploy-webapp.html[How to deploy a war] to see how to use meecrowave to deploy an existing war.

== Sample

https://github.com/apache/openwebbeans-meecrowave-examples contains ready to use examples using meecrowave.

You can also find more information on our link:howto.html[How To] page.