Introspector Filter

This library provides an effortless way to filter collections in Java based on attributes annotation.

Usage

In the pom.xml file, add the following dependency:

<dependency>
    <groupId>io.github.tnas</groupId>
    <artifactId>introspectorfilter</artifactId>
    <version>1.0.0</version>
</dependency>

In the Java code

Annotate any attribute that should be considered in the search with @Filterable.

Class Diagram (Example)

Filtering Collections - Examples

For examples of using the Introspector Filter, consider the class diagram above.

The tool (and the respective examples not using it) uses the Apache Commons Lang StringUtils class to removes diacritics (~= accents) from strings.

Assumptions:

• A List<Post> postsCollection is provided to be filtered.
• A primitive type value (textFilter) to be used as a filter is provided.
• An instance of IntrospectorFilter is provided.

Filtering by text in Publication

Without Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> Objects.isNull(p.getText()) ||
        StringUtils.stripAccents(p.getText().trim().toLowerCase())
            .contains(textFilter.trim().toLowerCase()))
    .toList();

With Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> filter.filter(p, textFilter)).toList();

Filtering by hashtags in Post

Without Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> Objects.isNull(p.getHashtags()) || p.getHashtags().isEmpty() ||
        p.getHashtags().stream().anyMatch(h ->
            StringUtils.stripAccents(h.trim().toLowerCase())
                .contains(textFilter.trim().toLowerCase())))
    .toList();

With Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> filter.filter(p, textFilter)).toList();

Filtering by review in Comment

Without Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> Objects.isNull(p.getComments()) || p.getComments().isEmpty() ||
        p.getComments().stream().anyMatch(c ->
            StringUtils.stripAccents(c.trim().toLowerCase())
                .contains(textFilter.trim().toLowerCase())))
    .toList();

With Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> filter.filter(p, textFilter)).toList();

Filtering by relevance in Publication

Without Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> p.getRelevance() == textFilter)
    .toList();

With Introspector Filter

var filteredList = postsCollection.stream()
    .filter(p -> filter.filter(p, textFilter)).toList();

Javadoc available at Introspector Filter Javadoc