commonMain.io.github.optimumcode.json.schema.extension.ExternalAssertion.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of json-schema-validator Show documentation

Multiplatform Kotlin implementation of JSON schema validator

The newest version!

package io.github.optimumcode.json.schema.extension

import io.github.optimumcode.json.schema.ErrorCollector
import io.github.optimumcode.json.schema.ExperimentalApi
import io.github.optimumcode.json.schema.internal.wrapper.JsonWrapper
import io.github.optimumcode.json.schema.model.AbstractElement
import kotlinx.serialization.json.JsonElement

/**
 * This interface allows you to implement your own schema assertion.
 * This interface **does not** allow implementing custom applicators.
 * Only simple assertions (like: _format_, _type_) can be implemented.
 */
@Suppress("detekt:ForbiddenComment")
@ExperimentalApi
public interface ExternalAssertion {
  /**
   * Validates passes [element].
   * If [element] does not pass the assertion returns `false`
   * and calls [ErrorCollector.onError] on passed [errorCollector].
   * Otherwise, returns `true`
   *
   * You should follow the rules from JSON specification.
   * E.g. element passes assertion if it has a different type from that the assertion expects.
   * This would mean for 'format' assertion if the [element] is not a primitive the assertion must pass
   *
   * @param element JSON element to validate
   * @param context [ExternalAssertionContext] associated with the [element]
   * @param errorCollector handler for [io.github.optimumcode.json.schema.ValidationError] produced by assertion
   * @return `true` if element is valid against assertion. Otherwise, returns `false`
   */
  public fun validate(
    element: AbstractElement,
    context: ExternalAssertionContext,
    errorCollector: ErrorCollector,
  ): Boolean =
    // TODO: remove it after two minor/major release
    validate(element.unwrap(), context, errorCollector)

  // TODO: increase level to error in the next release
  @Deprecated(
    message = "override validate(AbstractElement, ExternalAssertionContext, ErrorCollector) instead",
    level = DeprecationLevel.WARNING,
  )
  public fun validate(
    element: JsonElement,
    context: ExternalAssertionContext,
    errorCollector: ErrorCollector,
  ): Boolean = throw UnsupportedOperationException()
}

internal fun AbstractElement.unwrap(): JsonElement =
  when (this) {
    is JsonWrapper -> unwrap()
    else -> error("unsupported element type: ${this::class.simpleName}")
  }