Class: Qa::Authorities::Getty::TGN

Inherits:
Base
  • Object
show all
Includes:
WebServiceBase
Defined in:
lib/qa/authorities/getty/tgn.rb

Instance Attribute Summary

Attributes included from WebServiceBase

#raw_response

Instance Method Summary collapse

Methods included from WebServiceBase

#get_json, #json, #response

Methods inherited from Base

#all, #full_record

Instance Method Details

#build_query_url(q) ⇒ Object 



9
10
11
12
13
14
 
# File 'lib/qa/authorities/getty/tgn.rb', line 9

def build_query_url(q)
  query = URI.escape(sparql(untaint(q)))
  # Replace ampersands, otherwise the query will fail
  # Gsub hack to convert the encoded regex in the REPLACE into a form Getty understands
  "http://vocab.getty.edu/sparql.json?query=#{query.gsub('&', '%26').gsub(',[%5E,]+,[%5E,]+$', '%2C[^%2C]%2B%2C[^%2C]%2B%24')}&_implicit=false&implicit=true&_equivalent=false&_form=%2Fsparql"
end

#find(id) ⇒ Object 



53
54
55
 
# File 'lib/qa/authorities/getty/tgn.rb', line 53

def find(id)
  json(find_url(id))
end

#find_url(id) ⇒ Object 



57
58
59
 
# File 'lib/qa/authorities/getty/tgn.rb', line 57

def find_url(id)
  "http://vocab.getty.edu/tgn/#{id}.json"
end

#request_options ⇒ Object 



61
62
63
 
# File 'lib/qa/authorities/getty/tgn.rb', line 61

def request_options
  { accept: 'application/sparql-results+json' }
end

#search(q) ⇒ Object 



5
6
7
 
# File 'lib/qa/authorities/getty/tgn.rb', line 5

def search(q)
  parse_authority_response(json(build_query_url(q)))
end

#sparql(q) ⇒ Object

Use a regex to exclude the continent and ‘world’ from the query If only one word is entered only search the name (not the parent string) If more than one word is entered, one word must appear in the name, and all words in either parent or name



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/qa/authorities/getty/tgn.rb', line 19

def sparql(q)
  search = untaint(q)
  if search.include?(' ')
    ex = "(("
    search.split(' ').each do |i|
      ex += "regex(CONCAT(?name, ', ', REPLACE(str(?par), \",[^,]+,[^,]+$\", \"\")), \"#{i}\",\"i\" ) && "
    end
    ex = ex[0..ex.length - 4]
    ex += ') && ('
    search.split(' ').each do |i|
      ex += "regex(?name, \"#{i}\",\"i\" ) || "
    end
    ex = ex[0..ex.length - 4]
    ex += ") )"

  else
    ex = "regex(?name, \"#{search}\", \"i\")"
  end

  # The full text index matches on fields besides the term, so we filter to ensure the match is in the term.
  sparql = "SELECT DISTINCT ?s ?name ?par {
          ?s a skos:Concept; luc:term \"#{search}\";
             skos:inScheme <http://vocab.getty.edu/tgn/> ;
             gvp:prefLabelGVP [skosxl:literalForm ?name] ;
              gvp:parentString ?par .
          FILTER #{ex} .
        } ORDER BY ?name ASC(?par)"
  sparql
end

#untaint(q) ⇒ Object 



49
50
51
 
# File 'lib/qa/authorities/getty/tgn.rb', line 49

def untaint(q)
  q.gsub(/[^\w\s-]/, '')
end