Class: Contentful::Management::ResourceBuilder
- Inherits:
-
Object
- Object
- Contentful::Management::ResourceBuilder
- Defined in:
- lib/contentful/management/resource_builder.rb
Overview
Transforms a Contentful::Response into a Contentful::Resource or a Contentful::Error See example/resource_mapping.rb for avanced usage
Constant Summary collapse
- DEFAULT_RESOURCE_MAPPING =
Default Resource Mapping
{ 'Space' => Contentful::Management::Space, 'ContentType' => Contentful::Management::ContentType, 'Entry' => :find_entry_class, 'Asset' => Contentful::Management::Asset, 'Array' => :array_or_sync_page, 'Link' => Contentful::Management::Link, 'WebhookDefinition' => Contentful::Management::Webhook, 'ApiKey' => Contentful::Management::ApiKey, 'Locale' => Contentful::Management::Locale, 'Role' => Contentful::Management::Role, 'EditorInterface' => Contentful::Management::EditorInterface }
- DEFAULT_ENTRY_MAPPING =
Default Entry Mapping
{}
Instance Attribute Summary collapse
-
#client ⇒ Object
readonly
Returns the value of attribute client.
-
#entry_mapping ⇒ Object
readonly
Returns the value of attribute entry_mapping.
-
#resource ⇒ Object
readonly
Returns the value of attribute resource.
-
#resource_mapping ⇒ Object
readonly
Returns the value of attribute resource_mapping.
-
#response ⇒ Object
readonly
Returns the value of attribute response.
Instance Method Summary collapse
-
#array_or_sync_page(object) ⇒ Object
Detects if a resource is an Contentful::Array or a SyncPage.
-
#content_type_id_for_entry(object) ⇒ Object
Returns the id of the related ContentType, if there is one.
-
#create_all_resources! ⇒ Object
PARSING MECHANISM - raise error if response not valid - look for included objects and parse them to resources - parse main object to resource - replace links in included resources with known resources - replace links in main resource with known resources - return main resource.
-
#create_resource(object) ⇒ Object
Creates a single resource from the response object.
-
#default_entry_mapping ⇒ Object
The default entry mapping.
-
#default_resource_mapping ⇒ Object
The default mapping for #detect_resource_class.
-
#detect_resource_class(object) ⇒ Object
Uses the resource mapping to find the proper Resource class to initialize for this Response object type.
-
#find_entry_class(object) ⇒ Object
Checks in a custom class for an entry was defined in entry_mapping.
-
#get_dynamic_entry(object) ⇒ Object
Finds the proper DynamicEntry class for an entry.
-
#initialize(response, client, resource_mapping = {}, entry_mapping = {}) ⇒ ResourceBuilder
constructor
A new instance of ResourceBuilder.
-
#run ⇒ Contentful::Management::Resource, Contentful::Management::Error
Starts the parsing process.
-
#try_dynamic_entry(object) ⇒ Object
Automatically converts Entry to DynamicEntry if in cache.
Constructor Details
#initialize(response, client, resource_mapping = {}, entry_mapping = {}) ⇒ ResourceBuilder
Returns a new instance of ResourceBuilder.
42 43 44 45 46 47 48 49 50 51 |
# File 'lib/contentful/management/resource_builder.rb', line 42 def initialize(response, client, resource_mapping = {}, entry_mapping = {}) @response = response @client = client @included_resources = {} @known_resources = Hash.new { |hash, key| hash[key] = {} } @nested_locales = true @default_locale = (client.configuration || Contentful::Management::Client::DEFAULT_CONFIGURATION)[:default_locale] @resource_mapping = default_resource_mapping.merge(resource_mapping) @entry_mapping = default_entry_mapping.merge(entry_mapping) end |
Instance Attribute Details
#client ⇒ Object (readonly)
Returns the value of attribute client.
40 41 42 |
# File 'lib/contentful/management/resource_builder.rb', line 40 def client @client end |
#entry_mapping ⇒ Object (readonly)
Returns the value of attribute entry_mapping.
40 41 42 |
# File 'lib/contentful/management/resource_builder.rb', line 40 def entry_mapping @entry_mapping end |
#resource ⇒ Object (readonly)
Returns the value of attribute resource.
40 41 42 |
# File 'lib/contentful/management/resource_builder.rb', line 40 def resource @resource end |
#resource_mapping ⇒ Object (readonly)
Returns the value of attribute resource_mapping.
40 41 42 |
# File 'lib/contentful/management/resource_builder.rb', line 40 def resource_mapping @resource_mapping end |
#response ⇒ Object (readonly)
Returns the value of attribute response.
40 41 42 |
# File 'lib/contentful/management/resource_builder.rb', line 40 def response @response end |
Instance Method Details
#array_or_sync_page(object) ⇒ Object
Detects if a resource is an Contentful::Array or a SyncPage
119 120 121 122 123 124 125 |
# File 'lib/contentful/management/resource_builder.rb', line 119 def array_or_sync_page(object) if object['nextPageUrl'] || object['nextSyncUrl'] SyncPage else Array end end |
#content_type_id_for_entry(object) ⇒ Object
Returns the id of the related ContentType, if there is one
114 115 116 |
# File 'lib/contentful/management/resource_builder.rb', line 114 def content_type_id_for_entry(object) object['sys']['contentType']['sys']['id'] end |
#create_all_resources! ⇒ Object
PARSING MECHANISM
-
raise error if response not valid
-
look for included objects and parse them to resources
-
parse main object to resource
-
replace links in included resources with known resources
-
replace links in main resource with known resources
-
return main resource
70 71 72 73 74 75 76 77 78 79 80 81 82 |
# File 'lib/contentful/management/resource_builder.rb', line 70 def create_all_resources! create_included_resources! response.object['includes'] @resource = create_resource(response.object) unless @included_resources.empty? replace_links_in_included_resources_with_known_resources replace_links_with_known_resources @resource end @resource rescue UnparsableResource => error error end |
#create_resource(object) ⇒ Object
Creates a single resource from the response object
85 86 87 88 89 90 91 92 93 94 95 |
# File 'lib/contentful/management/resource_builder.rb', line 85 def create_resource(object) res_class = detect_resource_class(object) @nested_locales ||= res_class.nested_locale_fields? res = res_class.new(object, response.request, client, @nested_locales, @default_locale) add_to_known_resources res replace_children res, object replace_child_array res.items if res.array? res end |
#default_entry_mapping ⇒ Object
The default entry mapping
154 155 156 |
# File 'lib/contentful/management/resource_builder.rb', line 154 def default_entry_mapping DEFAULT_ENTRY_MAPPING.dup end |
#default_resource_mapping ⇒ Object
The default mapping for #detect_resource_class
149 150 151 |
# File 'lib/contentful/management/resource_builder.rb', line 149 def default_resource_mapping DEFAULT_RESOURCE_MAPPING.dup end |
#detect_resource_class(object) ⇒ Object
Uses the resource mapping to find the proper Resource class to initialize for this Response object type
The mapping value can be a
-
Class
-
Proc: Will be called, expected to return the proper Class
-
Symbol: Will be called as method of the ResourceBuilder itself
134 135 136 137 138 139 140 141 142 143 144 145 146 |
# File 'lib/contentful/management/resource_builder.rb', line 134 def detect_resource_class(object) type = object['sys'] && object['sys']['type'] case res_class = resource_mapping[type] when Symbol public_send(res_class, object) when Proc res_class[object] when nil fail UnparsableResource, response else res_class end end |
#find_entry_class(object) ⇒ Object
Checks in a custom class for an entry was defined in entry_mapping
98 99 100 |
# File 'lib/contentful/management/resource_builder.rb', line 98 def find_entry_class(object) entry_mapping[content_type_id_for_entry(object)] || try_dynamic_entry(object) end |
#get_dynamic_entry(object) ⇒ Object
Finds the proper DynamicEntry class for an entry
108 109 110 111 |
# File 'lib/contentful/management/resource_builder.rb', line 108 def get_dynamic_entry(object) content_id = content_type_id_for_entry(object) client.dynamic_entry_cache[content_id.to_sym] if content_id end |
#run ⇒ Contentful::Management::Resource, Contentful::Management::Error
Starts the parsing process.
55 56 57 58 59 60 61 |
# File 'lib/contentful/management/resource_builder.rb', line 55 def run if response.status == :ok create_all_resources! else response.object end end |
#try_dynamic_entry(object) ⇒ Object
Automatically converts Entry to DynamicEntry if in cache
103 104 105 |
# File 'lib/contentful/management/resource_builder.rb', line 103 def try_dynamic_entry(object) get_dynamic_entry(object) || Contentful::Management::Entry end |