Merge pull request #1074 from alvadb/master

Adding api annotations
Azure · Sep 14, 2016 · 7c42fa2 · 7c42fa2
2 parents da190f8 + 68cdbb8
commit 7c42fa2
Show file tree

Hide file tree

Showing 107 changed files with 462 additions and 4 deletions.
diff --git a/azure-mgmt-compute/pom.xml b/azure-mgmt-compute/pom.xml
@@ -77,6 +77,11 @@
       <version>1.0.0-SNAPSHOT</version>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>com.microsoft.azure</groupId>
+      <artifactId>api-annotations</artifactId>
+      <version>0.0.1-SNAPSHOT</version>
+    </dependency>
   </dependencies>
   <build>
     <plugins>
@@ -119,6 +124,25 @@
 <br />*/</code>]]></bottom>
         </configuration>
       </plugin>
+
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.0</version>
+        <configuration>
+          <annotationProcessors>
+            <annotationProcessor>
+              com.microsoft.azure.management.apigeneration.LangDefinitionProcessor</annotationProcessor>
+          </annotationProcessors>
+          <debug>true</debug>
+          <optimize>true</optimize>
+          <compilerArguments>
+            <AaddGeneratedAnnotation>true</AaddGeneratedAnnotation>
+            <Adebug>true</Adebug>
+          </compilerArguments>
+        </configuration>
+      </plugin>
+
     </plugins>
   </build>
 </project>
diff --git a/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/AvailabilitySet.java b/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/AvailabilitySet.java
@@ -5,6 +5,7 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.compute.implementation.AvailabilitySetInner;
 import com.microsoft.azure.management.resources.fluentcore.arm.models.GroupableResource;
 import com.microsoft.azure.management.resources.fluentcore.arm.models.Resource;
@@ -19,6 +20,7 @@
 /**
  * An immutable client-side representation of an Azure availability set.
  */
+@LangDefinition(ContainerName = "~/")
 public interface AvailabilitySet extends
         GroupableResource,
         Refreshable<AvailabilitySet>,
@@ -67,6 +69,7 @@ public interface AvailabilitySet extends
     /**
      * Container interface for all the definitions.
      */
+    @LangDefinition(ContainerName = "~/AvailabilitySet.Definition")
     interface Definition extends
         DefinitionStages.Blank,
         DefinitionStages.WithGroup,
@@ -76,6 +79,7 @@ interface Definition extends
     /**
      * Grouping of availability set definition stages.
      */
