MindTouch.Core vs. MindTouch.Dream

[dsimunic]

Hi,


just started looking into dream framework to use on a project. Very impressive, thank you for giving this to the community.

I have a question regarding the intentions and reasons behind splitting the project into two separate libraries, Core and Dream. Both seem to have same dependencies and the same namespace, yet Core depends on Dream.

Looking at DekiWiki source, it seems to depend only on the Dream library, don't see Core mentioned anywhere.

If you have a moment, could you elaborate the purpose of the Core library -- I'd like to better understand how to optimally use the framework.

Thanks,

Damir

[SteveB]

Welcome dsimunic! And thanks for the praise. Feedback is always appreciated. :)

mindtouch.core is used to create a hosting environment such as mindtouch.host.exe. It also includes a set of basic services, they may evolve at a different pace than mindtouch.dream.

mindtouch.dream contains the essentials that are used by every project. It's used to implement services, connect to RESTful resources, and is used by mindtouch.core to implement the environment.

In short, if you create a new service, you'll only need mindtouch.dream and you can then use mindtouch.host.exe to run it as a standalone host. Or you could be more sophisticated and also use mindtouch.core to create your own custom hosting environment.

Let us know how it goes!

[dsimunic]

Steve,

thanks for the prompt answer -- this clears things up. Guess I'll have to use the Core library since I need it to work through IIS.

I'll test the framework for the next two weeks; I'll probably have more questions as I go along.

Thanks,

Damir

[PeteE]

Guess I'll have to use the Core library since I need it to work through IIS.


dsimunic - I wrote up a quick tutorial on using MindTouch.Dream.Http.HttpHandler within IIS6. You might find it helpful.

http://doc.opengarden.org/User:PeteE/Dream_HttpHandler_IIS6

[dsimunic]

Pete, thanks a lot, much appreciated.

Went quickly through it and it works OK, maybe it would be good to include the minimal Web.config for people who start from scratch. Seems that root-uri, service-dir, and apikey are mandatory settings. Otherwise the HttpHandler constructor fails.

A small correction, you mention "localhost/@api/host/@about" instead of "localhost/dream/host/@about".

Thanks again, this certainly put me to the right track much quicker then I hoped for.


Damir

[PeteE]

maybe it would be good to include the minimal Web.config for people who start from scratch. Seems that root-uri, service-dir, and apikey are mandatory settings. Otherwise the HttpHandler constructor fails.

If you're using dream from SVN there's a sample web.config in

dream/src/web.config
though I don't think it's included in the VS.NET project file...



A small correction, you mention "localhost/@api/host/@about" instead of "localhost/dream/host/@about".

Thanks, I've updated it :)

Thanks for trying this out. Any feedback is greatly appreciated!