com.yahoo.vespa.hosted.controller.tenant.TenantContacts Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of controller-api Show documentation
There is a newer version: 8.253.3
// Copyright Vespa.ai. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.vespa.hosted.controller.tenant;

import java.util.Arrays;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.stream.Collectors;

/**
 * Tenant contacts are targets of the notification system.  Sometimes they
 * are a person with an email address, other times they are a Slack channel,
 * IRC plugin, etc.
 *
 * @author ogronnesby
 */
public class TenantContacts {
    private final List contacts;

    public TenantContacts(List contacts) {
        this.contacts = List.copyOf(contacts);
        for (int i = 0; i < contacts.size(); i++) {
            for (int j = 0; j < i; j++) {
                if (contacts.get(i).equals(contacts.get(j))) {
                    throw new IllegalArgumentException("Duplicate contact: " + contacts.get(i));
                }
            }
        }
    }

    public static TenantContacts empty() {
        return new TenantContacts(List.of());
    }

    public List all() {
        return contacts;
    }

    public  List ofType(Class type) {
        return contacts.stream()
                .filter(type::isInstance)
                .map(type::cast)
                .toList();
    }

    public boolean isEmpty() {
        return contacts.isEmpty();
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        TenantContacts that = (TenantContacts) o;
        return contacts.equals(that.contacts);
    }

    @Override
    public int hashCode() {
        return Objects.hash(contacts);
    }

    @Override
    public String toString() {
        return "TenantContacts{" +
                "contacts=" + contacts +
                '}';
    }

    public abstract static class Contact {
        private final List audiences;

        public Contact(List audiences) {
            this.audiences = List.copyOf(audiences);
            if (audiences.isEmpty()) throw new IllegalArgumentException("At least one notification activity must be enabled");
        }

        public List audiences() { return audiences; }

        public abstract Type type();

        public abstract boolean equals(Object o);
        public abstract int hashCode();
        public abstract String toString();
    }

    public static class EmailContact extends Contact {
        private final Email email;

        public EmailContact(List audiences, Email email) {
            super(audiences);
            this.email = email;
        }

        public Email email() { return email; }

        public EmailContact withEmail(Email email) {
            return new EmailContact(audiences(), email);
        }

        @Override
        public Type type() {
            return Type.EMAIL;
        }

        @Override
        public boolean equals(Object o) {
            if (this == o) return true;
            if (o == null || getClass() != o.getClass()) return false;
            EmailContact that = (EmailContact) o;
            return email.equals(that.email);
        }

        @Override
        public int hashCode() {
            return Objects.hash(email);
        }

        @Override
        public String toString() {
            return "email '" + email + '\'';
        }
    }

    public enum Type {
        EMAIL("email");

        private final String value;

        Type(String value) {
            this.value = value;
        }

        public String value() {
            return this.value;
        }

        public static Optional from(String value) {
            return Arrays.stream(Type.values()).filter(x -> x.value().equals(value)).findAny();
        }
    }

    public enum Audience {
        // tenant admin type updates about billing etc.
        TENANT("tenant"),

        // system notifications like deployment failures etc.
        NOTIFICATIONS("notifications");

        private final String value;

        Audience(String value) {
            this.value = value;
        }

        public String value() {
            return value;
        }

        public static Optional from(String value) {
            return Arrays.stream(Audience.values()).filter((x -> x.value().equals(value))).findAny();
        }
    }
}