/*
 * Copyright (c) Nov 9, 2018 StarChart Labs Authors.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *    romeara - initial API and implementation and/or initial documentation
 */
package org.starchartlabs.chronicler.machete;

import java.util.Collection;
import java.util.Objects;
import java.util.function.Function;
import java.util.stream.Collectors;

import javax.annotation.Nullable;

import com.amazonaws.services.lambda.runtime.events.SNSEvent;
import com.amazonaws.services.lambda.runtime.events.SNSEvent.SNS;
import com.amazonaws.services.lambda.runtime.events.SNSEvent.SNSRecord;

/**
 * Represents common utility operations related to AWS SNS event payloads
 *
 * @author romeara
 * @since 0.1.0
 */
public final class SnsEvents {

    /**
     * Prevent instantiation of utility class
     */
    private SnsEvents() throws InstantiationException {
        throw new InstantiationException("Cannot instantiate instance of utility class '" + getClass().getName() + "'");
    }

    /**
     * Extracts SNS message payload(s) from a received set of SNS messages
     *
     * @param snsEvent
     *            The SNS payload to read from
     * @param toEvent
     *            Function for converting string payload(s) to a meaningful Java representation
     * @param subject
     *            Message subject to filter matches to. May be null to prevent any subject-based filtering
     * @return A collection of converted message payload(s)
     * @since 0.1.0
     */
    public static <T> Collection<T> getMessages(SNSEvent snsEvent, Function<String, T> toEvent, @Nullable String subject) {
        Objects.requireNonNull(snsEvent);
        Objects.requireNonNull(toEvent);

        return snsEvent.getRecords().stream()
                .map(SNSRecord::getSNS)
                .filter(sns -> subject == null || Objects.equals(sns.getSubject(), subject))
                .map(SNS::getMessage)
                .map(toEvent)
                .collect(Collectors.toSet());
    }

}

@@ -1611,16 +1611,92 @@
 ltering%0A
+     * @param %3CT%3E%0A     *            Java representation of event to provide%0A
      * @

Fix missing parameter in Javadoc