/* ======================================================================== * Copyright (c) 2005-2020 The OPC Foundation, Inc. All rights reserved. * * OPC Foundation MIT License 1.00 * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation * files (the "Software"), to deal in the Software without * restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following * conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. * * The complete license agreement can be found here: * http://opcfoundation.org/License/MIT/1.00/ * ======================================================================*/ using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Text; using System.Windows.Forms; using System.Threading; using Opc.Ua.Client.Controls; namespace Opc.Ua.Client.Controls { /// /// Displays a list of servers. /// public partial class DiscoveredServerListCtrl : Opc.Ua.Client.Controls.BaseListCtrl { #region Constructors /// /// Initalize the control. /// public DiscoveredServerListCtrl() { InitializeComponent(); SetColumns(m_ColumnNames); ItemsLV.Sorting = SortOrder.Descending; ItemsLV.MultiSelect = false; } #endregion #region Private Fields // The columns to display in the control. private readonly object[][] m_ColumnNames = new object[][] { new object[] { "Name", HorizontalAlignment.Left, null }, new object[] { "Type", HorizontalAlignment.Left, null }, new object[] { "Host", HorizontalAlignment.Left, null }, new object[] { "URI", HorizontalAlignment.Left, null } }; private ApplicationConfiguration m_configuration; private int m_discoveryTimeout; private int m_discoverCount; private string m_discoveryUrl; #endregion #region Public Interface /// /// The timeout in milliseconds to use when discovering servers. /// [System.ComponentModel.DefaultValue(5000)] public int DiscoveryTimeout { get { return m_discoveryTimeout; } set { m_discoveryTimeout = value; } } /// /// Gets or sets the discovery URL used to find the servers displayed in the control. /// /// The discovery URL. public string DiscoveryUrl { get { return m_discoveryUrl; } set { m_discoveryUrl = value; } } /// /// Displays a list of servers in the control. /// public void Initialize(ConfiguredEndpointCollection endpoints, ApplicationConfiguration configuration) { Interlocked.Exchange(ref m_configuration, configuration); ItemsLV.Items.Clear(); foreach (ApplicationDescription server in endpoints.GetServers()) { AddItem(server); } AdjustColumns(); } /// /// Displays a list of servers in the control. /// public void Initialize(string hostname, ApplicationConfiguration configuration) { Interlocked.Exchange(ref m_configuration, configuration); ItemsLV.Items.Clear(); if (String.IsNullOrEmpty(hostname)) { hostname = System.Net.Dns.GetHostName(); } this.Instructions = Utils.Format("Discovering servers on host '{0}'.", hostname); AdjustColumns(); // get a list of well known discovery urls to use. StringCollection discoveryUrls = null; if (configuration != null && configuration.ClientConfiguration != null) { discoveryUrls = configuration.ClientConfiguration.WellKnownDiscoveryUrls; } if (discoveryUrls == null || discoveryUrls.Count == 0) { discoveryUrls = new StringCollection(Utils.DiscoveryUrls); } // update the urls with the hostname. StringCollection urlsToUse = new StringCollection(); foreach (string discoveryUrl in discoveryUrls) { urlsToUse.Add(Utils.Format(discoveryUrl, hostname)); } Interlocked.Increment(ref m_discoverCount); ThreadPool.QueueUserWorkItem(new WaitCallback(OnDiscoverServers), urlsToUse); } /// /// Updates the list of servers displayed in the control. /// private void OnUpdateServers(object state) { if (this.InvokeRequired) { this.BeginInvoke(new WaitCallback(OnUpdateServers), state); return; } ItemsLV.Items.Clear(); ApplicationDescriptionCollection servers = state as ApplicationDescriptionCollection; if (servers != null) { foreach (ApplicationDescription server in servers) { if (server.ApplicationType == ApplicationType.DiscoveryServer) { continue; } AddItem(server); } } if (ItemsLV.Items.Count == 0) { this.Instructions = Utils.Format("No servers to display."); } AdjustColumns(); } /// /// Attempts fetch the list of servers from the discovery server. /// private void OnDiscoverServers(object state) { try { int discoverCount = m_discoverCount; // do nothing if a valid list is not provided. IList discoveryUrls = state as IList; if (discoveryUrls == null) { return; } // process each url. foreach (string discoveryUrl in discoveryUrls) { Uri url = Utils.ParseUri(discoveryUrl); if (url != null) { if (DiscoverServers(url)) { return; } // check if another discover operation has started. if (discoverCount != m_discoverCount) { return; } } } // display empty list. OnUpdateServers(null); } catch (Exception e) { Utils.Trace(e, "Unexpected error discovering servers."); } } /// /// Fetches the servers from the discovery server. /// private bool DiscoverServers(Uri discoveryUrl) { // use a short timeout. EndpointConfiguration configuration = EndpointConfiguration.Create(m_configuration); configuration.OperationTimeout = m_discoveryTimeout; DiscoveryClient client = null; try { client = DiscoveryClient.Create( discoveryUrl, BindingFactory.Create(m_configuration, m_configuration.CreateMessageContext()), EndpointConfiguration.Create(m_configuration)); ApplicationDescriptionCollection servers = client.FindServers(null); m_discoveryUrl = discoveryUrl.ToString(); OnUpdateServers(servers); return true; } catch (Exception e) { Utils.Trace("DISCOVERY ERROR - Could not fetch servers from url: {0}. Error=({2}){1}", discoveryUrl, e.Message, e.GetType()); return false; } finally { if (client != null) { client.Close(); } } } #endregion #region Overridden Methods /// /// Updates an item in the control. /// protected override void UpdateItem(ListViewItem listItem, object item) { ApplicationDescription server = listItem.Tag as ApplicationDescription; if (server == null) { base.UpdateItem(listItem, server); return; } string hostname = ""; // extract host from application uri. Uri uri = Utils.ParseUri(server.ApplicationUri); if (uri != null) { hostname = uri.DnsSafeHost; } // get the host name from the discovery urls. if (String.IsNullOrEmpty(hostname)) { foreach (string discoveryUrl in server.DiscoveryUrls) { Uri url = Utils.ParseUri(discoveryUrl); if (url != null) { hostname = url.DnsSafeHost; break; } } } listItem.SubItems[0].Text = String.Format("{0}", server.ApplicationName); listItem.SubItems[1].Text = String.Format("{0}", server.ApplicationType); listItem.SubItems[2].Text = String.Format("{0}", hostname); listItem.SubItems[3].Text = String.Format("{0}", server.ApplicationUri); listItem.ImageKey = GuiUtils.Icons.Service; } #endregion } }