/* * Copyright (C) 2017 The Android Open Source Project * * 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 android.car.vms; import android.annotation.NonNull; import android.annotation.SystemApi; import android.os.Parcel; import android.os.Parcelable; import java.util.ArrayList; import java.util.Collections; import java.util.HashSet; import java.util.List; import java.util.Objects; import java.util.Set; /** * Subscription state of Vehicle Map Service layers. * * The subscription state is used by publishers to determine which layers to publish data for, as * any data published to a layer without subscribers will be dropped by the Vehicle Map Service. * * Sequence numbers are used to indicate the succession of subscription states, and increase * monotonically with each change in subscriptions. They must be used by clients to ignore states * that are received out-of-order. * * @hide */ @SystemApi public final class VmsSubscriptionState implements Parcelable { private final int mSequenceNumber; private final Set mLayers; private final Set mSubscribedLayersFromPublishers; /** * Constructs a summary of the state of the current subscriptions for publishers to consume * and adjust which layers that the are publishing. */ public VmsSubscriptionState(int sequenceNumber, @NonNull Set subscribedLayers, @NonNull Set layersFromPublishers) { mSequenceNumber = sequenceNumber; mLayers = Collections.unmodifiableSet(subscribedLayers); mSubscribedLayersFromPublishers = Collections.unmodifiableSet(layersFromPublishers); } /** * @return sequence number of the subscription state */ public int getSequenceNumber() { return mSequenceNumber; } /** * @return set of layers with subscriptions to all publishers */ @NonNull public Set getLayers() { return mLayers; } /** * @return set of layers with subscriptions to a subset of publishers */ @NonNull public Set getAssociatedLayers() { return mSubscribedLayersFromPublishers; } @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("sequence number=").append(mSequenceNumber); sb.append("; layers={"); for (VmsLayer layer : mLayers) { sb.append(layer).append(","); } sb.append("}"); sb.append("; associatedLayers={"); for (VmsAssociatedLayer layer : mSubscribedLayersFromPublishers) { sb.append(layer).append(","); } sb.append("}"); return sb.toString(); } public static final Parcelable.Creator CREATOR = new Parcelable.Creator() { public VmsSubscriptionState createFromParcel(Parcel in) { return new VmsSubscriptionState(in); } public VmsSubscriptionState[] newArray(int size) { return new VmsSubscriptionState[size]; } }; @Override public void writeToParcel(Parcel out, int flags) { out.writeInt(mSequenceNumber); out.writeParcelableList(new ArrayList(mLayers), flags); out.writeParcelableList(new ArrayList(mSubscribedLayersFromPublishers), flags); } @Override public boolean equals(Object o) { if (!(o instanceof VmsSubscriptionState)) { return false; } VmsSubscriptionState p = (VmsSubscriptionState) o; return Objects.equals(p.mSequenceNumber, mSequenceNumber) && p.mLayers.equals(mLayers) && p.mSubscribedLayersFromPublishers.equals(mSubscribedLayersFromPublishers); } @Override public int hashCode() { return Objects.hash(mSequenceNumber, mLayers, mSubscribedLayersFromPublishers); } @Override public int describeContents() { return 0; } private VmsSubscriptionState(Parcel in) { mSequenceNumber = in.readInt(); List layers = new ArrayList<>(); in.readParcelableList(layers, VmsLayer.class.getClassLoader()); mLayers = Collections.unmodifiableSet(new HashSet(layers)); List associatedLayers = new ArrayList<>(); in.readParcelableList(associatedLayers, VmsAssociatedLayer.class.getClassLoader()); mSubscribedLayersFromPublishers = Collections.unmodifiableSet(new HashSet(associatedLayers)); } }