setCommandSecondLevelFieldSchema method

void setCommandSecondLevelFieldSchema(
  1. String? schemaName
)

Setter method that sets the "Field Schema" to be subscribed to through Lightstreamer Server for the second-level items.

It can only be used on COMMAND Subscriptions.
Any call to this method will override any "Field List" or "Field Schema" previously specified for the second-level.
Calling this method enables the two-level behavior:
in synthesis, each time a new key is received on the COMMAND Subscription, the key value is treated as an Item name and an underlying Subscription for this Item is created and subscribed to automatically, to feed fields specified by this method. This mono-item Subscription is specified through an "Item List" containing only the Item name received. As a consequence, all the conditions provided for subscriptions through Item Lists have to be satisfied. The item is subscribed to in "MERGE" mode, with snapshot request and with the same maximum frequency setting as for the first-level items (including the "unfiltered" case). All other Subscription properties are left as the default. When the key is deleted by a DELETE command on the first-level Subscription, the associated second-level Subscription is also unsubscribed from.
Specify null as parameter will disable the two-level behavior.

Lifecycle This method can only be called while the Subscription instance is in its "inactive" state.

Throws IllegalStateException if the Subscription is currently "active".

Throws IllegalStateException if the Subscription mode is not "COMMAND".

  • schemaName A String to be expanded into a field list by the Metadata Adapter.

  • See Subscription.setCommandSecondLevelFields

Implementation

external void setCommandSecondLevelFieldSchema(String? schemaName);