Class: Houston::Notification

Inherits:
Object
  • Object
show all
Defined in:
lib/houston/notification.rb

Defined Under Namespace

Classes: APNSError

Constant Summary collapse

MAXIMUM_PAYLOAD_SIZE =
2048

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Notification

Returns a new instance of Notification


39
40
41
42
43
44
45
46
47
48
49
50
51
# File 'lib/houston/notification.rb', line 39

def initialize(options = {})
  @token = options.delete(:token) || options.delete(:device)
  @alert = options.delete(:alert)
  @badge = options.delete(:badge)
  @sound = options.delete(:sound)
  @category = options.delete(:category)
  @expiry = options.delete(:expiry)
  @id = options.delete(:id)
  @priority = options.delete(:priority)
  @content_available = options.delete(:content_available)

  @custom_data = options
end

Instance Attribute Details

#alertObject

Returns the value of attribute alert


32
33
34
# File 'lib/houston/notification.rb', line 32

def alert
  @alert
end

#apns_error_code=(value) ⇒ Object (writeonly)

Sets the attribute apns_error_code

Parameters:

  • value

    the value to set the attribute apns_error_code to.


34
35
36
# File 'lib/houston/notification.rb', line 34

def apns_error_code=(value)
  @apns_error_code = value
end

#badgeObject

Returns the value of attribute badge


32
33
34
# File 'lib/houston/notification.rb', line 32

def badge
  @badge
end

#categoryObject

Returns the value of attribute category


32
33
34
# File 'lib/houston/notification.rb', line 32

def category
  @category
end

#content_availableObject

Returns the value of attribute content_available


32
33
34
# File 'lib/houston/notification.rb', line 32

def content_available
  @content_available
end

#custom_dataObject

Returns the value of attribute custom_data


32
33
34
# File 'lib/houston/notification.rb', line 32

def custom_data
  @custom_data
end

#expiryObject

Returns the value of attribute expiry


32
33
34
# File 'lib/houston/notification.rb', line 32

def expiry
  @expiry
end

#idObject

Returns the value of attribute id


32
33
34
# File 'lib/houston/notification.rb', line 32

def id
  @id
end

#priorityObject

Returns the value of attribute priority


32
33
34
# File 'lib/houston/notification.rb', line 32

def priority
  @priority
end

#sent_atObject (readonly)

Returns the value of attribute sent_at


33
34
35
# File 'lib/houston/notification.rb', line 33

def sent_at
  @sent_at
end

#soundObject

Returns the value of attribute sound


32
33
34
# File 'lib/houston/notification.rb', line 32

def sound
  @sound
end

#tokenObject Also known as: device

Returns the value of attribute token


32
33
34
# File 'lib/houston/notification.rb', line 32

def token
  @token
end

Instance Method Details

#errorObject


91
92
93
# File 'lib/houston/notification.rb', line 91

def error
  APNSError.new(@apns_error_code) if @apns_error_code and @apns_error_code.nonzero?
end

#mark_as_sent!Object


75
76
77
# File 'lib/houston/notification.rb', line 75

def mark_as_sent!
  @sent_at = Time.now
end

#mark_as_unsent!Object


79
80
81
# File 'lib/houston/notification.rb', line 79

def mark_as_unsent!
  @sent_at = nil
end

#messageObject


66
67
68
69
70
71
72
73
# File 'lib/houston/notification.rb', line 66

def message
  data = [device_token_item,
          payload_item,
          identifier_item,
          expiration_item,
          priority_item].compact.join
  [2, data.bytes.count, data].pack('cNa*')
end

#payloadObject


53
54
55
56
57
58
59
60
61
62
63
64
# File 'lib/houston/notification.rb', line 53

def payload
  json = {}.merge(@custom_data || {}).inject({}){|h,(k,v)| h[k.to_s] = v; h}

  json['aps'] ||= {}
  json['aps']['alert'] = @alert if @alert
  json['aps']['badge'] = @badge.to_i rescue 0 if @badge
  json['aps']['sound'] = @sound if @sound
  json['aps']['category'] = @category if @category
  json['aps']['content-available'] = 1 if @content_available

  json
end

#sent?Boolean

Returns:

  • (Boolean)

83
84
85
# File 'lib/houston/notification.rb', line 83

def sent?
  !!@sent_at
end

#valid?Boolean

Returns:

  • (Boolean)

87
88
89
# File 'lib/houston/notification.rb', line 87

def valid?
  payload.to_json.bytesize <= MAXIMUM_PAYLOAD_SIZE
end