Span.php

<?php

declare (strict_types=1);
namespace OpenTelemetry\API\Trace;

use OpenTelemetry\Context\Context;
use OpenTelemetry\Context\ContextInterface;
use OpenTelemetry\Context\ContextKeys;
use OpenTelemetry\Context\ScopeInterface;
abstract class Span implements SpanInterface {
    private static ?self $invalidSpan = null;
    
    /** @inheritDoc */
    public static final function fromContext(ContextInterface $context) : SpanInterface {
        return $context->get(ContextKeys::span()) ?? self::getInvalid();
    }
    
    /** @inheritDoc */
    public static final function getCurrent() : SpanInterface {
        return self::fromContext(Context::getCurrent());
    }
    
    /** @inheritDoc */
    public static final function getInvalid() : SpanInterface {
        if (null === self::$invalidSpan) {
            self::$invalidSpan = new NonRecordingSpan(SpanContext::getInvalid());
        }
        return self::$invalidSpan;
    }
    
    /** @inheritDoc */
    public static final function wrap(SpanContextInterface $spanContext) : SpanInterface {
        if (!$spanContext->isValid()) {
            return self::getInvalid();
        }
        return new NonRecordingSpan($spanContext);
    }
    
    /** @inheritDoc */
    public final function activate() : ScopeInterface {
        return Context::getCurrent()->withContextValue($this)
            ->activate();
    }
    
    /** @inheritDoc */
    public final function storeInContext(ContextInterface $context) : ContextInterface {
        if (LocalRootSpan::isLocalRoot($context)) {
            $context = LocalRootSpan::store($context, $this);
        }
        return $context->with(ContextKeys::span(), $this);
    }

}