/*
 **********************************************************************
 * Copyright (c) 2018 Contributors to the Eclipse Foundation
 *               2018 Red Hat, Inc. and/or its affiliates
 *               and other contributors as indicated by the @author tags.
 *
 * See the NOTICES file(s) distributed with this work for additional
 * information regarding copyright ownership.
 *
 * 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.
 *
 * SPDX-License-Identifier: Apache-2.0
 **********************************************************************/
package org.eclipse.microprofile.metrics;

import java.util.Objects;

/**
 * The {@link Metadata} builder.
 * This builder has a default value:
 * {@link MetadataBuilder#type} as {@link MetricType#INVALID}
 * {@link MetadataBuilder#unit} as {@link MetricUnits#NONE}
 * {@link MetadataBuilder#reusable} as {@link Boolean#FALSE}
 */
public class MetadataBuilder {

    private String name;

    private String displayName;

    private String description;

    private MetricType type = MetricType.INVALID;

    private String unit = MetricUnits.NONE;

    private boolean reusable = true;

    MetadataBuilder(Metadata metadata) {
        this.name = metadata.getName();
        this.type = metadata.getTypeRaw();
        this.reusable = metadata.isReusable();
        this.displayName = metadata.getDisplayName();
        metadata.getDescription().ifPresent(this::withDescription);
        metadata.getUnit().ifPresent(this::withUnit);

    }

    public MetadataBuilder() {

    }

    /**
     * Sets the name
     *
     * @param name the name
     * @return the builder instance
     * @throws NullPointerException when name is null
     */
    public MetadataBuilder withName(String name) {
        this.name = Objects.requireNonNull(name, "name is required");
        return this;
    }

    /**
     * Sets the displayName
     *
     * @param displayName the displayName
     * @return the builder instance
     * @throws NullPointerException when displayName is null
     */
    public MetadataBuilder withDisplayName(String displayName) {
        this.displayName = Objects.requireNonNull(displayName, "displayName is required");
        return this;
    }

    /**
     * Sets the description
     *
     * @param description the name
     * @return the builder instance
     * @throws NullPointerException when description is null
     */
    public MetadataBuilder withDescription(String description) {
        this.description = Objects.requireNonNull(description, "description is required");
        return this;
    }

    /**
     * Sets the type
     *
     * @param type the name
     * @return the builder instance
     * @throws NullPointerException when type is null
     */
    public MetadataBuilder withType(MetricType type) {
        this.type = Objects.requireNonNull(type, "type is required");
        return this;
    }

    /**
     * Sets the unit
     *
     * @param unit the name
     * @return the builder instance
     * @throws NullPointerException when unit is null
     */
    public MetadataBuilder withUnit(String unit) {
        this.unit = Objects.requireNonNull(unit, "unit is required");
        return this;
    }

    /**
     * Sets the reusable to {@link Boolean#TRUE}
     *
     * @return the builder instance
     */
    public MetadataBuilder reusable() {
        this.reusable = true;
        return this;
    }

    /**
     * Sets the reusable to {@link Boolean#FALSE}
     *
     * @return the builder instance
     */
    public MetadataBuilder notReusable() {
        this.reusable = false;
        return this;
    }

    /**
     * @return An object implementing {@link Metadata} from the provided properties
     * @throws IllegalStateException when either name is null
     */
    public Metadata build() {
        if (Objects.isNull(name)) {
            throw new IllegalStateException("Name is required");
        }

        return new DefaultMetadata(name, displayName, description, type, unit, reusable);
    }
}

@@ -3735,34 +3735,42 @@
  Sets the reusab
-le
+ility flag
  to %7B@link Boole
@@ -3957,18 +3957,313 @@
 e reusab
-le
+ility flag to the desired boolean value%0A     *%0A     * @param value the value of the reusability flag%0A     * @return the builder instance%0A     */%0A    public MetadataBuilder reusable(boolean value) %7B%0A        this.reusable = value;%0A        return this;%0A    %7D%0A%0A    /**%0A     * Sets the reusability flag
  to %7B@li

Introduce MetadataBuilder.reusable(boolean). Fixes #407