Simplified Azure Storage Client in .NET Core is a collectino of useful utility tools implemented in .NET Core aiming to increase productivity and keep code simplicity. Currently it includes: RESTful HTTP Client, Azure Storage Client, Redis Cache Client.
All tools are wrapped into single class Restme() to keep everything simple, the class will automatically identify whether it's used as HTTP Client, Azure Storage Client or Redis Cache Client.
- Implemented based on the latest .NET Core 1.0 (RC2)
- Simple methods and flexible calls
- Uses Newtonsoft JSON and allows custom serilization
- Async support
- HTTP Client:
- Parameters get automatically converted into query string or post form fields
- Supports GET, POST, PUT, DELETE
- Bearer Authentication and custom headers
- Azure Storage Client:
- Simplified call stack
- Redis Cache Client
- Simplified call stack (Currently only support Azure Redis Cache, you can modify the source code to support other Redis Servers)
Install-Package OElite.Restme
Package available and released to Nuget: https://www.nuget.org/packages/OElite.Restme/
if you get any compatibility issues and is using netcoreapp1.0, try add the additional imports to your project.json file:
"frameworks": {
"netcoreapp1.0": {
"imports": [
"dnxcore50",
"netcore50",
"portable-net451+win8"
]
}
}
With concept of simplifying understanding of how Azure Storage, Redis Cache or RESTful requests work, RESTme only cares about the following:
using OElite;
...
var rest = new Rest(yourConfigParameters); //the parameters are either HTTP url if it is HTTP Client, or the connection string for Azure Blob/Redis server
//HTTP Restful client (sudo code)
// Get data
rest.Get(requestUrl);
// Save data
rest.Add(paramKey, paramValue);
rest.Post(requestUrl, data);
// Delete data
rest.Delete(requestUrl);
//Azure Storage or Redis ache sudo-code
// Get data
rest.Get<Stream>("/container/filePath");
rest.Get("/container/jsonData");
rest.Get<myObject>("/container/filePath");
// Save data
rest.Post<myObject>("/container/filePath", myObject);
// Delete data
rest.Delete("/container/filePath");
//direct string JSON return
var rest = new Rest(new Uri("http://freegeoip.net"));
var result1 = rest.Get("/json/github.com");
//automatic Generic cast
var result2 = rest.Get<MyObject>("/json/github.com");
var resultAsync2 = await rest.GetAsync<MyObjecT>("/json/github.com");
//add parameters (Parameters get automatically converted into query string or post form fields)
rest.add("q","github.com");
var result3 = rest.Get<MyObject>("/json");
var resultAsync3 = await rest.GetAsync<MyObject>("/json");
//supports POST, DELETE, PUT etc.
var rest2 = new Rest(new Uri("http://example.com"));
rest2.Add("Username","[email protected]");
rest2.Add("Birthday",DateTime.UtcNow);
rest2.Post<MyObject>("/someurl");
rest3.PostAsync<MyObject>("/asyncexample");
//supports direct object submission
var myObject = new MyObject()
{
Username = "[email protected]",
Birthday = DateTime.UtcNow
};
var rest3 = new Rest(new Uri("http://example.com"));
rest3.Add(myObject);
rest3.Post<ExpectedResultObject>("/directObjectPost");
//get blob stream directly
var blobStorageConnectionString = "{Your Storage Account Connection String}";
var rest = new Rest(blobStorageConnetionString);
rest.CreateAzureBlobContainerIfNotExists = true; //do this only if you want to auto create the container
//NOTE 1: first segment of the path should always be your container name
//NOTE 3: Type T: if it is a type of Stream it will be stored as original Stream as Azure Blob, otherwise it is always saved into JSON format as Azure Blob
//NOTE 2: use a type of Stream if you want the original value retrieved from the blob
rest.Get<Stream>("/myContainer/myfilePath");
rest.GetAsync<Stream>("/myContainer/myfilePath");
//NOTE: only blob items saved in JSON format is suppported
rest.Get<ObjectType>("/myContainer/myfileObjectInJSONFileFormat");
rest.GetAsync<ObjectType>("/myContainer/myfileObjectInJSONFileFormat");
var redisConnectionString = "{Your Redis Cache Connection String}";
var rest = new Rest(redisConnectionString);
//get cache data (support Generic cast)
var cacheResult = rest.Get("home:testKey");
var cacheResult2 = rest.Get<bool>("home:testKey2");
var cacheResult3 = rest.Get<ObjectType>("home:testKey3");
//set cache data
rest.Post("home:testKey","value");
rest.Post<bool>("home:testKey2",true);
var myObject = new ObjectType(); //will be serialized into JSON format and stored as string on redis server
rest.Post<ObjectType>("home:testKey3", myObject);
You can get in touch with me on my LinkedIn Profile:
You can also follow my GitHub Profile to stay updated about my latest projects:
If you liked the repo then kindly support it by giving it a star ⭐
Made with ❤️ by Pranam Bhat. Follow me on https://www.linkedin.com/in/pranam-bhat-11670689/
For any queries : [email protected]