railo
1.0.0
Bienvenue dans le référentiel de code source du moteur RAILO CFML.
Railo est un moteur CFML haute performance, open source. Pour plus d'informations, visitez la page d'accueil du projet à http://www.getrailo.org/
Avant de pouvoir commencer à construire Railo à partir de Source, vous aurez besoin de quelques choses installées sur votre machine:
Java JDK - Puisque vous allez compiler le code Java, vous avez besoin du JDK et pas seulement du JRE. Railo nécessite JDK 6 ou version ultérieure pour compiler. http://www.oracle.com/technetwork/java/javase/downloads/
Apache Ant - Le code source contient plusieurs scripts de construction qui automatiseront le processus de construction pour vous. Vous aurez besoin de la fourmi installée pour exécuter ces scripts de construction. http://ant.apache.org/bindownload.cgi
Une copie exécutable de RAILO - Vous aurez besoin d'une instance en cours d'exécution de Railo sur la machine locale dans le cadre du processus de construction. http://www.getrailo.org/index.cfm/download/
Si vous connaissez Eclipse et Git, nous vous recommandons également d'utiliser ces outils.
Le code source de Railo est contrôlé par version avec GIT et est hébergé sur github.com (https://github.com/getrailo/raillo - il y a de fortes chances que c'est là que vous lisez ceci dès maintenant;]).
Le référentiel contient quelques branches, les plus importantes étant maître (version actuelle) et se développent (rejets alpha et bêta).
Si vous connaissez Git, alors, clonez le référentiel et prenez toutes les branches à la fois.
Si vous n'êtes pas à l'aise de travailler avec Git, un moyen plus facile de saisir le code source d'une branche donnée est en téléchargeant un zipball:
Master Branch - https://github.com/getrailo/railo/zipball/master
Développer Branch - https://github.com/getrailo/railo/zipball/develop
Si vous avez besoin d'autres branches, modifiez simplement la branche que vous surrez depuis la liste déroulante ci-dessus, puis cliquez sur le bouton étiqueté Zip.
Extraire le contenu de l'archive zip dans un répertoire de travail, par exemple / railo-source. À l'intérieur de ce répertoire de travail, vous aurez désormais les dossiers / Railo-CFML et / RAILO-Java et quelques autres fichiers (y compris celui-ci).
Une partie du code RAILO est écrite en CFML, vous aurez donc besoin d'une instance en cours d'exécution de RAILO sur votre machine locale afin de la compiler. Dans un sens, nous utilisons Railo pour construire Railo. Quelle méta est-ce! :)
Le moyen le plus simple de configurer et d'exécuter une instance locale de Railo est de saisir une copie de Railo Express à partir de http://www.getrailo.org/index.cfm/download/
La racine de ce serveur doit pointer vers le dossier / RAILO-CFML dans le code source que vous avez téléchargé. Si vous utilisez Rairo Express, vous pouvez le définir comme suivant:
Modifier {RAILO-EXPRESS} /Contexts/railo.xml et modifier l'élément ResourceBase afin qu'il pointe vers le dossier / RAILO-CFML, par exemple
<Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>C:/workspace/railo-source/railo-cfml/</Set>
TIP: Later versions of Railo Express may have a www.xml file instead of a railo.xml file. Rename the file from www.xml to railo.xml and modify the resourceBase element as indicated above.
Démarrez l'instance de Railo Express en exécutant {RAILO-EXPRESS} / START ou {RAILO-EXPRESS} /start.bat
Parcourez l'administrateur de cette instance RAILO, par exemple http: // localhost: 8888 / railo-context / admin / server.cfm et définissez le mot de passe de l'administrateur.
TIP: If you are using the Railo Express version, the default port number is 8888.
TIP: Set the Server Administrator password as well as the Web Administrator password.
Notez l'URL de cette instance RAILO. Vous en aurez besoin à l'étape suivante.
Le processus de construction se connectera à l'instance locale de RAILO afin de compiler une partie du code.
Vous devez modifier /railo-java/railo-core/build.properties et informer le script de construction où trouver l'instance de Railo locale.
Modifiez la ligne qui lit railo.url = http: //compile/compileadmin.cfm afin que la valeur de railo.url pointe vers votre instance locale de RAILO, par exemple
railo.url=http://localhost:8888/compileAdmin.cfm
Le processus de construction générera un fichier de correctif que vous pouvez déployer en tant que mise à jour des serveurs RAILO. Pour que le correctif fonctionne, sa version doit être supérieure à la version actuelle du serveur que vous souhaitez corriger.
Vous devez définir la version dans /railo-java/railo-core/src/railo/runtime/info.ini
Au moment d'écrire ces lignes, le contenu de ce fichier est:
[version]
number=4.1.0.000
level=os
state=alpha
name=Endal
name-explanation=http://en.wikipedia.org/wiki/Endal_(Dog)
release-date=2012/07/16 12:15:25 CET
Modifiez simplement la valeur de la propriété numérique afin qu'elle soit supérieure à la version du serveur que vous prévoyez de patcher, par exemple: 4.1.0.111
Ouvrez une invite de commande (ou shell) et modifiez le répertoire de travail en / RAILO-JAVA / RAILO-MASTER et exécutez la fourmi en tapant simplement
ANT
Lorsque vous êtes invité, entrez le mot de passe administrateur que vous avez défini à l'étape 3.
TIP: ANT's path must be in the system's executables PATH.
Le processus de construction doit prendre une minute ou deux. Une fois terminé, vous pouvez trouver le fichier de correctif nouvellement construit dans / RAILO-Java / RAILO-Core / DIST /
Le nom de fichier sera le numéro de version que vous avez défini à l'étape 5, avec l'extension .rc, par exemple: 4.1.0.111.rc
