identifier field is mutually exclusive of the url field.
*
* @since OpenAPI 3.1.0
* @var string
*/
public $identifier = Generator::UNDEFINED;
/**
* A URL to the license used for the API. This MUST be in the form of a URL.
*
* The url field is mutually exclusive of the identifier field.
*
* @var string
*/
public $url = Generator::UNDEFINED;
/**
* @inheritdoc
*/
public static $_types = [
'name' => 'string',
'identifier' => 'string',
'url' => 'string',
];
/**
* @inheritdoc
*/
public static $_required = ['name'];
/**
* @inheritdoc
*/
public static $_parents = [
Info::class,
];
/**
* @inheritdoc
*/
public static $_nested = [
Attachable::class => ['attachables'],
];
public function jsonSerialize(): \stdClass
{
$data = parent::jsonSerialize();
if ($this->_context->isVersion('3.0.x')) {
unset($data->identifier);
}
return $data;
}
#[\Override]
public function validate(?Analysis $analysis = null, string $version = OpenApi::DEFAULT_VERSION, ?object $context = null): bool
{
$isValid = parent::validate($analysis, $version, $context);
if (!OpenApi::versionMatch($version, '3.0.x')) {
if (!Generator::isDefault($this->url) && !Generator::isDefault($this->identifier)) {
$this->_context->logger->warning($this->identity() . ' url and identifier are mutually exclusive in ' . $this->_context);
$isValid = false;
}
}
return $isValid;
}
}