#region Disclaimer / License // Copyright (C) 2006, Kenneth Skovhede // http://www.hexad.dk, opensource@hexad.dk // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either // version 2.1 of the License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA // #endregion using System; using OSGeo.MapGuide; namespace OSGeo.MapGuide.MaestroAPI { /// /// A connection to the server, using the Native API. /// Only works locally, or with special firewall rules for the server. /// public class LocalNativeConnection : ServerConnectionBase, ServerConnectionI { private OSGeo.MapGuide.MgSiteConnection m_con; private string m_locale; private string m_sessionId; private LocalNativeConnection() : base() { } public LocalNativeConnection(string sessionid) : this() { MgUserInformation mgui = new MgUserInformation(sessionid); m_con = new MgSiteConnection(); m_con.Open(mgui); m_sessionId = sessionid; } public LocalNativeConnection(string configFile, string username, string password, string locale) : this() { m_username = username; m_password = password; m_locale = locale; OSGeo.MapGuide.MapGuideApi.MgInitializeWebTier(configFile); //Throws an exception if it fails RestartSession(); } #region ServerConnectionI Members public override string SessionID { get { return m_sessionId; } } public ResourceList RepositoryResources { get { return GetRepositoryResources(); } } public override ResourceList GetRepositoryResources(string startingpoint, string type, int depth) { if (type == null) type = ""; MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; System.Reflection.MethodInfo mi = res.GetType().GetMethod("EnumerateResources", new Type[] { typeof(MgResourceIdentifier), typeof(int), typeof(string) }); return (ResourceList) base.DeserializeObject(typeof(ResourceList), Utility.MgStreamToNetStream(res, mi, new object[] {new MgResourceIdentifier(startingpoint), depth, type })); } public override FeatureProviderRegistryFeatureProviderCollection FeatureProviders { get { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; return (FeatureProviderRegistryFeatureProviderCollection) base.DeserializeObject(typeof(ResourceList), Utility.MgStreamToNetStream(fes, fes.GetType().GetMethod("GetFeatureProviders"), new object[] { })); } } public string TestConnection(string providername, System.Collections.Specialized.NameValueCollection parameters) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; System.Text.StringBuilder sb = new System.Text.StringBuilder(); if (parameters != null) { foreach(System.Collections.DictionaryEntry de in parameters) sb.Append((string)de.Key + "=" + (string)de.Value + "\t"); if (sb.Length > 0) sb.Length--; } return fes.TestConnection(providername, sb.ToString()) ? "No errors" : "Unspecified errors"; } public override string TestConnection(string featuresource) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; return fes.TestConnection(new MgResourceIdentifier(featuresource)) ? "No errors" : "Unspecified errors"; } public void DescribeSchema() { throw new MissingMethodException(); } public FdoProviderCapabilities GetProviderCapabilities(string provider) { MgFeatureService fes = m_con.CreateService(MgServiceType.ResourceService) as MgFeatureService; return (FdoProviderCapabilities) base.DeserializeObject(typeof(FdoProviderCapabilities), Utility.MgStreamToNetStream(fes, fes.GetType().GetMethod("GetCapabilities"), new object[] { provider })); } public override System.IO.MemoryStream GetResourceData(string resourceID, string dataname) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; return Utility.MgStreamToNetStream(res, res.GetType().GetMethod("GetResourceData"), new object[] { new MgResourceIdentifier(resourceID), dataname }); } public override byte[] GetResourceXmlData(string resourceID) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; return Utility.MgStreamToNetStream(res, res.GetType().GetMethod("GetResourceContent"), new object[] { new MgResourceIdentifier(resourceID) }).ToArray(); } public override FeatureProviderRegistryFeatureProvider GetFeatureProvider(string providername) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; System.IO.MemoryStream ms = Utility.MgStreamToNetStream(fes, fes.GetType().GetMethod("GetCapabilities"), new object[] { providername }); return (FeatureProviderRegistryFeatureProvider)DeserializeObject(typeof(FeatureProviderRegistryFeatureProvider), ms); } public System.IO.Stream GetMapDWF(string resourceID) { throw new MissingMethodException(); } public override void SetResourceData(string resourceid, string dataname, OSGeo.MapGuide.MaestroAPI.ResourceDataType datatype, System.IO.Stream stream) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; byte[] data = Utility.StreamAsArray(stream); MgByteReader reader = new MgByteReader(data, data.Length, "binary/octet-stream"); res.SetResourceData(new MgResourceIdentifier(resourceid), dataname, datatype.ToString(), reader); } public override void SetResourceXmlData(string resourceid, System.IO.Stream stream) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; if (stream == null) res.SetResource(new MgResourceIdentifier(resourceid), null, null); else { byte[] buf = Utility.StreamAsArray(stream); MgByteReader r = new MgByteReader(buf, buf.Length, "text/xml"); res.SetResource(new MgResourceIdentifier(resourceid), r, null); } } public FeatureSetReader QueryFeatureSource(string resourceID, string schema, string query) { return QueryFeatureSource(resourceID, schema, query, null); } public FeatureSetReader QueryFeatureSource(string resourceID, string schema) { return QueryFeatureSource(resourceID, schema, null, null); } public FeatureSetReader QueryFeatureSource(string resourceID, string schema, string query, string[] columns) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; MgFeatureQueryOptions mgf = new MgFeatureQueryOptions(); if (query != null) mgf.SetFilter(query); if (columns != null && columns.Length != 0) foreach(string s in columns) mgf.AddFeatureProperty(s); return new FeatureSetReader(fes.SelectFeatures(new MgResourceIdentifier(resourceID), schema, mgf)); } public FeatureSourceDescription DescribeFeatureSource(string resourceID) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; System.IO.MemoryStream ms = new System.IO.MemoryStream(System.Text.Encoding.UTF8.GetBytes(fes.DescribeSchemaAsXml(new MgResourceIdentifier(resourceID), ""))); return new FeatureSourceDescription(ms); } public FeatureSourceDescription DescribeFeatureSource(string resourceID, string schema) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; if (schema != null && schema.IndexOf(":") > 0) schema = schema.Split(':')[0]; System.IO.MemoryStream ms = new System.IO.MemoryStream(System.Text.Encoding.UTF8.GetBytes(fes.DescribeSchemaAsXml(new MgResourceIdentifier(resourceID), schema))); return new FeatureSourceDescription(ms); } public void CreateRuntimeMap(string resourceID, string mapdefinition) { string mapname = this.GetResourceName(resourceID, true); MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; MgMap map = new MgMap(); map.Create(res, new MgResourceIdentifier(mapdefinition), mapname); map.Save(res, new MgResourceIdentifier(resourceID)); } void OSGeo.MapGuide.MaestroAPI.ServerConnectionI.CreateRuntimeMap(string resourceID, MapDefinition map) { string guid = base.GetResourceIdentifier(Guid.NewGuid().ToString(), ResourceTypes.MapDefinition, true); try { SaveResourceAs(map, guid); CreateRuntimeMap(resourceID, guid); } finally { try { DeleteResource(guid); } catch { } } } void OSGeo.MapGuide.MaestroAPI.ServerConnectionI.CreateRuntimeMap(string resourceID, OSGeo.MapGuide.MaestroAPI.RuntimeClasses.RuntimeMap map) { ValidateResourceID(resourceID, ResourceTypes.RuntimeMap); string selectionID = resourceID.Substring(0, resourceID.LastIndexOf(".")) + ".Selection"; SetResourceXmlData(resourceID, new System.IO.MemoryStream(System.Text.Encoding.UTF8.GetBytes(HttpServerConnection.RUNTIMEMAP_XML))); SetResourceXmlData(selectionID, new System.IO.MemoryStream(System.Text.Encoding.UTF8.GetBytes(HttpServerConnection.RUNTIMEMAP_SELECTION_XML))); System.IO.MemoryStream ms = new System.IO.MemoryStream(); BinarySerializer.MgBinarySerializer serializer = new BinarySerializer.MgBinarySerializer(ms, this.SiteVersion); RuntimeClasses.Selection sel = new RuntimeClasses.Selection(); sel.Serialize(serializer); ms.Position = 0; SetResourceData(selectionID, "RuntimeData", ResourceDataType.Stream, ms); SaveRuntimeMap(resourceID, map); } public void SaveRuntimeMap(string resourceID, RuntimeClasses.RuntimeMap map) { System.IO.MemoryStream ms = new System.IO.MemoryStream(); System.IO.MemoryStream ms2 = null; //Apparently the name is used to reconstruct the resourceId rather than pass it around //inside the map server string r = map.Name; string t = map.ResourceID; string mapname = resourceID.Substring(resourceID.IndexOf("//") + 2); mapname = mapname.Substring(0, mapname.LastIndexOf(".")); map.Name = mapname; map.ResourceID = resourceID; try { map.Serialize(new BinarySerializer.MgBinarySerializer(ms, this.SiteVersion)); if (this.SiteVersion >= SiteVersions.GetVersion(KnownSiteVersions.MapGuideOS1_2)) { ms2 = new System.IO.MemoryStream(); map.SerializeLayerData(new BinarySerializer.MgBinarySerializer(ms2, this.SiteVersion)); } SetResourceData(resourceID, "RuntimeData", ResourceDataType.Stream, ms); if (ms2 != null) SetResourceData(resourceID, "LayerGroupData", ResourceDataType.Stream, ms2); } finally { map.Name = r; map.ResourceID = t; } } public void DeleteResourceData(string resourceID, string dataname) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.DeleteResourceData(new MgResourceIdentifier(resourceID), dataname); } public ResourceDataList EnumerateResourceData(string resourceID) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; System.IO.MemoryStream ms = Utility.MgStreamToNetStream(res, res.GetType().GetMethod("EnumerateResourceData"), new object[] { new MgResourceIdentifier(resourceID) }); return (ResourceDataList)DeserializeObject(typeof(ResourceDataList), ms); } public override void DeleteResource(string resourceID) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.DeleteResource(new MgResourceIdentifier(resourceID)); } public void DeleteFolder(string folderPath) { if (!folderPath.EndsWith("/")) folderPath += "/"; MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.DeleteResource(new MgResourceIdentifier(folderPath)); } public RuntimeClasses.RuntimeMap GetRuntimeMap(string resourceID) { RuntimeClasses.RuntimeMap m = new RuntimeClasses.RuntimeMap(); m.Deserialize(new BinarySerializer.MgBinaryDeserializer(this.GetResourceData(resourceID, "RuntimeData"), this.SiteVersion)); if (this.SiteVersion >= SiteVersions.GetVersion(KnownSiteVersions.MapGuideOS1_2)) m.DeserializeLayerData(new BinarySerializer.MgBinaryDeserializer(this.GetResourceData(resourceID, "LayerGroupData"), this.SiteVersion)); m.CurrentConnection = this; return m; } public override Version SiteVersion { get { return SiteVersions.GetVersion(KnownSiteVersions.MapGuideOS1_2); } } public CoordinateSystem CoordinateSystem { get { throw new MissingMethodException(); } } public string DisplayName { get { return m_con.GetSite().GetCurrentSiteAddress(); } } public override ResourceReferenceList EnumerateResourceReferences(string resourceid) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; System.IO.MemoryStream ms = Utility.MgStreamToNetStream(res, res.GetType().GetMethod("EnumerateReferences"), new object[] { new MgResourceIdentifier(resourceid) }); return (ResourceReferenceList)DeserializeObject(typeof(ResourceReferenceList), ms); } public override void CopyResource(string oldpath, string newpath, bool overwrite) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.CopyResource(new MgResourceIdentifier(oldpath), new MgResourceIdentifier(newpath), overwrite); } public override void CopyFolder(string oldpath, string newpath, bool overwrite) { if (!oldpath.EndsWith("/")) oldpath += "/"; if (!newpath.EndsWith("/")) newpath += "/"; MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.CopyResource(new MgResourceIdentifier(oldpath), new MgResourceIdentifier(newpath), overwrite); } public override void MoveResource(string oldpath, string newpath, bool overwrite) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.MoveResource(new MgResourceIdentifier(oldpath), new MgResourceIdentifier(newpath), overwrite); } public override void MoveFolder(string oldpath, string newpath, bool overwrite) { if (!oldpath.EndsWith("/")) oldpath += "/"; if (!newpath.EndsWith("/")) newpath += "/"; MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; res.MoveResource(new MgResourceIdentifier(oldpath), new MgResourceIdentifier(newpath), overwrite); } public System.IO.Stream RenderRuntimeMap(string resourceId, double x, double y, double scale, int width, int height, int dpi) { MgRenderingService rnd = m_con.CreateService(MgServiceType.RenderingService) as MgRenderingService; MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; MgGeometryFactory gf = new MgGeometryFactory(); string mapname = this.GetResourceName(resourceId, true); MgMap map = new MgMap(); map.Open(res, mapname); MgSelection sel = new MgSelection(map); MgColor color = new MgColor(map.GetBackgroundColor()); object[] args = new object[] { map, sel, gf.CreateCoordinateXY(x, y), scale, width, height, color, "PNG", true }; return Utility.MgStreamToNetStream(rnd, rnd.GetType().GetMethod("RenderMap"), args); } public override bool IsSessionExpiredException(Exception ex) { return ex != null && ex.GetType() == typeof(OSGeo.MapGuide.MgSessionExpiredException) || ex.GetType() == typeof(OSGeo.MapGuide.MgSessionNotFoundException); } /// /// Returns the avalible application templates on the server /// /// The avalible application templates on the server public override ApplicationDefinitionTemplateInfoSet GetApplicationTemplates() { throw new MissingMethodException(); } /// /// Returns the avalible application widgets on the server /// /// The avalible application widgets on the server public override ApplicationDefinitionWidgetInfoSet GetApplicationWidgets() { throw new MissingMethodException(); } /// /// Returns the avalible widget containers on the server /// /// The avalible widget containers on the server public override ApplicationDefinitionContainerInfoSet GetApplicationContainers() { throw new MissingMethodException(); } /// /// Returns the spatial info for a given featuresource /// /// The ID of the resource to query /// Query only active items /// A list of spatial contexts public override FdoSpatialContextList GetSpatialContextInfo(string resourceID, bool activeOnly) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; MgSpatialContextReader rd = fes.GetSpatialContexts(new MgResourceIdentifier(resourceID), activeOnly); //TODO: Convert rd to FdoSpatialContextList throw new MissingMethodException(); } /// /// Gets the names of the identity properties from a feature /// /// The resourceID for the FeatureSource /// The classname of the feature, including schema /// A string array with the found identities public override string[] GetIdentityProperties(string resourceID, string classname) { MgFeatureService fes = m_con.CreateService(MgServiceType.FeatureService) as MgFeatureService; string[] parts = classname.Split(':'); MgResourceIdentifier resId = new MgResourceIdentifier(resourceID); MgPropertyDefinitionCollection props; if (parts.Length == 1) parts = new string[] { classname }; else if (parts.Length != 2) throw new Exception("Unable to parse classname into class and schema: " + classname); foreach(MgClassDefinition cdef in fes.DescribeSchema(resId, parts[0])[0].GetClasses()) if (parts.Length == 1 || cdef.Name.ToLower().Trim().Equals(parts[1].ToLower().Trim())) { props = cdef.GetIdentityProperties(); string[] res = new string[props.Count]; for (int i = 0; i < props.Count; i++) res[i] = (props[i] as MgProperty).Name; return res; } throw new Exception("Unable to find class: " + parts[1] + " in schema " + parts[0]); } /// /// Restarts the server session, and creates a new session ID /// /// If set to true, the call throws an exception if the call failed /// True if the creation succeed, false otherwise public override bool RestartSession(bool throwException) { if (m_username == null || m_password == null) if (throwException) throw new Exception("Cannot recreate session, because connection was not opened with username and password"); else return false; try { MgUserInformation mgui = new MgUserInformation(m_username, m_password); if (m_locale != null) mgui.SetLocale(m_locale); else mgui.SetLocale("en"); MgSiteConnection con = new MgSiteConnection(); con.Open(mgui); string s = con.GetSite().CreateSession(); if (s == null || s.Trim().Length == 0) throw new Exception("Failed to retrieve new session identifier"); m_sessionId = s; m_con = con; return true; } catch { if (throwException) throw; else return false; } } /// /// Sets the selection of a map /// /// The resourceID of the runtime map /// The selection xml public override void SetSelectionXml(string runtimeMap, string selectionXml) { ValidateResourceID(runtimeMap, ResourceTypes.RuntimeMap); MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; MgMap map = new MgMap(); string mapname = this.GetResourceName(runtimeMap, true); map.Open(res, mapname); MgSelection sel = new MgSelection(map, selectionXml); sel.Save(res, mapname); } /// /// Gets the selection from a map /// /// The resourceID of the runtime map /// The selection xml public override string GetSelectionXml(string runtimeMap) { MgResourceService res = m_con.CreateService(MgServiceType.ResourceService) as MgResourceService; MgMap map = new MgMap(); string mapname = this.GetResourceName(runtimeMap, true); map.Open(res, mapname); MgSelection sel = new MgSelection(map); return sel.ToXml(); } /// /// Enumerates all unmanaged folders, meaning alias'ed folders /// /// The type of data to return /// A filter applied to the items /// True if the list should contains recursive results /// The path to retrieve the data from /// A list of unmanaged data public override UnmanagedDataList EnumerateUnmanagedData(string startpath, string filter, bool recursive, UnmanagedDataTypes type) { throw new MissingMethodException(); } #endregion } }