no.hasmac.jsonld.uri.UriUtils Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of hasmac-json-ld Show documentation
Show all versions of hasmac-json-ld Show documentation
A more performant JSON-LD 1.1 Processor & API forked from Titanium JSON-LD.
The newest version!
/*
* Copyright 2020 APICATALOG and HASMAC.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* SPDX-License-Identifier: Apache-2.0
*/
package no.hasmac.jsonld.uri;
import no.hasmac.jsonld.StringUtils;
import no.hasmac.jsonld.lang.Keywords;
import java.net.URI;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public final class UriUtils {
private static final Map COMMON_CONSTANTS = new HashMap<>();
static {
List uris = List.of(
"http://data.europa.eu/eli/ontology#",
"http://publications.europa.eu/mdr/eli/index.html",
"http://purl.bioontology.org/ontology/SNOMEDCT/",
"http://purl.org/dc/dcmitype/",
"http://purl.org/dc/elements/1.1",
"http://purl.org/dc/elements/1.1/",
"http://purl.org/dc/terms/",
"http://purl.org/ontology/bibo/",
"http://rdfs.org/ns/void#",
"http://schema.org/",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"http://www.w3.org/1999/02/22-rdf-syntax-ns#HTML",
"http://www.w3.org/2000/01/rdf-schema#",
"http://www.w3.org/2001/XMLSchema#",
"http://www.w3.org/2002/07/owl#",
"http://www.w3.org/2004/02/skos/core#",
"http://www.w3.org/XML/1998/namespace",
"http://www.w3.org/ns/dcat#",
"http://www.w3.org/ns/rdfa#",
"http://xmlns.com/foaf/0.1/"
);
for (String uri : uris) {
try {
COMMON_CONSTANTS.put(uri, URI.create(uri));
COMMON_CONSTANTS.put(uri.substring(0, uri.length() - 1), URI.create(uri));
} catch (Exception ignored) {
}
}
}
private UriUtils() {
}
public static boolean isURI(final String value) {
return value != null
&& StringUtils.isNotBlank(value)
&& !Keywords.matchForm(StringUtils.strip(value))
&& isValid(StringUtils.strip(value));
}
private static boolean isValid(String uriString) {
if (uriString == null) {
throw new IllegalArgumentException("The uri cannot be null.");
}
String uriValue = StringUtils.strip(uriString);
if (uriValue.isEmpty()) {
return false;
}
if (uriValue.endsWith(":")) {
uriValue += ".";
} else if (uriValue.endsWith("[") || uriValue.endsWith("]")) {
uriValue = uriValue.substring(0, uriValue.length() - 1);
}
try {
if (PartiallyImplementedUriValidator.isDefinitivelyValidAbsoluteUri(uriValue)) {
return true;
}
return getUriWithCache(uriValue) != null;
} catch (IllegalArgumentException e) {
return false;
}
}
public static URI create(final String uriString) {
if (uriString == null) {
throw new IllegalArgumentException("The uri cannot be null.");
}
String uriValue = StringUtils.strip(uriString);
if (uriValue.isEmpty()) {
return null;
}
if (uriValue.endsWith(":")) {
uriValue += ".";
} else if (uriValue.endsWith("[") || uriValue.endsWith("]")) {
uriValue = uriValue.substring(0, uriValue.length() - 1);
}
try {
return getUriWithCache(uriValue);
} catch (IllegalArgumentException e) {
return null;
}
}
/**
* Check if the provided URI ends with generic delimiter.
*
* @param uri to check
* @return true
if the provided URI ends with delimiter
* @see URI - Reserved
* Characters
*/
public static boolean endsWithGenDelim(final String uri) {
return uri.endsWith(":") || uri.endsWith("/") || uri.endsWith("?") || uri.endsWith("#") || uri.endsWith("[")
|| uri.endsWith("]") || uri.endsWith("@");
}
public static boolean isNotURI(final String uri) {
return uri == null
|| StringUtils.isBlank(uri)
|| Keywords.matchForm(StringUtils.strip(uri))
|| !isValid(StringUtils.strip(uri))
;
}
/**
* Deprecated in favor of {@link UriUtils#isNotAbsoluteUri(String, boolean)}
*
* @param uri to check
* @return true
if the given URI is not absolute
* @deprecated since 1.3.0
*/
@Deprecated
public static boolean isNotAbsoluteUri(final String uri) {
return isNotAbsoluteUri(uri, true);
}
public static boolean isNotAbsoluteUri(final String uri, final boolean validate) {
return !isAbsoluteUri(uri, validate);
}
/**
* Deprecated in favor of {@link UriUtils#isAbsoluteUri(String, boolean)}
*
* @param uri to check
* @return true
if the given URI is absolute
* @deprecated since 1.3.0
*/
@Deprecated
public static boolean isAbsoluteUri(final String uri) {
return isAbsoluteUri(uri, true);
}
public static boolean isAbsoluteUri(final String uri, final boolean validate) {
// if URI validation is disabled
if (!validate) {
// then validate just a scheme
return startsWithScheme(uri);
}
// minimal form s(1):ssp(1)
if (uri == null || uri.length() < 3) {
return false;
}
try {
if (PartiallyImplementedUriValidator.isDefinitivelyValidAbsoluteUri(uri)) {
return true;
}
return getUriWithCache(uri).isAbsolute();
} catch (IllegalArgumentException e) {
return false;
}
}
private static URI getUriWithCache(String uriString) {
URI commonUri = COMMON_CONSTANTS.get(uriString);
if (commonUri != null) {
return commonUri;
}
return URI.create(uriString);
}
private static boolean startsWithScheme(final String uri) {
if (uri == null
|| uri.length() < 2 // a scheme must have at least one letter followed by ':'
|| !Character.isLetter(uri.codePointAt(0)) // a scheme name must start with a letter
) {
return false;
}
for (int i = 1; i < uri.length(); i++) {
if (
// a scheme name must start with a letter followed by a letter/digit/+/-/.
Character.isLetterOrDigit(uri.codePointAt(i))
|| uri.charAt(i) == '-' || uri.charAt(i) == '+' || uri.charAt(i) == '.'
) {
continue;
}
// a scheme name must be terminated by ':'
return uri.charAt(i) == ':';
}
return false;
}
protected static String recompose(final String scheme, final String authority, final String path, final String query, final String fragment) {
boolean includeScheme = isDefined(scheme);
boolean includeAuthority = authority != null;
boolean includePath = isDefined(path);
boolean includeQuery = isDefined(query);
boolean includeFragment = isDefined(fragment);
String result = recomposeCommonCases(scheme, authority, path, query, fragment, includeScheme, includeAuthority, includePath, includeQuery, includeFragment);
if (result != null) {
return result;
}
return recomposeAllCases(scheme, authority, path, query, fragment, includeScheme, includeAuthority, includePath, includeQuery, includeFragment);
}
private static String recomposeAllCases(String scheme, String authority, String path, String query, String fragment, boolean includeScheme, boolean includeAuthority, boolean includePath, boolean includeQuery, boolean includeFragment) {
final StringBuilder builder = new StringBuilder();
if (includeScheme) {
builder.append(scheme);
builder.append(":");
}
if (includeAuthority) {
builder.append("//");
builder.append(authority);
}
if (includePath) {
builder.append(path);
}
if (includeQuery) {
builder.append('?');
builder.append(query);
}
if (includeFragment) {
builder.append('#');
builder.append(fragment);
}
return builder.toString();
}
private static String recomposeCommonCases(String scheme, String authority, String path, String query, String fragment, boolean includeScheme, boolean includeAuthority, boolean includePath, boolean includeQuery, boolean includeFragment) {
if (includeScheme && !includeAuthority && !includePath && !includeQuery && !includeFragment) {
return scheme + ":";
}
if (includeScheme && includeAuthority && !includePath && !includeQuery && !includeFragment) {
return scheme + ":" + "//" + authority;
}
if (includeScheme && !includeAuthority && includePath && !includeQuery && !includeFragment) {
return scheme + ":" + path;
}
if (includeScheme && includeAuthority && includePath && !includeQuery && !includeFragment) {
return scheme + ":" + "//" + authority + path;
}
if (includeScheme && includeAuthority && includePath && !includeQuery && includeFragment) {
return scheme + ":" + "//" + authority + path + "#" + fragment;
}
if (includeScheme && includeAuthority && includePath && includeQuery && !includeFragment) {
return scheme + ":" + "//" + authority + path + "?" + query;
}
if (includeScheme && includeAuthority && includePath && includeQuery && includeFragment) {
return scheme + ":" + "//" + authority + path + "?" + query + "#" + fragment;
}
return null;
}
protected static String recompose(final String path, final String query, final String fragment) {
final StringBuilder builder = new StringBuilder();
if (isDefined(path)) {
builder.append(path);
}
if (isDefined(query)) {
builder.append('?');
builder.append(query);
}
if (isDefined(fragment)) {
builder.append('#');
builder.append(fragment);
}
return builder.toString();
}
protected static String recompose(final String query, final String fragment) {
final StringBuilder builder = new StringBuilder();
if (isDefined(query)) {
builder.append('?');
builder.append(query);
}
if (isDefined(fragment)) {
builder.append('#');
builder.append(fragment);
}
return builder.toString();
}
protected static String recompose(final String fragment) {
if (isDefined(fragment)) {
return "#" + fragment;
}
return "";
}
protected static boolean isDefined(final String value) {
return value != null && StringUtils.isNotBlank(value);
}
protected static boolean isNotDefined(final String value) {
return value == null || StringUtils.isBlank(value);
}
}