Class: OpenHAB::Core::Items::GenericItem

Overview

Constant Summary

Constants included from Semantics

Semantics::Equipment, Semantics::Location, Semantics::Point, Semantics::Property, Semantics::Tag

Instance Attribute Summary collapse

• #category ⇒ String

  The item's category.

• #formatted_state ⇒ String readonly

  Format the item's state according to its state description.

• #label ⇒ String

  The item's descriptive label.

• #name ⇒ String readonly

  The item's name.

• #raw_state ⇒ State readonly

  Get the raw item state.

• #state ⇒ State^? readonly

  OpenHAB item state if state is not UNDEF or NULL, nil otherwise.

• #tags ⇒ Array<String>

  The item's tags.

Attributes included from Semantics

#equipment, #equipment_type, #location, #location_type, #point_type, #property_type, #semantic_type

Attributes included from Item

#accepted_command_types, #accepted_data_types, #all_groups, #groups, #metadata

Instance Method Summary collapse

• #command(command) ⇒ self^? (also: #<<)

  Send a command to this item.

• #modify(force: false) { ... } ⇒ Object

  Defers notifying openHAB of modifications to multiple attributes until the block is complete.

• #null? ⇒ true, false

  Check if the item state == NULL.

• #refresh ⇒ Item

  Send the REFRESH command to the item.

• #state? ⇒ true, false

  Check if the item has a state (not UNDEF or NULL).

• #undef? ⇒ true, false

  Check if the item state == UNDEF.

• #update(state) ⇒ self^?

  Send an update to this item.

Methods included from Semantics

add, #equipment?, #location?, lookup, #point?, #points, #semantic?, tags

Methods included from Item

#inspect, #member_of?, #provider, #tagged?, #thing, #things, #to_s

Methods included from Persistence

#all_states_between, #all_states_since, #average_between, #average_since, #changed_between?, #changed_since?, #count_between, #count_since, #count_state_changes_between, #count_state_changes_since, #delta_between, #delta_since, #deviation_between, #deviation_since, #evolution_rate, #historic_state, #last_update, #maximum_between, #maximum_since, #minimum_between, #minimum_since, #persist, #previous_state, #sum_between, #sum_since, #updated_between?, #updated_since?, #variance_between, #variance_since

Methods included from DSL::Items::Ensure::Ensurable

#ensure

260
261
262
263
264
265
266
267
268

# File 'lib/openhab/core/items/generic_item.rb', line 260

def category=(value)
  modify do
    value = value&.to_s
    next if category == value

    @modified = true
    set_category(value)
  end
end

logger.info(Exterior_WindDirection.formatted_state) # => "NE (36°)"

103
104
105

# File 'lib/openhab/core/items/generic_item.rb', line 103

def formatted_state
  GenericItem.item_states_event_builder.get_display_state(self)
end

# File 'lib/openhab/core/items/generic_item.rb', line 66

# File 'lib/openhab/core/items/generic_item.rb', line 62

81

# File 'lib/openhab/core/items/generic_item.rb', line 81

alias_method :raw_state, :state

115
116
117

# File 'lib/openhab/core/items/generic_item.rb', line 115

def state
  raw_state if state?
end

282
283
284
285
286
287
288
289
290
291

# File 'lib/openhab/core/items/generic_item.rb', line 282

def tags=(values)
  modify do
    values = DSL::Items::ItemBuilder.normalize_tags(*values)
    next if values.to_set == tags.to_set

    @modified = true
    remove_all_tags
    add_tags(values)
  end
end

142
143
144
145
146
147

# File 'lib/openhab/core/items/generic_item.rb', line 142

def command(command)
  command = format_command(command)
  logger.trace "Sending Command #{command} to #{name}"
  $events.send_command(self, command)
  Proxy.new(self)
end

MySwitch.modify do
  MySwitch.label = "New Label"
  MySwitch.tags = :labeled
end

221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243

# File 'lib/openhab/core/items/generic_item.rb', line 221

def modify(force: false)
  raise ArgumentError, "you must pass a block to modify" unless block_given?
  return yield if instance_variable_defined?(:@modifying) && @modifying

  begin
    provider = self.provider
    if provider && !provider.is_a?(org.openhab.core.common.registry.ManagedProvider)
      raise FrozenError, "Cannot modify item #{name} from provider #{provider.inspect}." unless force

      provider = nil
      logger.debug("Forcing modifications to non-managed item #{name}")
    end
    @modified = false
    @modifying = true

    r = yield

    provider&.update(self) if @modified
    r
  ensure
    @modifying = false
  end
end

# File 'lib/openhab/core/items/generic_item.rb', line 119

# File 'lib/openhab/core/items/generic_item.rb', line 156

88
89
90

# File 'lib/openhab/core/items/generic_item.rb', line 88

def state?
  !raw_state.is_a?(Types::UnDefType)
end

# File 'lib/openhab/core/items/generic_item.rb', line 123

167
168
169
170
171
172

# File 'lib/openhab/core/items/generic_item.rb', line 167

def update(state)
  state = format_update(state)
  logger.trace "Sending Update #{state} to #{name}"
  $events.post_update(self, state)
  Proxy.new(self)
end