Update javadocs of Meter builders to cross reference MeterRegistry.ge…

…tOrCreate()

metrics/api/src/main/java/io/helidon/metrics/api/Counter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -50,7 +50,10 @@ static Builder builder(String name) {
     long count();
 
     /**
-     * Builder for a new counter.
+     * Builder for a new counter. The actually building of the counter
+     * is performed by the registry.
+     *
+     * @see MeterRegistry#getOrCreate(Meter.Builder)
      */
     interface Builder extends Meter.Builder<Builder, Counter> {
     }

metrics/api/src/main/java/io/helidon/metrics/api/DistributionSummary.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -92,6 +92,8 @@ static Builder builder(String name) {
 
     /**
      * Builder for a {@link io.helidon.metrics.api.DistributionSummary}.
+     *
+     * @see MeterRegistry#getOrCreate(Meter.Builder)
      */
     interface Builder extends Meter.Builder<Builder, DistributionSummary> {
 

metrics/api/src/main/java/io/helidon/metrics/api/FunctionalCounter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -45,6 +45,8 @@ static <T> Builder<?> builder(String name, T stateObject, Function<T, Long> fn)
     /**
      * Builder for a {@link io.helidon.metrics.api.FunctionalCounter}.
      *
+     * @see MeterRegistry#getOrCreate(Meter.Builder)
+     *
      * @param <T> type of the state object
      */
     interface Builder<T> extends Meter.Builder<Builder<T>, FunctionalCounter> {

metrics/api/src/main/java/io/helidon/metrics/api/Gauge.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -65,6 +65,8 @@ static <N extends Number> Builder<N> builder(String name, Supplier<N> numberSupp
     /**
      * Builder for a new gauge.
      *
+     * @see MeterRegistry#getOrCreate(Meter.Builder)
+     *
      * @param <N> specific subtype of {@code Number} for the gauge this builder will produce
      */
     interface Builder<N extends Number> extends Meter.Builder<Builder<N>, Gauge<N>> {

metrics/api/src/main/java/io/helidon/metrics/api/Meter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -111,6 +111,8 @@ public String typeName() {
      * We do not want developers to see a {@code build()} operation that they should not invoke.
      * </p>
      *
+     * @see MeterRegistry#getOrCreate(Builder)
+     *
      * @param <B> type of the builder
      * @param <M> type of the meter the builder creates
      */

metrics/api/src/main/java/io/helidon/metrics/api/Timer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2023 Oracle and/or its affiliates.
+ * Copyright (c) 2023, 2024 Oracle and/or its affiliates.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -189,6 +189,8 @@ interface Sample {
 
     /**
      * Builder for a new {@link io.helidon.metrics.api.Timer}.
+     *
+     * @see MeterRegistry#getOrCreate(Meter.Builder)
      */
     interface Builder extends Meter.Builder<Builder, Timer> {