software.amazon.smithy.mqtt.traits.validators.MqttTopicConflictValidator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of smithy-mqtt-traits Show documentation
This module provides the implementation of MQTT binding traits for Smithy.
There is a newer version: 1.53.0
/*
 * Copyright 2019 Amazon.com, Inc. or its affiliates. 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.
 * A copy of the License is located at
 *
 *  http://aws.amazon.com/apache2.0
 *
 * or in the "license" file accompanying this file. This file 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 software.amazon.smithy.mqtt.traits.validators;

import java.util.List;
import java.util.stream.Collectors;
import software.amazon.smithy.model.Model;
import software.amazon.smithy.model.shapes.Shape;
import software.amazon.smithy.model.traits.Trait;
import software.amazon.smithy.model.validation.AbstractValidator;
import software.amazon.smithy.model.validation.ValidationEvent;
import software.amazon.smithy.mqtt.traits.ResolvedTopicIndex;
import software.amazon.smithy.mqtt.traits.TopicBinding;
import software.amazon.smithy.utils.Pair;
import software.amazon.smithy.utils.SmithyInternalApi;

/**
 * Validates that no two MQTT topics conflict.
 *
 * MQTT topics are allowed to conflict if both topics target the
 * same shape.
 */
@SmithyInternalApi
public final class MqttTopicConflictValidator extends AbstractValidator {
    @Override
    public List validate(Model model) {
        ResolvedTopicIndex bindingIndex = ResolvedTopicIndex.of(model);

        // Find conflicting topic bindings for each resolved topic.
        return bindingIndex.topicBindings()
                .map(binding -> Pair.of(binding, bindingIndex.topicBindings()
                        .filter(other -> other.conflictsWith(binding))
                        .collect(Collectors.toList())))
                // Only care when multiple entries are present.
                .filter(conflictingPair -> !conflictingPair.getRight().isEmpty())
                .map(conflictingPair -> invalidBindings(conflictingPair.getLeft(), conflictingPair.getRight()))
                .collect(Collectors.toList());
    }

    private ValidationEvent invalidBindings(
            TopicBinding binding,
            List> conflicts
    ) {
        String payloadShape = binding.getPayloadShape()
                .map(shape -> shape.getId().toString())
                .orElse("N/A");
        String conflictingStrings = conflicts.stream()
                .filter(b -> !b.equals(binding))
                .map(this::createConflictingBindingDescriptor)
                .sorted()
                .collect(Collectors.joining(", "));
        String message = String.format(
                "This shape resolves to an MQTT topic `%s` as part of the `%s` operation, and its payload of "
                + "`%s` conflicts with other topic payloads: [%s]",
                binding.getTopic(),
                binding.getOperation().getId(),
                payloadShape,
                conflictingStrings);
        return error(binding.getOperation(), binding.getMqttTrait(), message);
    }

    private String createConflictingBindingDescriptor(TopicBinding binding) {
        return String.format(
                "`%s` trait payload %s of `%s`",
                Trait.getIdiomaticTraitName(binding.getMqttTrait().toShapeId()),
                binding.getPayloadShape().map(Shape::getId).map(id -> "`" + id + "`").orElse("N/A"),
                binding.getOperation().getId());
    }
}