Create a Java entity to store ThreatMatch objects in SQL (#617)

* Squash everything together
Create SafeBrowsing_Threats table

Create LocalDateConverter and add indexes to SafeBrowsingThreats

Add indexes to SafeBrowsingThreats and make small style changes

Pass in DateTimeFormatter

Delete LocalDateConverterTest.java

Rebase

Make changes to ThreatType comments

Create LocalDateConverterTest

Add review changes

Add SafeBrowsingThreatTest

Rename repoId, refactor LocalDateConverterTest/SafeBrowsingThreatTest, add foreign keys

Change imports

Add foreign keys and rename version number

Add new generated db-schema file

Clean up null test cases

Add changes

Add foreign keys into SafeBrowsingThreatTeat and apply style checks

Add SafeBrowsingThreatTest into SqlIntegrationTestSuite and change golden file

Make small changes to SafeBrowsingThreatTest

Add tests for ForeignKeyViolations and remove setId in SafeBrowsingThreat

* Change V35 -> V36

* Add a foreign key test for a reference to Registrar

* Move some variables around

core/src/main/java/google/registry/model/reporting/SafeBrowsingThreat.java

@@ -0,0 +1,168 @@
+// Copyright 2020 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.model.reporting;
+
+import static google.registry.util.PreconditionsUtils.checkArgumentNotNull;
+
+import com.google.common.collect.ImmutableList;
+import google.registry.model.Buildable;
+import google.registry.model.ImmutableObject;
+import google.registry.schema.replay.DatastoreEntity;
+import google.registry.schema.replay.SqlEntity;
+import google.registry.util.DomainNameUtils;
+import javax.persistence.Column;
+import javax.persistence.Entity;
+import javax.persistence.EnumType;
+import javax.persistence.Enumerated;
+import javax.persistence.GeneratedValue;
+import javax.persistence.GenerationType;
+import javax.persistence.Id;
+import javax.persistence.Index;
+import javax.persistence.Table;
+import org.joda.time.LocalDate;
+
+@Entity
+@Table(
+    indexes = {
+      @Index(name = "safebrowsing_threat_registrar_id_idx", columnList = "registrarId"),
+      @Index(name = "safebrowsing_threat_tld_idx", columnList = "tld"),
+      @Index(name = "safebrowsing_threat_check_date_idx", columnList = "checkDate")
+    })
+public class SafeBrowsingThreat extends ImmutableObject implements Buildable, SqlEntity {
+
+  /** The type of threat detected. */
+  public enum ThreatType {
+    THREAT_TYPE_UNSPECIFIED,
+    MALWARE,
+    SOCIAL_ENGINEERING,
+    UNWANTED_SOFTWARE,
+    POTENTIALLY_HARMFUL_APPLICATION
+  }
+
+  /** An auto-generated identifier and unique primary key for this entity. */
+  @Id
+  @GeneratedValue(strategy = GenerationType.IDENTITY)
+  Long id;
+
+  /** The name of the offending domain */
+  @Column(nullable = false)
+  String domainName;
+
+  /** The type of threat detected. */
+  @Column(nullable = false)
+  @Enumerated(EnumType.STRING)
+  ThreatType threatType;
+
+  /** Primary key of the domain table and unique identifier for all EPP resources. */
+  @Column(nullable = false)
+  String domainRepoId;
+
+  /** ID of the registrar at the moment of the scan. Domains may change registrars over time */
+  @Column(nullable = false)
+  String registrarId;
+
+  /** Date on which the check was run, on which the domain was flagged as abusive. */
+  @Column(nullable = false)
+  LocalDate checkDate;
+
+  /** The domain's top-level domain. */
+  @Column(nullable = false)
+  String tld;
+
+  public Long getId() {
+    return id;
+  }
+
+  public String getDomainName() {
+    return domainName;
+  }
+
+  public ThreatType getThreatType() {
+    return threatType;
+  }
+
+  public String getDomainRepoId() {
+    return domainRepoId;
+  }
+
+  public String getRegistrarId() {
+    return registrarId;
+  }
+
+  public LocalDate getCheckDate() {
+    return checkDate;
+  }
+
+  public String getTld() {
+    return tld;
+  }
+
+  @Override
+  public ImmutableList<DatastoreEntity> toDatastoreEntities() {
+    return ImmutableList.of(); // not stored in Datastore
+  }
+
+  @Override
+  public Builder asBuilder() {
+    return new Builder(clone(this));
+  }
+
+  /** A builder for constructing {@link SafeBrowsingThreat}, since it is immutable. */
+  public static class Builder extends Buildable.Builder<SafeBrowsingThreat> {
+    public Builder() {}
+
+    private Builder(SafeBrowsingThreat instance) {
+      super(instance);
+    }
+
+    @Override
+    public SafeBrowsingThreat build() {
+      checkArgumentNotNull(getInstance().domainName, "Domain name cannot be null");
+      checkArgumentNotNull(getInstance().threatType, "Threat type cannot be null");
+      checkArgumentNotNull(getInstance().domainRepoId, "Repo ID cannot be null");
+      checkArgumentNotNull(getInstance().registrarId, "Registrar ID cannot be null");
+      checkArgumentNotNull(getInstance().checkDate, "Check date cannot be null");
+      checkArgumentNotNull(getInstance().tld, "TLD cannot be null");
+
+      return super.build();
+    }
+
+    public Builder setDomainName(String domainName) {
+      getInstance().domainName = domainName;
+      getInstance().tld = DomainNameUtils.getTldFromDomainName(domainName);
+      return this;
+    }
+
+    public Builder setThreatType(ThreatType threatType) {
+      getInstance().threatType = threatType;
+      return this;
+    }
+
+    public Builder setDomainRepoId(String domainRepoId) {
+      getInstance().domainRepoId = domainRepoId;
+      return this;
+    }
+
+    public Builder setRegistrarId(String registrarId) {
+      getInstance().registrarId = registrarId;
+      return this;
+    }
+
+    public Builder setCheckDate(LocalDate checkDate) {
+      getInstance().checkDate = checkDate;
+      return this;
+    }
+  }
+}

core/src/main/java/google/registry/persistence/converter/LocalDateConverter.java

@@ -0,0 +1,30 @@
+// Copyright 2020 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.persistence.converter;
+
+import javax.persistence.Converter;
+import org.joda.time.LocalDate;
+import org.joda.time.format.ISODateTimeFormat;
+
+/** JPA converter for {@link LocalDate}. */
+@Converter(autoApply = true)
+public class LocalDateConverter extends ToStringConverterBase<LocalDate> {
+
+  /** Converts the string (a date in ISO-8601 format) into a LocalDate. */
+  @Override
+  public LocalDate convertToEntityAttribute(String columnValue) {
+    return (columnValue == null) ? null : LocalDate.parse(columnValue, ISODateTimeFormat.date());
+  }
+}

core/src/main/resources/META-INF/persistence.xml

@@ -28,6 +28,7 @@
     <class>google.registry.model.host.HostResource</class>
     <class>google.registry.model.registrar.Registrar</class>
     <class>google.registry.model.registrar.RegistrarContact</class>
+    <class>google.registry.model.reporting.SafeBrowsingThreat</class>
     <class>google.registry.schema.domain.RegistryLock</class>
     <class>google.registry.schema.tmch.ClaimsList</class>
     <class>google.registry.schema.cursor.Cursor</class>
@@ -52,6 +53,7 @@
     <class>google.registry.persistence.converter.DateTimeConverter</class>
     <class>google.registry.persistence.converter.DurationConverter</class>
     <class>google.registry.persistence.converter.InetAddressSetConverter</class>
+    <class>google.registry.persistence.converter.LocalDateConverter</class>
     <class>google.registry.persistence.converter.PostalInfoChoiceListConverter</class>
     <class>google.registry.persistence.converter.RegistrarPocSetConverter</class>
     <class>google.registry.persistence.converter.StatusValueSetConverter</class>