The Web Layer

The Web Layer
一个控制器要"处理请求(handles request)","创建或准备响应(response)","判断请求的范围"。
从另外一个方面讲，每个响应都会创建一个新的控制器。一个控制器能够产生响应（response）或者代理生成一个页面（view）。
创建一个控制器很简单。他的名称以Controller 结尾，还有把他放在grails/controller的目录下。


理解Controllers和Actions
创建Controller
在项目的根目录使用create-controller [name]命令创建。
grails create-controller book
class BookController { … }


创建一个actions
一个控制器的属性每一个都是代码块。每个属性的名称映射一个uri。
class BookController {
    def list = {        // do controller logic
        // create model        return model
    }
}
URI是/root/book/list

默认的Action
有几个规则：
当action中没有定义明确的uri，你定义一个index属性，所有的请求将由它处理。
要么你就明确定义defaultAction 属性
def defaultAction = "list"

控制器和范围(scopes)
*servletContext javax.servlet.ServletContext
*session  HttpSession
*request HttpServletRequest
*params  从CGI引入的一个参数
*flash

访问这些变量
  def find = {
    def findBy = params["findBy"]
    def appContext = request["foo"]
def loggedUser = session["logged_user"]    }
class BookController {
    def find = {
        def findBy = params.findBy
        def appContext = request.foo
        def loggedUser = session.logged_user    }
}

使用Flash scope
flash是一个临时的存储变量，仅仅在两个request之间传递。

Models和视图
模型本质就是一个map，在返回时候，给view层使用。
有以下几种方式放回一个map的实例
def show = {
[ book : Book.get( params.id ) ]
}

class BookController {
    List books
    List authors
    def list = {
           books = Book.list()
           authors = Author.list()
    }
}
上面这些代码是线程不安全的。
使用Spring ModeAndView
import org.springframework.web.servlet.ModelAndViewdef index = {
    def favoriteBooks = … // get some books just for the index page, perhaps your favorites    // forward to the list view to show them
    return new ModelAndView("/book/list", [ bookList : favoriteBooks ])
}

选择视图：
class BookController {
def show = {
[ book : Book.get( params.id ) ]
}
}
上面的代码并没有明确指定返回的视图，Grails怎么知道的了？是因为grails使用了约定。
grails将会自动查找grails-app/views/book/show.gsp(而实际上它会先查找jsp，因为grails 能够使用jsp)

如果你喜欢指定返回的页面和模型(render)：
def show = {
  def map = [ book : Book.get( params.id ) ]
    render(view:"display", model:map)
}
定位在grails-app/views/book/display.gsp
这里默认的会查找book/display.gsp
如果想让它返回其他页面，看下面代码
def show = {
  def map = [ book : Book.get( params.id ) ]
    render(view:"/shared/display", model:map)
}
定位在grails-app/views/shared/display.gsp
返回一个简单的response
render "Hello World!"
// write some markup
render {
   for(b in books) {
      div(id:b.id, b.title)
   }
}
// render a specific view
render(view:'show')
// render a template for each item in a collection
render(template:'book_template', collection:Book.list())
// render some text with encoding and content type
render(text:"<xml>some xml</xml>",contentType:"text/xml",encoding:"UTF-8")


Redirects 和 chaining
class OverviewController {
                     def login = {}                     def find = {
                         if(!session.user)
                            redirect(action:login)
                         …
                     }
                 }

redirect使用的是HttpServeltResponse
在同一个控制类中：
redirect(action:login)
在不同的action中
redirect(controller:'home',action:'index')
URI
   redirect(uri:"/login.html")
url
redirect(url:"http://grails.org")