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 =
{ '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 }
- 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, resource_mapping = {}, entry_mapping = {}) ⇒ ResourceBuilder
constructor
A new instance of ResourceBuilder.
-
#run ⇒ Object
Starts the parsing process.
-
#try_dynamic_entry(object) ⇒ Object
Automatically converts Entry to DynamicEntry if in cache.
Constructor Details
#initialize(response, resource_mapping = {}, entry_mapping = {}) ⇒ ResourceBuilder
Returns a new instance of ResourceBuilder.
29 30 31 32 33 34 35 36 37 38 |
# File 'lib/contentful/management/resource_builder.rb', line 29 def initialize(response, resource_mapping = {}, entry_mapping = {}) @response = response @client = Contentful::Management::Client.shared_instance @included_resources = {} @known_resources = Hash.new { |h, k| h[k] = {} } @nested_locales = true @default_locale = (client.configuration || Contentful::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.
27 28 29 |
# File 'lib/contentful/management/resource_builder.rb', line 27 def client @client end |
#entry_mapping ⇒ Object (readonly)
Returns the value of attribute entry_mapping.
27 28 29 |
# File 'lib/contentful/management/resource_builder.rb', line 27 def entry_mapping @entry_mapping end |
#resource ⇒ Object (readonly)
Returns the value of attribute resource.
27 28 29 |
# File 'lib/contentful/management/resource_builder.rb', line 27 def resource @resource end |
#resource_mapping ⇒ Object (readonly)
Returns the value of attribute resource_mapping.
27 28 29 |
# File 'lib/contentful/management/resource_builder.rb', line 27 def resource_mapping @resource_mapping end |
#response ⇒ Object (readonly)
Returns the value of attribute response.
27 28 29 |
# File 'lib/contentful/management/resource_builder.rb', line 27 def response @response end |
Instance Method Details
#array_or_sync_page(object) ⇒ Object
Detects if a resource is an Contentful::Array or a SyncPage
117 118 119 120 121 122 123 |
# File 'lib/contentful/management/resource_builder.rb', line 117 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
109 110 111 112 113 114 |
# File 'lib/contentful/management/resource_builder.rb', line 109 def content_type_id_for_entry(object) object['sys'] && object['sys']['contentType'] && object['sys']['contentType']['sys'] && 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
66 67 68 69 70 71 72 73 74 75 76 |
# File 'lib/contentful/management/resource_builder.rb', line 66 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 end |
#create_resource(object) ⇒ Object
Creates a single resource from the response object
79 80 81 82 83 84 85 86 87 88 89 |
# File 'lib/contentful/management/resource_builder.rb', line 79 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
153 154 155 |
# File 'lib/contentful/management/resource_builder.rb', line 153 def default_entry_mapping DEFAULT_ENTRY_MAPPING.dup end |
#default_resource_mapping ⇒ Object
The default mapping for #detect_resource_class
148 149 150 |
# File 'lib/contentful/management/resource_builder.rb', line 148 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
132 133 134 135 136 137 138 139 140 141 142 143 144 145 |
# File 'lib/contentful/management/resource_builder.rb', line 132 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 raise UnparsableResource.new(response) else res_class end end |
#find_entry_class(object) ⇒ Object
Checks in a custom class for an entry was defined in entry_mapping
92 93 94 |
# File 'lib/contentful/management/resource_builder.rb', line 92 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
102 103 104 105 106 |
# File 'lib/contentful/management/resource_builder.rb', line 102 def get_dynamic_entry(object) if content_id = content_type_id_for_entry(object) client.dynamic_entry_cache[content_id.to_sym] end end |
#run ⇒ Object
Starts the parsing process. Either returns an Error, or the parsed Resource
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
# File 'lib/contentful/management/resource_builder.rb', line 42 def run case response.status when :contentful_error Error[response.raw.status].new(response) when :unparsable_json UnparsableJson.new(response) when :not_contentful Error.new(response) else begin create_all_resources! rescue UnparsableResource => error error end end end |
#try_dynamic_entry(object) ⇒ Object
Automatically converts Entry to DynamicEntry if in cache
97 98 99 |
# File 'lib/contentful/management/resource_builder.rb', line 97 def try_dynamic_entry(object) get_dynamic_entry(object) || Contentful::Management::Entry end |