JForum安装用例

1，键入http://localhost:8080/JForum/install.jsp

2，install.jsp有一个自动跳转；跳转到install/install.page?module=install&action=welcome

3，服务器截获install/install.page请求；交给一个名为net.jforum.InstallServlet的Servlet处理

4，如果net.jforum.InstallServlet是第一次启动，先要执行其init()方法。在该方法中：

 4.1调用父类JForumBaseServlet的init()方法。

 （一）加载日志文件。

  (1)装载/WEB-INF/log4j.xml日志文件

 （二）加载系统的全局变量。

  (2)使用ConfigLoader类装载系统全局变量属性文件/WEB-INF/config/SystemGlobals.properties和数据库属性文件/WEB_INF/config/database/mysql/mysql.properties

  (3)判断/WEB_INF/config/jforum-custom.conf是否存在，如果存在加载该配置文件中的属性
 
 （三）启动系统的缓存机制。

  (4)使用ConfigLoader类的startCacheEngine()方法启动缓存引擎，在该方法中：

   a.创建net.jforum.cache.DefaultCacheEngine类的对象

   b.调用net.jforum.cache.DefaultCacheEngine对象的init()方法，在该创建一个HashMap对象。

   c.在SystemGlobals.properties中找到需要缓存的对象(在"cacheable.objects"键中指明)，将刚刚创建的net.jforum.cache.DefaultCacheEngine对象传递给这些需要缓存的对象。这些缓存的对象包括：

   net.jforum.repository.BBCodeRepository, 
   net.jforum.repository.RankingRepository, 
   net.jforum.repository.SmiliesRepository, 
   net.jforum.repository.ForumRepository, 
   net.jforum.repository.TopicRepository, 
   net.jforum.SessionFacade, 
   net.jforum.repository.PostRepository, 
   net.jforum.repository.Tpl, 
   net.jforum.repository.RolesRepository, 
   net.jforum.repository.SecurityRepository, 
   net.jforum.repository.BanlistRepository

 （四）加载FreeMarker模板。
  
  (5)创建FreeMarker的配置对象Configuration

  (6)创建FreeMarker的模板加载器FileTemplateLoader

  (7)在配置对象Configuration设置模板加载器FileTemplateLoader
 
 （五）加载模块库。

  (8)借助ModulesRepository类在缓存中加载模块库。ModulesRepository类中有一个HashMap对象，该对象中有一个键名是entries，对应的值类型是Properties。该Properties对象是通过ConfigLoader的loadModulesMapping方法加载modulesMapping.properties文件实现的。modulesMapping.properties文件中描述了字符串与特定模块之间的映射关系（某个模块Module实际上是指某个特定的Action）。这样就实现了字符串与特定Action类的映射。

 （六）通过JForumBaseServlet类的loadConfigStuff()加载其他的配置文件

  (9)调用ConfigLoader类的loadUrlPatterns()方法加载urlPattern.properties文件

  (10)调用I18n类的load()方法加载locales.properties。

  (11)加载templatesMapping.properties文件

 （七）将FreeMarker的配置对象Configuration，存储到JForumExecutionContext中。

