Variabile act_location

La variabile act_location è una stringa che identifica l'ubicazione, all'interno della gerarchia di regole di un'espressione.

Dettagli

L'ubicazione è un nome completo che indica la posizione dell'espressione nella gearchia delle regole. Essa è nel formato identifier.identifier...., in cui ogni ricorrenza di identifier è uno dei seguenti:
  • Il valore dell'attributo name per un elemento XML che è nella rispettiva gerarchia.
  • Per gli elementi che ricorrono più volte in un blocco di regole o in una regola e non hanno attributo name: l'elemento XML che contiene l'espressione, seguito da un numero di indice in parentesi. Questo numero di indice indica la posizione dell'espressione all'interno dell'elemento che contiene. Il contatore per l'assegnazione dei numeri di indice inizia con 0 piuttosto che con 1. Di conseguenza, se un elemento è contenuto in un terzo elemento <action>, ad esempio, il numero di indice viene riportato come action[2].
Questi identificatori sono in ordine discendente da un blocco di regole di livello massimo all'elemento di livello minimo dell'elemento che contiene l'espressione.

Esempio di codifica

Il seguente codice ha accesso alla variabile act_lib per ottenere l'ubicazione dell'espressione:
String location = act_lib.getStringVariable(IACTLibrary.LOCATION);

Esempi dell'ubicazione che viene restituita dalla variabile

Di seguito sono riportati esempi dell'ubicazione che viene restituita dalla variabile act_location
ruleBlockA.ruleA.eventSelector[3].filteringPredicate
Questa espressione è contenuta in:
  • Blocco di regole con un valore di attributo name ruleBlockA
  • La regola con un valore di attributo name ruleA
  • Il quarto elemento <eventSelector>
  • L'elemento <filteringPredicate>
ruleBlockA.ruleA.onDetection.action[5]
Questa espressione è contenuta in:
  • Blocco di regole con un valore di attributo name ruleBlockA
  • La regola con un valore di attributo name ruleA
  • Elemento <onDetection>
  • Sesto elemento <action>
ruleBlockA.ruleA.variableA.varInitializer
Questa espressione è contenuta in:
  • Blocco di regole con un valore di attributo name ruleBlockA
  • La regola con un valore di attributo name ruleA
  • Variabile con valore di attributo name variableA
  • Elemento <varInitializer>