Introducción Flask
Puedes descargarte nuestro Manual Java en formato PDF.
El manual se encuentra en continua revisión, de forma automática la URL proporcionada contendrá la última versión del Tutorial Java.
A lo largo del Tutorial Java se van explicando una serie de ejemplos. Podéis descargaros los ejemplos del Tutorial Java desde el GitHub de Manual Web.
Si os gusta el contenido del material y los ejemplos os agradecemos si nos aportáis una estrella en GitHub.
Todas las preguntas y dudas sobre Java las puedes consultar en el Foro sobre Java. Y puedes echar un ojo a los ejemplos sobre el lenguaje Java.
]]>request
Para poder utilizar el objeto request deberemos de importarlo al principio de nuestro programa Flask:
from flask import request
Una de las primeras cosas para las que podemos utilizar el objeto request es la de saber el tipo de petición que nos hace el cliente: GET, POST, DELETE,… para ello el objeto request nos ofrece el atributo .method
Así podremos preguntar lo siguiente:
if request.method == 'POST':
El objeto request nos servirá para acceder a la información que nos envíe el cliente. La principal información que nos envía son los parámetros, ya sean parámetros tipo GET o parámetros tipo POST.
Para accerder a un parámetro de tipo GET, que son aquellos que vienen como una lista de claves/valor dentro de la URL de petición.
?parametro1=valor1¶metro2=valor2&…¶metroN=valorN
El objeto request nos ofrece la colección .args y el método .get() para poder acceder a parámetros de tipo GET.
El método .get() recibe como parámetro el nombre del parámetro que queremos recuperar, lo que sería la clave.
La estructura sería:
response.args.get('clave','')
Si nos invocan mediante un método GET con la cadena:
?nombre=Victor
Podremos acceder a dicho parámetro de la siguiente forma:
nombre = request.args.get('nombre','')
Lo primero que necesitamos es un editor de texto, aquel con el que te encuentres más a gusto, ya sea un completo Pycharm o un editor configurable como Atom.
Al ser un programa Python la extensión de nuestro fichero será .py. Lo primero que haremos en el programa será importar el Framework Flask, en concreto vamos a importar el objeto Flask que es el objeto principal del Framework.
from flask import Flask
Ahora vamos a crear una aplicación Flask, para ello instanciamos el objeto Flask.
app = Flask(__name__)
Ya tenemos la aplicación que será la que tendremos que ejecutar al final del programa.
El concepto principal que maneja Flask es el de las rutas. Por entendernos la ruta será un path del servidor. Lo que vamos a hacer es asociar un Path a una funcionalidad, esto lo conseguimos con las rutas.
Para definir una ruta utilizamos el método .route(), el cual recibirá entre paréntesis el path sobre el que queremos asociar la fucionalidad.
Así, si quereos gestionar el path o ruta raíz escribiremos lo siguiente:
@app.route('/')
Si lo que queremos es controlar el path o ruta /mensaje/saludo cambiaremos el parámetro del método:
@app.route('/mensaje/saludo')
Ahora asociamos a esa ruta un método, este será el que se encargue de controlar las peticiones o Request que lleguen a la ruta y de devolver el contenido mediante una Response.
@app.route('/')def saludo():
return 'Mi primer programa Flask!'
En este caso hemos asociado el método .saludo() a la ruta y lo que hacemos es devolver una simple cadena ‘Mi primer programa Flask!’
Una vez que tenemos definido el esqueleto del programa y las rutas que vayamos a utilizar, solo tendremos que ejecutar el objeto Flask.
Para ello ejecutamos el método .run() de nuestro objeto Flask app.
if __name__ == '__main__':
app.run()
Al ser una aplicación Python deberemos de guardar el fichero con una extensión .py. Por ejemplo hola-mundo.py
Ahora pasaremos a ejecutar el programa Flask. Al ser un programa Python tendremos que ejecutar el interprete de Python.
$ python hola-mundo.py
O bien podemos ejecutarla mediante el modulo de Flask:
$ export FLASK_APP=hola-mundo-flask.py $ python -m flask run
El módulo Flask también permite ejecutarla de la siguiente manera:
$ export FLASK_APP=hola-mundo-flask.py $ flask run
En la pantalla veremos que automáticamente se arranca el servidor que contiene las rutas.
La aplicación Flask solo estará disponible desde el ordenador dónde se arranca, en el caso de que queramos que esté disponible desde otro ordenador de la red deberemos de ejecutar
flask run –host=0.0.0.0
Simplemente tendremos que ir a esa dirección para poder ver el programa ejecutándose y la salida en el navegador donde pondrá:
Mi primer programa Flask!
Con esto ya habremos conseguido lanzar la aplicación Flask.
]]>La mayor virtud de Flask es poder crear rutas web de una forma muy sencilla. Una pequeña aplicación web que nos devolviese un hola mundo sería tan sencilla como escribir:
from flask import Flask
app = Flask(__name__)
@app.route("/")def hello():
return "¡Hola Mundo!"
if __name__ == "__main__":
app.run()
O crear un servicio que sumase dos números con Flask lo podríamos hacer con el siguiente código:
from flask import Flask
app = Flask(__name__)
@app.route('/suma/<int:s1>/<int:s2>',methods=['GET'])
def suma(s1,s2):
return str(s1+s2)
if __name__ == '__main__':
app.run()
En http://localhost:5000/ se tendrá el resultado del código.
Por convención los proyectos Flask tienen la siguiente estructura:
Flask depende de librerías externas como Werkzeug y Jinja2. Werkzeug es un toolkit para aplicaciones WSGI, que es un interface entre aplicaciones Python y servidores web. Jinja2 es un engine para el renderizado de plantillas (o templates) web.
Para poder utilizar Flask debes de tener, al menos, Python 2.6 instalado. Flask también funciona con Python 3.
Para instalar Flask vamos a utilizar pip. Así que simplemente deberemos de escribir en nuestra línea de comandos lo siguiente:
$ pip install Flask
Puede ser que para la instalación necesites ser administrador. En ese caso ejecuta:
$ sudo pip install Flask
Una buena práctica dentro del mundo Python es ejecutar el código dentro de un entorno virtual o virtualenv. Dentro del entorno virtual podremos trabajar con diferentes versiones de Python y de las librerías que estemos utilizando.
Para instalar virtualenv deberás de ejecutar lo siguiente
$ pip install virtualenv
Una vez instalado virtualenv deberás de crear un directorio para tu proyecto.
$ mkdir miproyecto $ cd miproyecto
Ahora creamos el entorno virtual del proyecto:
$ virtualenv mientornovirtual
Se suele utilizar venv como nombre de los entornos virtuales
Ahora tenemos que saber hacer dos cosas. Por un lado activar el entorno virtual:
$ . mientornovirtual/bin/activate
Y desactivarlo una vez acabemos de utilizarlo
$ deactivate
Dentro del entorno virtual realizaremos la instalación de Flask.
]]>