Implement getAppManifests, getAppMarketplaceUrl and installApp operat…

src/main/java/microsoft/exchange/webservices/data/core/ExchangeService.java

@@ -23,21 +23,6 @@
 
 package microsoft.exchange.webservices.data.core;
 
-import java.net.URI;
-import java.net.URISyntaxException;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.Collection;
-import java.util.Date;
-import java.util.EnumSet;
-import java.util.Enumeration;
-import java.util.HashMap;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Locale;
-import java.util.Map;
-import java.util.TimeZone;
-
 import microsoft.exchange.webservices.data.autodiscover.AutodiscoverService;
 import microsoft.exchange.webservices.data.autodiscover.IAutodiscoverRedirectionUrl;
 import microsoft.exchange.webservices.data.autodiscover.enumeration.UserSettingName;
@@ -90,6 +75,8 @@
 import microsoft.exchange.webservices.data.core.request.FindConversationRequest;
 import microsoft.exchange.webservices.data.core.request.FindFolderRequest;
 import microsoft.exchange.webservices.data.core.request.FindItemRequest;
+import microsoft.exchange.webservices.data.core.request.GetAppManifestsRequest;
+import microsoft.exchange.webservices.data.core.request.GetAppMarketplaceUrlRequest;
 import microsoft.exchange.webservices.data.core.request.GetAttachmentRequest;
 import microsoft.exchange.webservices.data.core.request.GetDelegateRequest;
 import microsoft.exchange.webservices.data.core.request.GetEventsRequest;
@@ -106,6 +93,7 @@
 import microsoft.exchange.webservices.data.core.request.GetUserConfigurationRequest;
 import microsoft.exchange.webservices.data.core.request.GetUserOofSettingsRequest;
 import microsoft.exchange.webservices.data.core.request.HttpWebRequest;
+import microsoft.exchange.webservices.data.core.request.InstallAppRequest;
 import microsoft.exchange.webservices.data.core.request.MoveFolderRequest;
 import microsoft.exchange.webservices.data.core.request.MoveItemRequest;
 import microsoft.exchange.webservices.data.core.request.RemoveDelegateRequest;
@@ -136,6 +124,7 @@
 import microsoft.exchange.webservices.data.core.response.GetFolderResponse;
 import microsoft.exchange.webservices.data.core.response.GetItemResponse;
 import microsoft.exchange.webservices.data.core.response.GetServerTimeZonesResponse;
+import microsoft.exchange.webservices.data.core.response.InstallAppResponse;
 import microsoft.exchange.webservices.data.core.response.MoveCopyFolderResponse;
 import microsoft.exchange.webservices.data.core.response.MoveCopyItemResponse;
 import microsoft.exchange.webservices.data.core.response.ServiceResponse;
@@ -168,6 +157,7 @@
 import microsoft.exchange.webservices.data.notification.PushSubscription;
 import microsoft.exchange.webservices.data.notification.StreamingSubscription;
 import microsoft.exchange.webservices.data.property.complex.Attachment;
+import microsoft.exchange.webservices.data.property.complex.ClientApp;
 import microsoft.exchange.webservices.data.property.complex.ConversationId;
 import microsoft.exchange.webservices.data.property.complex.DelegateUser;
 import microsoft.exchange.webservices.data.property.complex.EmailAddress;
@@ -195,12 +185,25 @@
 import microsoft.exchange.webservices.data.sync.ChangeCollection;
 import microsoft.exchange.webservices.data.sync.FolderChange;
 import microsoft.exchange.webservices.data.sync.ItemChange;
-
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 import org.w3c.dom.Document;
 import org.w3c.dom.Node;
 
+import java.io.InputStream;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Date;
+import java.util.EnumSet;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
 /**
  * Represents a binding to the Exchange Web Services.
  */
@@ -3993,4 +3996,38 @@ public boolean autodiscoverRedirectionUrlValidationCallback(
 
   }
 
+  public List<InputStream> getAppManifests() throws Exception {
+    GetAppManifestsRequest request = new GetAppManifestsRequest(this);
+    return request.execute().getManifests();
+  }
+
+  public List<ClientApp> getAppManifests(String apiVersionSupported, String schemaVersionSupported) throws Exception {
+    GetAppManifestsRequest request = new GetAppManifestsRequest(this);
+    request.setSchemaVersionSupported(schemaVersionSupported);
+    request.setApiVersionSupported(apiVersionSupported);
+    return request.execute().getApps();
+  }
+
+  public String getAppMarketplaceUrl(String apiVersionSupported, String schemaVersionSupported) throws Exception {
+    GetAppMarketplaceUrlRequest request = new GetAppMarketplaceUrlRequest(this);
+    request.setApiVersionSupported(apiVersionSupported);
+    request.setSchemaVersionSupported(schemaVersionSupported);
+    return request.execute().getAppMarketplaceUrl();
+  }
+
+  public String getAppMarketplaceUrl() throws Exception {
+    return getAppMarketplaceUrl(null, null);
+  }
+
+  public void installApp(InputStream manifest) throws Exception {
+    EwsUtilities.validateParam(manifest, "manifestStream");
+    this.internalInstallApp(manifest, null, null, false);
+  }
+
+  private boolean internalInstallApp(InputStream manifestStream, String marketplaceAssetId, String marketplaceContentMarket, boolean sendWelcomeEmail) throws Exception {
+    EwsUtilities.validateParam(manifestStream, "manifestStream");
+    InstallAppRequest request = new InstallAppRequest(this, manifestStream, marketplaceAssetId, marketplaceContentMarket, false);
+    InstallAppResponse response = request.execute();
+    return response.isWasFirstInstall();
+  }
 }

