io.micrometer.observation.transport.ReceiverContext Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of micrometer-observation Show documentation
Module containing Observation related code
There is a newer version: 1.14.1
Show newest version
/*
 * Copyright 2022 VMware, Inc.
 *
 * 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
 *
 * https://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.micrometer.observation.transport;

import io.micrometer.common.lang.NonNull;
import io.micrometer.common.lang.Nullable;
import io.micrometer.observation.Observation;

import java.util.Objects;

/**
 * Context used when receiving data over the wire without requiring any confirmation to be
 * sent to sender of the data.
 *
 * @author Marcin Grzejszczak
 * @since 1.10.0
 * @param  type of the carrier object
 */
public class ReceiverContext extends Observation.Context {

    private final Propagator.Getter getter;

    private final Kind kind;

    private C carrier;

    @Nullable
    private String remoteServiceName;

    @Nullable
    private String remoteServiceAddress;

    /**
     * Creates a new instance of {@link ReceiverContext}.
     * @param getter propagator getter
     * @param kind kind
     */
    public ReceiverContext(@NonNull Propagator.Getter getter, @NonNull Kind kind) {
        this.getter = Objects.requireNonNull(getter, "Getter must be set");
        this.kind = Objects.requireNonNull(kind, "Kind must be set");
    }

    /**
     * Creates a new instance of a {@link Kind#CONSUMER} {@link ReceiverContext}.
     * @param getter propagator getter
     */
    public ReceiverContext(@NonNull Propagator.Getter getter) {
        this(getter, Kind.CONSUMER);
    }

    public C getCarrier() {
        return carrier;
    }

    public void setCarrier(C carrier) {
        this.carrier = carrier;
    }

    public Propagator.Getter getGetter() {
        return getter;
    }

    public Kind getKind() {
        return kind;
    }

    /**
     * Return optional name for the service from which the message is polled.
     * @return optional name for the service from which the message is polled
     */
    @Nullable
    public String getRemoteServiceName() {
        return remoteServiceName;
    }

    /**
     * Set optional name for the service from which the message is polled.
     * @param remoteServiceName name of the service from which the message is polled
     */
    public void setRemoteServiceName(@Nullable String remoteServiceName) {
        this.remoteServiceName = remoteServiceName;
    }

    /**
     * Return optional address for the service that will be called.
     * @return optional address for the service that will be called
     */
    @Nullable
    public String getRemoteServiceAddress() {
        return remoteServiceAddress;
    }

    /**
     * Set optional service address for the service that will be called.
     * @param remoteServiceAddress service address for the service that will be called
     */
    public void setRemoteServiceAddress(@Nullable String remoteServiceAddress) {
        this.remoteServiceAddress = remoteServiceAddress;
    }

}