LoganSquare

Screaming fast JSON parsing and serialization library for Android.

License	Apache 2.0
Categories	Square Business Logic Libraries Financial LoganSquare Data JSON
GroupId	com.bluelinelabs
ArtifactId	logansquare-compiler
Last Version	1.3.7
Release Date	Mar 19, 2016
Type	jar
Description	LoganSquare Screaming fast JSON parsing and serialization library for Android.
Project URL	https://github.com/bluelinelabs/LoganSquare
Project Organization	BlueLine Labs
Source Code Management	https://github.com/bluelinelabs/LoganSquare

Download logansquare-compiler

Filename	Size
logansquare-compiler-1.3.7.pom
logansquare-compiler-1.3.7.jar	51 KB
logansquare-compiler-1.3.7-sources.jar	28 KB
logansquare-compiler-1.3.7-javadoc.jar	124 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.bluelinelabs/logansquare-compiler/ -->
<dependency>
    <groupId>com.bluelinelabs</groupId>
    <artifactId>logansquare-compiler</artifactId>
    <version>1.3.7</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.bluelinelabs/logansquare-compiler/
implementation 'com.bluelinelabs:logansquare-compiler:1.3.7'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.bluelinelabs/logansquare-compiler/
implementation ("com.bluelinelabs:logansquare-compiler:1.3.7")

Apache Buildr

'com.bluelinelabs:logansquare-compiler:jar:1.3.7'

Apache Ivy

<dependency org="com.bluelinelabs" name="logansquare-compiler" rev="1.3.7">
  <artifact name="logansquare-compiler" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.bluelinelabs', module='logansquare-compiler', version='1.3.7')
)

Scala SBT

libraryDependencies += "com.bluelinelabs" % "logansquare-compiler" % "1.3.7"

Leiningen

[com.bluelinelabs/logansquare-compiler "1.3.7"]

Dependencies

runtime (3)

Group / Artifact	Type	Version
org.apache.commons : commons-lang3	jar	3.2
com.squareup : javapoet	jar	1.2.0
com.bluelinelabs : logansquare	jar	1.3.7

Project Modules

There are no modules declared in this project.

#LoganSquare

The fastest JSON parsing and serializing library available for Android. Based on Jackson's streaming API, LoganSquare is able to consistently outperform GSON and Jackson's Databind library by 400% or more¹. By relying on compile-time annotation processing to generate code, you know that your JSON will parse and serialize faster than any other method available.

By using this library, you'll be able to utilize the power of Jackson's streaming API without having to code tedius, low-level code involving JsonParsers or JsonGenerators. Instead, just annotate your model objects as a @JsonObject and your fields as @JsonFields and we'll do the heavy lifting for you.

Don't believe it could improve upon Jackson Databind's or GSON's performance that much? Well, then check out the nifty graphs below for yourself. Not convinced? Feel free to build and run the BenchmarkDemo app included in this repository.

¹ _{Note: Our "400% or more" performance improvement metric was determined using ART. While LoganSquare still comes out on top with Dalvik, it seems as though the comparison is much closer. The benchmarks shown are actual screenshots taken from a 2nd gen Moto X.}

##Download

Note that Gradle is the only supported build configuration for LoganSquare. To add the library to your app's build.gradle file.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }
}
apply plugin: 'com.neenbedankt.android-apt'

dependencies {
    apt 'com.bluelinelabs:logansquare-compiler:1.3.6'
    compile 'com.bluelinelabs:logansquare:1.3.6'
}

For the curious, the buildscript and apply plugin lines add the apt plugin, which is what allows us to do compile-time annotation processing. The first dependency is what tells Gradle to process your JSON annotations, and the second dependency is our tiny 19kb runtime library that interfaces with the generated code for you.

##Usage

Using LoganSquare is about as easy as it gets. Here are a few docs to get you started:

• Creating your models
• Parsing from JSON
• Serializing to JSON
• Supporting custom types

##Proguard Like all libraries that generate dynamic code, Proguard might think some classes are unused and remove them. To prevent this, the following lines can be added to your proguard config file.

-keep class com.bluelinelabs.logansquare.** { *; }
-keep @com.bluelinelabs.logansquare.annotation.JsonObject class *
-keep class **$$JsonObjectMapper { *; }

##Why LoganSquare?

We're BlueLine Labs, a mobile app development company based in Chicago. We love this city so much that we named our company after the blue line of the iconic 'L.' And what's one of the most popular stops on the blue line? Well, that would be Logan Square of course. Does it have anything to do with JSON? Nope, but we're okay with that.

##Props

• Jackson's streaming API for being a super-fast, awesome base for this project.
• Instagram's ig-json-parser for giving us the idea for this project.
• Jake Wharton's Butterknife for being a great reference for annotation processing and code generation.

##License

Copyright 2015 BlueLine Labs, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

BlueLine Labs

A premier mobile app and web development company based out of Chicago, IL.

Versions

Version
1.3.7 Mar 19, 2016
1.1.0 Jun 27, 2015
1.0.6 Feb 24, 2015
1.0.5 Feb 21, 2015
1.0.4 Feb 19, 2015
1.0.3 Feb 18, 2015