polaris: session和middleware的支持

起因

polaris虽然是模仿tornado开发，但我觉得作为一个go的web框架，还需要提供一些额外的扩展支持。

polaris现在已经支持session以及middleware，主要参加django。

polaris对于这些额外功能的支持，采取的是注册 + json配置驱动的方式。这个跟go的database/sql有点类似，任何模块都提供一套类似如下的接口:

type Obj interface {

}

type Driver interface{
    Open(jsonConfig json.RawMessage) (Obj, error)
}

func Register(name string, driver Driver) error
func Open(name string, jsonConfig json.RawMessage) (Obj, error)

如果我们需要自定义功能，只需要实现自己的driver以及对应的obj，然后Register进去，后续就可以通过Open直接使用了。

对于每个模块的配置，因为polaris的整体配置是json，所以我也强制要求参数是json格式的，也就是json.RawMessage，各个模块自行进行Unmarshal处理。

session

对于一个session对象，无非就是Set，Get，Delete等，polaris需要关心的是这个session对应的store。store可以理解为该session的持久化保存位置，可以是db，redis，cookie或者memory。

polaris提供的store接口如下：

type Store interface {
    //get a session by id
    //if no session exist, regenerate another id to new a session
    Get(id string) (*Session, error)

    //delete session from store
    Delete(*Session) error

    //Save session to stroe
    Save(*Session) error
}

type Driver interface {
    Open(jsonConfig json.RawMessage) (Store, error)
}

现阶段，只提供了redis的支持，这里特别说明一下，我是在现在才知道redis有一个setex命令，想想以前经常用set + expire来设置一个key以及超时，想想都汗颜。

对于session的持久化，polaris提供了codec的接口，外部可以注册自己的序列化方式，同时在相应的store里面实现。对于一个codec，接口如下：

//codec for session encode and decode
type Codec interface {
    Encode(values map[interface{}]interface{}) ([]byte, error)
    Decode(buf []byte) (map[interface{}]interface{}, error)
}

func RegisterCodec(name string, codec Codec) error
func GetCodec(name string) (Codec, error)

现阶段，polaris提供了gob方式的codec。外部通过GetCodec("gob")就可以获取到。

middleware

polaris的middleware主要提供如下接口：

type Middleware interface {
    ProcessRequest(env *context.Env) error
    ProcessResponse(env *context.Env) error
}

context.Env是该次请求的上下文环境，对于每次http请求，polaris会首先调用middleware的ProcessRequest，在处理实际对应的restful接口，然后再调用ProcessResponse。

如果Process的时候，返回error，或者env已经finished，polaris会终止后续的process操作。这套处理流程是否合适后续在好好考量。

现阶段，polaris提供了session middleware的支持。

Todo

polaris采用注册 + json配置的方式，我觉得可以很好的处理后续模块功能的添加问题，后续可以参考django等框架继续完善。