java - adding descriptions for athena and cloudwatch examples and add…

…ing file names to the description for the rest

java/example_code/athena/src/main/java/aws/example/athena/AthenaClientFactory.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[AthenaClientFactory.java demonstrates how to create and configure an Amazon Athena client]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.ClientConfiguration;

java/example_code/athena/src/main/java/aws/example/athena/CreateNamedQueryExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[CreateNamedQueryExample.java demonstrates how to create a named query]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;

java/example_code/athena/src/main/java/aws/example/athena/DeleteNamedQueryExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DeleteNamedQueryExample.java demonstrates how to delete a named query by using the named query ID.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;

java/example_code/athena/src/main/java/aws/example/athena/ExampleConstants.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[ExampleConstants.java demonstrates how to query a table created by the getting started tutorial in Athena]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 public class ExampleConstants {

java/example_code/athena/src/main/java/aws/example/athena/ListNamedQueryExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[ListNamedQueryExample.java demonstrates how to obtain a list of named query IDs.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;
@@ -41,7 +38,7 @@ public static void main(String[] args) throws Exception
         while (hasMoreResults) {
             List<String> namedQueryIds = listNamedQueriesResult.getNamedQueryIds();
             // process named query IDs
-            
+
             // If nextToken is not null,  there are more results. Get the next page of results.
             if (listNamedQueriesResult.getNextToken() != null) {
                 listNamedQueriesResult = athenaClient.listNamedQueries(

java/example_code/athena/src/main/java/aws/example/athena/ListQueryExecutionsExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[ListQueryExecutionsExample.java demonstrates how to obtain a list of query execution IDs.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;
@@ -40,7 +37,7 @@ public static void main(String[] args) throws Exception
       while (hasMoreResults) {
           List<String> queryExecutionIds = listQueryExecutionsResult.getQueryExecutionIds();
           // process queryExecutionIds.
-          
+
           System.out.println(queryExecutionIds);
 
           //If nextToken is not null, then there are more results. Get the next page of results.

java/example_code/athena/src/main/java/aws/example/athena/StartQueryExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[StartQueryExample.java demonstrates how to submit a query to Athena for execution, wait till results are available, and then process the results.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;
@@ -170,4 +167,4 @@ private static void processRow(Row row, List<ColumnInfo> columnInfoList)
           }
       }
   }
-}
+}

java/example_code/athena/src/main/java/aws/example/athena/StopQueryExecutionExample.java

@@ -1,13 +1,10 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[StopQueryExecutionExample.java demonstrates how to stop a query and check its status.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-service:[athena]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 package aws.example.athena;
 
 import com.amazonaws.services.athena.AmazonAthena;

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/DeleteAlarm.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DeleteAlarm.java demonstrates how to delete a CloudWatch alarm.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -57,4 +54,3 @@ public static void main(String[] args) {
         System.out.printf("Successfully deleted alarm %s", alarm_name);
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/DeleteSubscriptionFilter.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DeleteSubscriptionFilter.java demonstrates how to delete a CloudWatch subscription filter.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -62,4 +59,3 @@ public static void main(String[] args) {
             filter);
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/DescribeAlarms.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DescribeAlarms.java demonstrates how to list all CloudWatch alarms.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -59,4 +56,3 @@ public static void main(String[] args) {
         }
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/DescribeSubscriptionFilters.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DescribeSubscriptionFilters.java demonstrates how to list CloudWatch subscription filters associated with a log group.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -55,7 +52,7 @@ public static void main(String[] args) {
                 new DescribeSubscriptionFiltersRequest()
                     .withLogGroupName(log_group)
                     .withLimit(1);
-        
+
         while(!done) {
 
             DescribeSubscriptionFiltersResult response =
@@ -79,4 +76,3 @@ public static void main(String[] args) {
         }
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/DisableAlarmActions.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[DisableAlarmActions.java demonstrates how to disables actions on a CloudWatch alarm.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/EnableAlarmActions.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[EnableAlarmActions.java demonstrates how to enables actions on a CloudWatch alarm.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -59,4 +56,3 @@ public static void main(String[] args) {
             "Successfully enabled actions on alarm %s", alarm);
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/ListMetrics.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[ListMetrics.java demonstrates how to list CloudWatch metrics.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -55,7 +52,7 @@ public static void main(String[] args) {
         ListMetricsRequest request = new ListMetricsRequest()
                 .withMetricName(name)
                 .withNamespace(namespace);
-        
+
         boolean done = false;
 
         while(!done) {
@@ -74,4 +71,3 @@ public static void main(String[] args) {
         }
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/PutEvents.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[PutEvents.java demonstrates how to put a sample CloudWatch event.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -68,4 +65,3 @@ public static void main(String[] args)
         System.out.println("Successfully put CloudWatch event");
     }
 }
-

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/PutMetricAlarm.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[PutMetricAlarm.java demonstrates how to create a new CloudWatch alarm based on CPU utilization for an instance.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/PutMetricData.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[PutMetricData.java demonstrates how to put a sample metric data point.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/PutRule.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[PutRule.java demonstrates how to create a CloudWatch event-routing rule.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *

java/example_code/cloudwatch/src/main/java/aws/example/cloudwatch/PutSubscriptionFilter.java

@@ -1,14 +1,11 @@
-
-//snippet-sourcedescription:[<<FILENAME>> demonstrates how to ...]
+//snippet-sourcedescription:[PutSubscriptionFilter.java demonstrates how to create a CloudWatch Logs subscription filter.]
 //snippet-keyword:[Java]
 //snippet-keyword:[Code Sample]
 //snippet-keyword:[Amazon Cloudwatch]
 //snippet-service:[cloudwatch]
 //snippet-sourcetype:[full-example]
 //snippet-sourcedate:[]
 //snippet-sourceauthor:[AWS]
-
-
 /*
  * Copyright 2010-2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
@@ -73,4 +70,3 @@ public static void main(String[] args) {
             filter);
     }
 }
-