apps/mcast/api/src/main/java/org/onosproject/mcast/api/McastRouteData.java

/*
 * Copyright 2018-present Open Networking Foundation
 *
 * 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 org.onosproject.mcast.api;

import com.google.common.annotations.Beta;
import com.google.common.collect.ImmutableMap;
import com.google.common.collect.ImmutableSet;
import org.onosproject.net.ConnectPoint;
import org.onosproject.net.HostId;

import java.util.Collection;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import java.util.stream.Collectors;

import static com.google.common.base.MoreObjects.toStringHelper;
import static com.google.common.base.Preconditions.checkArgument;
import static com.google.common.base.Preconditions.checkNotNull;

/**
 * Data regarding a multicast route, comprised of a type, multiple sources and multiple sinks.
 */
@Beta
public final class McastRouteData {

    private final ConcurrentHashMap<ConnectPoint, Boolean> sources = new ConcurrentHashMap<>();
    private final ConcurrentHashMap<HostId, Set<ConnectPoint>> sinks = new ConcurrentHashMap<>();

    private McastRouteData() {
    }

    /**
     * Sources contained in the associated route.
     *
     * @return set of sources
     */
    public Set<ConnectPoint> sources() {
        return ImmutableSet.copyOf(sources.keySet());
    }

    /**
     * Sources contained in the associated route.
     *
     * @return map of hostIds and associated sinks
     */
    public Map<HostId, Set<ConnectPoint>> sinks() {
        return ImmutableMap.copyOf(sinks);
    }

    /**
     * Sources contained in the associated route.
     *
     * @return map of hostIds and associated sinks
     */
    public Set<ConnectPoint> allSinks() {
        return sinks.values().stream().flatMap(Collection::stream).collect(Collectors.toSet());
    }

    /**
     * Sinks contained in the associated route for the given host.
     *
     * @param hostId the host
     * @return set of sinks
     */
    public Set<ConnectPoint> sinks(HostId hostId) {
        return sinks.get(hostId);
    }

    /**
     * Sinks contained in the associated route that are not bound to any host.
     *
     * @return set of sinks
     */
    public Set<ConnectPoint> nonHostSinks() {
        return sinks.get(HostId.NONE);
    }

    /**
     * Add the sources for the associated route.
     *
     * @param sources set of sources
     */
    public void addSources(Set<ConnectPoint> sources) {
        checkArgument(!sources.contains(null));
        sources.forEach(source -> {
            this.sources.put(source, true);
        });
    }

    /**
     * Removes all the sources contained in the associated route.
     */
    public void removeSources() {
        sources.clear();
    }

    /**
     * Removes the given sources contained in the associated route.
     *
     * @param sources the sources to remove
     */
    public void removeSources(Set<ConnectPoint> sources) {
        checkArgument(!sources.contains(null));
        sources.forEach(this.sources::remove);
    }

    /**
     * Adds sinks for a given host Id. If the Host Id is {@link HostId#NONE} the sinks are intended to be
     * used at all times independently of the attached host.
     *
     * @param hostId the host
     * @param sinks  the sinks
     */
    public void addSinks(HostId hostId, Set<ConnectPoint> sinks) {
        checkNotNull(hostId);
        checkArgument(!sinks.contains(null));
        this.sinks.put(hostId, sinks);
    }

    /**
     * Adds sink for this route that are not associated directly with a given host.
     *
     * @param sinks the sinks
     */
    public void addNonHostSinks(Set<ConnectPoint> sinks) {
        checkArgument(!sinks.contains(null));
        this.sinks.put(HostId.NONE, sinks);
    }

    /**
     * Removes all the sinks for this route.
     */
    public void removeSinks() {
        sinks.clear();
    }

    /**
     * Removes all the sinks for the given host for this route.
     *
     * @param hostId the host
     */
    public void removeSinks(HostId hostId) {
        checkNotNull(hostId);
        this.sinks.remove(hostId);
    }

    /**
     * Removes all the given sinks for the given host for this route.
     *
     * @param hostId the host
     * @param sinks  the sinks to remove
     */
    public void removeSinks(HostId hostId, Set<ConnectPoint> sinks) {
        checkNotNull(hostId);
        checkArgument(!sinks.contains(null));
        this.sinks.get(hostId).removeAll(sinks);
    }

    /**
     * Returns if the route has no sinks.
     *
     * @return true if no sinks
     */
    public boolean isEmpty() {
        return sinks.isEmpty();
    }

    /**
     * Creates an empty route object.
     *
     * @return an empty muticast rout data object.
     */
    public static McastRouteData empty() {
        return new McastRouteData();
    }

    @Override
    public int hashCode() {
        return Objects.hash(super.hashCode(), sources, sinks);
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj) {
            return true;
        }
        if (!(obj instanceof McastRouteData)) {
            return false;
        }
        final McastRouteData other = (McastRouteData) obj;

        return super.equals(obj) &&
                Objects.equals(sources(), other.sources()) &&
                Objects.equals(sinks(), other.sinks());
    }

    @Override
    public String toString() {
        return toStringHelper(this)
                .add("sources", sources())
                .add("sinks", sinks())
                .toString();
    }
}