google sitebricks 学习心得--最简单web应用

[b]简介[/b]

Sitebricks 目前仍然处于测试阶段，它是一种新的 Java™ Web 应用程序框架。您可能想问：“为什么我还需要另一个 Web 框架？” 通过 Google Sitebricks，您可以快速构建一个可由他人维护或操作的 Web 应用程序。Sitebricks 构建于 Guice 之上。它将许多 Guice 原则扩展到 Web。它像 Guice 一样大量使用注释将配置作为代码的一部分。要使用 Guice，不需要创建或编辑大量 XML 文件。而 Sitebricks 允许在创建 Web 应用程序时编写相对较少的代码。您编写的代码将会简单明了。可以查看 Sitebricks 代码并快速了解其表达的含义。Sitebricks 不会破坏类型安全或性能。

[b]先决条件[/b]

Sitebricks 仍然处于测试阶段；本文使用的是 0.8.2 版本。
目前，使用 Sitebricks 最简单的方式就是随 Maven 一同使用。本文使用的是 Maven 3.0.1。当然，Maven 会引入 Sitebricks 需要的所有其他依赖项，比如 Google Guice。
依赖于 Java 中的一些高级特性，因此需要用到 JDK 1.6。本文使用的是 JDK 1.6.0_5。
您可以使用一个 Java Web 应用服务器来部署本文中的样例应用程序，不过这并非必需步骤。
此外，样例应用程序包含一个可用作测试的嵌入式 Jetty 服务器。
在样例应用程序中用到了由 Sitebricks 使用的 Guice。熟悉一下 Guice 或 Spring 等其他依赖注入框架会很有用。

[b]使用maven创建项目[/b]

#mvn archetype:generate 

简单web项目应该是选择100

项目的POM文件

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>vmars</groupId>
	<artifactId>vmars</artifactId>
	<packaging>war</packaging>
	<version>1.0</version>
	<name>vmars Maven Webapp</name>
	<url>http://maven.apache.org</url>
         <repositories>
<!-- 如果搭建了maven私服，可以在私服上添加一个repository
     就可以不用以下的repository配置了
-->

        <repository> 
            <id>sonatype-google-snapshots</id> 
            <name>Sonatype Google Snapshots Repository</name>
            <url>http://oss.sonatype.org/content/repositories/
google-snapshots/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.7</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>com.google.sitebricks</groupId>
			<artifactId>sitebricks</artifactId>
			<version>0.8.2</version>
		</dependency>
			</dependencies>
	<build>
		<finalName>vmars</finalName>
		<plugins>
			<plugin>
				<groupId>org.mortbay.jetty</groupId>
				<artifactId>maven-jetty-plugin</artifactId>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>2.1</version>
				<configuration>
					<source>1.6</source>
					<target>1.6</target>
				</configuration>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-eclipse-plugin</artifactId>
				<configuration>
					<wtpmanifest>true</wtpmanifest>
					<wtpapplicationxml>true</wtpapplicationxml>
					<wtpversion>2.0</wtpversion>
					<ajdtVersion>none</ajdtVersion>
				</configuration>
			</plugin>
		</plugins>
	</build>
</project>

[b]生成eclipse项目[/b]

#mvn eclipse:eclipse

maven 会把依赖的jar下载下来

[b]配置web.xml文件[/b]

<web-app>
	<display-name>Archetype Created Web Application</display-name>
	<filter>
		<filter-name>webFilter</filter-name>
		<filter-class>com.google.inject.servlet.GuiceFilter</filter-class>
	</filter>
	<filter-mapping>
		<filter-name>webFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
	<listener>
		<listener-class>org.vmars.framework.web.MyGuiceCreator</listener-class>
	</listener>
</web-app>

看到在web.xml中需要一个自己的listener，这个listener的作用是在容器启动时配置sitebricks。

[b]写listener[/b]

public class MyGuiceCreator extends GuiceServletContextListener {
	@Override
	protected Injector getInjector() {
		return Guice.createInjector(new SitebricksModule() {
			 protected void configureSitebricks() { 
				 scan(Example.class.getPackage());    //scan class Example's package and all descendants
			 }
		});
	}
}

示例使用 scan，这是 Sitebricks 所特有的一个 API。它接收一个 Java 包并将其内容添加到由 Sitebricks 管理的类中。这的Example是一个处理请求的类。

[b]写Example[/b]

@At("/example") //请求的路径
@Show("/pages/example.html")
//处理请求指向的页面，如果没有不写此标签。就需要在webapp目录下或者WEB-INF目录下创建一个Example.html文件。
public class Example {
	private boolean appear = false;
	private String message = "Hello";

	public String getMessage() {
		return message;
	}

	public boolean isAppear() {
		return appear;
	}
	public void setAppear(boolean appear) {
		this.appear = appear;
	}
}

[b]写Example.html[/b]

<!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>Insert title here</title>
</head>
<body>
<a href='?appear=${!appear}'>show/hide</a>
@ShowIf(appear)
<span>
 ${message} from Sitebricks!
</span>
</body>
</html>

至此一个最简单例子就完成了。

[b]运行示例[/b]

#mvn jetty:run

然后在浏览器中输入
http://localhost:8080/项目名称/example
就可以访问测试了。

参考：
[url]http://www.ibm.com/developerworks/cn/web/wa-sitebricks/index.html?ca=drs-[/url]
[url]http://code.google.com/p/google-sitebricks/wiki/GettingStarted[/url]