5，net.jforum.InstallServlet执行其service()方法

 5.1从SystemGlobals.properties文件中取出encoding属性。默认是UTF-8。

 5.2设置HttpRequest请求编码为UTF-8。

 5.3创建WebRequestContext对象

  (一)分析请求类型
  
   (1)获取请求的方法类型并转换成大写(GET/POST)，在安装用例中请求类型是GET。

  (二)提取URI
  
   (1)获取请求的上下文路径，即web项目的名称，比如：/JForum

   (2)借助extractRequestUri(String requestUri, String contextPath)方法，提取uri剔除原始uri中含有的上下文部分，比如：/forums/install.page

   (3)分析URI中是否含有sessionid，用过分号识别。
  
  (三)URL请求分析

   (1)从SystemGlobals.properties配置文件中取出编码的配置方式，即UTF-8。

   (2)获取servlet截获的后缀名，即.page。

   (3)判断请求方式requestType是GET请求还是POST请求，在安装用例中是GET请求。

   (4)判断查询字符串是否为空，通过HttpRequest的getQueryString()方法获取查询字符串即?后面的部分。在安装用例中是：module=install&action=welcome。

   (5)判断是form提交的POST请求，还是form提交的GET请求，还是URL提交的GET请求。在安装用例中是URL提交的GET请求。

   (6)判断MIME类型，推断是否有文件上传。安装用例中没有文件上传。
   
   (7)判断是否有Ajax异步请求，在安装用例中没有异步请求。
   
   (8)借助superRequest.setCharacterEncoding(encoding)对客户端请求进行重新编码。即UTF-8。

   (9)从SystemGlobals.properties配置文件中取出容器的编码配置。

   (10)把URL中的查询字符串取出，并调用addParameter(String name, Object value)方法，把参数及参数值存储到WebRequestContext对象的query属性中。在存入过程中，借助(1)、(9)对参数值进行编码转换。
  
 5.4创建WebResponseContext对象

 5.5创建JForumExecutionContext类对象
 
  Thread类中有个属性是ThreadLocalMap对象，在这个ThreadLocalMap对象中，以某个ThreadLocal类的对象为键，以该Thread对象需要保有的数据为值。以ThreadLocal类的set()和get()方法作为操作接口，实现Thread对象和其保有的局部数据之间的映射。

  在JForum中，这个需要保有的数据就是JForumExecutionContext类的对象。该对象实际上是一个数据访问接口或者也可以称之为一个大容器。通过保有该对象，就可以访问到一些数据。比如：

   private Connection conn;
   private ForumContext forumContext;
   private SimpleHash context = new SimpleHash(ObjectWrapper.BEANS_WRAPPER);
   private String redirectTo;
   private String contentType;
   private boolean isCustomContent;
   private boolean enableRollback;

  上面这些数据都是每个线程一份副本。还有一些数据是多线程共享的，比如：

   private static ThreadLocal userData = new ThreadLocal();
   private static Logger logger = Logger.getLogger(JForumExecutionContext.class);
   private static Configuration templateConfig;

 5.6创建JForumContext类对象，该对象持有/JForum上下文路径、servlet截获的后缀名、request对象、response对象。将上述JForumContext类对象存储到JForumExecutionContext中。
 
 5.7将JForumExecutionContext对象存储到当前线程中的ThreadLocalMap中，在该Map中以JForumExecutionContext类对象的ThreadLocal属性为键，以JForumExecutionContext类对象为值。

 5.8用SimpleHash装载模板环境。包括：

  contextPath;
  serverName;
  templateName;
  serverPort;
  I18n;
  encoding;
  extension;
  JForumContext;
  version;

 5.9判断安装用例是否已经运行过，如果没有

  （一）取得模块类的名字，在安装用例中是"net.jforum.view.install.InstallAction"

  （二）在SimpleHash中添加键值对moduleName——install、action——welcome

  （三）利用response构建输出流

  （四）创建net.jforum.view.install.InstallAction类的对象。

  （五）调用net.jforum.view.install.InstallAction类的process(RequestContext request, ResponseContext response, SimpleHash context)方法。

   (1)设定模板default/empty.htm。

   (2)调用父类Command的process(RequestContext request, ResponseContext response, SimpleHash context)方法。

    a.取得action的名字"welcome"

    b.通过Java的反射机制调用InstallAction类的welcome()方法

     b1调用InstallAction类的checkLanguage()方法

      获取语言类型

      依据语言类型加载config/languages下的语言配置文件

      创建UserSession，将语言类型存储到UserSession中

      通过SessionFacade存储UserSession,本质上是存储在WebRequestContext中。但WebRequestContext存储在JForumContext中，而JForumContext又存储在JForumExecutionContext中，所以这个存储流程罗嗦异常。

      在Session和FreeMarker的SimpleHash中添加language属性。

     b2在SimpleHash中添加如下属性：

      "language", 
      "database"
      "dbhost"
      "dbuser"
      "dbname"
      "dbport"
      "dbpasswd"
      "dbencoding"
      "use_pool"
      "forumLink"
      "siteLink"
      "dbdatasource"
     
     b3设置模版install.htm

    c.JForumExecutionContext中的redirectTo属性置空。
    
    d.存储请求的模板名。

    e.装载模板。

 5.10从JForumExecutionContext中取出重定向到信息，如果不为空就进行页面跳转。安装用例中为空。

 5.11调用JForumExecutionContext类的finish()方法释放资源。在安装用例中主要释放当前线程的局部数据。