https://github.com/tecc/lahc

Lightweight Asynchronous HTTP Client for Java.
https://github.com/tecc/lahc

http http-client java lightweight

Last synced: about 1 month ago
JSON representation

Lightweight Asynchronous HTTP Client for Java.

• Host: GitHub
• URL: https://github.com/tecc/lahc
• Owner: tecc
• License: mit
• Created: 2021-08-23T06:54:29.000Z (over 3 years ago)
• Default Branch: dev
• Last Pushed: 2021-10-16T21:15:52.000Z (about 3 years ago)
• Last Synced: 2024-05-02T03:45:31.111Z (8 months ago)
• Topics: http, http-client, java, lightweight
• Language: Java
• Homepage:
• Size: 161 KB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Lightweight Asynchronous HTTP Client (LAHC)

![Maven metadata URL](https://img.shields.io/maven-metadata/v?metadataUrl=https%3A%2F%2Fm2.tecc.me%2Fsnapshots%2Fme%2Ftecc%2Flahc%2Flahc%2Fmaven-metadata.xml&style=flat-square)

This is a very simple and lightweight HTTP client for Java 8+. For bigger projects, use other HTTP client libraries

like [Apache's HTTPComponents Client](https://hc.apache.org/httpcomponents-client-5.1.x/)

or [OkHttp](https://squareup.github.io/okhttp).

## Adding Lahc as a dependency

Lahc is published on my own repository, located at `https://m2.tecc.me/snapshots`. It should be

named `me.tecc.lahc:lahc:[version]` (replace `[version]` with the version you want to use).

Quickies:

- Gradle:

  ```gradle

  repositories {

      maven {

          name 'tecc.me snapshots'

          url 'https://m2.tecc.me/snapshots'

      }

  } 

  dependencies {

      implementation 'me.tecc.lahc:lahc:[version]'

  }

  ```

## Usage

> Note: Usage is subject to change.

### Simple request

```java

// Create an HttpClient with its default settings

HttpClient client = new HttpClient();

// Create a request

HttpRequest request = new HttpRequest()

        // the index.html of example.com - you need to be explicit because Lahc doesn't automatically do this 

        .url("https://example.com/index.html");

// Execute the request using the client

Promise responseFuture = client.execute(request);

// Note that getting the result can throw exceptions - handle them however you want!

try {

    HttpResponse response = responseFuture.get();

    // Lahc creates toString() methods for debugging purposes

    // Very neat! - tecc

    System.out.println("Response: \n" + response)

} catch (Exception e) {

    // Example exception handling - once again, handle how you want

    e.printStackTrace();

}

```

## Licence

Lahc is licensed under the MIT licence. The licence text is available in the [LICENSE.txt](./LICENCE.txt) file.