Outils de Développement

• Obtenir le code via Git
• Développer avec le Code JMRI
• Git FAQs
• Construire avec:
  • Ant
  • NetBeans
  • Eclipse
  • IntelliJ IDEA

Structure du Code

• Introduction
• Application Structure
• Noms et Désignation
• Modèles de Structure du code
• Structure Swing
• Structure de Connexion Externe
• Liens
• Utilisation de XML
  • XML Schema
  • XSLT Formatting
• Site Web
• Javadocs
  • Index des Noms
  • Paquets
  • Hiérarchie des Classes

Techniques et Standards

• Pratiques Recommandées
• Intégration Continue
• Internationalisation
• Connexion & Gestion des erreurs
• Test Unitaire avec JUnit
• Documentation avec JavaDoc et UML
• Exécutez l'outil d'analyse statistique SpotBugs
• Fournir de l'aide avec Java
• Méthode Nom Portable
• XML Persistance

Comment Faire

• Etendre avec des Plugins
• Ajouter un Nouveau Type
• Ajouter un Nouveau Système

Infos Fonctionnelles

• Rétrosignalisation Aiguillage
• Connexions Réseau
• Comment les Scripts de Démarrage travaillent

Contexte Infos

• Technologie Roadmap
• Enquête sur les Capacités de JVM
• Sondage Utilisateur, Printemps 2007

Système d'Aide JMRI

Des pages marqué *) sont en Anglais.

Faites un don à JMRI.org

JMRI: Comment faire pour utiliser le Rapport

Cette page fournit un peu d'information sur la façon dont JMRI enregistre les erreur, l'état et les informations de débogage.

Pour d'autres détails internes sur JMRI , s'il vous plaît voir les pages techniques.

JMRI utilise le paquet Jakarta Log4J pour gérer les enregistrements depuis les classes individuelles. spécifiquement, depuis l'été 2015, nous utilisons la version 1.2.15; ce n'est pas la plus récente! nous l'utilisons via le système: SLF4J. ( Pour les librairies qui utilisent le systèm" java.util.loggind, exemple: jmDNS, nous utilisons ausssi l'adaptateur jul-to-slf4j )

Niveaux d'Enregistrement

Cette combinaisons fournit plusieurs niveaux d'enegistrement

Niveau	Fragment Code	Utilisation
ERREUR	log.error(..)	Indique que l'opération désirée n'a pas réussi et et devrait expliquer pourquoi. ERROR est destinée à être utilisé uniquement pour les graves problèmes qui demandent plus d'attention à chaque fois qu'ils surviennent, typiquement indication d'une possible faute dans JMRI lui-même.
ATTENTION	log.warn(..)	Le programme fonctionne toujours, en quelque sorte, mais quelque chose a mal fonctionné; souvent utilisé pour dire "Cette opération peut ne pas avoir fait tout ce que vous vouliez". Utilisez WARN lorsque la cause du problème est une entrée utilisateur incorrecte.
INFO	log.info(..)	Routines messages que vous voulez voir en fonctionnement normal. Gardez les à un minimum s'il vous plaît, il ne devrait pas y en avoir après que le programme a démarré.
DEBOGAGE	log.debug(..)	Messages détaillés, Utilisés seulement pout le débogage. Il y en a beaucoup , et les activer tous peut ralentir le programme de manière significative.
TRACE	log.debug(..)	Messages très détaillés, plus encore que DEBUG, utilisé pour le débogage volumineux (exemple: tous les caractères dans une transmissions) qui devrait normalement être désactivé, même lors du débogage. Typiquement seulement allumé pour une classe à la fois en raison de problèmes de volume et de performance.

Configuration

Par convention, les applications JMRI attendront pour initialiser Log4J utilisant le fichier de contrôle de connexion: "default_lcf.xml" JMRI qui contient une version du fichier defaut_lcf.xml avec de nombreux commentaires. ( Ce fichier doit être impérativement dans le "Répertoire Program", qui peut être trouvé en sélectionnant l'élémment "Emplacement" dans le menu Aide principal )

Un exemple de ce format par défaut:

2015-10-28 20:31:52,307 jmri.jmrit.powerpanel.PowerPane  WARN - No power manager instance found, panel not active [AWT-EventQueue-0]

Les colonnes sont:

• 2015-10-28 20:31:52,307 - Heure locale à laquelle le message a été enregistré
• jmri.jmrit.powerpanel.PowerPane - l'emplacement dans le code ( nom de la classe ) qui a émit le message.
• WARN - sévérité du message
• No power manager instance found, panel not active - le message lui-même.
• [AWT-EventQueue-0] - nom de la tâche qui a émit le message.

Codage

Pour enregistrer des messages à partir d'une classe nommée MyClass, ajoutez à la fin du fichier de classe .java:

        private static final Logger log = LoggerFactory.getLogger(MyClass.class);

et ajoutez des importations pour org.slf4j.Logger et org.slf4j.LoggerFactory dans votre section importation:

import org.slf4j.Logger;
import org.slf4j.LoggerFactory; Il est également OK de combiner ceux-ci suivant cette forme :

    private static final org.slf4j.Logger log = org.slf4j.LoggerFactory.getLogger(MyClass.class);

(Si l'enregistrement est retiré (par exemple commenté), il est OK pour commenter la définition de l'enregistrement de sorte qu'il peut être facilement rajouté plus tard. )

Pour chaque message à enregistrer, inserez une ligne comme;

        log.debug("message");

Les messages qui ne sont pas juste une chaîne explicites doivent utiliser cette forme à la place des variables:

        log.debug("Found {}", numberEntries);

Les opérations de chaîne pour construire le message réel d'erreur (dans ce cas, la combinaison "Found" et l'argument numberEntries) ne sont fait que si le message va être stocké dans les journaux, ce qui permet d'économiser beaucoup de temps lors de l'exécution normale (non-debug ) .

Si c'est informatiquement coûteux de passer un paramètre dans le journal, utilisez le formulaire ci-dessous pour que le programme ne perde pas de temps en calcul de paramètres (dans ce cas, appeler numberEntries () pour obtenir une valeur pour passer à l'appel de fonction):

        if (log.isDebugEnabled()) {
            log.debug("Found {}", numberEntries());
        }

Les exceptions devraient être enregistrées comme:

        log.error("my local text"+exception.getLocalizedMessage(), exception);

pour inclure la description lisible de l'utilisateur depuis l'exception elle-même, ainsi que toutes ses informations de retraçage.

DEBUG	log.debug(..)	Messages détaillés, utilisé dans le débogage
INFO	log.info(..)	Messages de routine que vous pouvez voir en fonctionnement normal
WARN	log.warn(..)	Le programme est encore en exploitation, en quelque sorte, mais quelque chose doit être examiné
ERROR	log.error(..)	Indique que l'opération souhaitée ne va pas se produire, et explique pourquoi

---