Tour d'horizon du package

Tour d'horizon du package --  Tour d'horizon des classes de Calendar

Tour d'horizon du package

Lorsque vous travaillez avec PEAR::Calendar, il y'a un total de 12 classes (publiques) disponibles pour vous aider à résoudre les problèmes que vous rencontrez. On peut les grouper en classes de dates, dates tabulaires, validation et décorations.

Classes de dates

Elles fournissent une représentation de toutes les unités humaines basiques de dates. Elles héritent toutes de Calendar et fournissent les méthodes définies par la suite :

Classes de Dates Tabulaires

Permet de construire des calendriers au format tabulaire. Ce sont toutes des sous classes de Calendar, elles disposent donc des mêmes méthodes.

Classes de Validation

Permet de valider des dates. Calendar fournit les méthodes isValid() afin de faire une vérification simple sur n'importe quelle date et getValidator() qui renvoie une instance de Calendar_Validator pour une validation plus fine.

Les Décorateurs

Fournit un mécanisme permettant d'ajouter des fonctionnalités aux principaux objets Calendar (les sous classes de Calendar) sans avoir besoin de les étendre (et prendre le risque d'écraser des champs accidentellement). Pour créer un décorateur, vous devez passer un objet Calendar au constructeur. Vous pourrez alors faire des appels au décorateur au lieu de les faire sur l'objet d'origine. Cela vous permettra de réécrire les méthodes de Calendar, ajouter de nouvelles méthodes ou même appliquer des décorateurs multiples au même objet Calendar. Les décorateurs peuvent être injecté (via une sélection ou le décorateur Calendar_Decorator_Wrapper ) dans la boucle générant le calendrier afin de modifier son contenu (pour par exemple convertir des valeurs numériques en textes : 1 -> janvier).

PEAR::Calendar fournit des implémentations de décorateurs afin d'effectuer les tâches communes. Celles-ci ne correspondront pas aux besoins de tous et sont fournies en tant que code optionnel (afin de ne pas détériorer les performances si vous ne les utilisez pas).