+    @LangDefinition(ContainerName = "~/AvailabilitySet.Definition", ContainerFileName = "IDefinition", IsContainerOnly = true)
     interface DefinitionStages {
         /**
          * The first stage of an availability set definition.
@@ -132,6 +136,7 @@ interface WithCreate extends
      * <p>
      * Call {@link Update#apply()} to apply the changes to the resource in Azure.
      */
+    @LangDefinition(ContainerName = "~/AvailabilitySet.Update")
     interface Update extends
         Appliable<AvailabilitySet>,
         Resource.UpdateWithTags<Update> {

diff --git a/...e-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/AvailabilitySets.java b/...e-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/AvailabilitySets.java
@@ -1,5 +1,6 @@
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsDeletingByGroup;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsGettingByGroup;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsGettingById;
@@ -12,6 +13,7 @@
 /**
  * Entry point to availability set management API.
  */
+@LangDefinition(ContainerName = "~/")
 public interface AvailabilitySets extends
         SupportsListingByGroup<AvailabilitySet>,
         SupportsGettingByGroup<AvailabilitySet>,

diff --git a/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachine.java b/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachine.java
@@ -3,6 +3,7 @@
 import com.microsoft.azure.CloudException;
 import com.microsoft.azure.PagedList;
 import com.microsoft.azure.management.compute.implementation.VirtualMachineInner;
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.network.Network;
 import com.microsoft.azure.management.network.NetworkInterface;
 import com.microsoft.azure.management.network.PublicIpAddress;
@@ -23,6 +24,7 @@
 /**
  * An immutable client-side representation of an Azure virtual machine.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachine extends
         GroupableResource,
         Refreshable<VirtualMachine>,
@@ -256,6 +258,7 @@ public interface VirtualMachine extends
     /**
      * The entirety of the virtual machine definition.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachine.Definition")
     interface Definition extends
             DefinitionStages.Blank,
             DefinitionStages.WithGroup,
@@ -275,6 +278,7 @@ interface Definition extends
     /**
      * Grouping of virtual machine definition stages.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachine.Definition", ContainerFileName = "IDefinition", IsContainerOnly = true)
     interface DefinitionStages {
         /**
          * The first stage of a virtual machine definition.
@@ -847,6 +851,7 @@ interface WithCreate extends
     /**
      * Grouping of virtual machine update stages.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachine.Update", ContainerFileName = "IUpdate", IsContainerOnly = true)
     interface UpdateStages {
         /**
          * The stage of the virtual machine definition allowing to specify data disk configuration.
@@ -989,6 +994,7 @@ interface WithExtension {
      * <p>
      * Call {@link Update#apply()} to apply the changes to the resource in Azure.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachine.Update")
     interface Update extends
             Appliable<VirtualMachine>,
             Resource.UpdateWithTags<Update>,

diff --git a/...-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineDataDisk.java b/...-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineDataDisk.java
@@ -1,5 +1,6 @@
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.models.ChildResource;
 import com.microsoft.azure.management.resources.fluentcore.model.Attachable;
 import com.microsoft.azure.management.resources.fluentcore.model.Settable;
@@ -8,6 +9,7 @@
 /**
  * A data disk of a virtual machine.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineDataDisk extends
         Wrapper<DataDisk>,
         ChildResource {
@@ -66,6 +68,7 @@ public interface VirtualMachineDataDisk extends
     /**
      * Grouping of data disk definition stages applicable as part of a virtual machine creation.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Definition", ContainerFileName = "IDefinition", IsContainerOnly = true)
     interface DefinitionStages {
         /**
          * The first stage of a  data disk definition.
@@ -162,6 +165,7 @@ interface WithAttach<ParentT> extends Attachable.InUpdate<ParentT> {
      * The entirety of a data disk definition.
      * @param <ParentT> the return type of the final {@link Attachable#attach()}
      */
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Definition")
     interface Definition<ParentT> extends
             DefinitionStages.Blank<ParentT>,
             DefinitionStages.WithAttach<ParentT>,
@@ -171,6 +175,7 @@ interface Definition<ParentT> extends
     /**
      * Grouping of data disk definition stages applicable as part of a virtual machine update.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Update", ContainerFileName = "IUpdateDefinition", IsContainerOnly = true)
     interface UpdateDefinitionStages {
         /**
          * The first stage of a  data disk definition.
@@ -266,7 +271,8 @@ interface WithAttach<ParentT> extends Attachable.InDefinition<ParentT> {
     /** The entirety of a data disk definition as part of a virtual machine update.
      * @param <ParentT> the return type of the final {@link UpdateDefinitionStages.WithAttach#attach()}
      */
-    interface UpdateDefinition<ParentT>  extends
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Update", ContainerFileName = "IUpdateDefinition")
+       interface UpdateDefinition<ParentT>  extends
             UpdateDefinitionStages.Blank<ParentT>,
             UpdateDefinitionStages.WithAttach<ParentT>,
             UpdateDefinitionStages.WithStoreAt<ParentT> {
@@ -275,6 +281,7 @@ interface UpdateDefinition<ParentT>  extends
     /**
      * Grouping of data disk update stages.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Update", ContainerFileName = "IUpdate")
     interface UpdateStages {
         /**
          * Specifies the new size in GB for data disk.
@@ -304,6 +311,7 @@ interface UpdateStages {
     /**
      * The entirety of a data disk update as part of a virtual machine update.
      */
+    @LangDefinition(ContainerName = "~/VirtualMachineDataDisk.Update")
     interface Update extends
             UpdateStages,
             Settable<VirtualMachine.Update> {

diff --git a/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImage.java b/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImage.java
@@ -5,6 +5,7 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.compute.implementation.VirtualMachineImageInner;
 import com.microsoft.azure.management.resources.fluentcore.arm.Region;
 import com.microsoft.azure.management.resources.fluentcore.model.Wrapper;
@@ -14,6 +15,7 @@
 /**
  * An immutable client-side representation of an Azure virtual machine image.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineImage extends
         Wrapper<VirtualMachineImageInner> {
     /**

diff --git a/...mt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImages.java b/...mt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImages.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListingByRegion;
 
 /**
  *  Entry point to virtual machine image management API.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineImages extends
         SupportsListingByRegion<VirtualMachineImage> {
     /**

diff --git a/...mpute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImagesInSku.java b/...mpute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineImagesInSku.java
@@ -1,8 +1,10 @@
 package com.microsoft.azure.management.compute;
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListing;
 
 /**
  * Entry point to virtual machine sku images.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineImagesInSku extends SupportsListing<VirtualMachineImage> {
 }
diff --git a/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineOffer.java b/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineOffer.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.Region;
 
 /**
  * Represents a virtual machine image offer.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineOffer {
     /**
      * @return the region where this virtual machine image offer is available

diff --git a/...mt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineOffers.java b/...mt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineOffers.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListing;
 
 /**
  * Entry point to virtual machine image offers.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineOffers extends SupportsListing<VirtualMachineOffer> {
 }
 
diff --git a/...compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachinePublisher.java b/...compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachinePublisher.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.Region;
 
 /**
  * Represents a virtual machine image publisher.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachinePublisher {
     /**
      * @return the region where virtual machine images from this publisher is available

diff --git a/...ompute/src/main/java/com/microsoft/azure/management/compute/VirtualMachinePublishers.java b/...ompute/src/main/java/com/microsoft/azure/management/compute/VirtualMachinePublishers.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListingByRegion;
 
 /**
  * Entry point to virtual machine image publishers.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachinePublishers extends SupportsListingByRegion<VirtualMachinePublisher> {
 }
 
diff --git a/...mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSize.java b/...mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSize.java
@@ -5,9 +5,12 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
+
 /**
  * A type representing virtual machine size available for a subscription in a region.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineSize {
     /**
      * @return the VM size name

diff --git a/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSizes.java b/...gmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSizes.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListingByRegion;
 
 /**
  *  Entry point to virtual machine sizes API.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineSizes extends
         SupportsListingByRegion<VirtualMachineSize> {
 }
diff --git a/...-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSku.java b/...-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSku.java
@@ -5,11 +5,13 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.Region;
 
 /**
  * Represents a virtual machine image SKU.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineSku {
     /**
      * @return the region where this virtual machine image offer SKU is available

diff --git a/...mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSkus.java b/...mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachineSkus.java
@@ -5,10 +5,12 @@
  */
 package com.microsoft.azure.management.compute;
 
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.collection.SupportsListing;
 
 /**
  * Entry point to virtual machine image offer skus.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachineSkus extends SupportsListing<VirtualMachineSku> {
 }
diff --git a/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachines.java b/azure-mgmt-compute/src/main/java/com/microsoft/azure/management/compute/VirtualMachines.java
@@ -1,6 +1,7 @@
 package com.microsoft.azure.management.compute;
 
 import com.microsoft.azure.CloudException;
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsDeletingByGroup;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsGettingByGroup;
 import com.microsoft.azure.management.resources.fluentcore.arm.collection.SupportsGettingById;
@@ -15,6 +16,7 @@
 /**
  *  Entry point to virtual machine management API.
  */
+@LangDefinition(ContainerName = "~/")
 public interface VirtualMachines extends
         SupportsListing<VirtualMachine>,
         SupportsListingByGroup<VirtualMachine>,

diff --git a/.../main/java/com/microsoft/azure/management/compute/implementation/AvailabilitySetImpl.java b/.../main/java/com/microsoft/azure/management/compute/implementation/AvailabilitySetImpl.java
@@ -6,6 +6,7 @@
 package com.microsoft.azure.management.compute.implementation;
 
 import com.microsoft.azure.SubResource;
+import com.microsoft.azure.management.apigeneration.LangDefinition;
 import com.microsoft.azure.management.compute.AvailabilitySet;
 import com.microsoft.azure.management.compute.InstanceViewStatus;
 import com.microsoft.azure.management.resources.fluentcore.arm.models.implementation.GroupableResourceImpl;
@@ -19,6 +20,7 @@
 /**
  * The implementation for {@link AvailabilitySet} and its create and update interfaces.
  */
+@LangDefinition
 class AvailabilitySetImpl
     extends
         GroupableResourceImpl<