HttpBuster

KO | EN

gitlite — search

#javascript #react #typescript #golang #android #machine-learning #deep-learning #linux #macos #awesome #kubernetes #awesome-list #mcp #openai

(★ 15)

Talk to REST APIs like a boss in Android.

HttpBuster Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HttpBuster

A very simple way to do http requests in **Android** using **okHttp**
***

### How to use 
---
- Create an instance of **HttpBuster** with an api endpoint
```java
Api api = new Api();
api.setEndpoint("https://example.com/api/");
HttpBuster httpBuster = HttpBuster.withApi(api).build();
```
Thats it. Now you are ready to make http requests to your api endpoint.
#### Make GET request
a.) Without any request parameters 
```java
httpBuster.makeGetRequest("jokes/random", null, new ApiCallback() {
    @Override
    public void done(BusterResponse response, JSONObject jsonObject, Exception exception) {
        Log.e(TAG, "GET without params done");
    }
});
```

b.) With request parameters 
```java
HashMap<String, Object> map = new HashMap<>();
map.put("firstName", "Mutinda");
map.put("lastName", "Boniface");
httpBuster.makeGetRequest("jokes/random", map, new ApiCallback() {
    @Override
    public void done(BusterResponse response, JSONObject jsonObject, Exception exception) {
        Log.e(TAG, "GET with params done");
    }
});
```

#### NB:
1. **The same applies for `POST`, `PUT`, `DELETE` requests**
2. We recommend using a single **HttpBuster** instance for the entire application- You can do this by intializing your **HttpBuster** instance via the Application class

#### Make FILE UPLOAD request
```java

// Add files to be upload 
List<RequestFile> files = new ArrayList<>();
String file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS).getPath()+"/no_picture.png";
files.add( new RequestFile("photo", file, MediaType.parse("image/PNG")) );

// add optional payload (this is optional)
HashMap<String, Object> map = new HashMap<>();
map.put("name", "Mutinda Boniface");

httpBuster.makeMultipartRequest("photo-upload/", map, files, new ApiCallback() {
    @Override
    public void done(BusterResponse response, JSONObject jsonObject, Exception exception) {
        Log.e(TAG,  "POST MULTIPART - Response =" +(response!=null? response.getString() :"Not reachable" ));
    }
});
```

Have a look at the demo app for a complete app using the Library [Demo app](https://github.com/bmutinda/HttpBuster/tree/master/demo/src/main/java/com/bmutinda/httpbuster/demo)

---
#### Latest Version: [![Release](https://jitpack.io/v/bmutinda/httpbuster.svg)](https://jitpack.io/#bmutinda/HttpBuster)

---
### Installation 
---

In your app `build.gradle` under repositories, include `jitpack.io` like below
```java
allprojects{
  repositories {
    maven { url "https://jitpack.io" }
  }
}
```
Then in your dependecies add this line replacing **{latest_version}** with the latest version under releases 
```java
  compile 'com.github.bmutinda:httpbuster:{latest_version}'
```
Example:
```java
  compile 'com.github.bmutinda:httpbuster:1.0'
```

## Wanna Support?
If `HttpBuster` helped you save time for your project delivery, you can buy coffee for me. Cheers
<a href="https://www.buymeacoffee.com/o5SnzKO"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" target="_blank"></a>

HttpBuster

HttpBuster Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

HttpBuster

HttpBuster Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README