com.networknt.oas.OpenApiParser Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of openapi-parser Show documentation
A light-weight, fast OpenAPI 3.0 parser and validator
There is a newer version: 2.1.38
/*******************************************************************************
 *  Copyright (c) 2017 ModelSolv, Inc. and others.
 *  All rights reserved. This program and the accompanying materials
 *  are made available under the terms of the Eclipse Public License v1.0
 *  which accompanies this distribution, and is available at
 *  http://www.eclipse.org/legal/epl-v10.html
 *
 *  Contributors:
 *     ModelSolv, Inc. - initial API and implementation and/or initial documentation
 *******************************************************************************/
package com.networknt.oas;

import com.fasterxml.jackson.databind.JsonNode;
import com.networknt.oas.jsonoverlay.JsonLoader;
import com.networknt.oas.jsonoverlay.ReferenceRegistry;
import com.networknt.oas.jsonoverlay.ResolutionBaseRegistry;
import com.networknt.oas.jsonoverlay.Resolver;
import com.networknt.oas.model.impl.OpenApi3Impl;

import java.io.File;
import java.io.IOException;
import java.net.MalformedURLException;
import java.net.URI;
import java.net.URL;

public class OpenApiParser {

	public OpenApiParser() {
	}

	public OpenApi parse(String spec, URL resolutionBase) {
		return parse(spec, resolutionBase, true);
	}

	public OpenApi parse(String spec, URL resolutionBase, boolean validate) {
		try {
			JsonLoader jsonLoader = new JsonLoader();
			JsonNode tree = jsonLoader.loadString(resolutionBase, spec);
			ResolutionBaseRegistry resolutionBaseRegistry = new ResolutionBaseRegistry(jsonLoader);
			resolutionBaseRegistry.register(resolutionBase.toString(), tree);
			return parse(resolutionBase, validate, resolutionBaseRegistry);
		} catch (IOException e) {
			throw new SwaggerParserException("Failed to parse spec as JSON or YAML", e);
		}
	}

	public OpenApi parse(File specFile) {
		return parse(specFile, true);
	}

	public OpenApi parse(File specFile, boolean validate) {
		try {
			return parse(specFile.toURI().toURL(), validate);
		} catch (IOException e) {
			throw new SwaggerParserException("Failed to read spec from file", e);
		}
	}

	public OpenApi parse(URI uri) {
		return parse(uri, true);
	}

	public OpenApi parse(URI uri, boolean validate) {
		try {
			return parse(uri.toURL(), validate);
		} catch (MalformedURLException e) {
			throw new SwaggerParserException("Invalid URI for Swagger spec", e);
		}
	}

	public OpenApi parse(URL resolutionBase) {
		return parse(resolutionBase, true);
	}

	public OpenApi parse(URL resolutionBase, boolean validate) {
		return parse(resolutionBase, validate, new ResolutionBaseRegistry(new JsonLoader()));
	}

	protected OpenApi parse(URL resolutionBase, boolean validate, ResolutionBaseRegistry resolutionBaseRegistry) {
		try {
			ReferenceRegistry referenceRegistry = new ReferenceRegistry();
			new Resolver(referenceRegistry, resolutionBaseRegistry).preresolve(resolutionBase);
			JsonNode tree = resolutionBaseRegistry.get(resolutionBase.toString()).getJson();
			if (isVersion3(tree)) {
				OpenApi3Impl model = new OpenApi3Impl(tree, null, referenceRegistry);
				if (validate) {
					model.validate();
				}
				return model;
			} else {
				throw new SwaggerParserException(
						"Could not determine OpenApi version - missing or invalid 'openapi' or 'swagger' property");
			}
		} catch (Exception e) {
			// throw new SwaggerParserException("Failed to parse Swagger spec", e);
			throw e;
		}

	}

	protected boolean isVersion3(JsonNode tree) {
		JsonNode versionNode = tree.path("openapi");
		return versionNode.isTextual() && versionNode.asText().startsWith("3.");
	}

	public static class SwaggerParserException extends RuntimeException {

		private static final long serialVersionUID = 1L;

		public SwaggerParserException() {
			super();
		}

		public SwaggerParserException(String message, Throwable cause, boolean enableSuppression,
				boolean writableStackTrace) {
			super(message, cause, enableSuppression, writableStackTrace);
		}

		public SwaggerParserException(String message, Throwable cause) {
			super(message, cause);
		}

		public SwaggerParserException(String message) {
			super(message);
		}

		public SwaggerParserException(Throwable cause) {
			super(cause);
		}
	}
}