Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mikebild/reactivemvvm
https://github.com/mikebild/reactivemvvm
Last synced: 16 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/mikebild/reactivemvvm
- Owner: MikeBild
- Created: 2011-03-27T00:40:18.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2012-07-31T10:52:53.000Z (over 12 years ago)
- Last Synced: 2024-10-11T12:45:02.976Z (about 1 month ago)
- Language: C#
- Homepage:
- Size: 17.3 MB
- Stars: 9
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README
Awesome Lists containing this project
README
ReactiveMVVM Toolkit
is a small MVVM Toolkit with base classes for build Silverlight applications that using the MMVM pattern. ReactiveMVVM is based on Rx.NET as inmemory message bus and AutoFac as DI based instance lifecycle manager and type resolver.
HOW TO USE
ENVIRONMENT - Application BootStrapper & Application Host
1) Build your own BootStrapper for type registrations
public class TodoListBootStrapper : BootStrapper
{
public TodoListBootStrapper()
{
Builder.RegisterType().As();
}
public override void Configure()
{
base.Configure();
Startup();
}
}
2) Add BootStrapper configuration to application startup
public partial class App : Application
{
public App()
{
new TodoListBootStrapper().Configure();
}
}
3) Build application environment by inheriting from SilverlightAppHost
public class MyAppHost : SilverlightAppHost
{
...
}
4) Override Start() by implementing application startup operations
public class MyAppHost : SilverlightAppHost
{
public override void Start()
{
...
}
}
VIEWMODEL
The ViewModel has two parts. One is the ViewModel self and one is a PageController for the ViewModel, View and external component communication.
1) Create you data or domain model like:
public class TodoItem
{
public string Description { get; set; }
public bool IsDone { get; set; }
public Guid TodoId { get; set; }
}
2) Create a ViewModel by implement the IViewModel tagging interface. For example:
public class MyViewModel : IViewModel
{
private readonly ObservableCollection _toDos = new ObservableCollection();
public ReadOnlyObservableCollection ToDos { get; private set; }
public MyViewModel()
{
ToDos = new ReadOnlyObservableCollection(_toDos);
}
}
3) Create a PageController by inheriting from PageController. For example:
public class MyPageController : PageController
{
public MyPageController()
{
MyCommand = new DelegateCommand(todoItem=>{ ... });
}
public ICommand MyCommand { get;set;}
}
4) Register the PageControlle as static application resource in your App.xaml like:
5) Register the PageController in your XAML UserControl or XAML Page definition like:
6) Now you can invoke commands in XAML views by using standard triggers like Command="{Binding MyCommand}" or interaction triggers from System.Windows.Interactivity. For example:
--- As Standard Command ---
--- In Page ---
--- In Templates ---
COMMANDS
ReactiveMVVM has 4 easy to use commands implemented.
--- DELEGATECOMMAND - a classic delegate based command ---
public class DelegateCommand : ICommand where T : class
---
public ICommand MyCommand { get;set; }
MyCommand = new DelegateCommand(x => { /*invoked by ICommand.Execute */});
--- PUBLISHCOMMAND - a message bus based command for publishing a event message ---
public class PublishCommand : ICommand where TBinding : class
---
public ICommand MyCommand { get;set; }
MyCommand = new PublishCommand(x => new TodoItemDescriptionChanged() { Id = x.TodoId, NewDescription = x.Description } /*return the IEventMessage to publish*/ );
--- SENDCOMMAND - a message bus based command for sending a command message ---
public class SendCommand : ICommand where TBinding : class
---
public ICommand MyCommand { get;set; }
MyCommand = new SendCommand(x => new LoadTodoItemList() /*return the ICommandMessage to send*/ );
--- REGISTERCOMMAND - a message bus based command for registing to recieve messages ---
public class RegisterCommand : ICommand where TMessage : class, IMessage
---
public ICommand MyCommand { get;set; }
MyCommand = new RegisterCommand(x => { /*invoked by receiving a IMessage from message bus */ });
TRIGGER
ReactiveMVVM has 2 easy to use triggers for using in XAML implemented.
--- MESSAGETRIGGER - a trigger to send a message to message bus ---
--- NAVIGATETOTRIGGER - a trigger to navigate to other page ---
NAVIGATION
1) For using navigation add following to MainPage.xaml
2) and add following to App.xaml to register a static application resource object for holding state of navigation parameter
MESSAGE BUS
The message bus is the central application hub for component communication. The message bus manage and orchestrate the collaboration between all application
components and all page controllers by using a message based communication pattern.
EVENT & COMMAND HANDLING
PERSISTENCE
comming soon
BACKLOG:
Navigation GoBack Command and Trigger
Navigation GoForward Command and Trigger
Object Parameter in MessageTrigger
IUnitOfWork instead of IIsolatedStorageUnitOfWork
wcf based persistence
reactive repository abstraction that using rx messagebus
wcf client integration for remote query, commands and events
a wpf and wp7 port
build up a NuGet package
some more samples for API validation
some integration tests
ReactiveMVVM is inspired by MVVM Light Toolkit.
ReactiveMVVM using external libs AutoFac, Rx.NET from NuGet repository.