first commit

04.Flask/07.上下文与信号.md

@@ -0,0 +1,174 @@
+# 上下文与信号
+
+## 1. Flask上下文
+
+`Flask`项目中有两个上下文，一个是应用上下文（app），另外一个是请求上下文（request）。请求上下文`request`和应用上下文`current_app`都是一个全局变量。所有请求都共享的。`Flask`有特殊的机制可以保证每次请求的数据都是隔离的，即A请求所产生的数据不会影响到B请求。所以可以直接导入`request`对象，也不会被一些脏数据影响了，并且不需要在每个函数中使用request的时候传入`request`对象。这两个上下文具体的实现方式和原理可以没必要详细了解。只要了解这两个上下文的四个属性就可以了：
+
+- `request`：请求上下文上的对象。这个对象一般用来保存一些请求的变量。比如`method`、`args`、`form`等。
+- `session`：请求上下文上的对象。这个对象一般用来保存一些会话信息。
+- `current\_app`：返回当前的app。
+- `g`：应用上下文上的对象。处理请求时用作临时存储的对象。
+
+### 1.1 常用的钩子函数
+
+- before_first_request：处理第一次请求之前执行。例如以下代码：
+
+```python
+  @app.before_first_request
+  def first_request():
+      print 'first time request'
+```
+
+- before_request：在每次请求之前执行。通常可以用这个装饰器来给视图函数增加一些变量。例如以下代码：
+
+```python
+ @app.before_request
+ def before_request():
+     if not hasattr(g,'user'):
+         setattr(g,'user','xxxx')
+```
+
+- teardown_appcontext：不管是否有异常，注册的函数都会在每次请求之后执行。
+
+```python
+ @app.teardown_appcontext
+ def teardown(exc=None):
+     if exc is None:
+         db.session.commit()
+     else:
+         db.session.rollback()
+     db.session.remove()
+```
+
+- template_filter：在使用`Jinja2` 模板的时候自定义过滤器。比如可以增加一个`upper` 的过滤器（当然Jinja2已经存在这个过滤器，本示例只是为了演示作用）：
+
+```python
+  @app.template_filter
+  def upper_filter(s):
+      return s.upper()
+```
+
+- context_processor：上下文处理器。返回的字典中的键可以在模板上下文中使用。例如：
+
+```python
+  @app.context_processor
+  return {'current_user':'xxx'}
+```
+
+- errorhandler：errorhandler接收状态码，可以自定义返回这种状态码的响应的处理方法。例如：
+
+```python
+  @app.errorhandler(404)
+  def page_not_found(error):
+      return 'This page does not exist',404
+```
+
+## 2. flask信号：
+
+### 2.1 安装：
+
+`flask`中的信号使用的是一个第三方插件，叫做`blinker`。通过`pip list`看一下，如果没有安装，通过以下命令即可安装`blinker`：
+
+```
+pip install blinker
+```
+
+### 2.2 内置信号：
+
+`flask`内置集中常用的信号：
+
+1. `flask.template_rendered`：模版渲染完毕后发送，示例如下：
+
+```python
+  from flask import template_rendered
+  def log_template_renders(sender,template,context,*args):
+      print 'sender:',sender
+      print 'template:',template
+      print 'context:',context
+
+  template_rendered.connect(log_template_renders,app)
+```
+
+2. `flask.request_started`：请求开始之前，在到达视图函数之前发送，订阅者可以调用`request`之类的标准全局代理访问请求。示例如下：
+
+```python
+  def log_request_started(sender,**extra):
+      print 'sender:',sender
+      print 'extra:',extra
+  request_started.connect(log_request_started,app)
+```
+
+3. `flask.request_finished`：请求结束时，在响应发送给客户端之前发送，可以传递`response`，示例代码如下：
+
+```python
+  def log_request_finished(sender,response,*args):
+      print 'response:',response
+  request_finished.connect(log_request_finished,app)
+```
+
+4. `flask.got_request_exception`：在请求过程中抛出异常时发送，异常本身会通过`exception`传递到订阅的函数。示例代码如下：
+
+```python
+  def log_exception_finished(sender,exception,*args):
+      print 'sender:',sender
+      print type(exception)
+  got_request_exception.connect(log_exception_finished,app)
+```
+
+5. `flask.request_tearing_down`：请求被销毁的时候发送，即使在请求过程中发生异常，也会发送，示例代码如下：
+
+```python
+  def log_request_tearing_down(sender,**kwargs):
+      print 'coming...'
+  request_tearing_down.connect(log_request_tearing_down,app)
+```
+
+6. `flask.appcontext_tearing_down`：在应用上下文销毁的时候发送，它总是会被调用，即使发生异常。示例代码如下：
+
+```python
+  def log_appcontext_tearing_down(sender,**kwargs):
+      print 'coming...'
+  appcontext_tearing_down.connect(log_appcontext_tearing_down,app)
+```
+
+### 2.3 自定义信号：
+
+自定义信号分为3步，第一是定义一个信号，第二是监听一个信号，第三是发送一个信号。以下将对这三步进行讲解：
+
+1. 定义信号：定义信号需要使用到`blinker`这个包的`Namespace`类来创建一个命名空间。比如定义一个在访问了某个视图函数的时候的信号。示例代码如下：
+
+```python
+  from blinker import Namespace
+
+  mysignal = Namespace()
+  visit_signal = mysignal.signal('visit-signal')
+```
+
+2. 监听信号：监听信号使用`singal`对象的`connect`方法，在这个方法中需要传递一个函数，用来接收以后监听到这个信号该做的事情。示例代码如下：
+
+```python
+  def visit_func(sender,username):
+    print(sender)
+    print(username)
+
+  mysignal.connect(visit_func)
+```
+
+3. 发送信号：发送信号使用`singal`对象的`send`方法，这个方法可以传递一些其他参数过去。示例代码如下：
+
+```python
+  mysignal.send(username='zhiliao')
+```
+
+
+
+
+
+
+
+
+
+
+
+
+