Application Delivery Management

Properties-Default-Sources, construction

La construction properties-default-sources est analogue à la construction parameters-default-sources. Alors que la construction parameters-default-sources permet la réutilisation de paramètres existants (provenant d’autres StyleBooks) dans un StyleBook, la construction properties-default-sources permet à l’utilisateur de spécifier les propriétés d’un composant en fonction de sources existantes.

Les propriétés d’un composant peuvent être réparties dans différentes sections du StyleBook. Par exemple, les propriétés peuvent provenir de paramètres d’objets, de substitutions renvoyant un objet, de propriétés d’autres composants ou de sorties d’autres composants. Dans ce cas, vous devez redéfinir les propriétés qui apparaissent dans d’autres sections du StyleBook dans la définition du composant. Il est clair que cela est redondant et peut entraîner des erreurs. Pour résoudre ce problème, la construction properties-default-sources peut être utilisée. La construction properties-default-sources est une liste dans laquelle chaque élément identifie une source pour certaines propriétés du composant.

Par exemple, considérez un composant qui crée une configuration lbvserver. Ce composant doit définir les propriétés du serveur lbvserver comme suit.

parameters:
  -
    name: lb
    type: ns::lbvserver
components:
  -
    name: lb-comp
    type: ns::lbvserver
    properties:
      name: $parameters.lb.name
      ipv46: $parameters.lb.ipv46
      port: $parameters.lb.port
      servicetype: $parameters.lb.servicetype
      lbmethod: $parameters.lb.lbmethod
<!--NeedCopy-->

Dans l’exemple ci-dessus, observez que les valeurs de toutes les propriétés définies dans la section composants sont extraites de l’objet $parameters.lb. Bien qu’elles soient extraites d’une seule source, les propriétés sont à nouveau définies dans le StyleBook. En outre, si un nouveau sous-paramètre de l’objet $parameters.lb pertinent pour la configuration du lbvserver est ajouté, vous devez mettre à jour le composant lb-comp pour ajouter la nouvelle propriété correspondant au nouveau sous-paramètre.

Pour éviter de redéfinir les propriétés et récupérer toutes les propriétés pertinentes d’un composant sans les énumérer explicitement dans la section propriétés, la construction properties-default-sources peut être utilisée. L’exemple ci-dessus peut être écrit comme suit.

parameters:
  -
    name: lb
    type: ns::lbvserver
components:
  -
    name: lb-comp
    type: ns::lbvserver
    properties-default-sources:
      - $parameters.lb
<!--NeedCopy-->

Dans l’exemple ci-dessus, l’utilisation de la construction properties-default-sources entraîne une réduction de la taille de la définition du composant, ce qui vous permet de définir un composant de manière concise. De plus, chaque fois que la source des propriétés du composant change, les modifications sont reflétées automatiquement. Par exemple, lorsqu’une nouvelle propriété, par exemple « persistencetype », est ajoutée à l’objet $parameters.lb, cette propriété est ajoutée à la configuration de lb-comp par défaut puisque persistencetype est une propriété de lbvserver. Ainsi, la construction properties-default-sources fournit une interface dynamique pour définir les composants sans se soucier des changements qui se produisent dans les sources des propriétés du composant.

Calcul des propriétés du composant

Cette section explique comment les propriétés sont récupérées si la construction properties-default-sources est utilisée dans un composant. Tout d’abord, le compilateur StyleBooks identifie la liste des propriétés d’un composant en fonction de son type (dans l’exemple ci-dessus, lbvserver). Ensuite, le compilateur récupère ces propriétés à partir des multiples sources dans l’ordre dans lequel elles sont définies (dans la section properties-default-sources du composant). Si une propriété existe dans plusieurs sources, la propriété apparaissant dans la dernière source a priorité sur les autres. Enfin, une propriété récupérée à l’aide de la construction properties-default-sources peut être remplacée dans la section propriétés du composant. Il est important de noter que la définition d’une section de composant doit au moins comporter une section properties-default-sources ou une section de propriétés. Il peut avoir les deux.

Properties-Default-Sources, construction