Usage of the "*" wildcard is allowed in the path argument of this method as a convenience feature. The wildcard can be used in either or both path fragments, but only at the end of the fragments. The semantics of the wildcard is that it stands for any matching {@code StatusVariable} at thetime of the method call, it does not affect the event sending status of {@code StatusVariable}s which are not yet registered. As an example, when the {@code switchEvents("MyMonitorable/*", false)} method is executed,event sending from all {@code StatusVariables} of the MyMonitorableservice are switched off. However, if the MyMonitorable service starts to publish a new {@code StatusVariable} later, it's event sending status ison by default. @param path the identifier of the {@code StatusVariable}(s) in [Monitorable_id]/[StatusVariable_id] format, possibly with the "*" wildcard at the end of either path fragment @param on {@code false} if event sending should be switched off,{@code true} if it should be switched on for the given path @throws java.lang.SecurityException if the caller does not hold{@code MonitorPermission} with the {@code switchevents} action orif there is any {@code StatusVariable} in the {@code path} fieldfor which it is not allowed to switch event sending on or off as per the target field of the permission @throws java.lang.IllegalArgumentException if {@code path} is{@code null} or otherwise invalid, or points to a non-existing{@code StatusVariable}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|