Kikaha documentation
k

Kikaha

blog source code

Getting Started in 1 Minute

As a micro-service middleware, Kikaha is just a library that helps developers to write fast codes faster. In practice it means that you can use any JVM build tool to create you project. Kikaha is available at the Maven Central Repository, so, if you choose to use Maven to build Kikaha we encourage you to take a look at the Creating a Kikaha maven project guide.

To automate most of build routines that maven imposes, Kikaha also comes with a simple Command Line Tool. Indeed, the fastest way to create the first Kikaha is through the Kikaha's CLI .

  1. Download the Kikaha's command line interface tool.
  2. Run the following commands at your terminal. The comments bellow will helps you to understand what will be done.
# create an empty project named first-project
kikaha project create 2.0 --artifact-id=first-project
# enter into the just created project folder
cd first-project
# run your project
kikaha run-app

Open your browser and enter the address http://localhost:9000. And €¦ that's it! You just finished your 1 Minute tutorial.

Notes about your just created project

You just created an empty Kikaha project from empty-project template. It becomes with only a basic set of dependencies leaving up to you include the extra modules and dependencies you need on your project. The dependencies included is:

  • The Kikaha Core module
  • The Kikaha Dependency Injection module - in order to provide CDI integration
  • Logback - as default logging framework

Out-of-box there is more than one project template available. Please, take a look at the Project templates page for more details.

As opposite from a Kikaha project created as an ordinary maven project, your just created project does not follow the default maven directory structure convention. Indeed, maven lets you configure your own structure, if you want it. The default directory structure we have here were designed to be less verbose and be easier to understand, specially for those developers that isn't quite familiar with Maven.

  • source - To place your routes and another Java classes
  • resources - To place your resource files ( Server configuration, JPA configuration, template configuration, etc )
  • webapp - To place your static files or templates
  • tests - To place your unit tests
  • tests-resources - To place resources that belongs exclusively to unit/integration tests

Nexts steps

Now that you just finished your 1 minute tutorial you may be interested in:

Welcome

WELCOME About Kikaha philosophy

GETTING STARTED Getting started in 1 minute Creating a Kikaha maven project Architecture overview

TUTORIALS Logging configuration Configuring the server Creating your first HTTP route Kikaha's command line interface Configuring your favorite IDE Wro4j Integration

CORE FEATURES HTTP and HTTPS Routing static assets Dependency injection Authentication and authorization Smart routes

ESSENTIAL MODULES μRouting API WebSocket Routing Database Connection Pool JSON with Jackson Protobuf Mustache Templates Rocker Templates BCrypt

CLOUD MODULES Overview of Cloud Modules Consul.io Codahale's Metrics Auth0 Single Sign-On μWorkers - Actor-like API Hazelcast

AWS-RELATED MODULES Overview of AWS-Related Modules Deploying Applications on AWS AWS IAM Credentials AWS EC2 AWS SQS queues AWS CloudWatch metrics AWS Application Load Balancer AWS Lambda functions AWS X-Ray

ADVANCED TOPICS Creating custom modules Routing with Undertow's API Creating custom cloud modules