天乙社区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配置文件：
<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;}@Overridepublic 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上显示的内容。