chx 学习jForum笔记八－ForumAction三，发现用户认证模块。
2010.12.9。接昨天
在net.jforum.view.forum.common/ForumCommon.java中
public static void checkUnreadPosts(final Forum forum, final Map
{
final LastPostInfo lpi = forum.getLastPostInfo (); //取Forum中最后贴子信息
if (lpi == null) {
return;
}
final Integer topicId = Integer.valueOf(lpi.getTopicId()); //Forum中最后贴子的主题ID
//tracking 来自 SessionFacade.getTopicsReadTime() 最后阅读时间
if (tracking != null && tracking.containsKey(topicId)) { //tracking中读过此主题的记录
final long readTime = tracking.get(topicId).longValue(); //tracking中读主题的时间
forum.setUnread(readTime > 0 && lpi.getPostTimeMillis() > readTime); //主题变更时间晚于阅读时间
}
else {
forum.setUnread(lpi.getPostTimeMillis() > lastVisit); //主题变更时间晚于登录时间
}
}
从上面这段字看来，基本上是设置FORUM的状态，如果FORUM中有会员未读的帖子，就将状态设为未读。
这里有三个问题。一是tracking从哪里来的，查了一下，从SessionFacade.getTopicsReadTime()获取，但这里面的值又是什么时候设置的？二是lastVisit从哪里来的，来自userSession.getLastVisit().getTime(); //最后登录时间，同样的，这里面的值是什么时候设置的？三是forum.getLastPostInfo ();
在net.jforum.entities/Forum.java中
public LastPostInfo getLastPostInfo() {
return this.lpi;
}
仅仅是返回一个属性，查构造函数：
public Forum(final Forum forum)
{
this.description = forum.getDescription();
this.id = forum.getId();
this.idCategories = forum.getCategoryId();
this.lastPostId = forum.getLastPostId();
this.moderated = forum.isModerated();
this.name = forum.getName();
this.order = forum.getOrder();
this.totalPosts = forum.getTotalPosts();
this.totalTopics = forum.getTotalTopics();
this.unread = forum.isUnread();
this.lpi = forum.getLastPostInfo();
}
居然也是这句：getLastPostInfo()，难道购造时已经有forum的值了吗？哦，有个传入的forum值。
public void setLastPostInfo(final LastPostInfo lpi) {
this.lpi = lpi;
}
再普通不过的写值。全项目查找这个setLastPostInfo，得到四个结果，在同一个文件中。net.jforum.repository/ForumRepository.java
public static LastPostInfo getLastPostInfo(Forum forum) //取指定forum的最后帖子信息
{
LastPostInfo lpi = forum.getLastPostInfo(); //取指定forum的最后帖子信息
if (lpi == null || !forum.getLastPostInfo().hasInfo()) { //信息为空
lpi = DataAccessDriver.getInstance().newForumDAO().getLastPostInfo (forum.getId()); //从数据表中取信息
forum.setLastPostInfo(lpi); //设置forum的最后帖子信息
}
return lpi; //返回forum的最后帖子信息
}
嗯，看来这个最正确了。从数据表中取信息的。
net.jforum.dao.generic/GenericForumDAO.java
public LastPostInfo getLastPostInfo(final int forumId)
{
return this.getLastPostInfo (forumId, true);
}
找到主体了：
private LastPostInfo getLastPostInfo(final int forumId, boolean origTryFix)
{
boolean tryFix = origTryFix; //是否尝试修复
final LastPostInfo lpi = new LastPostInfo();
PreparedStatement pstmt = null;
ResultSet resultSet = null;
try { //读取sql语句。并设置参数
pstmt = JForumExecutionContext.getConnection()
.prepareStatement(SystemGlobals.getSql("ForumModel.lastPostInfo"));
pstmt.setInt(1, forumId);
resultSet = pstmt.executeQuery(); //执行sql语句
if (resultSet.next()) {
lpi.setUsername(resultSet.getString("username")); //取用户名
lpi.setUserId(resultSet.getInt("user_id")); //取用户id
final SimpleDateFormat sdf = new SimpleDateFormat(SystemGlobals.getValue(ConfigKeys.DATE_TIME_FORMAT), Locale.getDefault());
lpi.setPostDate(sdf.format(resultSet.getTimestamp("post_time"))); //取发贴显示日期
lpi.setPostId(resultSet.getInt("post_id")); //取帖子ID
lpi.setTopicId(resultSet.getInt("topic_id")); //取主题ID
lpi.setPostTimeMillis(resultSet.getTimestamp("post_time").getTime()); //取发贴时间
lpi.setTopicReplies(resultSet.getInt("topic_replies")); //取主题回复数
lpi.setHasInfo(true); //设为有信息
lpi.setTitle(resultSet.getString("topic_title")); //取主题标题。
// Check if the topic is consistent
TopicDAO topicDao = DataAccessDriver.getInstance().newTopicDAO();
Topic topic = topicDao.selectById(lpi.getTopicId()); //从数据表中取主题内容
if (topic.getId() == 0) { //未取到主题，尝试修复
// Hm, that's not good. Try to fix it
topicDao.fixFirstLastPostId(lpi.getTopicId()); ////修复主题的首贴ID与尾贴ID
}
tryFix = false; //设置标志为“正常”非修复的。
}
else if (tryFix) { //未取到最后贴子信息并且需要尝试修复
resultSet.close();
pstmt.close();
int postId = this.getMaxPostId(forumId); //初始值取最大的贴子ID
//读取sql语句。并设置参数
pstmt = JForumExecutionContext.getConnection().prepareStatement(
SystemGlobals.getSql("ForumModel.latestTopicIdForfix"));
pstmt.setInt(1, forumId);
resultSet = pstmt.executeQuery();
if (resultSet.next()) {
int topicId;
topicId = resultSet.getInt("topic_id"); //取SQL执行返回值。
resultSet.close();
pstmt.close();
// Topic 更新数据表内容
pstmt = JForumExecutionContext.getConnection().prepareStatement(
SystemGlobals.getSql("ForumModel.fixLatestPostData"));
pstmt.setInt(1, postId);
pstmt.setInt(2, topicId);
pstmt.executeUpdate();
pstmt.close();
// Forum 更新数据表内容
pstmt = JForumExecutionContext.getConnection().prepareStatement(
SystemGlobals.getSql("ForumModel.fixForumLatestPostData"));
pstmt.setInt(1, postId);
pstmt.setInt(2, forumId);
pstmt.executeUpdate();
}
}
//如果是修复的，返回修复后的结果，否则返回取到的值。
return (tryFix ? this.getLastPostInfo (forumId, false) : lpi);
}
catch (SQLException e) {
throw new DatabaseException(e);
}
finally {
DbUtils.close(resultSet, pstmt);
}
}
至此，getLastPostInfo研究结束，SQL语句来自于"ForumModel.lastPostInfo"，并且还具有自查修复功能。
下面查SessionFacade.getTopicsReadTime()和userSession.getLastVisit().getTime();
net.jforum/SessionFacade.java
public static Map
{ //取属性
Map
if (tracking == null) { //如果未取到
tracking = new HashMap
setAttribute (ConfigKeys.TOPICS_READ_TIME, tracking); //设置属性
}
return tracking;
}
好象是直接去操作SESSION了。对这个我是一窍不通的。
public static Object getAttribute(final String name)
{
return JForumExecutionContext.getRequest().getSessionContext().getAttribute(name);
}
public static void setAttribute(final String name, final Object value)
{
JForumExecutionContext.getRequest().getSessionContext().setAttribute(name, value);
}
看看是什么时候设置进去的，查"setAttribute(ConfigKeys.TOPICS_READ_TIME"，找到了四处，一处是上面的设置空值，一处是setAttribute(ConfigKeys.TOPICS_READ_TIME_BY_FORUM,……)，当然也不对，一处是跟MAIL有关的，先排除，剩下最后一处最象。
但是，怎么又是空值？
SessionFacade.setAttribute(ConfigKeys.TOPICS_READ_TIME, new HashMap
回过来再看第二处那个“ConfigKeys.TOPICS_READ_TIME_BY_FORUM”的。似乎有点象。
在net.jforum.view.forum/ForumAction.java中
public void readAll() // 将所有主题标记为已读
{
String forumId = this.request.getParameter("forum_id"); //取查询参数
if (forumId != null) {
Map
if (tracking == null) { //未取到
tracking = new HashMap
}
tracking.put(Integer.valueOf(forumId), Long.valueOf(System.currentTimeMillis())); //设置forumID及当前时间
SessionFacade.setAttribute(ConfigKeys.TOPICS_READ_TIME_BY_FORUM, tracking); //设置session
}
if (forumId != null) {
JForumExecutionContext.setRedirect(this.makeRedirect("show")); //重定向到show
}
else { //重定向到list
JForumExecutionContext.setRedirect(this.request.getContextPath() + "/forums/list"
+ SystemGlobals.getValue(ConfigKeys.SERVLET_EXTENSION));
}
}
看来，session中保存的ConfigKeys.TOPICS_READ_TIME_BY_FORUM 是板块的ID及查看时间。似乎并不是ConfigKeys.TOPICS_READ_TIME。再根据“TOPICS_READ_TIME”查找全文，仍然没有新的内容。也许没有实现这个主题阅读时间的功能吧。
反正 if (tracking != null && tracking.containsKey(topicId)) { //tracking中读过此主题的记录
else {
forum.setUnread(lpi.getPostTimeMillis() > lastVisit); //主题变更时间晚于登录时间
}
现在再查lastVisit。userSession.getLastVisit().getTime();
来自于net.jforum.entities/UserSession.java
public Date getLastVisit()
{
//return new GregorianCalendar(2007, 6, 28, 15, 15, 19).getTime();
return this.lastVisit;
}
public void setLastVisit(final Date lastVisit)
{
this.lastVisit = lastVisit;
}
public void registerBasicInfo() //注册基本信息
{
this.setStartTime(new Date(System.currentTimeMillis()));
this.setLastVisit(new Date(System.currentTimeMillis()));
this.setUserId(SystemGlobals.getIntValue(ConfigKeys.ANONYMOUS_USER_ID));
this.setUsername(I18n.getMessage("Guest"));
}
除了注册基本信息中会同时设置一下最后登录时间外，应该还有其他地方设置这个值。
查"setLastVisit",嗯，挺多的。
net.jforum/ControllerUtils.java中
protected void configureUserSession(final UserSession userSession, final User user)//SSO登入认证成功后的操作。
net.jforum.view.forum/UserAction.java中
private void logNewRegisteredUserIn(final int userId, final User user) //用户注册
public void validateLogin() //用记登录校验
好了，看来这个LastVisit也仅仅是最后登录时间，而非最后看贴时间。
小结：
至此，ForumAction中的 this.context.put("allCategories", ForumCommon.getAllCategoriesAndForums(true));//页面显示的所有分类和板块（检查有无未读的贴子） 这句话研究结束。
不仅返回所有有权查看的分类、板块，同时还返回板块是否有未读贴子的状态。
关于用户认证，在net.jforum/ControllerUtils.java中的protected void configureUserSession(final UserSession userSession, final User user)//SSO登入认证成功后的操作。
及net.jforum.view.forum/UserAction.java中的 public void validateLogin() //用记登录校验
另外，用户注册在private void logNewRegisteredUserIn(final int userId, final User user) //用户注册
这几个都是我将来要改造的。