ATOS installations non standards, ATOS full Java, serveur en safe_mode... Options

[Wouf]

Tutorial de la contribution ATOS Full Java

Le pourquoi du comment...

Cette contribution a été crée dans le but de s'affranchir de la limitation (au niveau des systèmes d'exploitations) induite par l'utilisation de binaires précompilés. En effet, sur serveur Mac (mon environnement de travail), la contribution déjà existante ne pouvait s'installer.

Dans quel cas l'utiliser ?

Il faut utiliser cette contribution dans tous les cas ou celle-ci ne fonctionnerait pas. Plus exactement, il faut utiliser cette contribution si votre serveur n'execute pas les binaires précompilés fournis par Atos et prévus pour foncitonner avec la contribution ci dessus.
Si vous êtes sous Mac (serveur) vous êtes obligés d'utiliser cette contribution.

Prérequis

• Oscommerce MS2
  Travail réalisé sur Creload 6 sp1.1 mais censé fonctionner sur MS2
• La contribution
  Elle est a récupérer ici : Atos Full Java
• L'api ATOS FULL Java fournie par votre banque
  Ne pas confondre l'api fourni par la banque et ma contrib qui portent le même nom : ATOS FULL Java
• Un environnement de développement Java (Eclipse, Xcode, etc...)
• Un peu de patience...

Les servlets

# Késako ?

Une servlet est une application coté serveur qui fonctionne comme un CGI (a l'image de PHP ou ASP). Une servlet est codée en Java et nécessite donc un moteur de servlet pour fonctionner. Une servlet est donc écrite dans une quelconque IDE (environnement de developpement) puis compilée en un fichier .class exploitable par le moteur de servlet.

# Le moteur de servlet

Je ne sais pas si il en existe beaucoup mais l'un des principaux et le plus connu est Tomcat. Ce moteur de servlet doit impératicement être installé coté serveur sans quoi rien ne sera possible ensuite. Je ne détaillerai pas son installation d'autant plus que le site web Tomcat's Corner en parlera certainement mieux que moi !

# Compiler les servlets

Les fichiers sources des servlets sont disponible dans ma contribution et se nomment "requestservlet.java" et "responseServlet.java". Ces fichiers sont basés sur ceux fournis par l'API ATOS full Java et ont été modifiés afin de prendre en compte les bons paramêtres.
Il faut donc les ouvrir dans votre IDE pour pouvoir les compiler. Afin que la compilation reussissent il faut aussi spécifier les librairies a utiliser (framework). Ces librairies sont apipayment.jar (fourni dans l'api Atos) et servlet.jar (fourni avec Tomcat), il faut donc les ajouter au projet de façon qu'elles soient prises en compte lors de la compilation (sinon une erreur sera générée). Une fois les librairies bien spécifiées, la compilation ne devrait plus poser de problème. Il faut alors déployer les servlet.

# Deployer les servlets (avec Tomcat)

Deployer signifie "mettre en place" ou encore mettre les fichiers issues de la compilation au bon endroit avec la bonne configuration afin que le moteur de servlet puissent les executer. Encore une fois je vous renvoie vers l'excellent Tomcat's Corner, neanmoins je vais vous présenter la façon dont je m'y suis pris (pour l'instant je ne suis pas en production donc il se peut que lors d'un passage en production la mise en place de ces servlets diffèrent selon les contraintes de l'hébergeur).

J'ai placer mes fichiers selon l'architecture suivante dans le répertoire de Tomcat :

• Tomcat
  • common
    • lib
      • servlet.jar (déjà présent)
      • apipayment.jar (à ajouter ici)
  • webapps
    • atos
      • WEB-INF (répertoire obligatoire pour servlet)
        • classes
          • request
            • requestServlet.class
          • response
            • responseServlet.class
        • web.xml

Dans le cas d'un deploiement comme ci dessus, il n'est pas nécessaire d'ajouter des lignes de configurations au fichier server.xml, par contre le fichier web.xml aura une structure bien particulière.
Ci dessous le fichier web.xml avec mes explications en rouge :