• Home
• com.inrupt.client
• inrupt-client-jena
• 1.3.0
• source code
• package-info.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

com.inrupt.client.jena.package-info Maven / Gradle / Ivy

/*
 * Copyright Inrupt Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal in
 * the Software without restriction, including without limitation the rights to use,
 * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
 * Software, and to permit persons to whom the Software is furnished to do so,
 * subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
 * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */
/**
 * 
Jena RDF support for the Inrupt Java Client Libraries.
 *
 * 
The Jena module gives two possibilities to read RDF data: through the Service {@link JenaService}
 * and through the BodyHandler {@link JenaBodyHandlers}.
 * 
 * 
A user of the {@code JenaService} should ensure that this implementation is
 * available on the classpath by adding the following dependency:
 *
 * 
 *     <dependency>
 *            <groupId>com.inrupt</groupId>
 *            <artifactId>inrupt-client-jena</artifactId>
 *            <version>${project.version}</version>
 *     </dependency>
 * 
 * 
 * 
Example of using the Jena Service toDataset() method to read triples
 * from a trig file into a {@code Dataset}:
 *
 * 
{@code
    RdfService service = ServiceProvider.getRdfService();
    Dataset dataset;
    try (InputStream input = Test.class.getResourceAsStream("/tripleExamples.trig")) {
        dataset = service.toDataset(RDFSyntax.TRIG, input);
    }
    System.out.println("Number of triples in file: " + dataset.size());
 * }
 *
 * 
Example of using the Jena BodyHandler ofModel() method to read the triples
 * from the same trig file into a {@code Model}:
 * 
{@code
    Request request = Request.newBuilder()
        .uri(URI.create("https://example.example/tripleExamples.trig"))
        .GET()
        .build();

    Response response = client.send(request, JenaBodyHandlers.ofModel()).toCompletableFuture().join();

    System.out.println("HTTP status code: " + response.statusCode());
    System.out.println("Number of triples in file: " + response.body().size());
 * }
 *
 * 
The {@link JenaBodyPublishers} can be used to write triples. An example that uses the
 * POST method to write a {@code Model}:
 *
 * 
{@code
    Model model = ModelFactory.createDefaultModel();

    model.add(
        ResourceFactory.createResource("https://example.example/subject"),
        ResourceFactory.createProperty("https://example.example/predicate"),
        "object");

    Request request = Request.newBuilder()
            .uri("https://example.example/postEndpoint"))
            .header("Content-Type", "text/turtle")
            .POST(JenaBodyPublishers.ofModel(model))
            .build();

    Response response = client.send(request, Response.BodyHandlers.discarding()).toCompletableFuture().join();

    System.out.println("HTTP status code: " + response.statusCode());
 * }
 */
package com.inrupt.client.jena;