Location-allocation solver
LicenseInitializer.cs
// Copyright 2012 ESRI
// 
// All rights reserved under the copyright laws of the United States
// and applicable international laws, treaties, and conventions.
// 
// You may freely redistribute and use this sample code, with or
// without modification, provided you include the original copyright
// notice and use restrictions.
// 
// See the use restrictions.
// 

using System;
using System.Collections.Generic;
using ESRI.ArcGIS.esriSystem;

//FILE AUTOMATICALLY GENERATED BY ESRI LICENSE INITIALIZATION ADDIN
//YOU SHOULD NOT NORMALLY EDIT OR REMOVE THIS FILE FROM THE PROJECT

namespace LocationAllocationSolver
{
  internal sealed class LicenseInitializer
  {
    private IAoInitialize m_AoInit = new AoInitializeClass();

    #region Private members
    private const string MessageNoLicensesRequested = "Product: No licenses were requested";
    private const string MessageProductAvailable = "Product: {0}: Available";
    private const string MessageProductNotLicensed = "Product: {0}: Not Licensed";
    private const string MessageExtensionAvailable = " Extension: {0}: Available";
    private const string MessageExtensionNotLicensed = " Extension: {0}: Not Licensed";
    private const string MessageExtensionFailed = " Extension: {0}: Failed";
    private const string MessageExtensionUnavailable = " Extension: {0}: Unavailable";

    private bool m_hasShutDown = false;
    private bool m_hasInitializeProduct = false;

    private List<int> m_requestedProducts;
    private List<esriLicenseExtensionCode> m_requestedExtensions;
    private Dictionary<esriLicenseProductCode, esriLicenseStatus> m_productStatus = new Dictionary<esriLicenseProductCode, esriLicenseStatus>();
    private Dictionary<esriLicenseExtensionCode, esriLicenseStatus> m_extensionStatus = new Dictionary<esriLicenseExtensionCode, esriLicenseStatus>();

    private bool m_productCheckOrdering = true; //default from low to high
    #endregion

    public bool InitializeApplication(esriLicenseProductCode[] productCodes, esriLicenseExtensionCode[] extensionLics)
    {
      //Cache product codes by enum int so can be sorted without custom sorter
      m_requestedProducts = new List<int>();
      foreach (esriLicenseProductCode code in productCodes)
      {
        int requestCodeNum = Convert.ToInt32(code);
        if (!m_requestedProducts.Contains(requestCodeNum))
        {
          m_requestedProducts.Add(requestCodeNum);
        }
      }

      AddExtensions(extensionLics);
      return Initialize();
    }

    /// <summary>
    /// A summary of the status of product and extensions initialization.
    /// </summary>
    public string LicenseMessage()
    {
      string prodStatus = string.Empty;
      if (m_productStatus == null || m_productStatus.Count == 0)
      {
        prodStatus = MessageNoLicensesRequested + Environment.NewLine;
      }
      else if (m_productStatus.ContainsValue(esriLicenseStatus.esriLicenseAlreadyInitialized)
        || m_productStatus.ContainsValue(esriLicenseStatus.esriLicenseCheckedOut))
      {
        prodStatus = ReportInformation(m_AoInit as ILicenseInformation,
          m_AoInit.InitializedProduct(),
          esriLicenseStatus.esriLicenseCheckedOut) + Environment.NewLine;
      }
      else
      {
        //Failed...
        foreach (KeyValuePair<esriLicenseProductCode, esriLicenseStatus> item in m_productStatus)
        {
          prodStatus += ReportInformation(m_AoInit as ILicenseInformation,
            item.Key, item.Value) + Environment.NewLine;
        }
      }

      string extStatus = string.Empty;
      foreach (KeyValuePair<esriLicenseExtensionCode, esriLicenseStatus> item in m_extensionStatus)
      {
        string info = ReportInformation(m_AoInit as ILicenseInformation, item.Key, item.Value);
        if (!string.IsNullOrEmpty(info))
          extStatus += info + Environment.NewLine;
      }

      string status = prodStatus + extStatus;
      return status.Trim();
    }

    /// <summary>
    /// Shuts down AoInitialize object and check back in extensions to ensure
    /// any ESRI libraries that have been used are unloaded in the correct order.
    /// </summary>
    /// <remarks>Once Shutdown has been called, you cannot re-initialize the product license
    /// and should not make any ArcObjects call.</remarks>
    public void ShutdownApplication()
    {
      if (m_hasShutDown)
        return;

      //Check back in extensions
      foreach (KeyValuePair<esriLicenseExtensionCode, esriLicenseStatus> item in m_extensionStatus)
      {
        if (item.Value == esriLicenseStatus.esriLicenseCheckedOut)
          m_AoInit.CheckInExtension(item.Key);
      }

      m_requestedProducts.Clear();
      m_requestedExtensions.Clear();
      m_extensionStatus.Clear();
      m_productStatus.Clear();
      m_AoInit.Shutdown();
      m_hasShutDown = true;
      //m_hasInitializeProduct = false;
    }

    /// <summary>
    /// Indicates if the extension is currently checked out.
    /// </summary>
    public bool IsExtensionCheckedOut(esriLicenseExtensionCode code)
    {
      return m_AoInit.IsExtensionCheckedOut(code);
    }

    /// <summary>
    /// Set the extension(s) to be checked out for your ArcObjects code. 
    /// </summary>
    public bool AddExtensions(params esriLicenseExtensionCode[] requestCodes)
    {
      if (m_requestedExtensions == null)
        m_requestedExtensions = new List<esriLicenseExtensionCode>();
      foreach (esriLicenseExtensionCode code in requestCodes)
      {
        if (!m_requestedExtensions.Contains(code))
          m_requestedExtensions.Add(code);
      }

      if (m_hasInitializeProduct)
        return CheckOutLicenses(this.InitializedProduct);

      return false;
    }

