Expressions
L'une des fonctionnalités les plus puissantes d'un StyleBook est l'utilisation d'expressions. Vous pouvez utiliser les expressions StyleBooks dans divers scénarios pour calculer des valeurs dynamiques. L'exemple suivant est une expression permettant de concaténer une valeur de paramètre avec une chaîne littérale.
Exemple :
$parameters.appname + "-mon"
Cette expression récupère le paramètre nommé
appname et le concatène avec la chaîne -mon.
Les types d'expressions suivants sont pris en charge :
Expressions arithmétiques
-
Addition (+)
-
Soustraction (-)
-
Multiplication (*)
-
Division (/)
-
Modulo (%)
Exemples :
-
Ajout de deux nombres : $parameters.a + $parameters.b
-
Multiplication de deux nombres : $parameters.a * 10
-
Recherche du reste après la division d'un nombre par un autre :
15%10 Donne 5
Expressions de chaîne
-
Concaténer deux chaînes (+)
Exemple :
Concaténer deux chaînes : str("app-") + $parameters.appname
Expressions de liste
Fusionne deux listes (+)
Exemple :
Expressions relationnelles
-
== : Teste si deux opérandes sont égaux et renvoie vrai s'ils sont égaux, sinon renvoie faux.
-
!= : Teste si deux opérandes sont différents et renvoie vrai s'ils sont différents, sinon renvoie faux.
-
\> : Renvoie vrai si le premier opérande est supérieur au second opérande, sinon renvoie faux.
-
\>= : Renvoie vrai si le premier opérande est supérieur ou égal au second opérande, sinon renvoie faux.
-
\< : Retourne vrai si le premier opérande est inférieur au second opérande, sinon retourne faux.
-
\<= : Retourne vrai si le premier opérande est inférieur ou égal au second opérande, sinon retourne faux.
Exemple :
-
Utilisation de l'opérateur d'égalité :
$parameters.name = = "abcd" -
Utilisation de l'opérateur d'inégalité :
$parameters.name != "default" -
Exemples pour d'autres opérateurs relationnels
-
10 > 9
-
10 >= 10
-
0 < 9
-
10 <= 9
-
10 == 10
-
10 != 1
-
Expressions logiques - booléennes
-
et : L'opérateur logique 'et'. Si les deux opérandes sont vrais, le résultat est vrai, sinon il est faux.
-
ou : L'opérateur logique 'ou'. Si l'un des opérandes est vrai, le résultat est vrai, sinon il est faux.
-
not : L'opérateur unaire. Si l'opérande est vraie, le résultat est faux, et inversement.
-
in : Teste si le premier argument est une sous-chaîne du second argument.
-
in : Teste si un élément fait partie d'une liste.
Remarque
Vous pouvez convertir le type des expressions où les chaînes sont converties en nombres et les nombres en chaînes. De même, vous pouvez convertir
tcp-port en nombre, et une adresse IP peut être convertie en chaîne.
Utilisez un délimiteur avant et après tout opérateur. Vous pouvez utiliser les délimiteurs suivants :
-
Avant un opérateur :
space,tab,comma,(,),[,] -
Après un opérateur :
space,tab,(,[
Par exemple :
-
abc + def -
100 % 10 -
10 > 9
Expressions de chaîne littérales
Vous pouvez utiliser des chaînes littérales lorsque des caractères spéciaux dans une chaîne doivent prendre leur forme littérale. Ces chaînes peuvent contenir des caractères d'échappement, des barres obliques inverses, des guillemets, des parenthèses, des espaces, des crochets, etc. Dans les chaînes littérales, l'interprétation habituelle des caractères spéciaux est ignorée. Tous les caractères de la chaîne sont conservés dans leur forme littérale.
Dans les StyleBooks, vous pouvez inclure des expressions de stratégie NetScaler dans leur forme littérale en utilisant des chaînes littérales. Les expressions de stratégie contiennent généralement des caractères spéciaux. Sans les chaînes littérales, vous devez échapper les caractères spéciaux en divisant les chaînes en sous-chaînes.
Pour créer une chaîne textuelle, encapsulez une chaîne entre des caractères spéciaux comme suit :
~{string}~
Vous pouvez utiliser des chaînes textuelles n’importe où dans le StyleBook.
Remarque
N’utilisez pas la séquence de caractères
}~ dans une chaîne d’entrée, car cette séquence indique la fin d’une chaîne textuelle.
Exemple :
~{HTTP.REQ.COOKIE.VALUE("jsessionid") ALT HTTP.REQ.URL.BEFORE_STR("=").AFTER_STR(";jsessionid=") ALT HTTP.REQ.URL.AFTER_STR(";jsessionid=")}~
Expressions cibles
Dans une définition StyleBook, vous pouvez utiliser l’expression
$current-target pour faire référence à l’instance ADC cible actuelle. Pour faire spécifiquement référence à l’adresse IP de l’instance ADC cible, utilisez cette expression comme suit :
$current-target.ip
Exemple :
components:
-
name: lb-comp
type: ns::lbvserver
properties:
name: $current-target.ip + "-lbvserver"
Dans cet exemple, le nom du
lbvserver est construit avec l’adresse IP de l’instance ADC cible.
Validation du type d’expression
Le moteur StyleBook permet une vérification de type plus stricte au moment de la compilation, c’est-à-dire que les expressions utilisées lors de l’écriture du StyleBook sont validées lors de l’importation du StyleBook lui-même plutôt que lors de la création du pack de configuration.
Toutes les références aux paramètres, substitutions, composants, propriétés des composants, sorties des composants, variables définies par l’utilisateur (repeat-item, repeat-index, arguments aux fonctions de substitution), etc., sont toutes validées pour leur existence et leurs types.
Exemple de vérifications de type :
Dans l’exemple suivant, le type attendu de la propriété de port du StyleBook
lbvserver est tcp-port. Dans NetScaler Application Delivery Management (ADM), les validations de type se produisent au moment de la compilation (importation). Le compilateur constate que la chaîne et tcp-port ne sont pas des types compatibles et, par conséquent, le compilateur StyleBook affiche une erreur et ne parvient pas à importer ou à migrer un StyleBook.
components:
-
name: lbvserver-comp
type: ns::lbvserver
properties:
name: mylb
ipv46: 10.102.190.15
port: str("80")
servicetype: HTTP
Pour compiler ce StyleBook avec succès, déclarez ce qui suit comme un nombre dans le compilateur :
port: 80
Exemple de signalisation d'expressions invalides :
Dans les versions précédentes, lorsqu'une expression invalide était attribuée à un nom de propriété, le compilateur ne détectait pas les expressions invalides et permettait l'importation des StyleBooks dans NetScaler® ADM. Maintenant, si ce StyleBook est importé dans NetScaler ADM, le compilateur identifie ces expressions invalides et les signale. Par conséquent, l'importation du StyleBook dans NetScaler ADM échoue.
Dans cet exemple, l'expression attribuée à la propriété de nom dans le composant
lb-sg-binding-comp est : $components.lbvserver-comp.properties.lbvservername. Cependant, il n'y a pas de propriété appelée lbvservername dans le composant lbvserver-comp. Dans les versions précédentes de NetScaler ADM, le compilateur aurait autorisé cette expression et l'aurait importée avec succès. L'échec réel se produirait lorsqu'un utilisateur voudrait créer un pack de configuration à l'aide de ce StyleBook. Cependant, maintenant, ce type d'erreur est identifié lors de l'importation et le StyleBook n'est pas importé dans NetScaler ADM. Corrigez manuellement ces erreurs et importez les StyleBooks.
Components:
-
name: lbvserver-comp
type: ns::lbvserver
properties:
name: mylb
ipv46: 10.102.190.15
port: 80
servicetype: HTTP
-
name: sg-comp
type: ns::servicegroup
properties:
servicegroupname: mysg
servicetype: HTTP
-
name: lb-sg-binding-comp
type: ns::lbvserver_servicegroup_binding
condition: $parameters.create-binding
properties:
name: $components.lbvserver-comp.properties.lbvservername
servicegroupname: $components.sg-comp.properties.servicegroupname
Indexation des listes
Les éléments d'une liste peuvent maintenant être accédés en les indexant directement :
| Expression | Description |
$components.test-lbs[0] |
Fait référence au premier élément du composant test-lbs |
$components.test-lbs[0].properties.p1 |
Fait référence à la propriété p1 du premier élément du composant test-lbs |
$components.lbcomps[0].outputs.servicegroups[1].properties.servicegroupname |
Fait référence à la propriété servicegroupname du deuxième élément du composant servicegroups, qui est une sortie du premier élément du composant lbcomps |