Module: Contentful::Management::Resource

Included in:
ApiKey, Array, Asset, ContentType, EditorInterface, Entry, Environment, Field, File, Link, Locale, Location, Organization, PersonalAccessToken, PreviewApiKey, Role, Snapshot, Space, SpaceMembership, UIExtension, Upload, User, Validation, Webhook, WebhookCall, WebhookHealth
Defined in:
lib/contentful/management/resource.rb,
lib/contentful/management/resource/fields.rb,
lib/contentful/management/resource/archiver.rb,
lib/contentful/management/resource/publisher.rb,
lib/contentful/management/resource/refresher.rb,
lib/contentful/management/resource/array_like.rb,
lib/contentful/management/resource/field_aware.rb,
lib/contentful/management/resource/asset_fields.rb,
lib/contentful/management/resource/entry_fields.rb,
lib/contentful/management/resource/all_published.rb,
lib/contentful/management/resource/environment_aware.rb,
lib/contentful/management/resource/system_properties.rb

Overview

Include this module to declare a class to be a contentful resource. This is done by the default in the existing resource classes

You can define your own classes that behave like contentful resources: See examples/custom_classes.rb to see how.

Take a look at examples/resource_mapping.rb on how to register them to be returned by the client by default

See Also:

  • examples/custom_classes.rb Custom Class as Resource
  • examples/resource_mapping.rb Mapping a Custom Class

Defined Under Namespace

Modules: AllPublished, Archiver, ArrayLike, AssetFields, ClassMethods, EntryFields, EnvironmentAware, FieldAware, Fields, Publisher, Refresher, SystemProperties

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#client ⇒ Object

Shared instance of the API client



117
118
119
 
# File 'lib/contentful/management/resource.rb', line 117

def client
  @client
end

#default_locale ⇒ Object (readonly)

rubocop:enable Style/DoubleNegation



30
31
32
 
# File 'lib/contentful/management/resource.rb', line 30

def default_locale
  @default_locale
end

#properties ⇒ Object (readonly)

rubocop:enable Style/DoubleNegation



30
31
32
 
# File 'lib/contentful/management/resource.rb', line 30

def properties
  @properties
end

#raw_object ⇒ Object (readonly)

rubocop:enable Style/DoubleNegation



30
31
32
 
# File 'lib/contentful/management/resource.rb', line 30

def raw_object
  @raw_object
end

#request ⇒ Object (readonly)

rubocop:enable Style/DoubleNegation



30
31
32
 
# File 'lib/contentful/management/resource.rb', line 30

def request
  @request
end

Instance Method Details

#array? ⇒ Boolean

Returns true for resources that behave like an array

Returns:

  • (Boolean) 


95
96
97
 
# File 'lib/contentful/management/resource.rb', line 95

def array?
  false
end

#destroy ⇒ true, Contentful::Management::Error

Destroys a resource.

Returns:



80
81
82
83
84
85
86
 
# File 'lib/contentful/management/resource.rb', line 80

def destroy
  ResourceRequester.new(client, self.class).destroy(
    space_id: space.id,
    environment_id: environment_id,
    resource_id: id
  )
end

#environment_id ⇒ Object

Returns the Environment ID



127
128
129
 
# File 'lib/contentful/management/resource.rb', line 127

def environment_id
  nil
end

#fields ⇒ Object

Resources that don’t include Fields or AssetFields return nil for #fields



112
113
114
 
# File 'lib/contentful/management/resource.rb', line 112

def fields
  nil
end

#nested_locale_fields? ⇒ Boolean

By default, fields come flattened in the current locale. This is different for syncs

Returns:

  • (Boolean) 


100
101
102
103
104
 
# File 'lib/contentful/management/resource.rb', line 100

def nested_locale_fields?
  # rubocop:disable Style/DoubleNegation
  !!@nested_locale_fields
  # rubocop:enable Style/DoubleNegation
end

#resource? ⇒ true

Returns:

  • (true) 


122
123
124
 
# File 'lib/contentful/management/resource.rb', line 122

def resource?
  true
end

#sys ⇒ Object

Resources that don’t include SystemProperties return nil for #sys



107
108
109
 
# File 'lib/contentful/management/resource.rb', line 107

def sys
  nil
end

#update(attributes) ⇒ Contentful::Management::Resource

Updates a resource.

Parameters:

  • attributes (Hash)

Returns:

See Also:

  • README for more information on how to create each resource


64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/contentful/management/resource.rb', line 64

def update(attributes)
  ResourceRequester.new(client, self.class).update(
    self,
    {
      space_id: space.id,
      environment_id: environment_id,
      resource_id: id
    },
    query_attributes(attributes),
    version: sys[:version]
  )
end