com.apicatalog.rdf.Rdf Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of titanium-json-ld Show documentation
A JSON-LD 1.1 Processor & API
There is a newer version: 1.4.1
/*
 * Copyright 2020 the original author or authors.
 *
 * 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.
 */
package com.apicatalog.rdf;

import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.OutputStreamWriter;
import java.io.Reader;
import java.io.Writer;
import java.util.Collection;

import com.apicatalog.jsonld.http.media.MediaType;
import com.apicatalog.jsonld.lang.BlankNode;
import com.apicatalog.jsonld.uri.UriUtils;
import com.apicatalog.rdf.io.RdfReader;
import com.apicatalog.rdf.io.RdfWriter;
import com.apicatalog.rdf.io.error.UnsupportedContentException;
import com.apicatalog.rdf.lang.XsdConstants;
import com.apicatalog.rdf.spi.RdfProvider;

public final class Rdf {

    private Rdf() {
    }
    
    public static final RdfGraph createGraph() {
        return RdfProvider.provider().createGraph();
    }

    public static final Collection canRead() {
        return RdfProvider.provider().canRead();
    }
    
    public static final RdfReader createReader(final MediaType contentType, Reader reader) throws UnsupportedContentException {

        if (reader == null || contentType == null) {
            throw new IllegalArgumentException();
        }

        return RdfProvider.provider().createReader(contentType, reader);
    }
    
    public static final RdfReader createReader(final MediaType contentType, final InputStream is) throws UnsupportedContentException {
        
        if (is == null || contentType == null) {
            throw new IllegalArgumentException();
        }

        return createReader(contentType, new InputStreamReader(is));
    }

    public static final Collection canWrite() {
        return RdfProvider.provider().canWrite();
    }
    
    public static final RdfWriter createWriter(final MediaType contentType, final Writer writer) throws UnsupportedContentException {
        
        if (writer == null || contentType == null) {
            throw new IllegalArgumentException();
        }

        return RdfProvider.provider().createWriter(contentType, writer);
    }

    public static final RdfWriter createWriter(final MediaType contentType, final OutputStream os) throws UnsupportedContentException {
        
        if (os == null || contentType == null) {
            throw new IllegalArgumentException();
        }

        return createWriter(contentType, new OutputStreamWriter(os));
    }

    public static final RdfDataset createDataset() {
        return RdfProvider.provider().createDataset();
    }

    public static final RdfTriple createTriple(RdfResource subject, RdfResource predicate, RdfValue object) {
        
        if (subject == null || predicate == null || object == null) {
            throw new IllegalArgumentException();
        }

        return RdfProvider.provider().createTriple(subject, predicate, object);
    }

    public static final RdfNQuad createNQuad(RdfResource subject, RdfResource predicate, RdfValue object, RdfResource graphName) {
        
        if (subject == null) {            
            throw new IllegalArgumentException("Subject cannot be null.");
        }
        if (predicate == null) {
            throw new IllegalArgumentException("Predicate cannot be null.");
        }
        if (object == null) {
            throw new IllegalArgumentException("Object cannot be null.");            
        }

        return RdfProvider.provider().createNQuad(subject, predicate, object, graphName);
    }

    public static final RdfNQuad createNQuad(RdfTriple triple, RdfResource graphName) {
        
        if (triple == null) {            
            throw new IllegalArgumentException("Triple cannot be null.");
        }

        return RdfProvider.provider().createNQuad(triple.getSubject(), triple.getPredicate(), triple.getObject(), graphName);
    }

    public static RdfValue createValue(String value) {
        
        if (value == null) {
            throw new IllegalArgumentException();
        }
        
        if (UriUtils.isAbsoluteUri(value)) {
            return RdfProvider.provider().createIRI(value);
        }
        
        if (BlankNode.isWellFormed(value)) {
            return RdfProvider.provider().createBlankNode(value);
        }
        
        return RdfProvider.provider().createTypedString(value, XsdConstants.STRING);
    }

    public static RdfLiteral createString(String lexicalForm) {
        
        if (lexicalForm == null) {
            throw new IllegalArgumentException();
        }
        
        return RdfProvider.provider().createTypedString(lexicalForm, XsdConstants.STRING);
    }

    public static RdfLiteral createTypedString(String lexicalForm, String dataType) {
        
        if (lexicalForm == null) {
            throw new IllegalArgumentException();
        }
        
        return RdfProvider.provider().createTypedString(lexicalForm, dataType);
    }
    
    public static RdfLiteral createLangString(String lexicalForm, String langTag) {
        
        if (lexicalForm == null) {
            throw new IllegalArgumentException();
        }
        
        return RdfProvider.provider().createLangString(lexicalForm, langTag);
    }

    /**
     * Create a new {@link RdfResource}.
     * 
     * @param resource is an absolute IRI or blank node identifier
     * @return RDF resource 
     * @throws IllegalArgumentException if the resource is not an absolute IRI or blank node identifier
     */
    public static RdfResource createResource(String resource) {
        
        if (resource == null) {
            throw new IllegalArgumentException("The resource value cannot be null.");
        }
        
        if (UriUtils.isAbsoluteUri(resource)) {
            return RdfProvider.provider().createIRI(resource);
        }
        
        if (BlankNode.isWellFormed(resource)) {
            return RdfProvider.provider().createBlankNode(resource);
        }
        
        throw new IllegalArgumentException("The resource must be an absolute IRI or blank node identifier, but was [" + resource + "].");        
    }
    
    public static RdfResource createBlankNode(final String value) {
        
        if (value == null || value.isBlank()) {
            throw new IllegalArgumentException();
        }

        return RdfProvider.provider().createBlankNode(value);
    }
    
    public static RdfResource createIRI(final String value) {
        
        if (value == null || value.isBlank()) {
            throw new IllegalArgumentException();
        }

        return RdfProvider.provider().createIRI(value);
    }
}