13. Exercício [IMPOTS] com um serviço WEB
Voltamos ao exercício [IMPOTS], já abordado nos parágrafos 4.2, 4.3, 8 e 10.
 |
13.1. O servidor
Encontramo-nos na seguinte arquitetura cliente-servidor:
 |
Do lado do servidor, vamos utilizar novamente uma arquitetura de três camadas. A camada [dao] será implementada pela classe ImpotsMySQL utilizada na versão com o SGBD e o MySQL no parágrafo 10. A camada [metier] será implementada pela classe [ImpotsMetier], já analisada. Resta, portanto, apenas escrever o serviço web. Este recebe dos seus clientes um parâmetro params na forma params= sim,2,200000, em que o primeiro elemento indica se o contribuinte é casado ou não, o segundo o número de filhos e o terceiro o seu salário anual.
O serviço web é o seguinte (impots_web_01):
#!D:\Programas\ActivePython\Python2.7.2\python.exe
# -*- coding=Utf-8 -*-
# importação do módulo das classes Impostos*
from impots import *
import cgi,cgitb,re
# autoriza-se a exibição de informações de depuração
cgitb.enable()
sys.stderr=sys.stdout
# ------------------------------------------------
# o serviço web dos impostos
# ------------------------------------------------
# os dados necessários para o cálculo do imposto foram colocados na tabela mysqL TABLE
# pertencente à base de dados BASE. A tabela tem a seguinte estrutura
# limites decimal(10,2), coeffR decimal(6,2), coeffN decimal(10,2)
# os parâmetros dos contribuintes (estado civil, número de filhos, salário anual)
# são enviados pelo cliente no formato params=estado civil, número de filhos, salário anual
# os resultados (estado civil, número de filhos, salário anual, imposto a pagar) são devolvidos ao cliente
# na forma <imposto>valor</imposto>
# ou no formato <erro>msg</erro>, se os parâmetros forem inválidos
# o servidor devolve ao cliente texto não formatado
print "Content-Type: text/plain\n"
# definição das constantes
USER="root"
PWD=""
HOTE="localhost"
BASE="dbimpots"
TABLE="impots"
# cria-se a camada [metier]
# O Python parece não suportar sessões
# no PHP, teria-se utilizado uma sessão para memorizar o objeto de negócio
# aqui, constrói-se-o sistematicamente a partir dos dados da base de dados MySQL
# instanciação da camada [metier]
try:
metier=ImpotsMetier(ImpotsMySQL(HOTE,USER,PWD,BASE,TABLE))
except (IOError, ImpotsError) as infos:
print ("<erreur>Une erreur s'est produite : {0}</erreur>".format(infos))
sys.exit()
# recuperamos a linha enviada pelo cliente ao servidor
params=cgi.FieldStorage().getlist('params')
# se não houver parâmetros, ocorre um erro
if not params:
print "<erreur>Le parametre [params] est absent<erreur>"
sys.exit()
# processa-se o parâmetro «params»
items=params[0].strip().lower().split(',')
# só deve haver 3 campos
if len(items)!=3:
print "<erreur>[%s] : nombre de parametres invalide</erreur>" % (params[0])
sys.exit()
# o primeiro parâmetro (estado civil) deve ser sim/não
marie=items[0].strip()
if marie!="oui" and marie != "non":
print "<erreur>[%s] : 1er parametre invalide</erreur>\n"% (params[0])
sys.exit()
# o segundo parâmetro (número de filhos) deve ser um número inteiro
match=re.match(r"^\s*(\d+)\s*$",items[1])
if not match:
print "<erreur>[%s] : 2ieme parametre invalide</erreur>\n"% (params[0])
sys.exit()
enfants=int(match.groups()[0])
# o terceiro parâmetro (salário) deve ser um número inteiro
match=re.match(r"^\s*(\d+)\s*$",items[2])
if not match:
print "<erreur>[%s] : 3ieme parametre invalide</erreur>\n"% (params[0])
sys.exit()
salaire=int(match.groups()[0])
# calcula-se o imposto
impot=metier.calculer(marie,enfants,salaire)
# retorna-se o resultado
print "<impot>%s</impot>\n" % (impot)
# fim
Notas:
- linha 5: importam-se os objetos do ficheiro impots.py;
- linha 9: depurar um script CGI pode ser problemático. O módulo cgitb envia, em caso de erro, o motivo da falha. Para tal, é necessário redirecionar a saída de erro padrão (sys.stderr) para a saída padrão (sys.stdout) (linha 10);
- linha 26: o cabeçalho HTTP que define a natureza do documento enviado, neste caso, um texto não formatado. O serviço web devolve a sua resposta sob a forma de uma única linha de texto:
- <erreur>message</erreur> se houver um erro;
- <impot>valeur</impot>, em que valeur é o montante do imposto.
- linha 43: instância das camadas [dao] e [metier];
- linhas 44-46: em caso de erro na instância, o script envia a sua resposta e termina;
- linhas 49-53: o parâmetro «params» é recuperado. Se estiver ausente, o script envia a sua resposta e termina;
- linha 56: o parâmetro «oui,2,200000» é decomposto em 3 campos na tabela «items»;
- linhas 58-77: verifica-se a validade dos 3 campos. Se houver um erro, o script envia a sua resposta e termina;
- linha 79: o imposto é calculado;
- linha 81: e enviado ao cliente.
Num navegador da Web, obtêm-se os seguintes resultados:
 |  |
13.2. Um cliente programado
O programa (client_impots_web_01)
# -*- coding=utf-8 -*-
import httplib,urllib,re
# constantes
HOST="localhost"
URL="/cgi-bin/impots_web_01b.py"
data=("oui,2,200000","non,2,200000","oui,3,200000","non,3,200000","x,y,z,t","x,2,200000", "oui,x,200000","oui,2,x");
# ligação
connexion=httplib.HTTPConnection(HOST)
# acompanhamento
#connexion.set_debuglevel(1)
# é executado um ciclo sobre os dados a enviar para o servidor
for params in data:
# os parâmetros devem ser codificados antes de serem enviados para o servidor
parametres = urllib.urlencode({'params': params})
# envio do pedido
connexion.request("POST",URL,parametres)
# processamento da resposta (linha de texto)
reponse=connexion.getresponse().read()
lignes=reponse.split("\n")
# a linha de texto tem o seguinte formato
# <impot>xxx</impot>
# ou <erro>xxx</erro>
impot=re.match(r"^<impot>(\S+)</impot>\s*$",lignes[0])
if impot:
print "params=%s, impot=%s" % (params,impot.groups()[0])
else:
erreur=re.match(r"^<erreur>(.+)</erreur>\s*$",lignes[0])
if erreur:
print "params=%s, erreur=%s" % (params,erreur.groups()[0])
else:
print lignes
# encerramento da ligação
connexion.close()