    /// <summary>
    /// Check in extension(s) when it is no longer needed.
    /// </summary>
    public void RemoveExtensions(params esriLicenseExtensionCode[] requestCodes)
    {
      if (m_extensionStatus == null || m_extensionStatus.Count == 0)
        return;

      foreach (esriLicenseExtensionCode code in requestCodes)
      {
        if (m_extensionStatus.ContainsKey(code))
        {
          if (m_AoInit.CheckInExtension(code) == esriLicenseStatus.esriLicenseCheckedIn)
          {
            m_extensionStatus[code] = esriLicenseStatus.esriLicenseCheckedIn;
          }
        }
      }
    }

    /// <summary>
    /// Get/Set the ordering of product code checking. If true, check from lowest to 
    /// highest license. True by default.
    /// </summary>
    public bool InitializeLowerProductFirst
    {
      get
      {
        return m_productCheckOrdering;
      }
      set
      {
        m_productCheckOrdering = value;
      }
    }

    /// <summary>
    /// Retrieves the product code initialized in the ArcObjects application
    /// </summary>
    public esriLicenseProductCode InitializedProduct
    {
      get
      {
        try
        {
          return m_AoInit.InitializedProduct();
        }
        catch
        {
          return 0;
        }
      }
    }

    #region Helper methods
    private bool Initialize()
    {
      if (m_requestedProducts == null || m_requestedProducts.Count == 0)
        return false;

      esriLicenseProductCode currentProduct = new esriLicenseProductCode();
      bool productInitialized = false;

      //Try to initialize a product
      ILicenseInformation licInfo = (ILicenseInformation)m_AoInit;

      m_requestedProducts.Sort();
      if (!InitializeLowerProductFirst) //Request license from highest to lowest
        m_requestedProducts.Reverse();

      foreach (int prodNumber in m_requestedProducts)
      {
        esriLicenseProductCode prod = (esriLicenseProductCode)Enum.ToObject(typeof(esriLicenseProductCode), prodNumber);
        esriLicenseStatus status = m_AoInit.IsProductCodeAvailable(prod);
        if (status == esriLicenseStatus.esriLicenseAvailable)
        {
          status = m_AoInit.Initialize(prod);
          if (status == esriLicenseStatus.esriLicenseAlreadyInitialized ||
            status == esriLicenseStatus.esriLicenseCheckedOut)
          {
            productInitialized = true;
            currentProduct = m_AoInit.InitializedProduct();
          }
        }

        m_productStatus.Add(prod, status);

        if (productInitialized)
          break;
      }

      m_hasInitializeProduct = productInitialized;
      m_requestedProducts.Clear();

      //No product is initialized after trying all requested licenses, quit
      if (!productInitialized)
      {
        return false;
      }

      //Check out extension licenses
      return CheckOutLicenses(currentProduct);
    }

    private bool CheckOutLicenses(esriLicenseProductCode currentProduct)
    {
      bool allSuccessful = true;
      //Request extensions
      if (m_requestedExtensions != null && currentProduct != 0)
      {
        foreach (esriLicenseExtensionCode ext in m_requestedExtensions)
        {
          esriLicenseStatus licenseStatus = m_AoInit.IsExtensionCodeAvailable(currentProduct, ext);
          if (licenseStatus == esriLicenseStatus.esriLicenseAvailable)//skip unavailable extensions
          {
            licenseStatus = m_AoInit.CheckOutExtension(ext);
          }
          allSuccessful = (allSuccessful && licenseStatus == esriLicenseStatus.esriLicenseCheckedOut);
          if (m_extensionStatus.ContainsKey(ext))
            m_extensionStatus[ext] = licenseStatus;
          else
            m_extensionStatus.Add(ext, licenseStatus);
        }

        m_requestedExtensions.Clear();
      }

      return allSuccessful;
    }


    private string ReportInformation(ILicenseInformation licInfo,
       esriLicenseProductCode code, esriLicenseStatus status)
    {
      string prodName = string.Empty;
      try
      {
        prodName = licInfo.GetLicenseProductName(code);
      }
      catch
      {
        prodName = code.ToString();
      }

      string statusInfo = string.Empty;

      switch (status)
      {
        case esriLicenseStatus.esriLicenseAlreadyInitialized:
        case esriLicenseStatus.esriLicenseCheckedOut:
          statusInfo = string.Format(MessageProductAvailable, prodName);
          break;
        default:
          statusInfo = string.Format(MessageProductNotLicensed, prodName);
          break;
      }

      return statusInfo;
    }
    private string ReportInformation(ILicenseInformation licInfo,
      esriLicenseExtensionCode code, esriLicenseStatus status)
    {
      string extensionName = string.Empty;
      try
      {
        extensionName = licInfo.GetLicenseExtensionName(code);
      }
      catch
      {
        extensionName = code.ToString();
      }

      string statusInfo = string.Empty;

      switch (status)
      {
        case esriLicenseStatus.esriLicenseAlreadyInitialized:
        case esriLicenseStatus.esriLicenseCheckedOut:
          statusInfo = string.Format(MessageExtensionAvailable, extensionName);
          break;
        case esriLicenseStatus.esriLicenseCheckedIn:
          break;
        case esriLicenseStatus.esriLicenseUnavailable:
          statusInfo = string.Format(MessageExtensionUnavailable, extensionName);
          break;
        case esriLicenseStatus.esriLicenseFailure:
          statusInfo = string.Format(MessageExtensionFailed, extensionName);
          break;
        default:
          statusInfo = string.Format(MessageExtensionNotLicensed, extensionName);
          break;
      }

      return statusInfo;
    }
    #endregion

  }
}