GeoPubby  Version 0.1.0.0
Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
IRIRewriter Class Referenceabstract

Rewrites IRI in an 1:1 fashion. More...

Inheritance diagram for IRIRewriter:
Inheritance graph
[legend]
Collaboration diagram for IRIRewriter:
Collaboration graph
[legend]

Public Member Functions

abstract String rewrite (String absoluteIRI)
 Rewrites an IRI. More...
 
abstract String unrewrite (String absoluteIRI)
 Rewrites an IRI. More...
 
Property rewrite (Property original)
 
Property unrewrite (Property rewritten)
 
Resource rewrite (Resource original)
 
Resource unrewrite (Resource rewritten)
 
Model rewrite (Model original)
 Rewrites the RDF graph in a Jena model by returning a new in-memory model that contains all statements from the original with any IRIs rewritten. More...
 
Map< Property, Integer > rewrite (Map< Property, Integer > original)
 

Static Public Member Functions

static IRIRewriter createNamespaceBased (final String originalNamespace, final String rewrittenNamespace)
 Creates a new rewriter that rewrites all IRIs starting with a given namespace by replacing that namespace with another namespace. More...
 
static IRIRewriter chain (final IRIRewriter rewriter1, final IRIRewriter rewriter2)
 Creates an IRIRewriter that applies two existing IRIRewriters. More...
 

Static Public Attributes

static final IRIRewriter identity
 The trivial IRI rewriter that returns IRIs unmodified. More...
 

Detailed Description

Rewrites IRI in an 1:1 fashion.

For any syntactically valid IRI x, the following expressions must either be true or throw an IllegalArgumentException:

  • unrewrite(rewrite(x)).equals(x)
  • rewrite(unrewrite(x)).equals(x)

Member Function Documentation

◆ chain()

static IRIRewriter chain ( final IRIRewriter  rewriter1,
final IRIRewriter  rewriter2 
)
static

Creates an IRIRewriter that applies two existing IRIRewriters.

214  {
215  if (rewriter1 == identity) return rewriter2;
216  if (rewriter2 == identity) return rewriter1;
217  return new IRIRewriter() {
218  @Override
219  public String rewrite(String absoluteIRI) {
220  return rewriter2.rewrite(rewriter1.rewrite(absoluteIRI));
221  }
222  @Override
223  public String unrewrite(String absoluteIRI) {
224  return rewriter1.unrewrite(rewriter2.unrewrite(absoluteIRI));
225  }
226  };
227  }
de.fuberlin.wiwiss.pubby.IRIRewriter.rewrite
abstract String rewrite(String absoluteIRI)
Rewrites an IRI.
de.fuberlin.wiwiss.pubby.IRIRewriter.identity
static final IRIRewriter identity
The trivial IRI rewriter that returns IRIs unmodified.
Definition: IRIRewriter.java:31
de.fuberlin.wiwiss.pubby.IRIRewriter.unrewrite
abstract String unrewrite(String absoluteIRI)
Rewrites an IRI.

References IRIRewriter.identity, IRIRewriter.rewrite(), and IRIRewriter.unrewrite().

Referenced by Dataset.buildDataSource().

◆ createNamespaceBased()

static IRIRewriter createNamespaceBased ( final String  originalNamespace,
final String  rewrittenNamespace 
)
static

Creates a new rewriter that rewrites all IRIs starting with a given namespace by replacing that namespace with another namespace.

Any IRIs that don't start with theat namespace are returned unchanged. For example, if original namespace is https://example.com/ and replacement namespace is http://localhost:8080/, then the IRI https://example.com/foo/bar will be rewritten to http://localhost:8080/foo/bar, and the IRI https://foo.example.org/bar will be rewritten to itself as it doesn't start with the original namespace.

Parameters
originalNamespaceThe namespace to be replaced
rewrittenNamespaceThe replacement namespace
Returns
171  {
172  if (originalNamespace.equals(rewrittenNamespace)) {
173  return identity;
174  }
175  if (originalNamespace.startsWith(rewrittenNamespace) ||
176  rewrittenNamespace.startsWith(originalNamespace)) {
177  throw new IllegalArgumentException(
178  "Cannot rewrite overlapping namespaces, " +
179  "this would be ambiguous: " + originalNamespace +
180  " => " + rewrittenNamespace);
181  }
182  return new IRIRewriter() {
183  @Override
184  public String rewrite(String absoluteIRI) {
185  if (absoluteIRI.startsWith(originalNamespace)) {
186  return rewrittenNamespace + absoluteIRI.substring(
187  originalNamespace.length());
188  }
189  if (absoluteIRI.startsWith(rewrittenNamespace)) {
190  throw new IllegalArgumentException(
191  "Can't rewrite already rewritten IRI: " + absoluteIRI);
192  }
193  return absoluteIRI;
194  }
195  @Override
196  public String unrewrite(String absoluteIRI) {
197  if (absoluteIRI.startsWith(rewrittenNamespace)) {
198  return originalNamespace + absoluteIRI.substring(
199  rewrittenNamespace.length());
200  }
201  if (absoluteIRI.startsWith(originalNamespace)) {
202  throw new IllegalArgumentException(
203  "Can't unrewrite IRI that already is in the original namespace: " + absoluteIRI);
204  }
205  return absoluteIRI;
206  }
207  };
208  }

