четверг, 3 мая 2012 г.

Использование Spring MVC для разработки приложений в среде Google App Engine


Использование Spring MVC для разработки приложений в среде Google App Engine

Рассматриваются вопросы использования среды разработки web-приложений Spring MVC в облаке Google AppEngine с использованием  декоратора SiteMesh.

Используется следующее программное обеспечение:
  • Eclipse с плагином Google AppEngine (версия Google AppEngine SDK 1.6.4)
  • Spring MVC 3.1.1
В папку /WEB-INF/lib положите следующие библиотеки:
  1. spring-webmvc-3.1.1.RELEASE.jar
  2. spring-asm-3.1.1.RELEASE.jar
  3. spring-beans-3.1.1.RELEASE.jar
  4. spring-context-3.1.1.RELEASE.jar
  5. spring-aop-3.1.1.RELEASE.jar
  6. spring-context-support-3.1.1.RELEASE.jar
  7. spring-core-3.1.1.RELEASE.jar
  8. commons-logging-1.1.1.jar
  9. spring-expression-3.1.1.RELEASE.jar
  10. spring-web-3.1.1.RELEASE.jar
  11. aopalliance-1.0.jar
  12. sitemesh-2.4.2.jar
Чтобы определить список необходимых библиотек, можно создать Maven-проект здесь же, в Eclipse, добавить зависимость spring-webmvc и посмотреть, что требуется. Вообще, есть плагин, позволяющий включить управления зависимостями в проекте web-приложения Google AppEngine, но что-то я с ним не подружился.

В build path проекта web-приложения нужно добавить:
  1. spring-webmvc-3.1.1.RELEASE.jar
  2. spring-context-3.1.1.RELEASE.jar
  3. spring-web-3.1.1.RELEASE.jar
В созданном проекте Google Web Application Project в файл web.xml нужно вставить следующие строки (все, что там уже есть, лучше удалить):


<filter>

    <filter-name>sitemesh</filter-name>
    <filter-class>com.opensymphony.sitemesh.webapp.SiteMeshFilter</filter-class>
</filter>

<filter-mapping>
    <filter-name>sitemesh</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

<servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/spring/*</url-pattern>
</servlet-mapping>

Сначала настроим подсистему декораторов, чтобы не вырисовывать каждую страницу отдельно, сделаем шаблон и будем его применять с помощью sitemesh, добавим в папку WEB-INF файл decorators.xml со следующим содержимым:

<decorators>
</decorators>

С декораторами пока закончим и продолжим позднее.

В папке WEB-INF нужно создать файл spring-servlet.xml (начало названия файла должно совпадать с названием сервлета из файла web.xml):

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:p="http://www.springframework.org/schema/p" 
    xmlns:context="http://www.springframework.org/schema/context"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-3.0.xsd">

    <context:component-scan base-package="org.samples.controllers"/>


    <bean id="viewResolver"

class="org.springframework.web.servlet.view.UrlBasedViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
<property name="prefix" value="/WEB-INF/jsp/"/>
<property name="suffix" value=".jsp"/>
    </bean>

</beans>

Элемент <context:component-scan base-package="org.samples.controllers"/> определяет java-package, где Spring MVC будет искать контроллеры для обработки запросов к web-приложению.
Теперь создадим простой контроллер:

package org.samples.controllers;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class IndexController {
    @RequestMapping("/index")
    public String helloWorld(Model model) {
        model.addAttribute("message", "Hello World!");
        return "index";
    }
}

Контроллер будет обрабатывать запрос http://localhost:8888/spring/index

Теперь нужно создать страницу в папке WEB-INF/jsp под именем index.jsp (название файла определяется настройками в файле spring-servlet.xml и возвращаемым значением контроллера) и с текстом:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-">
<title>Приветствие</title>
</head>
<body>
<h1>${message}</h1>
</body>
</html>

После запуска web-приложения из Eclipse через правую кнопку мыши на проекте-Run As-Web Application, указанный выше url будет работать.

Ну а теперь сделаем простенький декоратор. Сначала заменим содержимое файла decorators.xml в папке WEB-INF на следующее:

<?xml version="1.0" encoding="UTF-8"?>

<decorators defaultdir="?WEB-INF/decorators">
    <decorator name="main" page="main.jsp">
          <pattern>/*</pattern>
    </decorator>
</decorators>

В папке /WEB-INF/decorators надо создать файл main.jsp:

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<%@ taglib uri="http://www.opensymphony.com/sitemesh/decorator" prefix="decorator" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title><decorator:title default="Hello" /></title>
<link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/combo?3.5.0/build/cssreset/cssreset-min.css&3.5.0/build/cssfonts/cssfonts-min.css&3.5.0/build/cssgrids/cssgrids-min.css&3.5.0/build/cssbase/cssbase-min.css" />
<style type="text/css">
body {
    margin: auto;
    width: 960px;
    height: 500px;
    border: 1px black dotted;
}
</style>

<decorator:head />
</head>
<body>

<decorator:body />

</body>
</html>

Это все, можно публиковать приложение в облаке Google App Engine.