https://github.com/bootique/bootique

Bootique is a minimally opinionated platform for modern runnable Java apps.
https://github.com/bootique/bootique

bootique dependency-injection java runnable-jar

Last synced: 29 days ago
JSON representation

Bootique is a minimally opinionated platform for modern runnable Java apps.

• Host: GitHub
• URL: https://github.com/bootique/bootique
• Owner: bootique
• License: apache-2.0
• Created: 2015-12-10T14:45:15.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-05-20T20:59:22.000Z (6 months ago)
• Last Synced: 2024-10-09T09:56:02.122Z (about 1 month ago)
• Topics: bootique, dependency-injection, java, runnable-jar
• Language: Java
• Homepage: https://bootique.io
• Size: 2.93 MB
• Stars: 1,417
• Watchers: 140
• Forks: 285
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


[![build test deploy](https://github.com/bootique/bootique/workflows/build%20test%20deploy/badge.svg)](https://github.com/bootique/bootique/actions)

[![Maven Central](https://img.shields.io/maven-central/v/io.bootique/bootique.svg?colorB=brightgreen)](https://search.maven.org/artifact/io.bootique/bootique)

Bootique is a [minimally opinionated](https://medium.com/@andrus_a/bootique-a-minimally-opinionated-platform-for-modern-java-apps-644194c23872#.odwmsbnbh) 

java launcher and integration technology. It is intended for building container-less runnable Java applications. 

With Bootique you can create REST services, webapps, jobs, DB migration tasks, etc. and run them as if they were 

simple commands. No JavaEE container required! Among other things Bootique is an ideal platform for 

Java [microservices](http://martinfowler.com/articles/microservices.html), as it allows you to create a fully-functional

app with minimal setup.

Each Bootique app is a collection of modules interacting with each other via dependency injection. This GitHub project 

provides Bootique core. Bootique team also develops a number of important modules. A full list is available 

[here](http://bootique.io/docs/).

## Quick Links

* [WebSite](https://bootique.io)

* [Getting Started](https://bootique.io/docs/2.x/getting-started/)

* [Docs](https://bootique.io/docs/) - documentation collection for Bootique core and all standard 

  modules.

## Support

You have two options:

* [Open an issue](https://github.com/bootique/bootique/issues) on GitHub with a label of "help wanted" or "question" 

  (or "bug" if you think you found a bug).

* Post a question on the [Bootique forum](https://groups.google.com/forum/#!forum/bootique-user).

## TL;DR

For the impatient, here is how to get started with Bootique:

* Declare the official module collection:

```xml

    

        

            io.bootique.bom

            bootique-bom

            3.0-M4

            pom

            import

         

    

```

* Include the modules that you need:

```xml

    

        io.bootique.jersey

        bootique-jersey

    

    

        io.bootique.logback

        bootique-logback

    

```

* Write your app:

```java

package com.foo;

import io.bootique.Bootique;

public class Application {

    public static void main(String[] args) {

        Bootique

            .app(args)

            .autoLoadModules()

            .exec()

            .exit();

    }

}

```

It has ```main()``` method, so you can run it! 

*For a more detailed tutorial proceed to [this link](https://bootique.io/docs/2.x/getting-started/).*

## Upgrading

See the "maven-central" badge above for the current production version of ```bootique-bom```. 

When upgrading, don't forget to check [upgrade notes](https://github.com/bootique/bootique/blob/master/UPGRADE.md) 

specific to your version.