com.github.kristofa.brave.ClientSpanState Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of brave-core Show documentation

Brave core.

There is a newer version: 4.13.6

package com.github.kristofa.brave;

import com.twitter.zipkin.gen.Span;

/**
 * Maintains state for a single client span.
 *
 * Client spans can be at the following locations in the span tree.
 * 

 *     The root-span of a trace originated by Brave
 *     A child of a server span originated by Brave
 *     A child of a local span originated by Brave
 * 
 *
 * @author kristof
 * @deprecated Replaced by {@code brave.propagation.CurrentTraceContext}
 */
@Deprecated
public interface ClientSpanState extends CommonSpanState {

    /**
     * Gets the Span for the client request that was started as part of current request.
     * 
     * Should be thread-aware to support multiple parallel requests.
     * 
     * @return Client request span for current thread.
     */
    Span getCurrentClientSpan();

    /**
     * Sets current client span.
     * 
     * Should be thread-aware to support multiple parallel requests.
     * 
     * @param span Client span.
     */
    void setCurrentClientSpan(final Span span);
}