* PIP.java * * Created on 15 août 2003, 10:53 Copyright (C) 2003 René BEDDOK * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. *******************************************************************************/ PIP Est un programme écrit en Java d'aide à l'utilisation de la CCAM. Il à été développé avec l'atelier java opensource netbeans 3.51 (http://www.netbeans.org) Ce programme est diffusé sous licence GPL, vous pouvez l'utiliser, le modifier et le diffuser librement dans le respect de la licence GPL qui l'accompagne. Il s'agit de la 2ème version diffusée, ce logiciel est encore incomplet je vous encourage à me faire parvenir vos remarques et corrections, améliorations par email, à : openccam ch-cahors fr. La dernière version est disponible sur http://openccam.free.fr que je vous encourage à consulter régulièrement. Le programme PIP proprement dit est un programme client qui communique une base de donnée CCAM. Développé en Java il peut être utilisé avec toute base de données relationnelle pourvue d'un Driver JDBC. * Base de données supportées : En principe toute base de donnée possédant un driver JDBC (voire ODBC en utilisant le driver sun.jdbc.odbc.JdbcOdbcDriver) - Le développement initial à été fait avec une base de donnée MySQL (http://www.mysql.com), qui est la configuration donnant les meilleures performances et donc préconisée. un script sql de création de la base sous mysql est disponible. Pour la plateforme Windows,pour les utilisateurs ne désirant pas faire une installation complète de MySQL, une Base MySQL Minimale préconfigurée est livrée comprenant : . Les exécutables minimum pour faire fonctionner MySQL (mysqld.exe : Daemon MySQL , mysqladmin : administration) . Les fichiers de configurations . Les Fichiers de données . 2 Utilisateurs préparamétrés : -> ccam, mot de passe ccam utilisé par PIP -> root, mot de passe ccam utilisable pour l'administration de la base. . Les raccourcis mysql_start et mysql_stop permettent le démarrage et l'arrêt de MySQL . Le Raccourci PIP_MySQL : enchaîne le Démarrage de MySQL, le lancement de PIP, l'arrêt de MySQL . Dans PIP Le Menu MySQL permet d'arrêter et redémarrer la base (il dépend des raccourcis ci-dessus - mysql_start, mysql_stop - qui ne doivent pas être déplacés et éventuellement adaptés en fonction de l'installation de mysql ) - Dans le cadre d'une utilisation monoposte le logiciel a été également testé avec Microsoft ACCESS et une base CCAM sous Access est livrée. - Pour ceux qui souhaite une solution facile à installer et totalement opensource, la base de données java hsqldb est utilisable, mais les performances sont, dans mon expérience, relativement médiocres (en tout cas sur un PIII 500Mhz) * Environnement : - Tous système supportant une machine virtuelle java (Unix,Linux, Mac OS, Windows) - Il vous faut avoir installé au préalable Java (JRE 1.3 ou supérieure) : http://www.javasoft.com/ * Fichiers livrés Répertoire PIP : ---> pip.bat : Script pour lancer le programme sous windows ---> pip.sh : Script pour lancer le programme sous Unix ---> fichier PIP.jar : Archive jar contenant le programme PIP et le Driver JDBC pour MySQL ---> fichier PIP_HSQLDB.jar : Archive jar contenant le programme PIP ,le Driver JDBC pour MySQL et la base de données HSQLDB ---> ccam.mdb : Base Microsoft Access contenant la CCAM ---> fichier pip.ini : fichier de paramétrage permettant de sélectionnée la source de donnée JDBC ---> fichier licence.txt : licence GPL ---> fichier lisezmoi.txt ---> fichier releases_notes ---> Répertoire hsqldb : contient les fichiers de la base CCAM au format hsqldb -----------------------> ccam.script -----------------------> ccam.backup -----------------------> ccam.data -----------------------> ccam.properties ---> Répertoire source : contient les sources du programme : -----------------------> PIP.java : source java -----------------------> PIP.form : source xml de l'interface graphique ---> Répertoire sql : Contient les scripts sql de création de la structure de la base pour MySQL, HSQLDB. ---> Répertoire mysql : contient les exécutables et les données pour MySQL -----------------------> mysqld -----------------------> mysqladmin -----------------------> Répertoire data : les tables de données -----------------------------------------> Répertoire mysql : Tables internes à MySQL -----------------------------------------> Répertoire ccam : Tables de la CCAM * configuration : la base de donnée utilisée est indiquée dans le fichier pip.ini ce fichier doit se trouver dans le répertoire ou on lance le programme: + à partir de la version 0.6 le format change il n'est plus nécessaire d'éditer manuellement ce fichier : (Remarque l'ancien format est toujour utilisable, mais sera le fichier sera transformé au nouveau format lors de tout enregistrement) - La première ligne doit être !!V1!! - Chaque source de donnée est décrite par 3 lignes : -- le nom -- le driver JDBC -- la chaine de connexion sous la forme : url,user,password ex : - pour une base Mysql sur la même machine , avec user = ccam et password= ccam : Mysql sur localhost com.mysql.jdbc.Driver jdbc:mysql:///CCAM,ccam,ccam - pour une base Mysql sur la machine linux3 , avec user = ccam et password= ccam : Mysql sur linux3 com.mysql.jdbc.Driver jdbc:mysql://linux3/CCAM,ccam,ccam - pour une base Access "ccam.mdb" sur située sur la même machine dans le répertoire "E:\Developpement\CCAM\" - Remarque : avec cette syntaxe il n'est pas nécessaire de définir une source de données ODBC Access sans ODBC sun.jdbc.odbc.JdbcOdbcDriver jdbc:odbc:;DBQ=ccam.mdb;DefaultDir=E:\Developpement\CCAM\;DRIVER={Microsoft Access Driver (*.mdb)} - pour une base hsqldb "ccam" avec user = "sa" et pas de mot de passe utilisée en mode StandAlone ( cad que la base tourne dans l'applicatif PIP ) hsqldb en mode StandAlone org.hsqldb.jdbcDriver jdbc:hsqldb:hsqldb/ccam,sa, - pour une base hsqldb "ccam" avec user = "sa" et pas de mot de passe utilisée en mode Server sur la machine linux3 hsqldb mode Server sur Linux3 org.hsqldb.jdbcDriver jdbc:hsqldb:hsql://linux3,sa, * Démarrage du programme : en étant dans le répertoire du programme : $ java -cp PIP.jar PIP ou $ java -jar PIP.jar ou > pip.bat ou $./pip.sh Sous Windows avec la base MySQL incluse : voir ci-dessus pour pourvoir utiliser la base hsqldb remplacer PIP.jar par PIP_HSQLDB.jar Dr René BEDDOK DIM Centre Hospitalier de CAHORS openccam ch-cahors fr