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

#alert ⇒ Object

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

#badge ⇒ Object

Returns the value of attribute badge.



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

def badge
  @badge
end

#category ⇒ Object

Returns the value of attribute category.



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

def category
  @category
end

#content_available ⇒ Object

Returns the value of attribute content_available.



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

def content_available
  @content_available
end

#custom_data ⇒ Object

Returns the value of attribute custom_data.



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

def custom_data
  @custom_data
end

#expiry ⇒ Object

Returns the value of attribute expiry.



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

def expiry
  @expiry
end

#id ⇒ Object

Returns the value of attribute id.



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

def id
  @id
end

#priority ⇒ Object

Returns the value of attribute priority.



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

def priority
  @priority
end

#sent_at ⇒ Object (readonly)

Returns the value of attribute sent_at.



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

def sent_at
  @sent_at
end

#sound ⇒ Object

Returns the value of attribute sound.



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

def sound
  @sound
end

#token ⇒ Object 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

#error ⇒ Object 



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

#message ⇒ Object 



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

#payload ⇒ Object 



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