Interface DynamicStateDescriptionProvider

All Known Implementing Classes:

@NonNullByDefault public interface DynamicStateDescriptionProvider
The DynamicStateDescriptionProvider is responsible for providing StateDescription for a Channel dynamically in the runtime. Therefore the provider must be registered as OSGi service.
Pawel Pieczul - Initial contribution
  • Method Details

    • getStateDescription

      @Nullable StateDescription getStateDescription(Channel channel, @Nullable StateDescription originalStateDescription, @Nullable Locale locale)
      For a given Channel, return a StateDescription that should be used for the channel, instead of the one defined statically in the ChannelType. For a particular channel, there should be only one provider of the dynamic state description. When more than one description is provided for the same channel (by different providers), only one will be used, from the provider that registered first. If the given channel will not be managed by the provider null should be returned. You never must return the original state description in such case.
      channel - channel
      originalStateDescription - original state description retrieved from the channel type this is the description to be replaced by the provided one
      locale - locale (can be null)
      state description or null if none provided