com.sonymobile.tools.gerrit.gerritevents.dto.rest.ReviewInput Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gerrit-events Show documentation
Java client library for receiving stream-events from Gerrit code review. As well as performing queries and sending reviews.
The newest version!
/*
 *  The MIT License
 *
 *  Copyright 2013 Jyrki Puttonen. All rights reserved.
 *  Copyright 2013 Sony Mobile Communications AB. All rights reserved.
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a copy
 *  of this software and associated documentation files (the "Software"), to deal
 *  in the Software without restriction, including without limitation the rights
 *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 *  copies of the Software, and to permit persons to whom the Software is
 *  furnished to do so, subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in
 *  all copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 *  THE SOFTWARE.
 */
package com.sonymobile.tools.gerrit.gerritevents.dto.rest;

import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;

//CS IGNORE LineLength FOR NEXT 6 LINES. REASON: JavaDoc.
/**
 * What to send as input to the actual review.
 *
 * @see Gerrit Documentation: set-review
 * @see Gerrit Documentation: review-input
 */
public class ReviewInput {
    final String message;
    final Map labels = new HashMap();
    final Map> comments = new HashMap>();
    Notify notify;
    String tag;

    /**
     * Standard Constructor.
     *
     * @param message    message
     * @param labelName  label
     * @param labelValue value
     */
    public ReviewInput(String message, String labelName, int labelValue) {
        this(message, Collections.singleton(new ReviewLabel(labelName, labelValue)));
    }

    /**
     * Standard Constructor.
     *
     * @param message message
     * @param labels  labels
     */
    public ReviewInput(String message, ReviewLabel... labels) {
        this(message, Arrays.asList(labels));
    }

    /**
     * Standard Constructor.
     *
     * @param message message
     * @param labels  labels
     */
    public ReviewInput(String message, Collection labels) {
        this(message, labels, Collections.emptyList());
    }

    /**
     * Standard Constructor.
     *
     * @param message        message
     * @param commentedFiles file comments
     * @param labels         label
     */
    public ReviewInput(String message, Collection commentedFiles, ReviewLabel... labels) {
        this(message, Arrays.asList(labels), commentedFiles);
    }

    /**
     * Standard Constructor.
     *
     * @param message        message
     * @param labels         labels
     * @param commentedFiles file comments
     */
    public ReviewInput(String message, Collection labels, Collection commentedFiles) {
        this.message = message;
        for (ReviewLabel label : labels) {
            this.labels.put(label.getName(), label.getValue());
        }
        for (CommentedFile file : commentedFiles) {
            if (!comments.containsKey(file.getFileName())) {
                comments.put(file.getFileName(), new HashSet());
            }
            comments.get(file.getFileName()).addAll(file.getLineComments());
        }
    }

    /**
     * Sets the 'notify' value.  Defines to whom email notifications should be sent after the review is stored.
     *
     * @param value the value to set.
     * @return this instance for convenience
     */
    public ReviewInput setNotify(Notify value) {
        this.notify = value;
        return this;
    }

    /**
     * Sets the 'tag' value.  Defines an optional tag to the review. This enables filtering out automatic comments.
     *
     * @param value the value to set.
     * @return this instance for convenience
     */
    public ReviewInput setTag(String value) {
        this.tag = value;
        return this;
    }
}