Android LINQ

Manipulate collections easily using C# LINQ style queries and Java 8 closures.

Description

Android LINQ is a small subset of collection manipulation utilities inspired by Microsoft C# LINQ library and targeted at Android developers looking to use new Java 8 Stream() API.

By using Retrolambda for Android, developers can leverage the power of closures and other new Java 8 features. Unfortunately, it doesn't allow the usage of the Stream API which is arguably its most awesome feature. However, by using it in conjunction with Android LINQ, its possible to perform powerful collection manipulation in just a few lines of code.

Android LINQ has little to no impact on performance because it does not make use of reflection or proxies. As its C# counterpart it's based on the monads concept, which is a fancy word to describe a sort of Decorator pattern implementation, and many sorting and ordering are just making calls to the default Java API.

Anyway, you need not to worry. Just add this to your Gradle/Maven and suffer with manual collection iteration no more!

Usage

Latest Version

Android

To use Android LINQ, first, go and setup Retrolambda for Android so we can use those fancy closures from Java 8 (don't worry, its just some extra lines on your build.gradle file).

Now, just add this line to your project build.gradle (files are hosted in Bintray jCenter, so don't forget to add it to the repositories list too).

Gradle

Android Studio >= 4.0

Android Studio 4.0 introduced a ne version of Gradle and with that, usage changed a little. See https://jitpack.io/#zbra-solutions/android-linq/1.1.0 for more details.

...
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
...

dependencies {
    implementation 'com.github.zbra-solutions:android-linq:1.1.0'
}

Legacy

...
repositories {
    jcenter()
}
...

compile 'br.com.zbra:android-linq:1.1.0'

Standard Java 8

Android LINQ uses standard Java and therefore can also be used outside Android.

Maven

<repositories>
    ...
    <repository>
      <id>jcenter</id>
      <url>http://jcenter.bintray.com </url>
      ...
    </repository>
    ...
</repositories>

<dependency>
  <groupId>br.com.zbra</groupId>
  <artifactId>android-linq</artifactId>
  <version>1.1.0</version>
</dependency>

Examples

Get names from contacts

List<String> contactNames = 
      stream(contacts)
          .select(c -> c.getName())
          .toList();

Get contacts who are 27 years or older

List<Contact> contacts = 
      stream(contacts)
          .where(c -> c.getAge() >= 27)
          .toList();

Sort contacts by name, then by age

List<Contact> contactNames = 
      stream(contacts)
          .orderBy(c -> c.getName())
          .thenBy(c -> c.Age())
          .toList();

Group products by category

Map<Category, Stream<Product>> productsByCategory
      stream(products)
          .groupBy(p -> p.getCategory())
          .toMap(g -> g.getKey() /* Category */, g.getElements() /* Stream<Product> */)

Calculate the total price of a purchase

double total = 
      stream(purchase.getItems())
          .sum((Purchase p) -> p.getPrice());

There are many more methods: first(), single(), distinct(), any(), aggregate(), count(), take(), skip() and reverse() are all available. Have fun!

Pull Requests Are Welcome!

Please, send feedback and pull requests a plenty! If you find a bug, a missing feature or have an improvement suggestion, don't be afraid to file an issue and we will do our best to attend it.