Refactor ICANN reporting and billing into common package

This moves the default yearMonth logic into a common ReportingModule, rather than the coarse-scoped BackendModule, which may not want the default parameter extraction logic, as well as moving the 'yearMonth' parameter constant to the common package it's used in. This also provides a basis for future consolidation of the ReportingEmailUtils and BillingEmailUtils classes, which have modest overlap.

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=183130311

java/google/registry/reporting/billing/BillingModule.java

@@ -0,0 +1,86 @@
+// Copyright 2017 The Nomulus Authors. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package google.registry.reporting.billing;
+
+import static google.registry.request.RequestParameters.extractRequiredParameter;
+import static java.lang.annotation.RetentionPolicy.RUNTIME;
+
+import com.google.api.client.googleapis.extensions.appengine.auth.oauth2.AppIdentityCredential;
+import com.google.api.client.http.HttpTransport;
+import com.google.api.client.json.JsonFactory;
+import com.google.api.services.dataflow.Dataflow;
+import com.google.common.collect.ImmutableSet;
+import dagger.Module;
+import dagger.Provides;
+import google.registry.config.RegistryConfig.Config;
+import google.registry.request.Parameter;
+import java.lang.annotation.Documented;
+import java.lang.annotation.Retention;
+import java.util.Set;
+import java.util.function.Function;
+import javax.inject.Qualifier;
+import javax.servlet.http.HttpServletRequest;
+import org.joda.time.YearMonth;
+
+/** Module for dependencies required by monthly billing actions. */
+@Module
+public final class BillingModule {
+
+  public static final String DETAIL_REPORT_PREFIX = "invoice_details";
+  public static final String OVERALL_INVOICE_PREFIX = "CRR-INV";
+  public static final String INVOICES_DIRECTORY = "invoices";
+
+  static final String PARAM_JOB_ID = "jobId";
+  static final String BILLING_QUEUE = "billing";
+  static final String CRON_QUEUE = "retryable-cron-tasks";
+
+  private static final String CLOUD_PLATFORM_SCOPE =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  /** Provides the invoicing Dataflow jobId enqueued by {@link GenerateInvoicesAction}. */
+  @Provides
+  @Parameter(PARAM_JOB_ID)
+  static String provideJobId(HttpServletRequest req) {
+    return extractRequiredParameter(req, PARAM_JOB_ID);
+  }
+
+  @Provides
+  @InvoiceDirectoryPrefix
+  static String provideDirectoryPrefix(YearMonth yearMonth) {
+    return String.format("%s/%s/", INVOICES_DIRECTORY, yearMonth.toString());
+  }
+
+  /** Constructs a {@link Dataflow} API client with default settings. */
+  @Provides
+  static Dataflow provideDataflow(
+      @Config("projectId") String projectId,
+      HttpTransport transport,
+      JsonFactory jsonFactory,
+      Function<Set<String>, AppIdentityCredential> appIdentityCredentialFunc) {
+
+    return new Dataflow.Builder(
+            transport,
+            jsonFactory,
+            appIdentityCredentialFunc.apply(ImmutableSet.of(CLOUD_PLATFORM_SCOPE)))
+        .setApplicationName(String.format("%s billing", projectId))
+        .build();
+  }
+
+  /** Dagger qualifier for the subdirectory we stage to/upload from. */
+  @Qualifier
+  @Documented
+  @Retention(RUNTIME)
+  @interface InvoiceDirectoryPrefix{}
+}