PolicyRule.addAllowedSubject()

Method

Related Forms

PolicyRule.addAllowedSubjects()

Declaration

PolicyRule addAllowedSubject(
    java.lang.String  subject,
    boolean           firstBorder)
  throws ConfigurationException
PolicyRule addAllowedSubjects(
    java.lang.String[]  subjects,
    boolean             firstBorder)
  throws ConfigurationException

Purpose

Update an existing policy rule by adding one or more subjects.

Remarks

This method returns the updated policy rule.

The first form adds only one subject. The second form adds several subjects. (The first form calls the second form with an array of one element.)

If the subject does not already exist in the rule, then the method adds it.

If the subject already exists in the rule, then the method throws a ConfigurationException; the rule and subject remain unchanged.

Parameter

Description

subject

Append a subject to the rule, so the border router forwards that subject.

subjects

Append an array of subjects to the rule, so the border router forwards those subjects.

firstBorder

When true, the rule instructs the border router to forward the new subjects only when a message has not yet crossed another border.

When false, the border router always forwards the new subjects.

This property applies to all the new subjects that this method adds. It does not affect pre-existing subjects.

See Also

BorderRouter.getPolicyRule()

PolicyRule

For the corresponding browser pages and background information, see Border Policy and Border Routing in TIBCO Rendezvous Administration