Module: JSONAPI::Serializable::Relationship::DSL

Included in:
JSONAPI::Serializable::Relationship
Defined in:
lib/jsonapi/serializable/relationship/dsl.rb

Instance Method Summary collapse

Instance Method Details

#data ⇒ Object

Declare the related resources for this relationship. end

Examples:

data do
  @object.posts
end

Yield Returns:

  • The related resources for this relationship.



13
14
15
16
17
18
19
 
# File 'lib/jsonapi/serializable/relationship/dsl.rb', line 13

def data
  # NOTE(beauby): Lazify computation since it is only needed when
  #   the corresponding relationship is included.
  @_resources_block = proc do
    JSONAPI::Serializable.resources_for(yield, @_exposures, @_class)
  end
end

#link(name, &block) ⇒ Object

Declare a link for this relationship. The properties of the link are set

by providing a block in which the DSL methods of
+JSONAPI::Serializable::Link+ are called.

Examples:

link(:self) do
  "http://api.example.com/users/#{@user.id}/relationships/posts"
end
link(:related) do
  href "http://api.example.com/users/#{@user.id}/posts"
  meta authorization_needed: true
end

Parameters:

  • name (Symbol) —

    The key of the link.

Yield Returns:

  • (Hash, String, nil) —

    The block to compute the value, if any.

See Also:

  • JSONAPI::Serialiable::Link


77
78
79
 
# File 'lib/jsonapi/serializable/relationship/dsl.rb', line 77

def link(name, &block)
  @_links[name] = Link.as_jsonapi(@_exposures, &block)
end

#linkage(options = {}, &block) ⇒ Object #linkage(options = {}) ⇒ Object

Overloads:

  • #linkage(options = {}, &block) ⇒ Object

    Explicitly declare linkage data.

    Examples:

    linkage do
  @object.posts.map { |p| { id: p.id.to_s, type: 'posts' } }
end

    Yield Returns:

    • The resource linkage.

  • #linkage(options = {}) ⇒ Object

    Forces standard linkage even if relationship not included.

    Examples:

    linkage always: true


35
36
37
38
 
# File 'lib/jsonapi/serializable/relationship/dsl.rb', line 35

def linkage(always: false, &block)
  @_include_linkage = always
  @_linkage_block = block
end

#meta(value) ⇒ Object #meta(&block) ⇒ Object

Overloads:

  • #meta(value) ⇒ Object

    Declare the meta information for this relationship.

    Examples:

    meta paginated: true

    Parameters:

    • value (Hash) —

      The meta information hash.

  • #meta(&block) ⇒ Object

    Declare the meta information for this relationship.

    Examples:

    meta do
  { paginated: true }
end

    Yield Returns:

    • (Hash) —

      The meta information hash.



55
56
57
 
# File 'lib/jsonapi/serializable/relationship/dsl.rb', line 55

def meta(value = nil)
  @_meta = value || yield
end