Steve Jobs Project/POS/Documentation:fr

This is a work in progress by User:Trigger. There is an English version of this by User:TheD.

Bonjour à tous!!! Ceci est un essaie de documentation technique de "OpenBravo POS".

Ce tutoriel est réaliser avec l'EDI Netbeans, mais vous êtes libre d'utiliser l'EDI qui vous convient.

Comment telecharger et modifier le code source de OpenBravo POS

Pour toutes informations permettant d'installer et modifier le code source de OpenBravo POS avec l'IDE Netbeans suivez le lien suivant :

• Comment telecharger et modifier le code source de OpenBravo POS?

Comment POS initialise les paramètres de la base de données par défaut?

Lors du lancement de l'application, si elle ne trouve pas de base de données, elle vous notifie de la création automatique d'une base de données par défaut. Dans cette section, nous verrons comment le script initialise la base de données. La section suivante concernera la connexion à la base de données et la création du schéma c'est-à-dire des différentes tables et des contraintes.

La classe responsable de l'initialisation des paramètres de la base de données à utiliser est com.openbravo.pos.forms.AppConfig. Voici, pour une vue générale de cette classe, un diagramme UML simplifier.

La méthode responsable de l'initialisation des parametres de la base de donnée par défaut est loadDefault().

private void loadDefault() {

       m_propsconfig = new Properties();

       String dirname = System.getProperty("dirname.path");
       dirname = dirname == null ? "./" : dirname;

       m_propsconfig.setProperty("db.driverlib", 
         new File(new File(dirname), "lib/derby.jar").getAbsolutePath());
       m_propsconfig.setProperty("db.driver", "org.apache.derby.jdbc.EmbeddedDriver");
       m_propsconfig.setProperty("db.URL", 
         "jdbc:derby:" + new File(new File(System.getProperty("user.home")),
           AppLocal.APP_ID + "-database").getAbsolutePath() + ";create=true");
       m_propsconfig.setProperty("db.user", "");
       m_propsconfig.setProperty("db.password", "");
       ...
}

Pour ceux qui veulent aller plus loin, vous pouvez voir les valeurs de ces variables en utilisant le debugger. Il suffit de placer un breakpoint, lancer le debugger et consulter l'état des différentes variables. Sur ma machine, voici le resultat. Il est important de noter que ce résultat dépend des plateformes utilisées (Windows, Mac, Linux,...).

Vous l'avez certainement remarqué!!! la suite de la méthode a pour but l'initialisation des autres paramètres de configuration de l'application. Une fois les paramètres initialisés, voyons comment le script crée le schéma de la base de données.

Comment POS cré automatiquement la base de données par défaut?

La classe responsable de la création des tables dans la base de données est com.openbravo.pos.forms.JRootApp. La méthode qui nous interesse dans cette classe, initApp, est chargée de créer une session et le schéma de la base de données.

com.openbravo.pos.JRootApp utilise la classe com.openbravo.pos.forms.AppViewConnection pour se connecter à la base de données par la methode getSession(). Ensuite JRootApp appelle la méthode magique!!! à l'interieure de laquelle la création de la base de données sera créée: getBean.

La méthode getBean crée un objet de type com.openbravo.pos.forms.DataLogicAdmin, qui hérite de la classe com.openbravo.pos.forms.BeanFactoryDataSingle, qui à son tour implémente l'interface com.openbravo.pos.forms.BeanFactoryApp, puis appelle la méthode init déclarer dans l'interface BeanFactoryApp. C'est ce dernier appel qui lance la création automatique du schéma de la base de données.

Avant de voir comment se connecter à la base de données via l'IDE Netbeans, je tiens à vous présenter partiellement le contenue de la méthode init de la classe com.openbravo.pos.forms.DataLogicAdmin.

public void init(Session s){
       this.s = s;
        
       m_tpeople = new TableDefinition(s,
           "PEOPLE"
           , new String[] {"ID", "NAME", "APPPASSWORD", "ROLE", "VISIBLE", "CARD", "IMAGE"}
           , new String[] {"ID", AppLocal.getIntString("label.peoplename"), 
                            AppLocal.getIntString("Label.Password"), 
                            AppLocal.getIntString("label.role"), 
                            AppLocal.getIntString("label.peoplevisible"),
                            AppLocal.getIntString("label.card"), 
                            AppLocal.getIntString("label.peopleimage")}
           , new Datas[] {Datas.STRING, Datas.STRING, Datas.STRING, 
                          STRING, Datas.BOOLEAN, Datas.STRING, Datas.IMAGE}
           , new Formats[] {Formats.STRING, Formats.STRING, Formats.STRING, 
                            STRING, Formats.BOOLEAN, Formats.STRING, Formats.NULL}
           , new int[] {0}
       );   
        
       m_troles = new TableDefinition(s,
           "ROLES"
           , new String[] {"ID", "NAME", "PERMISSIONS"}
           , new String[] {"ID", AppLocal.getIntString("Label.Name"), "PERMISSIONS"}
           , new Datas[] {Datas.STRING, Datas.STRING, Datas.BYTES}
           , new Formats[] {Formats.STRING, Formats.STRING, Formats.NULL}
           , new int[] {0}
       );

Dans la suite nous verons comment nous connecter à cette base de données via Netbeans et nous pourrons ainsi avoir une meilleur idées du schéma relationnel...