https://github.com/prabirshrestha/fluenthttp

a light weight library aimed to ease the development for your rest client
https://github.com/prabirshrestha/fluenthttp

Last synced: about 2 months ago
JSON representation

a light weight library aimed to ease the development for your rest client

• Host: GitHub
• URL: https://github.com/prabirshrestha/fluenthttp
• Owner: prabirshrestha
• License: other
• Created: 2011-05-15T18:06:42.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2023-12-15T17:29:12.000Z (over 1 year ago)
• Last Synced: 2025-04-07T18:21:08.227Z (2 months ago)
• Language: C#
• Homepage:
• Size: 1010 KB
• Stars: 48
• Watchers: 4
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# FluentHttp

## Overview

FluentHttp is a light weight library aimed to ease the development for your rest client with

consistent api throughout different frameworks whether you are using .net 4.0 or silverlight or

window phone. (It is not aimed to be used directly by the developers, but rather for creating 

a http client wrapper, such as for Facebook, Github, Twitter, Google etc.)

## Supported Frameworks

* .NET 4.0 (client profile supported) ~50kb

* .NET 3.5 (client profile supported) ~50kb

* .NET 2.0 ~50kb

* Silverlight 4.0  ~30kb

* Windows Phone 7  ~30kb

* Mono

## Getting Started

Reference appropriate FluentHttp.dll depending on your framework.

## Samples

Here are some samples to get started with on FluentHttp.

### Using async callbacks

	private static void GetAsync()

	{

		// Stream to save the response to

		var responseSaveStream = new MemoryStream();

		// Prepare the request.

		var request = new FluentHttpRequest()

			.BaseUrl("https://graph.facebook.com")

			.ResourcePath("/4")

			.Method("GET")

			.Headers(h => h.Add("User-Agent", "FluentHttp"))

			.QueryStrings(q => q

									.Add("fields", "name,first_name,last_name")

									.Add("format", "json"))

			.Proxy(WebRequest.DefaultWebProxy)

			.OnResponseHeadersReceived((o, e) => e.SaveResponseIn(responseSaveStream));

		request.ExecuteAsync(ar =>

                                {

                                    var response = ar.Response;

                                    // seek the save stream to beginning.

                                    response.SaveStream.Seek(0, SeekOrigin.Begin);

                                    // Print the response

                                    Console.WriteLine("GetAsync: ");

                                    Console.WriteLine(FluentHttpRequest.ToString(response.SaveStream));

                                });

	}

### Using with Task Parallel Library (TPL)

Note: supported only in .NET 4.0

	private static void GetAsyncWithTask()

	{

		// Stream to save the response to

		var responseSaveStream = new MemoryStream();

		// Prepare the request.

		var request = new FluentHttpRequest()

			.BaseUrl("https://graph.facebook.com")

			.ResourcePath("/4")

			.Method("GET")

			.Headers(h => h.Add("User-Agent", "FluentHttp"))

			.QueryStrings(q => q

									.Add("fields", "name,first_name,last_name")

									.Add("format", "json"))

			.Proxy(WebRequest.DefaultWebProxy)

			.OnResponseHeadersReceived((o, e) => e.SaveResponseIn(responseSaveStream));

		var task = request.ExecuteTaskAsync();

		task.ContinueWith(

			t =>

			{

				var ar = t.Result;

				var response = ar.Response;

				// seek the save stream to beginning.

				response.SaveStream.Seek(0, SeekOrigin.Begin);

				// Print the response

				Console.WriteLine("GetAsyncWithTask: ");

				Console.WriteLine(FluentHttpRequest.ToString(response.SaveStream));

			});

	}

### Making synchronous requests

Synchronous request can be made by calling the Execute() method. Exception is NOT thrown

when error occurs. Execute() methods behaves exactly the same way as async result of ExecuteAsync().

Make sure to check if exception has occurred. (This allows you to have same methods to process the

response from both the synchronous and asynchronous methods using the same method.)

	var ar = request.Execute();

	

	if(ar.Exception != null)

		throw ar.Exception;

	else

		// process the response.

## Using Authenticators

To simplify authentication for http web requests, FluentHttp source includes some

authenticators. (These authenticators are not part of the core FluentHttp.dll and must

be included manually which can be found [here](https://github.com/prabirshrestha/FluentHttp/tree/master/src/FluentHttp.Tests/FluentAuthenticators).)

	request.AuthenticateUsing(new HttpBasicAuthenticator("username", "password");

## License

FluentHttp is intended to be used in both open-source and commercial environments.

FluentHttp is licensed under Apache License 2.0.