@DoNotImplement
public interface TopicPermissionBuilder

This builder allows to create TopicPermissions that can be used in the extension system.

Since:: 4.0.0, CE 2019.1

Method Summary

Modifier and Type	Method	Description
`@NotNull TopicPermissionBuilder`	`activity(TopicPermission.MqttActivity activity)`	Set an Activity for this `TopicPermission`.
`@NotNull TopicPermission`	`build()`	Builds the `TopicPermission` with the provided values or default values.
`@NotNull TopicPermissionBuilder`	`qos(TopicPermission.Qos qos)`	Set a QoS for this `TopicPermission`.
`@NotNull TopicPermissionBuilder`	`retain(TopicPermission.Retain retain)`	Set a Retain for this `TopicPermission`.
`@NotNull TopicPermissionBuilder`	`sharedGroup(@NotNull String sharedGroup)`	Set a shared group for this `TopicPermission`.
`@NotNull TopicPermissionBuilder`	`sharedSubscription(TopicPermission.SharedSubscription sharedSubscription)`	Set a SharedSubscription for this `TopicPermission`.
`@NotNull TopicPermissionBuilder`	`topicFilter(@NotNull String topicFilter)`	Set a topic filter for this `TopicPermission`.
`@NotNull TopicPermissionBuilder`	`type(TopicPermission.PermissionType type)`	Set a type for this `TopicPermission`.

Method Details
- topicFilter
  
  @NotNull @NotNull TopicPermissionBuilder topicFilter(@NotNull String topicFilter)
  
  Set a topic filter for this TopicPermission.
  This value has no default and must be set.
  
  Parameters:
  
  topicFilter - The topic filter to set.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the topic filter is null.
  
  IllegalArgumentException - If the topic filter is an empty string.
  
  IllegalArgumentException - If the topic filter contains invalid UTF-8 characters.
  
  IllegalArgumentException - If the topic filter is longer than the configured maximum. Default maximum length is 65535.
  
  Since:
  
  4.0.0, CE 2019.1
- type
  
  @NotNull @NotNull TopicPermissionBuilder type(@NotNull TopicPermission.PermissionType type)
  
  Set a type for this TopicPermission.
  DEFAULT: ALLOW.
  
  Parameters:
  
  type - The TopicPermission.PermissionType to use.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the type is null.
  
  Since:
  
  4.0.0, CE 2019.1
- qos
  
  @NotNull @NotNull TopicPermissionBuilder qos(@NotNull TopicPermission.Qos qos)
  
  Set a QoS for this TopicPermission.
  DEFAULT: ALL.
  
  Parameters:
  
  qos - The TopicPermission.Qos to use.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the qos is null.
  
  Since:
  
  4.0.0, CE 2019.1
- activity
  
  @NotNull @NotNull TopicPermissionBuilder activity(@NotNull TopicPermission.MqttActivity activity)
  
  Set an Activity for this TopicPermission.
  DEFAULT: ALL.
  
  Parameters:
  
  activity - The TopicPermission.MqttActivity to use.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the activity is null.
  
  Since:
  
  4.0.0, CE 2019.1
- retain
  
  @NotNull @NotNull TopicPermissionBuilder retain(@NotNull TopicPermission.Retain retain)
  
  Set a Retain for this TopicPermission.
  This value is only used for PUBLISH actions. For SUBSCRIBE actions this value is ignored.
  DEFAULT: ALL.
  
  Parameters:
  
  retain - The TopicPermission.Retain to use.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the retain is null.
  
  Since:
  
  4.0.0, CE 2019.1
- sharedSubscription
  
  @NotNull @NotNull TopicPermissionBuilder sharedSubscription(@NotNull TopicPermission.SharedSubscription sharedSubscription)
  
  Set a SharedSubscription for this TopicPermission.
  This value is only used for SUBSCRIBE actions. For PUBLISH actions this value is ignored.
  DEFAULT: ALL.
  
  Parameters:
  
  sharedSubscription - The TopicPermission.SharedSubscription to use.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the sharedSubscription is null.
  
  Since:
  
  4.0.0, CE 2019.1
- sharedGroup
  
  @NotNull @NotNull TopicPermissionBuilder sharedGroup(@NotNull String sharedGroup)
  Set a shared group for this TopicPermission. The value can be either # which allows all shared group names, or a specific group name must be set.
  This value is only used for SUBSCRIBE actions. For PUBLISH actions this value is ignored. This value is only used when the Subscription's topic filter is a shared subscription. For regular subscriptions this value is ignored.
  DEFAULT: #.
  Limitations for shared group:
  
  Must not be an empty string
  Must not contain a slash '/'
  Must not contain the wildcard '+'
  Must not contain the wildcard '#' if string length is > 1
  Must not contain an invalid UTF-8 character
  Parameters:
  
  sharedGroup - The shared group that can be used, or # to allow any value.
  
  Returns:
  
  The TopicPermissionBuilder.
  
  Throws:
  
  NullPointerException - If the sharedGroup is null.
  
  IllegalArgumentException - If an invalid shared group name is passed.
  
  IllegalArgumentException - If the shared group contains invalid UTF-8 characters.
  
  Since:
  
  4.0.0, CE 2019.1
- build
  
  @NotNull @NotNull TopicPermission build()
  
  Builds the TopicPermission with the provided values or default values.
  
  Returns:
  
  A TopicPermission with the set parameters.
  
  Throws:
  
  NullPointerException - If the topic is null.
  
  Since:
  
  4.0.0, CE 2019.1

Interface TopicPermissionBuilder

Method Summary

Method Details