- Notifications
You must be signed in to change notification settings - Fork9
Smash is Volley inspired networking library that's using OkHttp in its core
License
appformation/smash
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Smash is Volley inspired networking library that's usingOkHttp in its core.
Add Smash library to your projectbuild.gradle
dependencies{ compile'pl.appformation:smash:0.3.0'}Instantiate one shared SmashQueue object (e.g. in your Application class):
mSmashQueue =Smash.buildSmashQueue(getApplicationContext());
To request content of server as String do following:
Stringurl ="https://github.com/appformation/smash";SmashStringRequestrequest =newSmashStringRequest(SmashRequest.Method.GET,url,newSmashResponse.SuccessListener<String>() {publicvoidonResponse(Stringresponse) {handleMyNiftyResponse(response); } },newSmashResponse.FailedListener() {publicvoidonFailedResponse(SmashErrorerror) {showImpendingDoomError(error); } });
Request object looks definitely cooler withRetrolambda library:
SmashStringRequestrequest =newSmashStringRequest(SmashRequest.Method.GET,url,this::handleNiftyResponse,this::showImpendingDoomError);
Constructed request this way we now need to add to our SmashQueue:
mSmashQueue.add(request);
Adding custom headers to request:
SmashStringRequestrequest = ...request.setHeaders(Headers.of("CustomHeader","Value","AnotherHeader","AnotherValue"));
Some of us like Volley library, it's easy to use and has superb extensibility with Request class, but recent removal of HttpClient in Marshmalow made library obsolete. We also don't like reactive programming. With this in mind came idea to rewrite Volley to use directly all of the internals ofOkIo andOkHttp libraries.
- URL address can be modified, up to the point of reaching dispatcher queue
- Source class from OkIo is used instead of InputStream
- Ability to modify User-Agent field globally for all requests
- Both listeners are obligatory in request constructor
- To prevent class names conflicting with OkHttp all smash classes have Smash prefix
- Retry policy (for now default from OkHttp is used)
- Authentication mechanism in requests
- Moshi support (thanks to OkIo we can use Source class with Moshi)
- Support for multipart/form-data upload
- ... and last but not least, unit tests
- com.squareup.okhttp3:okhttp 3.5.0
- com.squareup.okhttp3:okhttp-urlconnection 3.5.0
- com.android.support:support-annotations 25.1.0
Copyright (C) 2015-2017 Appformation Sp. z o.o.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.0Unless required by applicable law or agreed to in writing, softwaredistributed 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 andlimitations under the License.About
Smash is Volley inspired networking library that's using OkHttp in its core