io.streamthoughts.kafka.specs.change.ChangeResult Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jikkou Show documentation
A command-line tool to help you automate the management of the configurations that live on your Apache Kafka clusters.
There is a newer version: 0.30.0
/*
 * Copyright 2020 StreamThoughts.
 *
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements. See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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 io.streamthoughts.kafka.specs.change;

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonProperty;
import io.streamthoughts.kafka.specs.Description;
import io.streamthoughts.kafka.specs.internal.Time;

import java.io.PrintWriter;
import java.io.Serializable;
import java.io.StringWriter;
import java.util.List;
import java.util.stream.Collectors;

/**
 * This class is used to describe the result of a change operation that succeed of failed.
 *
 * @param  the change-type.
 */
public class ChangeResult> implements Serializable {

    public enum Status {CHANGED, OK, FAILED}

    private final boolean changed;
    private final long end;
    private final T resource;
    private final boolean failed;
    private final List errors;
    private final Status status;
    private transient final Description description;

    /**
     * Static method to build a new {@link ChangeResult} that doesn't result in cluster resource changes.
     *
     * @param resource    the operation result.
     * @param description the operation result description.
     * @param          the operation result-type.
     * @return a new {@link ChangeResult}.
     */
    public static > ChangeResult ok(final T resource,
                                                           final Description description) {
        return new ChangeResult<>(Status.OK, false, resource, description);
    }

    /**
     * Static method to build a new {@link ChangeResult} that do result in cluster resource changes.
     *
     * @param resource    the operation result.
     * @param description the operation result description.
     * @param          the operation result-type.
     * @return a new {@link ChangeResult}.
     */
    public static > ChangeResult changed(final T resource,
                                                                final Description description) {
        return new ChangeResult<>(Status.CHANGED, true, resource, description);
    }

    /**
     * Static method to build a new {@link ChangeResult}  that failed with the specified exception.
     *
     * @param resource    the operation result.
     * @param description the operation result description.
     * @param exceptions  the exceptions.
     * @param          the operation result-type.
     * @return a new {@link ChangeResult}.
     */
    public static > ChangeResult failed(final T resource,
                                                               final Description description,
                                                               final List exceptions) {
        return new ChangeResult<>(
                Status.FAILED,
                false,
                resource,
                description,
                true,
                exceptions.stream().map(ChangeResult::getStacktrace).collect(Collectors.toList())
        );
    }

    /**
     * Creates a new {@link ChangeResult} instance.
     */
    private ChangeResult(final Status status,
                         final boolean changed,
                         final T resource,
                         final Description description) {
        this(status, changed, resource, description, false, null);
    }

    /**
     * Creates a new {@link ChangeResult} instance.
     */
    private ChangeResult(final Status status,
                         final boolean changed,
                         final T resource,
                         final Description description,
                         final boolean failed,
                         final List errors) {
        this(status, changed, resource, description, failed, errors, Time.SYSTEM.milliseconds());
    }

    /**
     * Creates a new {@link ChangeResult} instance.
     */
    private ChangeResult(final Status status,
                         final boolean changed,
                         final T resource,
                         final Description description,
                         final boolean failed,
                         final List errors,
                         final long end) {
        this.status = status;
        this.changed = changed;
        this.resource = resource;
        this.end = end;
        this.failed = failed;
        this.errors = errors;
        this.description = description;
    }

    @JsonProperty
    public boolean isChanged() {
        return changed;
    }

    @JsonProperty
    public long getEnd() {
        return end;
    }

    @JsonProperty
    public T resource() {
        return resource;
    }

    @JsonProperty
    public boolean isFailed() {
        return failed;
    }

    @JsonProperty
    public List errors() {
        return errors;
    }

    @JsonProperty
    public Status status() {
        return this.status;
    }

    @JsonIgnore
    public Description description() {
        return this.description;
    }

    @Override
    public String toString() {
        return "ChangeResult{" +
                "changed=" + changed +
                ", end=" + end +
                ", resource=" + resource +
                ", failed=" + failed +
                ", errors=" + errors +
                ", status=" + status +
                ", description=" + description +
                '}';
    }

    /**
     * @return the stacktrace representation for the given {@link Throwable}.
     */
    static String getStacktrace(final Throwable throwable) {
        final StringWriter sw = new StringWriter();
        final PrintWriter pw = new PrintWriter(sw, true);
        throwable.printStackTrace(pw);
        return sw.getBuffer().toString();
    }
}