rickard-505/ddpclient-net

A Client for Meteor's DDP-Protocol written in C#/.NET

DDPClient-NET

A Client for Meteor's DDP-Protocol written in C#/.NET

##WIP This library is currently Work-In-Progress. Further Improvements, documentation + Unit-Tests will follow soon.

##Usage ###Connecting

static void Main(string [] args)
{
    //URL to your Meteor location
    _client = new DdpConnection("localhost:3000");
    _client.Retry = true; //Retry if we lose connection or initial connection fails
    _client.Login += OnLogin; //Login Callback
    _client.Connected += OnConnected;
    _client.Connect();

    Console.ReadKey();
    _client.Close(); //Close when we're done
}

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    if(connectResponse.DidFail()) //We're using a not supported DDP Version
        Console.WriteLine("Connecting Failed, Server wants Version: " + connectResponse.Failed.Version);

    //The client will save this ID and use it for reconnection attempts automatically
    Console.WriteLine("Connected! Our Session-ID: " + connectResponse.Session);
}

###Login

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    //Should check if successful


    _client.LoginWithEmail("[email protected]", "password");
    //or
    _client.LoginWithUsername("username", "password");
    //or
    _client.LoginWithToken("token");    
}

private static void Login(object sender, LoginResponse loginResponse)
{
    if(loginResponse.HasError())
        Console.WriteLine(loginResponse.Error.Error);
    Console.WriteLine("Success: " + loginResponse.Token);
    Console.WriteLine("Expires In:" + loginResponse.TokenExpires.DateTime);

    //You can save the token and use it later with LoginWithToken (until TokenExpires)
}

###Methods ####No Return-Type

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    //Should check if successful


     _client.Call("test"); //No parameter
     _client.Call("test", 5); //Single parameter
     _client.Call("test", 5, false, new Task()); //Multiple parameters
}

####Dynamic Return-Type

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    //Should check if successful


    _client.Call("test", (response) =>
    {
        if(response.HasError())
            return; //Print Error...
        Console.WriteLine(response.Result); //Result is dynamic
        //or
        Console.WriteLine(response.Get<Task>().Name); //Convert it to some type (Json.NET)
    });
}

####Fixed Return-Type

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    //Should check if successful


    _client.Call<Task>("test", (error, result) =>
    {
        if(error != null)
            return; //Print Error...
        Console.WriteLine(result.Name); //Result is dynamic
    });
}

###Collections/Subscribers ####Event-Based

static void Main(string [] args)
{
    //After connecting...

    DdpSubscriber<Task> subscriber = _client.GetSubscriber<Task>("task");
    subscriber.Added += (o, addedModel) => Console.WriteLine("Added: " + addedModel.Object.Name);
    subscriber.Removed += (o, removedModel) => Console.WriteLine("Removed ID: " + removedModel.Id);

    //Should close here
}

####Interface-Based

static void Main(string [] args)
{
    //After connecting...

    DdpSubscriber<Task> subscriber = _client.GetSubscriber<Task>("task");
    subscriber.Subscribers.Add(new TaskSubscriber());
    //Should close here
}

internal class TaskSubscriber : IDdpSubscriber<Task>
{
    public void Added(SubAddedModel<Task> added)
    {

    }
    //...
}

###Subscriptions

private static void OnConnected(object sender, ConnectResponse connectResponse)
{
    //Should check if successful

    DdpSubHandler subHandler = _client.GetSubHandler("testSub");
    subHandler.Ready += (o, args) => Console.WriteLine("Sub Ready");
    subHandler.Sub();

    //If you dont want any data: subHandler.Unsub();
}