Skip to content

Latest commit

 

History

History
166 lines (128 loc) · 4.86 KB

README.md

File metadata and controls

166 lines (128 loc) · 4.86 KB

FirebaseDatabase.net

AppVeyor Build status

Simple wrapper on top of Firebase Realtime Database REST API. Among others it supports streaming API which you can use for realtime notifications.

For Authenticating with Firebase checkout the Firebase Authentication library and related blog post

To upload files to Firebase Storage checkout the Firebase Storage library and related blog post

Installation

// Install release version
Install-Package FirebaseDatabase.net

// Install pre-release version
Install-Package FirebaseDatabase.net -pre

Supported frameworks

.NET Standard 2.0 - see https://github.com/dotnet/standard/blob/master/docs/versions.md for compatibility matrix

Usage

Authentication

The simplest solution where you only use your app secret is as follows:

var auth = "ABCDE"; // your app secret
var firebaseClient = new FirebaseClient(
  "<URL>",
  new FirebaseOptions
  {
    AuthTokenAsyncFactory = () => Task.FromResult(auth) 
  });

Note that using app secret can only be done for server-side scenarios. Otherwise you should use some sort of third-party login.

var firebaseClient = new FirebaseClient(
  "<URL>",
  new FirebaseOptions
  {
    AuthTokenAsyncFactory = () => LoginAsync()
  });

...

public static async Task<string> LoginAsync()
{
  // manage oauth login to Google / Facebook etc.
  // call FirebaseAuthentication.net library to get the Firebase Token
  // return the token
}
  

As you can se, the AuthTokenAsyncFactory is of type Func<Task<string>>. This is to allow refreshing the expired token in streaming scenarios, in which case the func is called to get a fresh token.

Using service account

See this issue

Querying

C#

using Firebase.Database;
using Firebase.Database.Query;

' Since the dinosaur-facts repo no longer works, populate your own one with sample data in "sample.json"
var firebase = new FirebaseClient("https://dinosaur-facts.firebaseio.com/");
var dinos = await firebase
  .Child("dinosaurs")
  .OrderByKey()
  .StartAt("pterodactyl")
  .LimitToFirst(2)
  .OnceAsync<Dinosaur>();
  
foreach (var dino in dinos)
{
  Console.WriteLine($"{dino.Key} is {dino.Object.Height}m high.");
}

VB.net

Imports Firebase.Database
Imports Firebase.Database.Query

' Since the dinosaur-facts repo no longer works, populate your own one with sample data in "sample.json"
Dim client = New FirebaseClient("https://dinosaur-facts.firebaseio.com/")

Dim dinos = Await client _
    .Child("dinosaurs") _
    .OrderByKey() _
    .StartAt("pterodactyl") _
    .LimitToFirst(2) _
    .OnceAsync(Of Dinosaur)

For Each dino In dinos
    Console.WriteLine($"{dino.Key} is {dino.Object.Height}m high.")
Next

Saving & deleting data

using Firebase.Database;
using Firebase.Database.Query;
...
var firebase = new FirebaseClient("https://dinosaur-facts.firebaseio.com/");

// add new item to list of data and let the client generate new key for you (done offline)
var dino = await firebase
  .Child("dinosaurs")
  .PostAsync(new Dinosaur());
  
// note that there is another overload for the PostAsync method which delegates the new key generation to the firebase server
  
Console.WriteLine($"Key for the new dinosaur: {dino.Key}");  

// add new item directly to the specified location (this will overwrite whatever data already exists at that location)
await firebase
  .Child("dinosaurs")
  .Child("t-rex")
  .PutAsync(new Dinosaur());

// delete given child node
await firebase
  .Child("dinosaurs")
  .Child("t-rex")
  .DeleteAsync();

Realtime streaming

C#

using Firebase.Database;
using Firebase.Database.Query;
using System.Reactive.Linq;
...
var firebase = new FirebaseClient("https://dinosaur-facts.firebaseio.com/");
var observable = firebase
  .Child("dinosaurs")
  .AsObservable<Dinosaur>()
  .Subscribe(d => Console.WriteLine(d.Key));
  

VB.net

Imports System.Reactive.Linq
Imports Firebase.Database
Imports Firebase.Database.Query
' ...
Dim client = New FirebaseClient("https://dinosaur-facts.firebaseio.com/")

child _
  .Child("dinosaurs") _
  .AsObservable(Of InboundMessage) _
  .Subscribe(Sub(f) Console.WriteLine(f.Key))

AsObservable<T> methods returns an IObservable<T> which you can take advantage of using Reactive Extensions