[mapguide-users] How to Use Maestro API Local Native Connection?

Jackie Ng jumpinjackie at gmail.com
Thu Aug 8 04:32:43 PDT 2019


The "Local Native" connection is an implementation of the Maestro API
interfaces that wraps the official MapGuide API, performance would be
slightly slower than if you were to just use the .net MapGuide API directly.

Hopefully this diagram explains where the Maestro API and its various
connection modes fit:
https://jumpinjackie.github.io/mapguide-maestro/devguide/coreconcepts.html#overview

The only reason you would ever want to use the "Local Native" connection
mode for your applications is if you already have a large swath of .net code
written using the Maestro API, but you don't want to bother with going
through the default http connection mode. The "Connect via TCP/IP" GUI login
option in Maestro (the end-user application) has no real practical purpose
beyond testing that the "Local Native" connection provider meets all the
behavioral contracts defined by the various Maestro API interfaces.

Now if you want to still go ahead and want to use this connection mode in
light of the above information, I'm afraid it's currently very difficult to
do. I used to provide an SDK zip package which contained the Maestro API
dlls, sample code and a provider template tool that helps build a local
native provider assembly for your particular version of MapGuide against the
provided Maestro API dlls, but this SDK package has been left in limbo due
to converting the Maestro API to become a series of .net standard libraries
provided as nuget packages, which has rendered the SDK package obsolete and
I'm figuring out a suitable alternative (current issue tracking this:
https://github.com/jumpinjackie/mapguide-maestro/issues/77).

In the meantime, I would just echo bishmanly's suggestion of just looking at
the source (in particular, the ProviderTemplate tool) to see how it produces
a local native assembly for you to use.

But again I emphasize: You must have a good reason to use the Maestro API
instead of just using the official .net MapGuide API proper if performance
is your main concern.

- Jackie



--
Sent from: http://osgeo-org.1560.x6.nabble.com/MapGuide-Users-f4182607.html


More information about the mapguide-users mailing list