天乙社区8.5.0Beta2
一、简介：
天乙社区是一套基于JAVA技术的网络虚拟社区，采用了Hibernate+Spring+Struts的轻量级J2EE框架.
1、全文检索：天乙社区6.0采用Lucene全文检索，并支持完全国际化多语言的全文检索。
2、MVC框架：天乙社区6.0继续了5.x的Struts框架，但经过优化，WEB端更加简洁高效。
3、集群支持：系统可以运行在集群上。
4、功能方面：大大加强了管理功能，用户可以多样化的定制系统的各项信息，包括用户级别、封锁IP、过滤字等等，论坛功能上主要增加了投票帖、上传附件类型多样、帖子中显示用户信息等等功能等。
下载地址： http://www.laoer.com/
二、功能分析：
1.web.xml：
在web.xml文件中，定义的filter和listener是有顺序的，涉及到对象的初始化顺序以及引用。特别注意的有如下几个配置：
Spring配置文件：
applicationContext.xml文件中定义的对象包括，数据源、service、dao和task等bean。其中很多task bean都有特定的作用。
验证图片servlet：
authimg类主要生产验证码图片，并对对cookie敏感内容进行加密。
2、cookie
2-1、关于localhost设置cookie的问题
在天乙BBS项目中，如果不配置cookie的domain而是localhost或127.0.0.1时，却向客户端写入cookie，如果浏览器调试成退出时清空cookie，则cookie:主机名@domain文件会自动删除，起不到保存登录状态的作用。原因如下：
说明：cookie IE cookie文件位置，IE->internet选项->常规->浏览历史记录->设置->查看文件，此文件中可以看到保存的cookie信息；
如果想进一步了解cookie，可以参考BLOG http://topmanopensource.iteye.com/blog/409819
如果浏览器禁用cookie，则cookie的功能就不能使用了。
在写Cookie时，设置Cookie.Domain为localhost时，Cookie.Domain会立即失效，而在服务器上需要使用域名来限定Cookie.Domain的作用范围，因此需要使用判断来区分：
if (!CheckFormat.isNull(Domain) && HttpContext.Current.Request.Url.Host.IndexOf(Domain) > -1 && CheckFormat.isValidDomain(HttpContext.Current.Request.Url.Host))
进行以下检查：
Domain是否为空值
当前域名中是否包含Domain字符串
当前域名是否为合法域名
由于localhost不符合以上的第3条，因此Cookie.Domain不会被设置。
当在服务器上运行时，用户使用域名访问的话，上诉3条均成立，因此Cookie.Domain可以被设置，并且Cookie能被保存，直到指定的失效时间为止。
3、struts2 自定义标签：
以face标签为例，该标签主要功能是现实用户图片，过程是：根据规则，将存放在硬盘上的用户信息文件中的图片信息取出来，并显示图片。
3.1jsp引用：
3.2定义bbscs.tld文件:
说明：
<name>face</name>:自定义标签名，页面上引用；
<tag-class>com.laoer.bbscs.web.taglib.UserFaceTag</tag-class>：数据标签内容的实现类；
<body-content>empty</body-content>：说明face标签内无内容；
<attribute>：确定标签在jsp上使用时的属性；例如<required>true</required>说明value属性是必须填写的；
3.3 定义UserFaceTag类
定义BbscsComponentTagSupport类：
说明：doStartTag方法是执行的入口，很显然是在解析开始标签的时候执行，返回值为标签状态，各状态的含义可以在网上查找到。doEndTag含义类似；
定义UserFace类：
说明：
writer.write(sb.toString())：使用write方法将html代码输出，即是在jsp上显示的内容。
天乙社区是一套基于JAVA技术的网络虚拟社区，采用了Hibernate+Spring+Struts的轻量级J2EE框架.
1、全文检索：天乙社区6.0采用Lucene全文检索，并支持完全国际化多语言的全文检索。
2、MVC框架：天乙社区6.0继续了5.x的Struts框架，但经过优化，WEB端更加简洁高效。
3、集群支持：系统可以运行在集群上。
4、功能方面：大大加强了管理功能，用户可以多样化的定制系统的各项信息，包括用户级别、封锁IP、过滤字等等，论坛功能上主要增加了投票帖、上传附件类型多样、帖子中显示用户信息等等功能等。
下载地址： http://www.laoer.com/
二、功能分析：
1.web.xml：
在web.xml文件中，定义的filter和listener是有顺序的，涉及到对象的初始化顺序以及引用。特别注意的有如下几个配置：
Spring配置文件：
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml,/WEB-INF/action-servlet.xml</param-value>
</context-param>
applicationContext.xml文件中定义的对象包括，数据源、service、dao和task等bean。其中很多task bean都有特定的作用。
验证图片servlet：
<servlet>
<servlet-name>authimg</servlet-name>
<servlet-class>com.laoer.bbscs.web.servlet.AuthImg</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>authimg</servlet-name>
<url-pattern>/authimg</url-pattern>
</servlet-mapping>
authimg类主要生产验证码图片，并对对cookie敏感内容进行加密。
2、cookie
2-1、关于localhost设置cookie的问题
在天乙BBS项目中，如果不配置cookie的domain而是localhost或127.0.0.1时，却向客户端写入cookie，如果浏览器调试成退出时清空cookie，则cookie:主机名@domain文件会自动删除，起不到保存登录状态的作用。原因如下：
说明：cookie IE cookie文件位置，IE->internet选项->常规->浏览历史记录->设置->查看文件，此文件中可以看到保存的cookie信息；
如果想进一步了解cookie，可以参考BLOG http://topmanopensource.iteye.com/blog/409819
如果浏览器禁用cookie，则cookie的功能就不能使用了。
在写Cookie时，设置Cookie.Domain为localhost时，Cookie.Domain会立即失效，而在服务器上需要使用域名来限定Cookie.Domain的作用范围，因此需要使用判断来区分：
if (!CheckFormat.isNull(Domain) && HttpContext.Current.Request.Url.Host.IndexOf(Domain) > -1 && CheckFormat.isValidDomain(HttpContext.Current.Request.Url.Host))
进行以下检查：
Domain是否为空值
当前域名中是否包含Domain字符串
当前域名是否为合法域名
由于localhost不符合以上的第3条，因此Cookie.Domain不会被设置。
当在服务器上运行时，用户使用域名访问的话，上诉3条均成立，因此Cookie.Domain可以被设置，并且Cookie能被保存，直到指定的失效时间为止。
3、struts2 自定义标签：
以face标签为例，该标签主要功能是现实用户图片，过程是：根据规则，将存放在硬盘上的用户信息文件中的图片信息取出来，并显示图片。
3.1jsp引用：
<%@taglib uri="/WEB-INF/bbscs.tld" prefix="bbscs"%>
<html>
<body>
......
<bbscs:face value="%{userSession.id}"/>
......
</body>
</html>
3.2定义bbscs.tld文件:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<taglib>
<tlib-version>2.2.3</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>bbscs</short-name>
<uri>/bbscs</uri>
<display-name>"BBSCS Tags"</display-name>
......
<tag>
<name>face</name>
<tag-class>com.laoer.bbscs.web.taglib.UserFaceTag</tag-class>
<body-content>empty</body-content>
<attribute>
<name>value</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
</taglib>
说明：
<name>face</name>:自定义标签名，页面上引用；
<tag-class>com.laoer.bbscs.web.taglib.UserFaceTag</tag-class>：数据标签内容的实现类；
<body-content>empty</body-content>：说明face标签内无内容；
<attribute>：确定标签在jsp上使用时的属性；例如<required>true</required>说明value属性是必须填写的；
3.3 定义UserFaceTag类
public class UserFaceTag extends BbscsComponentTagSupport {
/**
*
*/
private static final long serialVersionUID = -2113974447691755459L;
public UserFaceTag() {
// TODO 自动生成构造函数存根
}
private String value;
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
@Override
public Component getBean(ValueStack stack, PageContext pageContext) {
// TODO 自动生成方法存根
return new UserFace(stack, pageContext);
}
protected void populateParams() {
super.populateParams();
UserFace tag = (UserFace) component;
tag.setValue(value);
}
}
定义BbscsComponentTagSupport类：
public abstract class BbscsComponentTagSupport extends StrutsBodyTagSupport {
protected Component component;
public abstract Component getBean(ValueStack stack, PageContext pageContext);
public int doEndTag() throws JspException {
component.end(pageContext.getOut(), getBody());
component = null;
return EVAL_PAGE;
}
public int doStartTag() throws JspException {
component = getBean(getStack(), pageContext);
Container container = Dispatcher.getInstance().getContainer();
container.inject(component);
populateParams();
boolean evalBody = component.start(pageContext.getOut());
if (evalBody) {
return component.usesBody() ? EVAL_BODY_BUFFERED : EVAL_BODY_INCLUDE;
} else {
return SKIP_BODY;
}
}
protected void populateParams() {
component.setId(id);
}
public Component getComponent() {
return component;
}
}
说明：doStartTag方法是执行的入口，很显然是在解析开始标签的时候执行，返回值为标签状态，各状态的含义可以在网上查找到。doEndTag含义类似；
定义UserFace类：
public class UserFace extends Component {
private PageContext pageContext;
private String facePicName = "images/defaultFace.gif";
private String value;
public String getValue() {
return value;
}
public void setValue(String value) {
this.value = value;
}
public UserFace(ValueStack stack, PageContext pageContext) {
super(stack);
this.pageContext = pageContext;
}
public boolean start(Writer writer) {
boolean result = super.start(writer);
if (value == null) {
value = "top";
} else if (altSyntax()) {
if (value.startsWith("%{") && value.endsWith("}")) {
value = value.substring(2, value.length() - 1);
}
}
String userId = "";
Object idObj = this.getStack().findValue(value);
if (idObj != null) {
userId = (String) idObj;
}
StringBuffer sb = new StringBuffer();
if (StringUtils.isBlank(userId)) {
sb.append("<img src=\"");
sb.append(facePicName);
sb.append("\" alt=\"Face\" />");
try {
writer.write(sb.toString());
} catch (IOException e) {
e.printStackTrace();
}
return result;
} else {
if (userId.startsWith(Constant.GUEST_USERID)) { // 游客
sb.append("<img src=\"");
sb.append(facePicName);
sb.append("\" alt=\"Face\" />");
} else { // 正常用户
WebApplicationContext wc = WebApplicationContextUtils.getWebApplicationContext(this.pageContext
.getServletContext());
UserService us = (UserService) wc.getBean("userService");
UserInfoSimple uis = us.getUserInfoSimple(userId);
if (uis.getHavePic() == 1 && !uis.getPicFileName().equals("-")) {
sb.append("<a href=\"");
sb.append(BBSCSUtil.getUserWebPath(uis.getId()));
sb.append(uis.getPicFileName());
sb.append("\" target=\"_blank\">");
sb.append("<img src=\"");
sb.append(BBSCSUtil.getUserWebPath(uis.getId()));
sb.append(uis.getPicFileName());
sb.append(Constant.IMG_SMALL_FILEPREFIX);
sb.append("\" alt=\"Face\" border=\"0\" class=\"pic1\"/>");
sb.append("</a>");
} else {
sb.append("<img src=\"");
sb.append(facePicName);
sb.append("\" alt=\"Face\" />");
}
}
try {
writer.write(sb.toString());
} catch (IOException e) {
e.printStackTrace();
}
}
return result;
}
}
说明：
writer.write(sb.toString())：使用write方法将html代码输出，即是在jsp上显示的内容。