proj-sms-u
Pages enfant
  • Implémentation broker

Vous regardez une version antérieure (v. /wiki/pages/viewpage.action?pageId=134643713) de cette page.

afficher les différences afficher l'historique de la page

Vous regardez la version actuelle de cette page. (v. 1) afficher la version suivante »




Service SMS-U

 

 

Université de Paris

 

 

 

Document de conception

contexte du projet

rappel du contexte

L'Université Paris 1 Panthéon - Sorbonne souhaite mettre en place un service d'envoi de messages SMS intégré à l'Environnement Numérique de Travail. Ce service doit être :

  • Ouvert aux applications du SI (bibliothèque, service administratif, partenaires, ...)
  • Mutualisable entre les différents adhérents de l'UNPIdF



Figure 1 : Architecture fonctionnelle générale du service d'envoi de SMS
Ce service doit permettre d'attribuer à l'université une image d'administration en mouvement, ayant réussi son passage à l'ère numérique, en utilisant un média de communication très apprécié des jeunes adultes.
Ce service doit respecter le cadre technique décrit dans le projet open source ESUP Portail en s'appuyant plus particulièrement sur le framework esup-commons et proposer une architecture d'API permettant un faible couplage vis-à-vis des opérateurs télécom.

périmètre de l'étude

Ce document décrit la méthode à utiliser pour implémenter un broker autre que celui fourni par OLM.

architecture de l'implémentation broker

description de la gestion de l'envoi de SMS

Toute implémentation de broker doit répondre à l'interface ISMSSender.java. Celle ci ne contient qu'une méthode :

public interface ISMSSender {
/**
* Send the specified message.
* @param smsMessage
*/
void sendMessage(SMSBroker smsMessage);

}

Figure 2 : Interface ISMSSender
Cette méthode sendMessage est appelée par la couche métier du Back Office du service SMS-U. Elle ne prend qu'un unique paramètre, un objet de type SMSBroker qui est décrit comme suit :

public class SMSBroker implements Serializable {
/**
* The unique identifier message.
*/
private int id;

/**
* The message recipient.
*/
private String recipient;

/**
* The message itself.
*/
private String message;

...
}

Figure 3 : Classe SMSBroker
Ce « pojo » est composé de 3 attributs (et de leurs accesseurs) décrivant un SMS à envoyer avec :

  • id : L'identifiant unique du SMS à envoyer
  • recipient : une chaine de caractère représentant le numéro de téléphone du destinataires
  • message : le message en lui même.


Une fois l'implémentation réalisée, il faut remplacer (par le bean de la nouvelle implémentation) l'injection du bean spring smsSenderOlmImpl dans les beans sendSmsManager et sendSmsThirdManager du fichier d'application contexte business.xml.

<bean id="sendSmsManager"
class="org.esupportail.smsuapi.business.SendSmsManager">
<description>The business layer concerning the sending.</description>
<property name="daoService" ref="daoService" />
<property name="smsSender" ref="smsSenderOlmImpl" />
<property name="schedulerUtils" ref="schedulerUtils"/>
<property name="clientManager" ref="clientManager"/>
</bean>

<bean id="sendSmsThirdManager"
class="org.esupportail.smsuapi.business.SendSmsThirdManager">
<description>The business layer concerning the sending.</description>
<property name="daoService" ref="daoService" />
<property name="smsSender" ref="smsSenderOlmImpl" />
<property name="schedulerUtils" ref="schedulerUtils"/>
<property name="clientManager" ref="clientManager"/>
</bean>

Figure 4 : fichier business.xml

description de la gestion des acquittements

La gestion des acquittements reçus par le broker passe la classe nommée AckManager.

public class AckManager {

/**
*
* @param acknowledgment
*/
public void manageAck(final Acknowledgment acknowledgment) {
final AckManagerThread ackManagerThread = new AckManagerThread();

ackManagerThread.setAcknowledgment(acknowledgment);
ackManagerThread.run();
}
}

Figure 5 : Classe AckManager
Elle gère les acquittements sous la forme d'un objet Acknowledgment.

public class Acknowledgment {

/**
* The sms unique identifier.
*/
private int smsId;

/**
* the sms ack status.
*/
private SmsStatus smsStatus;


public int getSmsId() {
return smsId;
}

public void setSmsId(final int smsId) {
this.smsId = smsId;
}

public SmsStatus getSmsStatus() {
return smsStatus;
}

public void setSmsStatus(final SmsStatus ackStatus) {
this.smsStatus = ackStatus;
}

}

Figure 6 : Classe Acknowledgment
Ce « pojo » contient deux attributs :

    • smsId : qui est l'identifiant unique du message auquel est associé l'acquittement (le pendant de l'attribut id de la classe SMSBroker).
    • smsStatus : qui est la valeur de l'acquittement, cette valeur représente l'état dans lequel est le sms



La classe SmsStatus est une énumération qui reprend les différents états que peut prendre le sms.

public enum SmsStatus {
// Message saved in BD
CREATED,
// Message sent by the broker
IN_PROGRESS,
// Message successfully sent to the user mobile phone
DELIVERED,
// Message not sent due to quota error
ERROR_QUOTA,
// Message not sent because phone number is already in black list
ERROR_PRE_BL,
// Message not sent because phone number is invalid
ERROR_POST_BL,
// other error
ERROR
}

Figure 7 : Enumeration SmsStatus
Pour remplacer l'actuelle implémentation, il faut donc implémenter un gestionnaire d'acquittement spécifique au broker (comme cela est fait pour OLM dans le package org.esupportail.smsuapi.services.sms.impl.olm) dans lequel sera construit un objet Acknowledgment qui sera envoyé à la couche métier par le biais de la classe AckManager.

  • Aucune étiquette