repofactory

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 13 Open GitHub ↗

A flexible solution for creating a repository pattern

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![](https://jitpack.io/v/guidovezzoni/repofactory.svg)](https://jitpack.io/#guidovezzoni/repofactory)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/f1e73bb0ea4448ec84401e80b948e7b0)](https://www.codacy.com/app/guidovezzoni/repofactory?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=guidovezzoni/repofactory&amp;utm_campaign=Badge_Grade)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-RepoFactory-green.svg)]( https://android-arsenal.com/details/1/7640 )

# RepoFactory
A flexible solution for creating a repository pattern in your Android apps.

Based on RxJava and Retrofit you can either instantiate a ready-made one or build your own.

## Getting started
The idea behind this library is to provide a simple way to instantiate a repository pattern, providing a parameter to define the type of repository.

The following steps describe how to implement a ready-made repository pattern.

### 1) Define type of data involved
a. model returned by the endpoint call, the same class will be used for caching the response - `<M>` in the code

b. any parameters required for the endpoint call - `<P>` in the code. It can be `Void` if no params are required. 
In case of multiple parameters, then `Pair` or `Triple` (from Kotlin or java) can be used, or any other _Tuple_ defined in other libraries. 
The only limitation is that methods `equals` and `hashCode` must be overridden.
This is because this class will be used as key for the `HashMap` that handles the cache.

c. type of repository chosen. Currently it can be:
-  NO_CACHE: the repository simply triggers a network call for each request
-  SINGLE_LEVEL_CACHE: a one-level memory cache is present and will be used until the response associated with a specific value of parameters doesn't expire

### 2) Instantiate the factory and declare a `Repository<return_type, parameters>`
```
    private final RepoFactory repoFactory = new RepoFactory();
    private final Repository<ForecastResponse, String> weatherForecastRepo;
```

### 3) Instantiate the repository defining the endpoint call
```
        weatherForecastRepo = repoFactory.createRepo(RepoType.SINGLE_LEVEL_CACHE,
                location -> interfaceApi.getForecast(location);
```

### 4) Define the `Single` to which subscribe
```
    public Single<ForecastResponse> getForecast(String location) {
        return weatherForecastRepo.get();
    }
```

## Custom implementations

If any part of the architecture needs to be customised for specific needs - either the network datasource or the cache or the repository itself - the `RepoFactory` class can be derived and its method overridden as required.
See [RepoFactory.java](https://github.com/guidovezzoni/repofactory/blob/master/repofactory/src/main/java/com/guidovezzoni/repofactory/RepoFactory.java) for more info.

## Gradle
Add the JitPack repository in your root build.gradle at the end of repositories:
```
allprojects {
        repositories {
            ...
            maven { url 'https://jitpack.io' }
        }
    }
```
Add the dependency
```
dependencies {
            implementation 'com.github.guidovezzoni:repofactory:1.0.0'
	}
```

## Additional features
These features are likely to be included in future releases:
-  3 level cache 
-  periodical removal of expired cache

## Known Issues

### Cache validity setup
The `Repository` interface doesn't give access to `setCacheValidity()` so currently the only way to do that is 
```
((SingleLevelCacheRepository) weatherForecastRepo).setCacheValidity(TimeUnit.MINUTES.toMillis(1));
```
I'm still figuring out the best way to do it

### Usage of non hashable classes 
When parameter `<P>` uses a class for which methods `equals` and `hashCode` have not been overridden, cache won't work properly.

### Expired cache entries are not removed
Expired cache entries can build up in time if the parameters change frequently and values are not refreshed

## Bugs and Feedback
For bugs, questions and discussions please use the [GitHub Issues](https://github.com/guidovezzoni/repofactory/issues) .

## History

| Version     | Date       | Issues        | Notes                                      |
|:------------|:-----------|:--------------|:-------------------------------------------|
| 1.0.1       | 28/05/2019 | 008,009,F010  | Some Kotlin files converted, minor changes |
| 1.0.0       | 01/05/2019 |               | First Release                              |
| 0.1.2_alpha | 01/05/2019 |               | Minor changes, documentation improvements  |
| 0.1.1_alpha | 28/04/2019 |               | Fixed: network call always executed        |
| 0.1.0_alpha | 26/04/2019 |               | First alpha release                        |

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.
```

repofactory

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README