| <!DOCTYPE html> |
| <html lang="en"> |
| <head> |
| |
| |
| <title>Apache Jena - Uma Introdução a RDF e à API RDF de Jena</title> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| |
| <link href="/css/bootstrap.min.css" rel="stylesheet" media="screen"> |
| <link href="/css/bootstrap-icons.css" rel="stylesheet" media="screen"><link rel="stylesheet" type="text/css" href="https://jena.apache.org/sass/jena.1b17c39a117e22b46db4c66f6395dc27c134a60377d87d2d5745b8600eb69722.css" integrity="sha256-GxfDmhF+IrRttMZvY5XcJ8E0pgN32H0tV0W4YA62lyI="> |
| <link rel="shortcut icon" href="/images/favicon.ico" /> |
| |
| </head> |
| |
| <body> |
| |
| <nav class="navbar navbar-expand-lg bg-body-tertiary" role="navigation"> |
| <div class="container"> |
| <div class="navbar-header"> |
| <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> |
| <span class="navbar-toggler-icon"></span> |
| </button> |
| <a class="navbar-brand" href="/index.html"> |
| <img class="logo-menu" src="/images/jena-logo/jena-logo-notext-small.png" alt="jena logo">Apache Jena</a> |
| </div> |
| |
| <div class="collapse navbar-collapse" id="navbarNav"> |
| <ul class="navbar-nav me-auto mb-2 mb-lg-0"> |
| <li id="homepage" class="nav-item"><a class="nav-link" href="/index.html"><span class="bi-house"></span> Home</a></li> |
| <li id="download" class="nav-item"><a class="nav-link" href="/download/index.cgi"><span class="bi-download"></span> Download</a></li> |
| <li class="nav-item dropdown"> |
| <a href="#" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-journal"></span> Learn <b class="caret"></b></a> |
| <ul class="dropdown-menu"> |
| <li class="dropdown-header">Tutorials</li> |
| <li><a class="dropdown-item" href="/tutorials/index.html">Overview</a></li> |
| <li><a class="dropdown-item" href="/documentation/fuseki2/index.html">Fuseki Triplestore</a></li> |
| <li><a class="dropdown-item" href="/documentation/notes/index.html">How-To's</a></li> |
| <li><a class="dropdown-item" href="/documentation/query/manipulating_sparql_using_arq.html">Manipulating SPARQL using ARQ</a></li> |
| <li><a class="dropdown-item" href="/tutorials/rdf_api.html">RDF core API tutorial</a></li> |
| <li><a class="dropdown-item" href="/tutorials/sparql.html">SPARQL tutorial</a></li> |
| <li><a class="dropdown-item" href="/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li> |
| <li class="dropdown-divider"></li> |
| <li class="dropdown-header">References</li> |
| <li><a class="dropdown-item" href="/documentation/index.html">Overview</a></li> |
| <li><a class="dropdown-item" href="/documentation/query/index.html">ARQ (SPARQL)</a></li> |
| <li><a class="dropdown-item" href="/documentation/io/">RDF I/O</a></li> |
| <li><a class="dropdown-item" href="/documentation/assembler/index.html">Assembler</a></li> |
| <li><a class="dropdown-item" href="/documentation/tools/index.html">Command-line tools</a></li> |
| <li><a class="dropdown-item" href="/documentation/rdfs/">Data with RDFS Inferencing</a></li> |
| <li><a class="dropdown-item" href="/documentation/geosparql/index.html">GeoSPARQL</a></li> |
| <li><a class="dropdown-item" href="/documentation/inference/index.html">Inference API</a></li> |
| <li><a class="dropdown-item" href="/documentation/ontology/">Ontology API</a></li> |
| <li><a class="dropdown-item" href="/documentation/permissions/index.html">Permissions</a></li> |
| <li><a class="dropdown-item" href="/documentation/extras/querybuilder/index.html">Query Builder</a></li> |
| <li><a class="dropdown-item" href="/documentation/rdf/index.html">RDF API</a></li> |
| <li><a class="dropdown-item" href="/documentation/rdfconnection/">RDF Connection - SPARQL API</a></li> |
| <li><a class="dropdown-item" href="/documentation/rdfstar/index.html">RDF-star</a></li> |
| <li><a class="dropdown-item" href="/documentation/shacl/index.html">SHACL</a></li> |
| <li><a class="dropdown-item" href="/documentation/shex/index.html">ShEx</a></li> |
| <li><a class="dropdown-item" href="/documentation/tdb/index.html">TDB</a></li> |
| <li><a class="dropdown-item" href="/documentation/tdb2/index.html">TDB2</a></li> |
| <li><a class="dropdown-item" href="/documentation/query/text-query.html">Text Search</a></li> |
| </ul> |
| </li> |
| |
| <li class="nav-item dropdown"> |
| <a href="#" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-journal-code"></span> Javadoc <b class="caret"></b></a> |
| <ul class="dropdown-menu"> |
| <li><a class="dropdown-item" href="/documentation/javadoc.html">All Javadoc</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/arq/">ARQ</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/fuseki2/">Fuseki</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/geosparql/">GeoSPARQL</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/jena/">Jena Core</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/permissions/">Permissions</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/extras/querybuilder/">Query Builder</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/shacl/">SHACL</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/tdb/">TDB</a></li> |
| <li><a class="dropdown-item" href="/documentation/javadoc/text/">Text Search</a></li> |
| </ul> |
| </li> |
| </ul> |
| <form class="d-flex" role="search" action="/search" method="GET"> |
| <div class="input-group"> |
| <input class="form-control border-end-0 border m-0" type="search" name="q" id="search-query" placeholder="Search...." aria-label="Search" style="width: 10rem;"> |
| <button class="btn btn-outline-secondary border-start-0 border" type="submit"> |
| <i class="bi-search"></i> |
| </button> |
| </div> |
| </form> |
| <ul class="navbar-nav"> |
| <li id="ask" class="nav-item"><a class="nav-link" href="/help_and_support/index.html" title="Ask"><span class="bi-patch-question"></span><span class="text-body d-none d-xxl-inline"> Ask</span></a></li> |
| |
| <li class="nav-item dropdown"> |
| <a href="#" title="Get involved" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-megaphone"></span><span class="text-body d-none d-xxl-inline"> Get involved </span><b class="caret"></b></a> |
| <ul class="dropdown-menu"> |
| <li><a class="dropdown-item" href="/getting_involved/index.html">Contribute</a></li> |
| <li><a class="dropdown-item" href="/help_and_support/bugs_and_suggestions.html">Report a bug</a></li> |
| <li class="dropdown-divider"></li> |
| <li class="dropdown-header">Project</li> |
| <li><a class="dropdown-item" href="/about_jena/about.html">About Jena</a></li> |
| <li><a class="dropdown-item" href="/about_jena/architecture.html">Architecture</a></li> |
| <li><a class="dropdown-item" href="/about_jena/citing.html">Citing</a></li> |
| <li><a class="dropdown-item" href="/about_jena/team.html">Project team</a></li> |
| <li><a class="dropdown-item" href="/about_jena/contributions.html">Related projects</a></li> |
| <li><a class="dropdown-item" href="/about_jena/roadmap.html">Roadmap</a></li> |
| <li><a class="dropdown-item" href="/about_jena/security-advisories.html">Security Advisories</a></li> |
| <li class="dropdown-divider"></li> |
| <li class="dropdown-header">ASF</li> |
| <li><a class="dropdown-item" href="https://www.apache.org/">Apache Software Foundation</a></li> |
| <li><a class="dropdown-item" href="https://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li> |
| <li><a class="dropdown-item" href="https://www.apache.org/licenses/LICENSE-2.0">License</a></li> |
| <li><a class="dropdown-item" href="https://www.apache.org/security/">Security</a></li> |
| <li><a class="dropdown-item" href="https://www.apache.org/foundation/thanks.html">Thanks</a></li> |
| </ul> |
| </li> |
| |
| |
| |
| |
| <li class="nav-item" id="edit"><a class="nav-link" href="https://github.com/apache/jena-site/edit/main/source/tutorials/rdf_api_pt.md" title="Edit this page on GitHub"><span class="bi-pencil-square"></span><span class="text-body d-none d-xxl-inline"> Edit this page</span></a></li> |
| </ul> |
| </div> |
| </div> |
| </nav> |
| |
| <div class="container"> |
| <div class="row"> |
| <div class="col-md-12"> |
| |
| <div id="breadcrumbs"> |
|
|
|
|
|
|
|
|
|
|
|
|
| <ol class="breadcrumb mt-4 p-2 bg-body-tertiary">
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| <li class="breadcrumb-item"><a href='/tutorials'>TUTORIALS</a></li>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| <li class="breadcrumb-item active">RDF API PT</li>
|
|
|
|
|
|
|
|
|
| </ol>
|
|
|
|
|
|
|
| |
| </div> |
| <h1 class="title">Uma Introdução a RDF e à API RDF de Jena</h1> |
| |
| |
| <main class="d-flex flex-xl-row flex-column"> |
| |
| <aside class="text-muted align-self-start mb-3 p-0 d-xl-none d-block"> |
| <h2 class="h6 sticky-top m-0 p-2 bg-body-tertiary">On this page</h2> |
| <nav id="TableOfContents"> |
| <ul> |
| <li><a href="#prefácio">Prefácio</a></li> |
| <li><a href="#ch-Introduction">Introdução</a></li> |
| <li><a href="#ch-Statements">Sentenças</a></li> |
| <li><a href="#ch-Writing-RDF">Escrita de RDF</a></li> |
| <li><a href="#ch-Reading-RDF">Leitura de RDF</a></li> |
| <li><a href="#ch-Prefixes">Controlando prefixos</a> |
| <ul> |
| <li><a href="#definições-explícitas-de-prefixos">Definições explícitas de prefixos</a></li> |
| <li><a href="#definições-implícitas-de-prefixos">Definições implícitas de prefixos</a></li> |
| </ul> |
| </li> |
| <li><a href="#ch-Jena-RDF-Packages">Pacotes Jena RDF</a></li> |
| <li><a href="#ch-Navigating-a-Model">Navegação em Modelos</a></li> |
| <li><a href="#ch-Querying-a-Model">Consultas em Modelos</a></li> |
| <li><a href="#ch-Operations-on-Models">Operações em Modelos</a></li> |
| <li><a href="#ch-Containers">Containers</a></li> |
| <li><a href="#ch-More-about-Literals-and-Datatypes">Mais sobre Literais e Datatypes</a></li> |
| <li><a href="#ch-Glossary">Glossário</a></li> |
| </ul> |
| </nav> |
| </aside> |
| <article class="flex-column me-lg-4"> |
| <h2 id="prefácio">Prefácio</h2> |
| <p>Este é um tutorial introdutório ao framework de descrição de recursos (RDF) |
| e Jena, uma API Java para RDF. Ele é escrito para programadores que |
| não estão familiarizados com RDF e que aprendem melhor através de prototipagem, |
| ou, por outros motivos, desejam avançar rapidamente para a implementação. |
| Familiaridade com XML e Java é assumido.</p> |
| <p>Avançar direto para a implementação, sem conhecer inicialmente o modelo de dados de RDF, |
| levará à frustração e ao desapontamento. No entanto, estudar unicamente o modelo de dados é |
| desgastante e muitas vezes leva a "enigmas metafísicos torturantes". É melhor, |
| então, abordar os conceitos do modelo de dados e como usá-lo, paralelamente. |
| Aprender um pouco o modelo de dados, e praticá-lo. Então aprender um pouco mais e praticar. |
| A teoria leva à prática , e a prática leva à teoria. O modelo de dados é |
| relativamente simples, então esta abordagem não exigirá muito tempo.</p> |
| <p>RDF possui uma sintaxe XML, e muitos dos que são familiarizados com XML irão pensar em RDF em termos da sintaxe do XML. Isso é um erro. RDF deve ser entendido em termos do seu modelo de dados. Os dados RDF podem ser representados em XML, mas entender a sintaxe é menos importante do que entender o modelo de dados.</p> |
| <p>Uma implementação da API JENA, incluindo o código fonte dos exemplos usados neste tutorial, podem ser baixados em |
| <a href="//jena.apache.org/download/index.cgi"><code>jena.apache.org/download/index.cgi</code></a>.</p> |
| <p></p> |
| <h2 id="ch-Introduction">Introdução</h2> |
| <p> O framework de descrição de recursos (RDF) é um padrão (tecnicamente uma recomendação da W3C) para descrever recursos. Mas o que são recursos? Isso é uma questão profunda e a definição precisa ainda é um assunto de debates. Para nossos propósitos, nós podemos pensar em recursos como tudo que podemos identificar. Você é um recurso, assim como sua página pessoal, este tutorial, o número um e a grande baleia branca em Moby Dick.</p> |
| <p>Nossos exemplos neste tutorial serão sobre pessoas. Elas usam uma <a |
| href="https://www.w3.org/TR/vcard-rdf">representação RDF de cartão de negócios (VCARDS)</a>. RDF é melhor representado como um diagrama de nós e arcos. Um simples vcard se assemelha a isto em RDF:</p> |
| <p align="center"> |
| <img border="0" src="figures/fig1.png" alt="figure 1" width="240" height="180"></p> |
| <p>O <a href="#glos-Resource"><i>recurso</i></a>, John Smith, é exibido como uma elipse e identificado por um Identificador Uniforme de Recurso (URI)<font |
| size="1"><sup><a href="#fn-01">1</a></sup></font>, neste caso |
| "http://.../JohnSmith". Se você tentar acessar o recurso usando seu navegador, não vai obter sucesso. Se você não tem familiaridade com URI's, pense neles como nomes estranhos.</p> |
| <p>Recursos possuem <a href="#glos-Property"><i>propriedades</i></a>. Nesses exemplos, nós estamos interessados nos tipos de propriedades que apareceriam no cartão de negócios de Jonh Smith. A figura 1 mostra somente uma propriedade, o nome completo (full name) de Jonh Smith. Uma propriedade é representada por um arco, intitulado com o nome da propriedade. O nome da propriedade é também um URI, mas como os URIs são longos e incomodas, o diagrama o exibe em forma XML qname. A parte antes de ':' é chamada de prefixo namespace e representa um namespace. A parte depois de ':' é um nome local e representa o nome naquele namespace. Propriedades são normalmente representadas nesta forma de qname quando escrito como RDF XML, e isso é uma maneira prática de representá-los em diagramas e textos. No entanto, propriedades são rigorosamente representadas por um URI. A forma nsprefix:localname é um atalho para o URI do namespace concatenado com o nome local. Não há exigências de que o URI de uma propriedade resulte em algo quando acessado do navegador.</p> |
| <p>Toda propriedade possui um valor. Neste caso, o valor é uma <a |
| href="#glos-Literal"><i>literal</i></a>, que por hora podemos pensar nelas como uma cadeia de caracteres<font size="1"><sup><a href="#fn-02">2</a></sup></font>. |
| Literais são exibidas em retângulos.</p> |
| <p>Jena é uma API Java que pode ser usada para pra criar e manipular grafos RDF como o apresentado no exemplo. Jena possui classes para representar grafos, recursos, propriedades e literais. As interfaces que representam recursos, propriedades e literais são chamadas de modelo e é representada pela interface Model.</p> |
| <p>O código para criar este grafo, ou modelo, é simples:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// some definitions |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span><span style="color:#a2f;font-weight:bold">static</span> String personURI <span style="color:#666">=</span> <span style="color:#b44">"http://somewhere/JohnSmith"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">static</span> String fullName <span style="color:#666">=</span> <span style="color:#b44">"John Smith"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create an empty Model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Model model <span style="color:#666">=</span> ModelFactory<span style="color:#666">.</span><span style="color:#b44">createDefaultModel</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create the resource |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource johnSmith <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span>personURI<span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// add the property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>johnSmith<span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> fullName<span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Ele começa com algumas definições de constantes e então cria um Model vazio, usando o método <code>createDefaultModel()</code> de <code>ModelFactory</code> |
| para criar um modelo na memória. Jena possui outras implementações da interface Model, e.g. uma que usa banco de dados relacionais: esses tipos de modelo são também disponibilizados a partir de ModelFactory.</p> |
| <p>O recurso Jonh Smith é então criado, e uma propriedade é adicionada a ele. A propriedade é fornecida pela a classe "constante" VCARD, que mantém os objetos que representam todas as definições no esquema de VCARD. Jena provê classes constantes para outros esquemas bem conhecidos, bem como os próprios RDF e RDFs , Dublin Core e OWL.</p> |
| <p>O código para criar o recurso e adicionar a propriedade pode ser escrito de forma mais compacta usando um estilo cascata:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Resource johnSmith <span style="color:#666">=</span> |
| </span></span><span style="display:flex;"><span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span>personURI<span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> fullName<span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Os códigos desse exemplo podem ser encontrados no diretório /src-examples no pacote de distribuição do Jena como <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial01.java">tutorial 1</a>. Como exercício, pegue este código e modifique-o para criar um próprio VCARD para você.</p> |
| <p>Agora vamos adicionar mais detalhes ao vcard, explorando mais recursos de RDF e Jena.</p> |
| <p>No primeiro exemplo, o valor da propriedade foi um número. As propriedades RDF podem também assumir outros recursos como valor. Usando uma técnica comum em RDF, este exemplo mostra como representar diferentes partes do nome de Jonh Smith:</p> |
| <p align="center"> |
| <img border="0" src="figures/fig2.png" alt="figure 2" width="360" height="240"></p> |
| <p>Aqui, nós adicionamos uma nova propriedade, vcard:N, para representar a estrutura do nome de Jonh Smith. Há muitas coisas interessantes sobre este modelo. Note que a propriedade vcard:N usa um recurso como seu valor. Note também que a elipse que representa a composição do nome não possui URI. Isso é conhecido como <i><a href="#glos-blank node">blank Node</a>.</i></p> |
| <p>O código Jena para construir este exemplo é, novamente, muito simples. Primeiro algumas declarações e a criação do modelo vazio.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// some definitions |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>String personURI <span style="color:#666">=</span> <span style="color:#b44">"http://somewhere/JohnSmith"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span>String givenName <span style="color:#666">=</span> <span style="color:#b44">"John"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span>String familyName <span style="color:#666">=</span> <span style="color:#b44">"Smith"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span>String fullName <span style="color:#666">=</span> givenName <span style="color:#666">+</span> <span style="color:#b44">" "</span> <span style="color:#666">+</span> familyName<span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create an empty Model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Model model <span style="color:#666">=</span> ModelFactory<span style="color:#666">.</span><span style="color:#b44">createDefaultModel</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create the resource |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// and add the properties cascading style |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource johnSmith |
| </span></span><span style="display:flex;"><span> <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span>personURI<span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> fullName<span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">N</span><span style="color:#666">,</span> |
| </span></span><span style="display:flex;"><span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">()</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">Given</span><span style="color:#666">,</span> givenName<span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">Family</span><span style="color:#666">,</span> familyName<span style="color:#666">));</span> |
| </span></span></code></pre></div><p>Os códigos desse exemplo podem ser encontrados no diretório /src-examples no pacote de distribuição do Jena como <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial02.java">tutorial 2</a>.</p> |
| <h2 id="ch-Statements">Sentenças</h2> |
| <p>Cada arco no modelo RDF é chamado de <i><a |
| href="#glos-Statement">sentença</a></i>. Cada sentença define um fato sobre o recurso. Uma sentença possui três partes:</p> |
| <ul> |
| <li>o <i><a href="#glos-Subject"> sujeito</a></i> é o recurso de onde o arco começa.</li> |
| <li>o <i><a href="#glos-Predicate"> predicado</a></i> é a propriedade que nomeia o arco.</li> |
| <li>o <i><a href="#glos-Object"> objeto</a></i> é o recurso ou literal apontado pelo arco.</li> |
| </ul> |
| <p>Uma sentença é algumas vezes chamadas de <a href="#glos-Triple">tripla</a>, |
| por causa de suas três partes.</p> |
| <p>Um modelo RDF é representado como um <i>conjunto </i> de sentenças. Cada chamada a |
| <code>addProperty</code> no tutorial2 adiciona uma nova sentença. (Já que um modelo é um conjunto de sentenças, adicionar sentenças duplicadas não afeta em nada). A interface modelo de Jena define o método <code>listStatements()</code> que retorna um <code>StmtIterator</code>, um subtipo de |
| <code>Iterator</code> Java sobre todas as sentenças de um modelo. |
| <code>StmtIterator</code> possui o método <code>nextStatement()</code> |
| que retorna a próxima sentença do iterador (o mesmo que <code>next()</code> faz, já convertido para <code>Statement</code>). A interface <code>Statement</code> provê métodos de acesso ao sujeito, predicado e objeto de uma sentença.</p> |
| <p>Agora vamos usar essa interface para estender tutorial2 para listar todas as sentenças criadas e imprimi-las. O código completo deste exemplo pode ser encontrado em <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial03.java">tutorial 3</a>.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// list the statements in the Model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>StmtIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listStatements</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// print out the predicate, subject and object of each statement |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span><span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> Statement stmt <span style="color:#666">=</span> iter<span style="color:#666">.</span><span style="color:#b44">nextStatement</span><span style="color:#666">();</span> <span style="color:#080;font-style:italic">// get next statement |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span> Resource subject <span style="color:#666">=</span> stmt<span style="color:#666">.</span><span style="color:#b44">getSubject</span><span style="color:#666">();</span> <span style="color:#080;font-style:italic">// get the subject |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span> Property predicate <span style="color:#666">=</span> stmt<span style="color:#666">.</span><span style="color:#b44">getPredicate</span><span style="color:#666">();</span> <span style="color:#080;font-style:italic">// get the predicate |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span> RDFNode object <span style="color:#666">=</span> stmt<span style="color:#666">.</span><span style="color:#b44">getObject</span><span style="color:#666">();</span> <span style="color:#080;font-style:italic">// get the object |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">print</span><span style="color:#666">(</span>subject<span style="color:#666">.</span><span style="color:#b44">toString</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">print</span><span style="color:#666">(</span><span style="color:#b44">" "</span> <span style="color:#666">+</span> predicate<span style="color:#666">.</span><span style="color:#b44">toString</span><span style="color:#666">()</span> <span style="color:#666">+</span> <span style="color:#b44">" "</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">if</span> <span style="color:#666">(</span>object <span style="color:#a2f;font-weight:bold">instanceof</span> Resource<span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">print</span><span style="color:#666">(</span>object<span style="color:#666">.</span><span style="color:#b44">toString</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> <span style="color:#a2f;font-weight:bold">else</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#080;font-style:italic">// object is a literal |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">print</span><span style="color:#666">(</span><span style="color:#b44">" \""</span> <span style="color:#666">+</span> object<span style="color:#666">.</span><span style="color:#b44">toString</span><span style="color:#666">()</span> <span style="color:#666">+</span> <span style="color:#b44">"\""</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">" ."</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>Já que o objeto de uma sentença pode ser tanto um recurso quanto uma literal, o método |
| <code>getObject()</code> retorna um objeto do tipo <code>RDFNode</code>, que é uma superclasse comum de ambos <code>Resource</code> e <code>Literal</code>. O objeto em si é do tipo apropriado, então o código usa <code>instanceof</code> para determinar qual e processá-lo de acordo.</p> |
| <p>Quando executado, o programa deve produzir a saída:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-turtle" data-lang="turtle"><span style="display:flex;"><span><span style="">http</span>:<span style="">//somewhere/JohnSmith</span><span style="color:#bbb"> </span><span style="">http</span>:<span style="">//www</span>.<span style="">w</span><span style="color:#666">3</span>.<span style="">org/</span><span style="color:#666">2001</span><span style="">/vcard-rdf/</span><span style="color:#666">3.0</span><span style="color:#080;font-style:italic">#N anon:14df86:ecc3dee17b:-7fff .</span><span style="color:#bbb"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#bbb"></span><span style="">anon</span>:<span style="color:#666">14</span><span style="color:#00f;font-weight:bold">df86:</span><span style="color:#008000;font-weight:bold">ecc3dee17b</span>:<span style="color:#666">-7</span><span style="">fff</span><span style="color:#bbb"> </span><span style="">http</span>:<span style="">//www</span>.<span style="">w</span><span style="color:#666">3</span>.<span style="">org/</span><span style="color:#666">2001</span><span style="">/vcard-rdf/</span><span style="color:#666">3.0</span><span style="color:#080;font-style:italic">#Family "Smith" .</span><span style="color:#bbb"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#bbb"></span><span style="">anon</span>:<span style="color:#666">14</span><span style="color:#00f;font-weight:bold">df86:</span><span style="color:#008000;font-weight:bold">ecc3dee17b</span>:<span style="color:#666">-7</span><span style="">fff</span><span style="color:#bbb"> </span><span style="">http</span>:<span style="">//www</span>.<span style="">w</span><span style="color:#666">3</span>.<span style="">org/</span><span style="color:#666">2001</span><span style="">/vcard-rdf/</span><span style="color:#666">3.0</span><span style="color:#080;font-style:italic">#Given "John" .</span><span style="color:#bbb"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#bbb"></span><span style="">http</span>:<span style="">//somewhere/JohnSmith</span><span style="color:#bbb"> </span><span style="">http</span>:<span style="">//www</span>.<span style="">w</span><span style="color:#666">3</span>.<span style="">org/</span><span style="color:#666">2001</span><span style="">/vcard-rdf/</span><span style="color:#666">3.0</span><span style="color:#080;font-style:italic">#FN "John Smith"</span><span style="color:#bbb"> |
| </span></span></span><span style="display:flex;"><span><span style="color:#bbb"></span>.<span style="color:#bbb"> |
| </span></span></span></code></pre></div><p></p> |
| <p>Agora você sabe o porquê de ser simples elaborar modelos. Se você olhar atentamente, você perceberá que cada linha consiste de três campos representando o sujeito, predicado e objeto de cada sentença. Há quatro arcos no nosso modelo, então há quatro sentenças. O "anon:14df86:ecc3dee17b:-7fff" é um identificador interno gerado pelo Jena. Não é uma URI e não deve ser confundido como tal. É simplesmente um nome interno usado pela implementação do Jena.</p> |
| <p>O W3C <a href="https://www.w3.org/2001/sw/RDFCore/">RDFCore Working |
| Group</a> definiu uma notação similar chamada <a href="https://www.w3.org/TR/rdf-testcases/#ntriples">N-Triples</a>. O nome significa "notação de triplas". Nós veremos na próxima sessão que o Jena possui uma interface de escrita de N-Triples também.</p> |
| <h2 id="ch-Writing-RDF">Escrita de RDF</h2> |
| <p>Jena possui métodos para ler e escrever RDF como XML. Eles podem ser usados para armazenar o modelo RDF em um arquivo e carregá-lo novamente em outro momento.</p> |
| <p>O Tutorial 3 criou um modelo e o escreveu no formato de triplas. <a |
| href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial04.java">Tutorial 4</a> modifica o tutorial 3 para escrever o modelo na forma de RDF XML numa stream de saída. O código, novamente, é muito simples: <code>model.write</code> pode receber um <code>OutputStream</code> como argumento.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// now write the model in XML form to a file |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>A saída deve parecer com isso:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">'http://www.w3.org/1999/02/22-rdf-syntax-ns#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:vcard=</span><span style="color:#b44">'http://www.w3.org/2001/vcard-rdf/3.0#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">'http://somewhere/JohnSmith'</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>John Smith<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A0"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A0"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>John<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Smith<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p></p> |
| <p>As especificações de RDF especificam como representar RDF como XML. A sintaxe de RDF XML é bastante complexa. Recomendamos ao leitor dar uma olhada no <a href="https://www.w3.org/TR/rdf-primer/">primer</a> sendo desenvolvido pelo RDFCore WG para uma introdução mais detalhada. Entretanto, vamos dar uma olhada rápida em como interpretar a saída acima.</p> |
| <p>RDF é normalmente encapsulada num elemento <rdf:RDF>. O elemento é opcional se houver outras maneiras de saber se aquele XML é RDF, mas normalmente ele é presente. O elemento RDF define os dois namespaces usados no documento. Há um elemento <rdf:Description> que descreve o recurso cuja URI é "http://somewhere/JohnSmith". Se o atributo rdf:about estivesse ausente, esse elemento representaria um blank node.</p> |
| <p>O elemento <vcard:FN> descreve uma propriedade do recurso. O nome da propriedade é o "FN" no namespace do vcard. RDF o converte para uma referência URI concatenando a referência URI do prefixo presente no namespace de vcard e "FN", o nome local parte do nome. Isto nos dá a referência URI " http://www.w3.org/2001/vcard-rdf/3.0#FN". O valor da propriedade é a literal "Jonh Smith".</p> |
| <p>O elemento <vcard:N> é um recurso. Neste caso, o recurso é representado por uma referência URI relativa. RDF o converte para uma referência URI absoluta concatenando com o URI base do documento.</p> |
| <p>Há um erro nesse RDF XML: ele não representa exatamente o modelo que criamos. Foi dado uma URI ao blank node do modelo. Ele não é mais um blank node portanto. A sintaxe RDF/XML não é capaz de representar todos os modelos RDF; por exemplo, ela não pode representar um blank node que é o objeto de duas sentenças. O escritor que usamos para escrever este RDF/XML não é capaz de escrever corretamente o subconjunto de modelos que podem ser escritos corretamente. Ele dá uma URI a cada blank node, tornando-o não mais blank.</p> |
| <p>Jena possui uma interface extensível que permite novos escritores para diferentes linguagens de serialização RDF. Jena possuem também um escritor RDF/XML mais sofisticado que pode ser invocado ao especificar outro argumento à chamada de método |
| <code>RDFDataMgr.write</code>:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// now write the model in a pretty form |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>RDFDataMgr<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">,</span> model<span style="color:#666">,</span> Lang<span style="color:#666">.</span><span style="color:#b44">RDFXML</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Este escritor, chamado também de PrettyWriter, ganha vantagem ao usar as particularidades da sintaxe abreviada de RDF/XML ao criar um modelo mais compacto. Ele também é capaz de preservar os blank nodes onde é possível. Entretanto, não é recomendável para escrever modelos muito grandes, já que sua desempenho deixa a desejar. Para escrever grandes arquivos e preservar os blank nodes, escreva no formato de N-Triplas:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// now write the model in XML form to a file |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>RDFDataMgr<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">,</span> model<span style="color:#666">,</span> Lang<span style="color:#666">.</span><span style="color:#b44">NTRIPLES</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Isso produzirá uma saída similar à do tutorial 3, que está em conformidade com a especificação de N-Triplas.</p> |
| <h2 id="ch-Reading-RDF">Leitura de RDF</h2> |
| <p><a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial05.java">Tutorial 5</a> demonstra a leitura num modelo de sentenças gravadas num RDF XML. Com este tutorial, nós teremos criado uma pequena base de dados de vcards na forma RDF/XML. O código a seguir fará leitura e escrita. <em>Note que para esta aplicação rodar, o arquivo de entrada precisa estar no diretório da aplicação.</em></p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create an empty model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Model model <span style="color:#666">=</span> ModelFactory<span style="color:#666">.</span><span style="color:#b44">createDefaultModel</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// use the RDFDataMgr to find the input file |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>InputStream in <span style="color:#666">=</span> RDFDataMgr<span style="color:#666">.</span><span style="color:#b44">open</span><span style="color:#666">(</span> inputFileName <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">if</span> <span style="color:#666">(</span>in <span style="color:#666">==</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">throw</span> <span style="color:#a2f;font-weight:bold">new</span> IllegalArgumentException<span style="color:#666">(</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">"File: "</span> <span style="color:#666">+</span> inputFileName <span style="color:#666">+</span> <span style="color:#b44">" not found"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// read the RDF/XML file |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">read</span><span style="color:#666">(</span>in<span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// write it to standard out |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>O segundo argumento da chamada de método <code>read()</code> é a URI que será usada para resolver URIs relativas. Como não há referências URI relativas no arquivo de teste, ele pode ser vazio. Quando executado, <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial05.java"> tutorial 5</a> produzirá uma saída XML como esta:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">'http://www.w3.org/1999/02/22-rdf-syntax-ns#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:vcard=</span><span style="color:#b44">'http://www.w3.org/2001/vcard-rdf/3.0#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A0"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Smith<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>John<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">'http://somewhere/JohnSmith/'</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>John Smith<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A0"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">'http://somewhere/SarahJones/'</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>Sarah Jones<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A1"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">'http://somewhere/MattJones/'</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>Matt Jones<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A2"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A3"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Smith<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>Rebecca<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A1"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Jones<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>Sarah<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A2"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Jones<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>Matthew<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">'http://somewhere/RebeccaSmith/'</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>Becky Smith<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A3"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><h2 id="ch-Prefixes">Controlando prefixos</h2> |
| <h3 id="definições-explícitas-de-prefixos">Definições explícitas de prefixos</h3> |
| <p>Na sessão anterior, nós vimos que a saída XML declarou um prefixo namespace<br> |
| <code>vcard</code> e o usou para abreviar URIs. Enquanto que RDF usa somente URIs completas, e não sua forma encurtada, Jena provê formas de controlar namespaces usados na saída com seu mapeamento de prefixos. Aqui vai um exemplo simples.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Model m <span style="color:#666">=</span> ModelFactory<span style="color:#666">.</span><span style="color:#b44">createDefaultModel</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span>String nsA <span style="color:#666">=</span> <span style="color:#b44">"http://somewhere/else#"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span>String nsB <span style="color:#666">=</span> <span style="color:#b44">"http://nowhere/else#"</span><span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span>Resource root <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span> nsA <span style="color:#666">+</span> <span style="color:#b44">"root"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>Property P <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createProperty</span><span style="color:#666">(</span> nsA <span style="color:#666">+</span> <span style="color:#b44">"P"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>Property Q <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createProperty</span><span style="color:#666">(</span> nsB <span style="color:#666">+</span> <span style="color:#b44">"Q"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>Resource x <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span> nsA <span style="color:#666">+</span> <span style="color:#b44">"x"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>Resource y <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span> nsA <span style="color:#666">+</span> <span style="color:#b44">"y"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>Resource z <span style="color:#666">=</span> m<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">(</span> nsA <span style="color:#666">+</span> <span style="color:#b44">"z"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">add</span><span style="color:#666">(</span> root<span style="color:#666">,</span> P<span style="color:#666">,</span> x <span style="color:#666">).</span><span style="color:#b44">add</span><span style="color:#666">(</span> root<span style="color:#666">,</span> P<span style="color:#666">,</span> y <span style="color:#666">).</span><span style="color:#b44">add</span><span style="color:#666">(</span> y<span style="color:#666">,</span> Q<span style="color:#666">,</span> z <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span> <span style="color:#b44">"# -- no special prefixes defined"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span> System<span style="color:#666">.</span><span style="color:#b44">out</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span> <span style="color:#b44">"# -- nsA defined"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">setNsPrefix</span><span style="color:#666">(</span> <span style="color:#b44">"nsA"</span><span style="color:#666">,</span> nsA <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span> System<span style="color:#666">.</span><span style="color:#b44">out</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span> <span style="color:#b44">"# -- nsA and cat defined"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">setNsPrefix</span><span style="color:#666">(</span> <span style="color:#b44">"cat"</span><span style="color:#666">,</span> nsB <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span> System<span style="color:#666">.</span><span style="color:#b44">out</span> <span style="color:#666">);</span> |
| </span></span></code></pre></div><p>A saída deste fragmento são três blocos de RDF/XML, com três diferentes mapeamentos de prefixos. Primeiro o padrão, sem prefixos diferentes dos padrões:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span># -- no special prefixes defined |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:j.0=</span><span style="color:#b44">"http://nowhere/else#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">"http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:j.1=</span><span style="color:#b44">"http://somewhere/else#"</span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#root"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><j.1:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#x"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><j.1:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><j.0:Q</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#z"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>Nós vimos que o namespace rdf é declarado automaticamente, já que são requeridos para tags como <code><RDF:rdf></code> e <code><rdf:resource></code>. Declarações de namespace são também necessárias para o uso das duas propriedades P e Q, mas já que seus namespaces não foram introduzidos no modelo, eles recebem nomes namespaces inventados <code>j.0</code> e <code>j.1</code>.</p> |
| <p>O método <code>setNsPrefix(String prefix, String URI)</code> |
| declara que o namespace da <code>URI</code> deve ser abreviado por <code>prefixos</code>. Jena requer que o <code>prefixo</code> seja um namespace XML correto, e que o <code>URI</code> termine com um caractere sem-nome. O escritor RDF/XML transformará essas declarações de prefixos em declarações de namespaces XML e as usará nas suas saídas: |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span># -- nsA defined |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:j.0=</span><span style="color:#b44">"http://nowhere/else#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">"http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:nsA=</span><span style="color:#b44">"http://somewhere/else#"</span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#root"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><nsA:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#x"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><nsA:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><j.0:Q</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#z"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>O outro namespace ainda recebe o nome criado automaticamente, mas o nome nsA é agora usado nas tags de propriedades. Não há necessidade de que o nome do prefixo tenha alguma relação com as variáveis do código Jena:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span># -- nsA and cat defined |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:cat=</span><span style="color:#b44">"http://nowhere/else#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">"http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:nsA=</span><span style="color:#b44">"http://somewhere/else#"</span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#root"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><nsA:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#x"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><nsA:P</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/else#y"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><cat:Q</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">"http://somewhere/else#z"</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>Ambos os prefixos são usados na saída, e não houve a necessidade de prefixos gerados automaticamente.</p> |
| <h3 id="definições-implícitas-de-prefixos">Definições implícitas de prefixos</h3> |
| <p>Assim como as declarações de prefixos definidas por chamadas a <code>setNsPrefix</code>, Jena vai lembrar-se dos prefixos que foram usados na entrada para <code>model.read()</code>.</p> |
| <p>Pegue a saída produzida pelo fragmento anterior e cole-o dentro de algum arquivo, com a URL <b>file:/tmp/fragment.rdf</b> say. E execute o código: |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Model m2 <span style="color:#666">=</span> ModelFactory<span style="color:#666">.</span><span style="color:#b44">createDefaultModel</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span>m2<span style="color:#666">.</span><span style="color:#b44">read</span><span style="color:#666">(</span> <span style="color:#b44">"file:/tmp/fragment.rdf"</span> <span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>m2<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span> System<span style="color:#666">.</span><span style="color:#b44">out</span> <span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Você verá que os prefixos da entrada são preservados na saída. Todos os prefixos são escritos, mesmo se eles não forem usados em lugar algum. Você pode remover um prefixo com <code>removeNsPrefix(String prefix)</code> se você não o quiser na saída.</p> |
| <p>Como N-Triplas não possuem nenhuma forma reduzida de escrever URIs, não há prefixos nem na entrada nem na saída. A notação <b>N3</b>, também suportada pelo Jena, possui nomes prefixados reduzidos, e grava-os na entrada e usa-os na saída. |
| <p>Jena possui outras operações sobre mapeamento de prefixos de um modelo, como um<code>Map</code> de Java extraído a partir dos mapeamentos existentes, ou a adição de um grupo inteiro de mapeamentos de uma só vez; olhe a documentação de <code>PrefixMapping</code> para mais detalhes. |
| <h2 id="ch-Jena-RDF-Packages">Pacotes Jena RDF</h2> |
| <p>Jena é uma API JAVA para aplicações de web semântica. O pacote RDF chave para o desenvolvedor é |
| <code>org.apache.jena.rdf.model</code>. A API tem sido definida em termos de interfaces, logo o código da aplicação pode trabalhar com diferentes implementações sem causar mudanças. Esse pacote contém interfaces para representar modelos, recursos, propriedades, literais, sentenças e todos os outros conceitos chaves de RDF, e um ModelFactory para criação de modelos. Portanto, o código da aplicação permanece independente da implementação, o melhor é usar interfaces onde for possível e não implementações específicas de classes.</p> |
| <p>O pacote <code>org.apache.jena.tutorial</code> contém o código fonte funcional de todos os exemplos usados neste tutorial.</p> |
| <p>Os pacotes <code>org.apache.jena...impl</code> contêm a implementação de classes que podem ser comuns a várias implementações. Por exemplo, eles definem as classes <code>ResourceImpl</code>, |
| <code>PropertyImpl</code>, e <code>LiteralImpl</code> que podem ser usadas diretamente ou então herdadas por diferentes implementações. As aplicações devem raramente usar essas classes diretamente. Por exemplo, em vez de criar um nova instância de <code>ResourceImpl</code>, é melhor usar o método <code>createResource</code> do modelo que estiver sendo usado. Desta forma, se a implementação do modelo usar uma implementação otimizada de <code>Resource</code>, então não serão necessárias conversões entre os dois tipos.</p> |
| <h2 id="ch-Navigating-a-Model">Navegação em Modelos</h2> |
| <p>Até agora, este tutorial mostrou como criar, ler e escrever modelos RDF. Chegou o momento de mostrar como acessar as informações mantidas num modelo.</p> |
| <p> Dada a URI de um recurso, o objeto do recurso pode ser recuperado de um modelo usando o método <code>Model.getResource(String uri)</code>. Este método é definido para retornar um objeto Resource se ele existir no modelo, ou, caso contrário, criar um novo. Por exemplo, para recuperar o recurso Adam Smith do modelo lido a partir do arquivo no tutorial 5:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// retrieve the John Smith vcard resource from the model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource vcard <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">getResource</span><span style="color:#666">(</span>johnSmithURI<span style="color:#666">);</span> |
| </span></span></code></pre></div><p>A interface Resource define numerosos métodos para acessar as propriedades de um recurso. O método <code>Resource.getProperty(Property p)</code> acessa uma propriedade do recurso. Este método não segue a convenção usual de Java de acesso já que o tipo do objeto retorna é <code>Statement,</code> e não <code>Property</code> como era de se esperar. Retornando toda a sentença permite à aplicação acessar o valor da propriedade usando um de seus métodos de acesso que retornam o objeto da sentença. Por exemplo, para recuperar o recurso que é o valor da propriedade <code>vcard:N</code></p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// retrieve the value of the N property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource name <span style="color:#666">=</span> <span style="color:#666">(</span>Resource<span style="color:#666">)</span> vcard<span style="color:#666">.</span><span style="color:#b44">getProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">N</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getObject</span><span style="color:#666">();</span> |
| </span></span></code></pre></div><p>De modo geral, o objeto de uma sentença pode ser um recurso ou uma literal, então a aplicação, sabendo que o valor precisar ser um recurso, faz o cast do objeto retornado. Uma das coisas que Jena tenta fazer é fornecer tipos específicos de métodos, então a aplicação não tem que fazer cast, e checagem de tipos pode ser feita em tempo de compilação. O fragmento de código acima poderia ser mais convenientemente escrito assim:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// retrieve the value of the N property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource name <span style="color:#666">=</span> vcard<span style="color:#666">.</span><span style="color:#b44">getProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">N</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getResource</span><span style="color:#666">();</span> |
| </span></span></code></pre></div><p>Similarmente, o valor literal de uma propriedade pode ser recuperado:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java//" data-lang="java//"><span style="display:flex;"><span>String fullName <span style="color:#666">=</span> vcard<span style="color:#666">.</span><span style="color:#b44">getProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getString</span><span style="color:#666">();</span> |
| </span></span></code></pre></div><p>Neste exemplo, o recurso vcard possui somente as propriedades <code>vcard:FN</code> e <code>vcard:N</code>. RDF permite a um recurso repetir uma propriedade; por exemplo, Adam pode ter mais de um apelido. Vamos dar dois apelidos a ele:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// add two nickname properties to vcard |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>vcard<span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">NICKNAME</span><span style="color:#666">,</span> <span style="color:#b44">"Smithy"</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">NICKNAME</span><span style="color:#666">,</span> <span style="color:#b44">"Adman"</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Como notado anteriormente, Jena representa um modelo RDF como um conjunto de sentenças, então, adicionar uma sentença com um sujeito, predicado e objeto igual a um já existente não terá efeito. Jena não define qual do dois apelidos será retornado. O resultado da chamada a <code>vcard.getProperty(VCARD.NICKNAME)</code> é indeterminado. Jena vai retornar um dos valores, mas não há garantia nem mesmo de que duas chamadas consecutivas irá retornar o mesmo valor.</p> |
| <p>Se for possível que uma propriedade ocorra mais de uma vez, então o método Resource.listProperties(Property p) pode ser usado para retornar um iterador para lista-las. Este método retorna um iterador que retorna objetos do tipo <code>Statement</code>. Nós podemos listar os apelidos assim:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// set up the output |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">"The nicknames of \""</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">+</span> fullName <span style="color:#666">+</span> <span style="color:#b44">"\" are:"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// list the nicknames |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>StmtIterator iter <span style="color:#666">=</span> vcard<span style="color:#666">.</span><span style="color:#b44">listProperties</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">NICKNAME</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">" "</span> <span style="color:#666">+</span> iter<span style="color:#666">.</span><span style="color:#b44">nextStatement</span><span style="color:#666">()</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getObject</span><span style="color:#666">()</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">toString</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>Esse código pode ser encontrado em <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial06.java"> tutorial 6</a>. O iterador <code>iter</code> reproduz todas as sentenças com sujeito <code>vcard</code> e predicado <code>VCARD.NICKNAME</code>, então, iterar sobre ele permite recuperar cada sentença usando |
| <code>nextStatement()</code>, pegar o campo do objeto, e convertê-lo para string. O código produz a seguinte saída quando executado:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>The nicknames of <span style="color:#b44">"John Smith"</span> are: |
| </span></span><span style="display:flex;"><span> Smithy |
| </span></span><span style="display:flex;"><span> Adman |
| </span></span></code></pre></div><p>Todas as propriedades de um recurso podem ser listadas usando o método |
| <code>listProperties()</code> sem argumentos. |
| </p> |
| <h2 id="ch-Querying-a-Model">Consultas em Modelos</h2> |
| <p>A sessão anterior mostrou como navegar um modelo a partir de um recurso com uma URI conhecida. Essa sessão mostrará como fazer buscas em um modelo. O núcleo da API Jena suporta um limitada primitiva de consulta. As consultas mais poderosas de SPARQL são descritas em outros lugares.</p> |
| <p>O método <code>Model.listStatements()</code>, que lista todos as sentenças de um modelo, é talvez a forma mais crua de se consultar um modelo. Este uso não é recomendado em modelos muito grandes. |
| <code>Model.listSubjects()</code> é similar, mas retorna um iterador sobre todos os recursos que possuem propriedades, <i>ie</i> são sujeitos de alguma sentença.</p> |
| <p><code>Model.listSubjectsWithProperty(Property p, RDFNode |
| o)</code><code></code> retornará um iterador sobre todos os recursos com propriedade <code>p</code> de valor <code>o</code>. Se nós assumirmos que somente recursos vcard terão a propriedade <code>vcard:FN</code> e que, em nossos dados, todos esses recursos têm essa propriedade, então podemos encontrar todos os vCards assim:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// list vcards |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>ResIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listSubjectsWithProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> Resource r <span style="color:#666">=</span> iter<span style="color:#666">.</span><span style="color:#b44">nextResource</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">...</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>Todos esses métodos de consulta são açúcar sintático sobre o método primitivo de consulta <code>model.listStatements(Selector s)</code>. Esse método retorna um iterador sobre todas as sentenças no modelo 'selecionado' por <code>s</code>. A interface de selector foi feita para ser extensível, mas por hora, só há uma implementação dela, a classe <code>SimpleSelector</code> do pacote <code>org.apache.jena.rdf.model</code>. Usar <code>SimpleSelector </code> é uma das raras ocasiões em Jena onde é necessário usar uma classe especifica em vez de uma interface. O construtor de <code>SimpleSelector</code> recebe três argumentos:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Selector selector <span style="color:#666">=</span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span>subject<span style="color:#666">,</span> predicate<span style="color:#666">,</span> object<span style="color:#666">);</span> |
| </span></span></code></pre></div><p>Esse selector vai selecionar todas as sentenças em que o sujeito casa com |
| <code>subject</code>, um predicado que casa com <code>predicate</code> e um objeto que casa com <code>object</code>. Se <code>null</code> é passado para algum dos argumentos, ele vai casar com qualquer coisa, caso contrário, ele vai casar com os recursos ou literais correspondentes. (Dois recursos são iguais se eles possuem o mesmo URI ou são o mesmo blank node; dois literais são iguais se todos os seus componentes forem iguais.) Assim:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Selector selector <span style="color:#666">=</span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>vai selecionar todas as sentenças do modelo.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>Selector selector <span style="color:#666">=</span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>vai selecionar todas as sentenças com o predicado VCARD.FN, independente do sujeito ou objeto. Como um atalho especial, |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>listStatements<span style="color:#666">(</span> S<span style="color:#666">,</span> P<span style="color:#666">,</span> O <span style="color:#666">)</span> |
| </span></span></code></pre></div><p>é equivalente a</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>listStatements<span style="color:#666">(</span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span> S<span style="color:#666">,</span> P<span style="color:#666">,</span> O <span style="color:#666">)</span> <span style="color:#666">)</span> |
| </span></span></code></pre></div><p> |
| O código a seguir, que pode ser encontrado em <a |
| href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial07.java">tutorial 7</a> que lista os nomes completos de todos os vcards do banco de dados.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// select all the resources with a VCARD.FN property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>ResIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listSubjectsWithProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">if</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">"The database contains vcards for:"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">" "</span> <span style="color:#666">+</span> iter<span style="color:#666">.</span><span style="color:#b44">nextResource</span><span style="color:#666">()</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getString</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> <span style="color:#a2f;font-weight:bold">else</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">"No vcards were found in the database"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>Isso deve produzir uma saída similar a:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>The database contains vcards <span style="color:#a2f;font-weight:bold">for</span>: |
| </span></span><span style="display:flex;"><span> Sarah Jones |
| </span></span><span style="display:flex;"><span> John Smith |
| </span></span><span style="display:flex;"><span> Matt Jones |
| </span></span><span style="display:flex;"><span> Becky Smith |
| </span></span></code></pre></div><p>Seu próximo exercício é modificar o código para usar <code>SimpleSelector |
| </code>em vez de <code>listSubjectsWithProperty</code>.</p> |
| <p>Vamos ver como implementar um controle mais refinado sobre as sentenças selecionadas. |
| <code>SimpleSelector</code> pode ser herdado ter seus selects modificado para mais filtragens:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// select all the resources with a VCARD.FN property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// whose value ends with "Smith" |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>StmtIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listStatements</span><span style="color:#666">(</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> <span style="color:#666">(</span>RDFNode<span style="color:#666">)</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">public</span> <span style="color:#0b0;font-weight:bold">boolean</span> <span style="color:#00a000">selects</span><span style="color:#666">(</span>Statement s<span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">{</span><span style="color:#a2f;font-weight:bold">return</span> s<span style="color:#666">.</span><span style="color:#b44">getString</span><span style="color:#666">().</span><span style="color:#b44">endsWith</span><span style="color:#666">(</span><span style="color:#b44">"Smith"</span><span style="color:#666">);}</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">});</span> |
| </span></span></code></pre></div><p>Esse código usa uma técnica elegante de Java para sobrescrever a definição de um método quando criamos uma instância da classe. Aqui, o método <code>selects(...)</code> garante que o nome completo termine com “Smith”. É importante notar que a filtragem baseada nos argumentos sujeito, predicado e objeto tem lugar antes que o método <code>selects(...)</code> seja chamado, então esse teste extra só será aplicado para casar sentenças.</p> |
| <p>O código completo pode ser encontrado no <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial08.java">tutorial |
| 8</a> e produz uma saída igual a:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>The database contains vcards <span style="color:#a2f;font-weight:bold">for</span>: |
| </span></span><span style="display:flex;"><span> John Smith |
| </span></span><span style="display:flex;"><span> Becky Smith |
| </span></span></code></pre></div><p>Você pode imaginar que:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// do all filtering in the selects method |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>StmtIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listStatements</span><span style="color:#666">(</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">new</span> |
| </span></span><span style="display:flex;"><span> SimpleSelector<span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> <span style="color:#666">(</span>RDFNode<span style="color:#666">)</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">public</span> <span style="color:#0b0;font-weight:bold">boolean</span> <span style="color:#00a000">selects</span><span style="color:#666">(</span>Statement s<span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">return</span> <span style="color:#666">(</span>subject <span style="color:#666">==</span> <span style="color:#a2f;font-weight:bold">null</span> <span style="color:#666">||</span> s<span style="color:#666">.</span><span style="color:#b44">getSubject</span><span style="color:#666">().</span><span style="color:#b44">equals</span><span style="color:#666">(</span>subject<span style="color:#666">))</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">&</span>amp<span style="color:#666">;&</span>amp<span style="color:#666">;</span> <span style="color:#666">(</span>predicate <span style="color:#666">==</span> <span style="color:#a2f;font-weight:bold">null</span> <span style="color:#666">||</span> s<span style="color:#666">.</span><span style="color:#b44">getPredicate</span><span style="color:#666">().</span><span style="color:#b44">equals</span><span style="color:#666">(</span>predicate<span style="color:#666">))</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">&</span>amp<span style="color:#666">;&</span>amp<span style="color:#666">;</span> <span style="color:#666">(</span>object <span style="color:#666">==</span> <span style="color:#a2f;font-weight:bold">null</span> <span style="color:#666">||</span> s<span style="color:#666">.</span><span style="color:#b44">getObject</span><span style="color:#666">().</span><span style="color:#b44">equals</span><span style="color:#666">(</span>object<span style="color:#666">))</span> <span style="color:#666">;</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">});</span> |
| </span></span></code></pre></div><p>é equivalente a:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span>StmtIterator iter <span style="color:#666">=</span> |
| </span></span><span style="display:flex;"><span> model<span style="color:#666">.</span><span style="color:#b44">listStatements</span><span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span>subject<span style="color:#666">,</span> predicate<span style="color:#666">,</span> object<span style="color:#666">)</span> |
| </span></span></code></pre></div><p>Embora possam ser funcionalmente equivalentes, a primeira forma vai listar todas as sentenças do modelo e testar cada uma individualmente, a segunda forma permite índices mantidos pela implementação para melhor a perfomance. Tente isso em modelos grandes e veja você mesmo, mas prepare uma chícara de café antes.</p> |
| <h2 id="ch-Operations-on-Models">Operações em Modelos</h2> |
| <p>Jena provê três operações para manipular modelos. Elas são operações comuns de conjunto: união, intersecção e diferença.</p> |
| <p>A união de dois modelos é a união do conjunto de sentenças que representa cada modelo. Esta é uma das operações chaves que RDF suporta. Isso permite que fontes de dados discrepantes sejam juntadas. Considere o seguintes modelos:</p> |
| <p style="text-align: center"> |
| <img alt="figure 4" src="figures/fig4.png" width="240" height="240">and |
| <img alt="figure 5" src="figures/fig5.png" width="240" height="240"></p> |
| <p>Quando eles são juntados, os dois nós http://...JohnSmith são unidos em um, e o arco <code>vcard:FN</code> duplicado é descartado para produzir:</p> |
| <p style="text-align: center"> |
| <img alt="figure 6" src="figures/fig6.png" width="540" height="240"></p> |
| <p>Vamos ver o código (o código completo está em <a |
| href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial09.java">tutorial 9</a>) e ver o que acontece.</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// read the RDF/XML files |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model1<span style="color:#666">.</span><span style="color:#b44">read</span><span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">new</span> InputStreamReader<span style="color:#666">(</span>in1<span style="color:#666">),</span> <span style="color:#b44">""</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span>model2<span style="color:#666">.</span><span style="color:#b44">read</span><span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">new</span> InputStreamReader<span style="color:#666">(</span>in2<span style="color:#666">),</span> <span style="color:#b44">""</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// merge the Models |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Model model <span style="color:#666">=</span> model1<span style="color:#666">.</span><span style="color:#b44">union</span><span style="color:#666">(</span>model2<span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// print the Model as RDF/XML |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>system<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">,</span> <span style="color:#b44">"RDF/XML-ABBREV"</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>A saída produzida pelo PrettyWriter se assemelha a:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">"<a href="</span><span style="">http://www.w3.org/1999/02/22-rdf-syntax-ns#"</span><span style="color:#008000;font-weight:bold">></span>http://www.w3.org/1999/02/22-rdf-syntax-ns#<span style="color:#008000;font-weight:bold"></a></span>" |
| </span></span><span style="display:flex;"><span> xmlns:vcard="http://www.w3.org/2001/vcard-rdf/3.0#"> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:about=</span><span style="color:#b44">"http://somewhere/JohnSmith/"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:EMAIL></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:internet></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:value></span>John@somewhere.com<span style="color:#008000;font-weight:bold"></rdf:value></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></vcard:internet></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></vcard:EMAIL></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:N</span> <span style="color:#b44">rdf:parseType=</span><span style="color:#b44">"Resource"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Given></span>John<span style="color:#008000;font-weight:bold"></vcard:Given></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:Family></span>Smith<span style="color:#008000;font-weight:bold"></vcard:Family></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></vcard:N></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><vcard:FN></span>John Smith<span style="color:#008000;font-weight:bold"></vcard:FN></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>Mesmo que você não seja familiarizado com os detalhes da sintaxe RDF/XML, deve ser relativamente claro que os modelos foram unidos como esperado A interseção e a diferença de modelos podem ser computados de maneira semelhante, usando os métodos <code>.intersection(Model)</code> e |
| <code>.difference(Model)</code>; veja a documentação de |
| <a href="/documentation/javadoc/jena/org.apache.jena.core/org/apache/jena/rdf/model/Model.html#difference(org.apache.jena.rdf.model.Model)">difference</a> |
| e |
| <a href "/documentation/javadoc/jena/org.apache.jena.core/org/apache/jena/rdf/model/Model.html#intersection(org.apache.jena.rdf.model.Model)">intersection</a> |
| para mais detalhes. |
| </p> |
| <h2 id="ch-Containers">Containers</h2> |
| <p>RDF defina um tipo especial de recursos para representar coleções de coisas. Esses recursos são chamados de <i>containers</i>. Os membros de um container podem ser tanto literais quanto recursos. Há três tipos de containers:</p> |
| <ul> |
| <li>um BAG é uma coleção desordenada</li> |
| <li>uma ALT é uma coleção desordenada para representar alternativas</li> |
| <li>uma SEQ é uma coleção ordenada</li> |
| </ul> |
| <p>Um container é representado por um recurso. Esse recurso terá uma propriedade rdf:type cujo valor deve ser rdf:Bag, rdf:Alt, rdf:Seq, ou uma subclasse deles, dependendo do tipo do container. O primeiro membro do container é o valor da propriedade rdf:_1 do container; o segundo membro é o valor da propriedade rdf:_2 e assim por diante. As propriedades rdf:_nnn são conhecidas como <i>propriedades ordinais</i>.</p> |
| <p>Por exemplo, o modelo para uma bag simples contendo os vcards dos Smith pode se assemelhar a:</p> |
| <p align="center"> |
| <img border="0" src="figures/fig3.png" alt="figure 3" width="720" height="420"></p> |
| <p align="left">Embora os membros do bag serem representados pelas propriedades rdf:_1, rdf:_2 etc. a ordem das propriedades é insignificante. Nós poderíamos trocar os valores das propriedades rdf_1 e rdf_2 o resultado do modelo representaria a mesma informação.</p> |
| <p align="left">ALTs representam alternativas. Por exemplo, vamos supor um recurso representando um software. Ele poderia ter uma propriedade indicando onde ele foi obtido. O valor dessa propriedade pode ser uma coleção ALT contendo vários sites de onde ele poderia ser baixado. ALTs são desordenados a menos que a propriedade rdf:_1 tenha significado especial. Ela representa a escolha padrão.</p> |
| <p align="left">Embora os containers sejam manipulados como recursos e propriedades, Jena têm interfaces e implementações de classes explicitas para manipulá-los. Não é uma boa ideia ter um objeto manipulando um container e ao mesmo tempo modificando o estado do container usando métodos de mais baixo nível.</p> |
| <p align="left">Vamos modificar o tutorial 8 para criar essa bag:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create a bag |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Bag smiths <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">createBag</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// select all the resources with a VCARD.FN property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// whose value ends with "Smith" |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>StmtIterator iter <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">listStatements</span><span style="color:#666">(</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">new</span> SimpleSelector<span style="color:#666">(</span><span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">,</span> VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">,</span> <span style="color:#666">(</span>RDFNode<span style="color:#666">)</span> <span style="color:#a2f;font-weight:bold">null</span><span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">public</span> <span style="color:#0b0;font-weight:bold">boolean</span> <span style="color:#00a000">selects</span><span style="color:#666">(</span>Statement s<span style="color:#666">)</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">return</span> s<span style="color:#666">.</span><span style="color:#b44">getString</span><span style="color:#666">().</span><span style="color:#b44">endsWith</span><span style="color:#666">(</span><span style="color:#b44">"Smith"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">});</span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// add the Smith's to the bag |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span><span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> smiths<span style="color:#666">.</span><span style="color:#b44">add</span><span style="color:#666">(</span>iter<span style="color:#666">.</span><span style="color:#b44">nextStatement</span><span style="color:#666">().</span><span style="color:#b44">getSubject</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>Se nós imprimirmos esse modelo, vamos obter algo do tipo:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">'http://www.w3.org/1999/02/22-rdf-syntax-ns#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:vcard=</span><span style="color:#b44">'http://www.w3.org/2001/vcard-rdf/3.0#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span>... |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A3"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:type</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">'http://www.w3.org/1999/02/22-rdf-syntax-ns#Bag'</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:_1</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">'http://somewhere/JohnSmith/'</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:_2</span> <span style="color:#b44">rdf:resource=</span><span style="color:#b44">'http://somewhere/RebeccaSmith/'</span><span style="color:#008000;font-weight:bold">/></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>que representa o recurso Bag.</p> |
| <p>A interface do container fornece um iterador para listar o conteúdo do container:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// print out the members of the bag |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>NodeIterator iter2 <span style="color:#666">=</span> smiths<span style="color:#666">.</span><span style="color:#b44">iterator</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span><span style="color:#a2f;font-weight:bold">if</span> <span style="color:#666">(</span>iter2<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">"The bag contains:"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#a2f;font-weight:bold">while</span> <span style="color:#666">(</span>iter2<span style="color:#666">.</span><span style="color:#b44">hasNext</span><span style="color:#666">())</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">" "</span> <span style="color:#666">+</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">((</span>Resource<span style="color:#666">)</span> iter2<span style="color:#666">.</span><span style="color:#b44">next</span><span style="color:#666">())</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getProperty</span><span style="color:#666">(</span>VCARD<span style="color:#666">.</span><span style="color:#b44">FN</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">getString</span><span style="color:#666">());</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">}</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> <span style="color:#a2f;font-weight:bold">else</span> <span style="color:#666">{</span> |
| </span></span><span style="display:flex;"><span> System<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">.</span><span style="color:#b44">println</span><span style="color:#666">(</span><span style="color:#b44">"The bag is empty"</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span><span style="color:#666">}</span> |
| </span></span></code></pre></div><p>que produz a seguinte saída:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>The bag contains: |
| </span></span><span style="display:flex;"><span> John Smith |
| </span></span><span style="display:flex;"><span> Becky Smith |
| </span></span></code></pre></div><p>O código executável pode ser encontrado em <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial10.java"> |
| tutorial 10</a>, que coloca esses fragmentos de código juntos num exemplo completo.</p> |
| <p>As classes de Jena oferecem métodos para manipular containers, incluindo adição de novos membros, inserção de novos membros no meio de um container e a remoção de membros existentes. As classes de container Jena atualmente garantem que a lista ordenada de propriedades usadas começam com rdf:_1 e é contíguo. O RDFCore WG relaxou essa regra, permitindo uma representação parcial dos containers. Isso, portanto, é uma área de Jena que pode ser mudada no futuro.</p> |
| <h2 id="ch-More-about-Literals-and-Datatypes">Mais sobre Literais e Datatypes</h2> |
| <p>Literais RDF não são apenas strings. Literais devem ter uma tag para indicar a linguagem da literal. O diálogo de uma literal em Inglês é considerado diferente de um diálogo de uma literal em Francês. Esse comportamento estranho é um artefato da sintaxe RDF/XML original.</p> |
| <p>Há na realidade dois tipos de Literais. Em uma delas, o componente string é somente isso, uma string ordinária. Na outra, o componente string é esperado que fosse um bem balanceado fragmento de XML. Quando um modelo RDF é escrito como RDF/XML, uma construção especial usando um atributo parseType='Literal' é usado para representar isso.</p> |
| <p>Em Jena, esses atributos de uma literal podem ser setados quando a literal é construída, e.g. no <a href="https://github.com/apache/jena/tree/main/jena-core/src-examples/jena/examples/rdf/Tutorial11.java">tutorial 11</a>:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create the resource |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource r <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// add the property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>r<span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>RDFS<span style="color:#666">.</span><span style="color:#b44">label</span><span style="color:#666">,</span> model<span style="color:#666">.</span><span style="color:#b44">createLiteral</span><span style="color:#666">(</span><span style="color:#b44">"chat"</span><span style="color:#666">,</span> <span style="color:#b44">"en"</span><span style="color:#666">))</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>RDFS<span style="color:#666">.</span><span style="color:#b44">label</span><span style="color:#666">,</span> model<span style="color:#666">.</span><span style="color:#b44">createLiteral</span><span style="color:#666">(</span><span style="color:#b44">"chat"</span><span style="color:#666">,</span> <span style="color:#b44">"fr"</span><span style="color:#666">))</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>RDFS<span style="color:#666">.</span><span style="color:#b44">label</span><span style="color:#666">,</span> model<span style="color:#666">.</span><span style="color:#b44">createLiteral</span><span style="color:#666">(</span><span style="color:#b44">"&lt;em&gt;chat&lt;/em&gt;"</span><span style="color:#666">,</span> <span style="color:#a2f;font-weight:bold">true</span><span style="color:#666">));</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// write out the Model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>system<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>produz</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-xml" data-lang="xml"><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"><rdf:RDF</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdf=</span><span style="color:#b44">'http://www.w3.org/1999/02/22-rdf-syntax-ns#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#b44">xmlns:rdfs=</span><span style="color:#b44">'http://www.w3.org/2000/01/rdf-schema#'</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdf:Description</span> <span style="color:#b44">rdf:nodeID=</span><span style="color:#b44">"A0"</span><span style="color:#008000;font-weight:bold">></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdfs:label</span> <span style="color:#b44">xml:lang=</span><span style="color:#b44">'en'</span><span style="color:#008000;font-weight:bold">></span>chat<span style="color:#008000;font-weight:bold"></rdfs:label></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdfs:label</span> <span style="color:#b44">xml:lang=</span><span style="color:#b44">'fr'</span><span style="color:#008000;font-weight:bold">></span>chat<span style="color:#008000;font-weight:bold"></rdfs:label></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"><rdfs:label</span> <span style="color:#b44">rdf:parseType=</span><span style="color:#b44">'Literal'</span><span style="color:#008000;font-weight:bold">><em></span>chat<span style="color:#008000;font-weight:bold"></em></rdfs:label></span> |
| </span></span><span style="display:flex;"><span> <span style="color:#008000;font-weight:bold"></rdf:Description></span> |
| </span></span><span style="display:flex;"><span><span style="color:#008000;font-weight:bold"></rdf:RDF></span> |
| </span></span></code></pre></div><p>Para que duas literais sejam consideradas iguais, elas devem ser ambas literais XML ou ambas literais simples. Em adição a isso, ambas não devem possuir tag de linguagem, ou se as tags de linguagem estiverem presentes, elas devem ser iguais. Para simples literais strings, elas devem ser iguais. Literais XML têm duas noções de igualdade. A noção simples é que as condições anteriores são verdade e as strings também são iguais. A outra noção é de que elas podem ser iguais se a canonização das strings forem iguais.</p> |
| <p>As interfaces de Jena também suportam literais tipadas. A maneira antiga (mostrada abaixo) trata literais tipadas como atalhos para strings: valores tipados são convertidos por Java em strings, e essas strings são armazenadas no modelo. Por exemplo, tente (observando que para literais simples, nós podemos omitir a chamada code>model.createLiteral</code>(...)):</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-java" data-lang="java"><span style="display:flex;"><span><span style="color:#080;font-style:italic">// create the resource |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>Resource r <span style="color:#666">=</span> model<span style="color:#666">.</span><span style="color:#b44">createResource</span><span style="color:#666">();</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// add the property |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>r<span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>RDFS<span style="color:#666">.</span><span style="color:#b44">label</span><span style="color:#666">,</span> <span style="color:#b44">"11"</span><span style="color:#666">)</span> |
| </span></span><span style="display:flex;"><span> <span style="color:#666">.</span><span style="color:#b44">addProperty</span><span style="color:#666">(</span>RDFS<span style="color:#666">.</span><span style="color:#b44">label</span><span style="color:#666">,</span> <span style="color:#666">11</span><span style="color:#666">);</span> |
| </span></span><span style="display:flex;"><span> |
| </span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic">// write out the Model |
| </span></span></span><span style="display:flex;"><span><span style="color:#080;font-style:italic"></span>model<span style="color:#666">.</span><span style="color:#b44">write</span><span style="color:#666">(</span>system<span style="color:#666">.</span><span style="color:#b44">out</span><span style="color:#666">,</span> <span style="color:#b44">"N-TRIPLE"</span><span style="color:#666">);</span> |
| </span></span></code></pre></div><p>A saída produzida é:</p> |
| <div class="highlight"><pre tabindex="0" style="background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>_:A... <http://www.w3.org/2000/01/rdf-schema#label> <span style="color:#b44">"11"</span> . |
| </span></span></code></pre></div><p>Já que ambas as literais são apenas a string “’11”, então somente uma sentença é adicionada</p> |
| <p>O RDFCore WG definiu mecanismos para suportar datatypes em RDF. Jena os suporta usando mecanismos de <i>literais tipadas</i>; isso não é discutido neste tutorial.</p> |
| <h2 id="ch-Glossary">Glossário</h2> |
| <dl> |
| <dt><a id="glos-blank node">Blank Node</a></dt> |
| <dd>representam recursos, mas não indica a URI para este recurso. Blank nodes atuam como variáveis qualificadas existencialmente em lógica de primeira ordem.</dd> |
| <dt><a id="glos-dublin core">Dublin Core</a></dt> |
| <dd>é um padrão para metadados sobre recursos web. Mais informações podem ser encontradas no site <a href="http://purl.oclc.org/dc/">Dublin Core |
| web site</a>.</dd> |
| <dt><a id="glos-Literal">Literal</a></dt> |
| <dd>é uma cadeia de caracteres que pode ser o valor de uma propriedade.</dd> |
| <dt><a id="glos-Object">Objeto</a></dt> |
| <dd>é a parte da tripla que é o valor de uma sentença.</dd> |
| <dt><a id="glos-Predicate">Predicado</a></dt> |
| <dd>é a propriedade da tripla.</dd> |
| <dt><a id="glos-Property">Propriedade</a></dt> |
| <dd>é um atributo do recurso. Por exemplo, DC.Title é uma propriedade, como também RDF.type.</dd> |
| <dt><a id="glos-Resource">Recurso</a></dt> |
| <dd>é alguma entidade. Ele pode ser um recurso web como uma página, ou pode ser uma coisa concreta como um carro ou árvore. Pode ser uma ideia abstrata como xadrez ou futebol. Recursos são nomeados por URIs.</dd> |
| <dt><a id="glos-Statement">Sentença</a></dt> |
| <dd>é um arco no modelo RDF, normalmente interpretado como um fato.</dd> |
| <dt><a id="glos-Subject">Sujeito</a></dt> |
| <dd>é o recurso que é a fonte do arco num modelo RDF.</dd> |
| <dt><a id="glos-Triple">Tripla</a></dt> |
| <dd>é a estrutura contendo o sujeito, o predicado e o objeto. Outro termo para sentença.</dd> |
| </dl> |
| |
| </article> |
| |
| <aside class="text-muted align-self-start mb-3 mb-xl-5 p-0 d-none d-xl-flex flex-column sticky-top"> |
| <h2 class="h6 sticky-top m-0 p-2 bg-body-tertiary">On this page</h2> |
| <nav id="TableOfContents"> |
| <ul> |
| <li><a href="#prefácio">Prefácio</a></li> |
| <li><a href="#ch-Introduction">Introdução</a></li> |
| <li><a href="#ch-Statements">Sentenças</a></li> |
| <li><a href="#ch-Writing-RDF">Escrita de RDF</a></li> |
| <li><a href="#ch-Reading-RDF">Leitura de RDF</a></li> |
| <li><a href="#ch-Prefixes">Controlando prefixos</a> |
| <ul> |
| <li><a href="#definições-explícitas-de-prefixos">Definições explícitas de prefixos</a></li> |
| <li><a href="#definições-implícitas-de-prefixos">Definições implícitas de prefixos</a></li> |
| </ul> |
| </li> |
| <li><a href="#ch-Jena-RDF-Packages">Pacotes Jena RDF</a></li> |
| <li><a href="#ch-Navigating-a-Model">Navegação em Modelos</a></li> |
| <li><a href="#ch-Querying-a-Model">Consultas em Modelos</a></li> |
| <li><a href="#ch-Operations-on-Models">Operações em Modelos</a></li> |
| <li><a href="#ch-Containers">Containers</a></li> |
| <li><a href="#ch-More-about-Literals-and-Datatypes">Mais sobre Literais e Datatypes</a></li> |
| <li><a href="#ch-Glossary">Glossário</a></li> |
| </ul> |
| </nav> |
| </aside> |
| </main> |
| |
| </div> |
| </div> |
| </div> |
| |
| <footer class="bd-footer py-4 py-md-5 mt-4 mt-lg-5 bg-body-tertiary"> |
| <div class="container" style="font-size:80%" > |
| <p> |
| Copyright © 2011–2024 The Apache Software Foundation, Licensed under the |
| <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>. |
| </p> |
| <p> |
| Apache Jena, Jena, the Apache Jena project logo, Apache and the Apache feather logos are trademarks of |
| The Apache Software Foundation. |
| <br/> |
| <a href="https://privacy.apache.org/policies/privacy-policy-public.html" |
| >Apache Software Foundation Privacy Policy</a>. |
| </p> |
| </div> |
| </footer> |
| |
| <script src="/js/popper.min.js.js" type="text/javascript"></script> |
| <script src="/js/bootstrap.min.js" type="text/javascript"></script> |
| <script src="/js/improve.js" type="text/javascript"></script> |
| |
| <script type="text/javascript"> |
| (function() { |
| 'use strict' |
| |
| |
| |
| const links = document.querySelectorAll(`a[href="${window.location.pathname}"]`) |
| if (links !== undefined && links !== null) { |
| for (const link of links) { |
| |
| link.classList.add('active') |
| let parentElement = link.parentElement |
| let count = 0 |
| const levelsLimit = 4 |
| |
| |
| |
| |
| |
| while (['UL', 'LI'].includes(parentElement.tagName) && count <= levelsLimit) { |
| if (parentElement.tagName === 'LI') { |
| |
| |
| |
| parentElement.querySelector('a:first-child').classList.add('active') |
| } |
| parentElement = parentElement.parentElement |
| count++ |
| } |
| } |
| } |
| })() |
| </script> |
| |
| </body> |
| </html> |