src/main/java/microsoft/exchange/webservices/data/core/XmlElementNames.java

@@ -4785,4 +4785,104 @@ public class XmlElementNames {
   // by
   // UM
 
+  /**
+   * The Constant ActionUrl.
+   */
+  public static final String ActionUrl = "ActionUrl";
+
+  /**
+   * The Constant AppStatus.
+   */
+  public static final String AppStatus = "AppStatus";
+
+  /**
+   * The Constant EndNodeUrl.
+   */
+  public static final String EndNodeUrl = "EndNodeUrl";
+
+  /**
+   * The Constant GetAppManifestsRequest.
+   */
+  public static final String GetAppManifestsRequest = "GetAppManifests";
+
+  /**
+   * The Constant ApiVersionSupported.
+   */
+  public static final String ApiVersionSupported = "ApiVersionSupported";
+
+  /**
+   * The Constant SchemaVersionSupported.
+   */
+  public static final String SchemaVersionSupported = "SchemaVersionSupported";
+
+  /**
+   * The Constant Manifests.
+   */
+  public static final String Manifests = "Manifests";
+
+  /**
+   * The Constant Manifest.
+   */
+  public static final String Manifest = "Manifest";
+
+  /**
+   * The Constant Apps.
+   */
+  public static final String Apps = "Apps";
+
+  /**
+   * The Constant App.
+   */
+  public static final String App = "App";
+
+  /**
+   * The Constant GetAppManifestsResponse.
+   */
+  public static final String GetAppManifestsResponse = "GetAppManifestsResponse";
+
+  /**
+   * The Constant GetAppMarketplaceUrlRequest.
+   */
+  public static final String GetAppMarketplaceUrlRequest = "GetAppMarketplaceUrl";
+
+  /**
+   * The Constant GetAppMarketplaceUrlResponse.
+   */
+  public static final String GetAppMarketplaceUrlResponse = "GetAppMarketplaceUrlResponse";
+
+  /**
+   * The Constant AppMarketplaceUrl.
+   */
+  public static final String AppMarketplaceUrl= "AppMarketplaceUrl";
+
+  /**
+   * The Constant InstallAppRequest.
+   */
+  public static final String InstallAppRequest = "InstallApp";
+
+  /**
+   * The Constant MarketplaceAssetId.
+   */
+  public static final String MarketplaceAssetId = "MarketplaceAssetId";
+
+  /**
+   * The Constant MarketplaceContentMarket.
+   */
+  public static final String MarketplaceContentMarket = "MarketplaceContentMarket";
+
+  /**
+   * The Constant SendWelcomeEmail.
+   */
+  public static final String SendWelcomeEmail = "SendWelcomeEmail";
+
+  /**
+   * The Constant InstallAppResponse.
+   */
+  public static final String InstallAppResponse = "InstallAppResponse";
+
+  /**
+   * The Constant WasFirstInstall.
+   */
+  public static final String WasFirstInstall = "WasFirstInstall";
+
 }

src/main/java/microsoft/exchange/webservices/data/core/enumeration/misc/ExchangeVersion.java

@@ -50,4 +50,35 @@ public enum ExchangeVersion {
    * Exchange2010_SP2.
    */
   Exchange2010_SP2,
+
+  // Microsoft Exchange 2013
+  /**
+   * Exchange2013
+   */
+  Exchange2013,
+
+  // Microsoft Exchange 2013, Service Pack 1
+  /**
+   * Exchange2013_SP1
+   */
+  Exchange2013_SP1,
+
+  // Microsoft Exchange 2015 (aka Exchange 2016)
+  /**
+   * Exchange2013_SP1
+   */
+  Exchange2015,
+
+  // Microsoft Exchange 2016
+  /**
+   * Exchange2013_SP1
+   */
+  Exchange2016,
+
+  // Functionality starting 10/05/2015
+  /**
+   * V2015_10_05
+   */
+  V2015_10_05
+
 }