References IRIRewriter.identity, IRIRewriter.rewrite(), and IRIRewriter.unrewrite().

Referenced by Dataset.buildDataSource().

◆ rewrite() [1/5]

Map<Property, Integer> rewrite ( Map< Property, Integer >  original)
146  {
147  if (original == null) return null;
148  Map<Property, Integer> result = new HashMap<Property, Integer>();
149  for (Property p: original.keySet()) {
150  result.put(rewrite(p), original.get(p));
151  }
152  return result;
153  }

References IRIRewriter.rewrite().

◆ rewrite() [2/5]

Model rewrite ( Model  original)

Rewrites the RDF graph in a Jena model by returning a new in-memory model that contains all statements from the original with any IRIs rewritten.

It rewrites IRIs in subject, predicate, and object position. Also rewrites the namespace prefix mappings, if any are present.

Parameters
originalAn RDF graph in Jena model form
Returns
Rewritten version of the graph
122  {
123  Model result = ModelFactory.createDefaultModel();
124  for (String prefix: original.getNsPrefixMap().keySet()) {
125  String uri = original.getNsPrefixURI(prefix);
126  result.setNsPrefix(prefix, rewrite(uri));
127  }
128  StmtIterator it = original.listStatements();
129  while (it.hasNext()) {
130  Statement stmt = it.nextStatement();
131  Resource s = stmt.getSubject();
132  if (s.isURIResource()) {
133  s = result.createResource(rewrite(s.getURI()));
134  }
135  Property p = result.createProperty(
136  rewrite(stmt.getPredicate().getURI()));
137  RDFNode o = stmt.getObject();
138  if (o.isURIResource()) {
139  o = result.createResource(rewrite(o.asResource().getURI()));
140  }
141  result.add(s, p, o);
142  }
143  return result;
144  }

References IRIRewriter.rewrite().

◆ rewrite() [3/5]

Property rewrite ( Property  original)
81  {
82  String rewritten = rewrite(original.getURI());
83  if (rewritten.equals(original.getURI())) {
84  return original;
85  }
86  return ResourceFactory.createProperty(rewritten);
87  }

References IRIRewriter.rewrite().

◆ rewrite() [4/5]

Resource rewrite ( Resource  original)
97  {
98  String rewritten = rewrite(original.getURI());
99  if (rewritten.equals(original.getURI())) {
100  return original;
101  }
102  return ResourceFactory.createResource(rewritten);
103  }

References IRIRewriter.rewrite().

◆ rewrite() [5/5]

abstract String rewrite ( String  absoluteIRI)
abstract

Rewrites an IRI.

Parameters
Anyabsolute IRI
Returns
The rewritten form of the IRI

Reimplemented in PubbyIRIEscaper.

Referenced by IRIRewriter.chain(), IRIRewriter.createNamespaceBased(), RewrittenDataSource.describeResource(), RewrittenDataSource.getHighIndegreeProperties(), RewrittenDataSource.getHighOutdegreeProperties(), RewrittenDataSource.getIndex(), RewrittenDataSource.listPropertyValues(), and IRIRewriter.rewrite().

◆ unrewrite() [1/3]

Property unrewrite ( Property  rewritten)
89  {
90  String original = unrewrite(rewritten.getURI());
91  if (original.equals(rewritten.getURI())) {
92  return rewritten;
93  }
94  return ResourceFactory.createProperty(original);
95  }

References IRIRewriter.unrewrite().

◆ unrewrite() [2/3]

Resource unrewrite ( Resource  rewritten)
105  {
106  String original = unrewrite(rewritten.getURI());
107  if (original.equals(rewritten.getURI())) {
108  return rewritten;
109  }
110  return ResourceFactory.createResource(original);
111  }

References IRIRewriter.unrewrite().

◆ unrewrite() [3/3]

abstract String unrewrite ( String  absoluteIRI)
abstract

Rewrites an IRI.

For any valid IRI,

Parameters
Anyabsolute IRI
Returns
The rewritten form of the IRI

Reimplemented in PubbyIRIEscaper.

Referenced by RewrittenDataSource.addSameAsStatement(), RewrittenDataSource.canDescribe(), IRIRewriter.chain(), IRIRewriter.createNamespaceBased(), RewrittenDataSource.describeResource(), RewrittenDataSource.getHighIndegreeProperties(), RewrittenDataSource.getHighOutdegreeProperties(), RewrittenDataSource.isOriginalIRI(), RewrittenDataSource.listPropertyValues(), and IRIRewriter.unrewrite().

Member Data Documentation

◆ identity

final IRIRewriter identity
static

The trivial IRI rewriter that returns IRIs unmodified.

We override all methods for efficiency.

Referenced by Dataset.buildDataSource(), IRIRewriter.chain(), and IRIRewriter.createNamespaceBased().