Package caseine.publication.producers

Class ToCompareProducer.InstanceAndParameters

java.lang.Object
caseine.publication.producers.ToCompareProducer.InstanceAndParameters
Enclosing class:
ToCompareProducer
public static class ToCompareProducer.InstanceAndParameters extends Object
Pour définir un jeu de tests, c'est-à-dire un ensemble de données, à utiliser lors d'une évaluation qui compare l'exécution de deux méthodes (voir ToCompare)
Author:
Yvan Maillot <yvan.maillot@uha.fr>

La classe @caseine.publication.producers.ToCompareProducer.InstanceAndParameters

Une instance de InstanceAndParameters définit tout ou partie des données suivantes:

Un jeu de tests dépend fortement de la méthode à tester. Les fabriques (method factory) suivantes permettent d'élaborer des jeux de tests dans toutes les situations :

  1. newMessageInputInstanceParams(String message, String input, Object instance, Object... parameters)
  2. newMessageInstanceParams(String message, Object instance, Object... parameters)
  3. newInputInstanceParams(String input, Object instance, Object... parameters)
  4. newInstanceParams(Object instance, Object... parameters)
  5. newMessageInputParamsForStaticMethod(String message, String input, Object... parameters)
  6. newMessageParamsForStaticMethod(String message, Object...parameters)
  7. newInputParamsForStaticMethod(String input, Object...parameters)
  8. newParamsForStaticMethod(Object...parameters)

L'instance créée sera exploitée pour comparer le comportement d'une méthode annotée (celle de l'étudiant) à une méthode référence (celle de l'enseignant).

See Also:

  • Field Details

    • message

      public final String message
      Le message à afficher en cas d'échec de la comparaison (optionnel).

    • input

      public final String input
      Le flux en entrée si la méthode à comparer lit des données sur l'entrée standard (au clavier) (optionnel).

    • instance

      public final Object instance
      L'objet sur lequel s'applique la méthode à comparer (null si elle est déclarée static)

    • parameters

      public final Object[] parameters
      Les arguments de la méthode à comparer.

  • Constructor Details

    • InstanceAndParameters

      public InstanceAndParameters(String message, String input, Object instance, Object... parameters)
      Pour construire tout type de jeux de tests.

      Pas toujours facile à utiliser. Préférer les fabriques aux noms évocateurs pour construire des jeux de tests plus facilement.

      Parameters:
      message - le message si la comparaison échoue.
      input - une chaîne de caractères qui contient les données lues par la méthode comparer.
      instance - l'instance sur laquelle s'applique la méthode à comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.

  • Method Details

    • newMessageInputInstanceParams

      public static ToCompareProducer.InstanceAndParameters newMessageInputInstanceParams(String message, String input, Object instance, Object... parameters)
      Un jeu de tests destiné à une méthode d'instance qui lit des données sur son entrée standard (en général le clavier).
      Parameters:
      message - le message si la comparaison échoue.
      input - une chaîne de caractères qui contient les données lues par la méthode comparer.
      instance - l'instance sur laquelle s'applique la méthode à comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newMessageInstanceParams

      public static ToCompareProducer.InstanceAndParameters newMessageInstanceParams(String message, Object instance, Object... parameters)
      Un jeu de tests destiné à une méthode d'instance.
      Parameters:
      message - le message si la comparaison échoue.
      instance - l'instance sur laquelle s'applique la méthode à comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newMessageInputParamsForStaticMethod

      public static ToCompareProducer.InstanceAndParameters newMessageInputParamsForStaticMethod(String message, String input, Object... parameters)
      Un jeu de tests destiné à une méthode de classe (static) qui lit des données sur son entrée standard (en général le clavier).
      Parameters:
      message - le message si la comparaison échoue.
      input - une chaîne de caractères qui contient les données lues par la méthode comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newInputInstanceParams

      public static ToCompareProducer.InstanceAndParameters newInputInstanceParams(String input, Object instance, Object... parameters)
      Un jeu de tests destiné à une méthode d'instance qui lit des données sur son entrée standard (en général le clavier).

      Un message standard sera généré en cas d'échec de la comparaison.

      Parameters:
      input - une chaîne de caractères qui contient les données lues par la méthode comparer.
      instance - l'instance sur laquelle s'applique la méthode à comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newInstanceParams

      public static ToCompareProducer.InstanceAndParameters newInstanceParams(Object instance, Object... parameters)
      Un jeu de tests destiné à une méthode d'instance.

      Un message standard sera généré en cas d'échec de la comparaison.

      Parameters:
      instance - l'instance sur laquelle s'applique la méthode à comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newMessageParamsForStaticMethod

      public static ToCompareProducer.InstanceAndParameters newMessageParamsForStaticMethod(String message, Object... parameters)
      Un jeu de tests destiné à une méthode de classe (static).
      Parameters:
      message - le message si la comparaison échoue.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newInputParamsForStaticMethod

      public static ToCompareProducer.InstanceAndParameters newInputParamsForStaticMethod(String input, Object... parameters)
      Un jeu de tests destiné à une méthode de classe (static) qui lit des données sur son entrée standard (en général le clavier).

      Un message standard sera généré en cas d'échec de la comparaison.

      Parameters:
      input - une chaîne de caractères qui contient les données lues par la méthode comparer.
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • newParamsForStaticMethod

      public static ToCompareProducer.InstanceAndParameters newParamsForStaticMethod(Object... parameters)
      Un jeu de tests destiné à une méthode de classe (static).

      Un message standard sera généré en cas d'échec de la comparaison.

      Parameters:
      parameters - des arguments requis par la méthode à comparer, en nombre suffisant et de types adéquats.
      Returns:
      une instance qui contient le jeu de tests voulu.

    • toString

      public String toString()
      Une représentation qui résume le jeu de tests.
      Overrides:
      toString in class Object
      Returns:
      Une représentation qui résume le jeu de tests.