Getting Started

Do you know how to use Java and you just want the jar file?

Drop the jar file into your project and follow the examples in the wiki.

It is in the maven repo.

Do you know how to use maven and git?

Boon is in maven under the group name io.fastjson.

    <dependency>
         <groupId>io.fastjson</groupId>
         <artifactId>boon</artifactId>
         <version>0.11</version>
    </dependency>

If you prefer to build, then do this:

    $ git clone https://github.com/boonproject/boon.git
    $ cd boon
    $ mvn clean install

Add the following dependency

<dependency>
     <groupId>fastjson.io</groupId>
     <artifactId>boon</artifactId>
     <version>0.11-SNAPSHOT</version>
</dependency>

GOLDEN BRANCH To work with the stable (build works, and a fresh git pull was done to verify it):

$ git clone -b golden https://github.com/boonproject/boon.git boonGold
$ cd boonGold
$ mvn clean install

Last build test

$ git clone https://github.com/boonproject/boon.git boon
Cloning into 'boon'...
remote: Counting objects: 2011, done.
remote: Compressing objects: 100% (761/761), done.
remote: Total 2011 (delta 706), reused 1982 (delta 677)
Receiving objects: 100% (2011/2011), 865.56 KiB | 440.00 KiB/s, done.
Resolving deltas: 100% (706/706), done.
Checking connectivity... done

$ cd boon
$ setjdk 1.7
java version "1.7.0_45"
Java(TM) SE Runtime Environment (build 1.7.0_45-b18)
Java HotSpot(TM) 64-Bit Server VM (build 24.45-b08, mixed mode)

$ mvn clean install
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 14.667s
[INFO] Finished at: Sun Nov 03 13:57:29 PST 2013
[INFO] Final Memory: 15M/253M
[INFO] ------------------------------------------------------------------------

Thoughts

Thoughts? Write me at richard high tower AT g mail dot c-o-m (Rick Hightower).

Further Reading:

If you are new to boon start here:

• Java Boon Byte Buffer Builder
• Java Boon Slice Notation
• Java Boon Slice's work with TreeSets
• Java Boon Description
• More...
• Boon Home
• Boon Source
• Introducing Boon October 2013
• Java Slice Notation
• What if Java collections were easy to search and sort?
• Boon HTTP utils
• Boon Java JSON parser Benchmarks or hell yeah JSON parsing is damn fast!
• Boon JSON parser is really damn fast! Part II
• Boon JSON parser Round III now just not fast as but much faster than other Java JSON parsers
• Boon World's fastest Java JSON parser Round IV from fast to blazing to rocket fuel aka Braggers going to brag
• Boon gets adopted by JSON Path as the default Java JSON parser
• Boon graphics showing just how fast Boon JSON parsing is - about 50% to 200% faster than the graphs shown here now so wicked fast became wickeder - just got sick of making graphics
• 10 minute guide to Boon JSON parsing after I added @JsonIgnore, @JsonProperty, @JsonView, @Exposes, etc.
• Hightower speaks to the master of Java JSON parsing, the king of speed The COW TOWN CODER!
• Boon provides easy Java objects from lists, from maps and from JSON.

Why Boon?

Easily read in files into lines or a giant string with one method call. Works with files, URLs, class-path, etc. Boon IO support will surprise you how easy it is. Boon has Slice notation for dealing with Strings, Lists, primitive arrays, Tree Maps, etc. If you are from Groovy land, Ruby land, Python land, or whatever land, and you have to use Java then Boon might give you some relief from API bloat. If you are like me, and you like to use Java, then Boon is for you too. Boon lets Java be Java, but adds the missing productive APIs from Python, Ruby, and Groovy. Boon may not be Ruby or Groovy, but its a real Boon to Java development.

Core Boon Philosophy

Core Boon will never have any dependencies. It will always be able to run as a single jar. This is not just NIH, but it is partly. My view of what Java needs is more inline with what Python, Ruby and Groovy provide. Boon is an addition on top of the JVM to make up the difference between the harder to use APIs that come with Java and the types of utilities that are built into Ruby, Python, PHP, Groovy etc. Boon is a Java centric view of those libs. The vision of Boon and the current implementation is really far apart.

===

Contact Info

blog|[twitter](https://twitter.com/RickHigh|[infoq]http://www.infoq.com/author/Rick-Hightower|[stackoverflow](http://stackoverflow.com/users/2876739/rickhigh)|[java lobby](http://java.dzone.com/users/rhightower)|Other | richard high tower AT g mail dot c-o-m (Rick Hightower)|work|cloud|nosql