Class: JSON::LD::Resource
- Includes:
- RDF::Enumerable
- Defined in:
- vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb
Overview
Simple Ruby reflector class to provide native access to JSON-LD objects
Instance Attribute Summary collapse
-
#attributes ⇒ Hash<String => Object] Object representation of resource
readonly
Hash
Object] Object representation of resource. -
#context ⇒ JSON::LD::Context
readonly
Context associated with this resource.
-
#id ⇒ String
readonly
ID of this resource.
Attributes included from RDF::Enumerable
Instance Method Summary collapse
-
#anonymous? ⇒ Boolean
Anonymous resources have BNode ids or no schema:url.
-
#clean? ⇒ Boolean
Is this resource clean (i.e., saved to mongo?).
-
#deresolve ⇒ Hash
Reverse resolution of resource attributes.
-
#dirty? ⇒ Boolean
Is this resource dirty (i.e., not yet saved to mongo?).
-
#each(&block) ⇒ Object
Enumerate over statements associated with this resource.
-
#hash ⇒ Integer
Return a hash of this object, suitable for use by for ETag.
-
#initialize(node_definition, **options) ⇒ Resource
constructor
A new resource from the parsed graph.
- #inspect ⇒ Object
-
#method_missing(method, *_args) ⇒ Object
Access individual fields, from subject definition.
-
#new? ⇒ Boolean
Is this a new resource, which has not yet been synched or created within the DB?.
-
#property(prop_name) ⇒ Object
Access individual fields, from subject definition.
-
#reconciled? ⇒ Boolean
Has this resource been reconciled against a mongo ID?.
-
#resolve(reference_map) ⇒ Resource
Update node references using the provided map.
-
#resolved? ⇒ Boolean
Has this resource been resolved so that all references are to other Resources?.
-
#save ⇒ Boolean
Override this method to implement save using an appropriate storage mechanism.
-
#stub? ⇒ Boolean
Is this a stub resource, which has not yet been synched or created within the DB?.
-
#to_json(**options) ⇒ String
Serialize to JSON-LD, minus
@context
using a deresolved version of the attributes. - #update_obj(obj, reference_map) ⇒ Object
Methods included from RDF::Enumerable
add_entailment, #canonicalize, #canonicalize!, #dump, #each_graph, #each_object, #each_predicate, #each_quad, #each_statement, #each_subject, #each_term, #each_triple, #entail, #enum_graph, #enum_object, #enum_predicate, #enum_quad, #enum_statement, #enum_subject, #enum_term, #enum_triple, #graph?, #graph_names, #invalid?, #object?, #objects, #predicate?, #predicates, #project_graph, #quad?, #quads, #respond_to_missing?, #statement?, #statements, #subject?, #subjects, #supports?, #term?, #terms, #to_a, #to_h, #to_set, #triple?, #triples, #valid?, #validate!
Methods included from RDF::Util::Aliasing::LateBound
Methods included from RDF::Isomorphic
#bijection_to, #isomorphic_with?
Methods included from RDF::Countable
Constructor Details
#initialize(node_definition, **options) ⇒ Resource
A new resource from the parsed graph
94 95 96 97 98 99 100 101 102 103 104 105 106 107 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 94 def initialize(node_definition, **) @context = [:context] @clean = .fetch(:clean, false) @new = .fetch(:new, true) @reconciled = .fetch(:reconciled, !@new) @resolved = false @attributes = if [:compact] JSON::LD::API.compact(node_definition, @context) else node_definition end @id = @attributes['@id'] @anon = @id.nil? || @id.to_s.start_with?('_:') end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method, *_args) ⇒ Object
Access individual fields, from subject definition
236 237 238 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 236 def method_missing(method, *_args) property(method.to_s) end |
Instance Attribute Details
#attributes ⇒ Hash<String => Object] Object representation of resource (readonly)
Returns Hash
11 12 13 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 11 def attributes @attributes end |
#context ⇒ JSON::LD::Context (readonly)
Returns Context associated with this resource.
17 18 19 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 17 def context @context end |
#id ⇒ String (readonly)
Returns ID of this resource.
14 15 16 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 14 def id @id end |
Instance Method Details
#anonymous? ⇒ Boolean
Anonymous resources have BNode ids or no schema:url
56 57 58 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 56 def anonymous? @anon end |
#clean? ⇒ Boolean
Is this resource clean (i.e., saved to mongo?)
23 24 25 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 23 def clean? @clean end |
#deresolve ⇒ Hash
Reverse resolution of resource attributes.
Just returns attributes
if
resource is unresolved. Otherwise, replaces Resource
values with node references.
Result is expanded and re-compacted to get to normalized representation.
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 126 def deresolve node_definition = if resolved? deresolved = [].tap do |memo| attributes.each_pair do |prop, value| memo[prop] = case value when Resource { 'id' => value.id } when Array value.map do |v| v.is_a?(Resource) ? { 'id' => v.id } : v end else value end end end deresolved else attributes end compacted = nil JSON::LD::API.(node_definition, expandContext: @context) do || compacted = JSON::LD::API.compact(, @context) end compacted.delete_if { |k, _v| k == '@context' } end |
#dirty? ⇒ Boolean
Is this resource dirty (i.e., not yet saved to mongo?)
31 32 33 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 31 def dirty? !clean? end |
#each(&block) ⇒ Object
Enumerate over statements associated with this resource
166 167 168 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 166 def each(&block) JSON::LD::API.toRdf(attributes, expandContext: context, &block) end |
#hash ⇒ Integer
Return a hash of this object, suitable for use by for ETag
112 113 114 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 112 def hash deresolve.hash end |
#inspect ⇒ Object
240 241 242 243 244 245 246 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 240 def inspect "<Resource" + attributes.map do |k, v| "\n #{k}: #{v.inspect}" end.join(" ") + ">" end |
#new? ⇒ Boolean
Is this a new resource, which has not yet been synched or created within the DB?
70 71 72 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 70 def new? !!@new end |
#property(prop_name) ⇒ Object
Access individual fields, from subject definition
230 231 232 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 230 def property(prop_name) @attributes.fetch(prop_name, nil) end |
#reconciled? ⇒ Boolean
Has this resource been reconciled against a mongo ID?
39 40 41 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 39 def reconciled? @reconciled end |
#resolve(reference_map) ⇒ Resource
Update node references using the provided map. This replaces node references with Resources, either stub or instantiated.
Node references with ids not in the reference_map will cause stub resources to be added to the map.
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 180 def resolve(reference_map) return if resolved? def update_obj(obj, reference_map) case obj when Array obj.map { |o| update_obj(o, reference_map) } when Hash if node_reference?(obj) reference_map[obj['id']] ||= Resource.new(obj, context: @context_name, clean: false, stub: true) else obj.each_key do |k| obj[k] = update_obj(obj[k], reference_map) end obj end else obj end end # $logger.debug "resolve(0): #{attributes.inspect}" @attributes.each do |k, _v| next if %w[id type].include?(k) @attributes[k] = update_obj(@attributes[k], reference_map) end # $logger.debug "resolve(1): #{attributes.inspect}" @resolved = true self end |
#resolved? ⇒ Boolean
Has this resource been resolved so that all references are to other Resources?
48 49 50 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 48 def resolved? @resolved end |
#save ⇒ Boolean
Override this method to implement save using an appropriate storage mechanism.
Save the object to the Mongo collection use Upsert to create things that don't exist. First makes sure that the resource is valid.
224 225 226 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 224 def save raise NotImplementedError end |
#stub? ⇒ Boolean
Is this a stub resource, which has not yet been synched or created within the DB?
63 64 65 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 63 def stub? !!@stub end |
#to_json(**options) ⇒ String
Serialize to JSON-LD, minus @context
using
a deresolved version of the attributes
160 161 162 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 160 def to_json(**) deresolve.to_json(**) end |
#update_obj(obj, reference_map) ⇒ Object
183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 |
# File 'vendor/bundler/ruby/3.3.0/bundler/gems/json-ld-f1de87658826/lib/json/ld/resource.rb', line 183 def update_obj(obj, reference_map) case obj when Array obj.map { |o| update_obj(o, reference_map) } when Hash if node_reference?(obj) reference_map[obj['id']] ||= Resource.new(obj, context: @context_name, clean: false, stub: true) else obj.each_key do |k| obj[k] = update_obj(obj[k], reference_map) end obj end else obj end end |