JEECMS开发文档

1.在myeclipse中新建一个项目jeecms，将服务器中jeecms项目下web-inf文件夹下内容拷到新建项目中2.解压缩jeecms-3.0.2-final-src，在src文件夹下会看到有三个压缩文件，如果只想进行普通的二次开发，可以只导入cms这个源码，删除j eecms-cms-identity-3.0.2-final.jar即可，如果想进行深入的二次开发，需要导入common和core源码，另导入common-lib下的jar包，删除jeecms-cms- identity-3.0.2-final.jar，jeecms-common-3.0.2-final.jar ，jeecms-core- identity-3.0.2-final.jar这三个jar包，切记：务必进行build path3.修改jdbc链接，自己导入数据库。

4.把服务器下install\config下的web.xml复制出来覆盖掉新建项目WEB-INF下的web.xml5.classes下有四个文件，手动烤到myeclipse项目src根目录下中6.将服务器上jeecms项目删掉，发布新建的jeecms项目。

首页的加载过程：在浏览器中输入http://localhost:8080/jeecms，回车首先进入配置文件web.xml，<context-param><param-name>contextConfigLocation</param-name><!----><param-value>/WEB-INF/config/application-context.xml/WEB-INF/config/cache-context.xml/WEB-INF/config/captcha-context.xml/WEB-INF/config/jeecore-context.xml/WEB-INF/config/jeecms-context.xml</param-value></context-param>应用范围内的初始化参数其中jeecms-context.xml是对标签的初始化<welcome-file-list><welcome-file>index.html</welcome-file><welcome-file>index.shtml</welcome-file><welcome-file>index.jhtml</welcome-file></welcome-file-list>通过以上标签找到应该加载哪一个页面<servlet><servlet-name>JeeCmsFront</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>/WEB-INF/config/jeecms-servlet-front.xml</param-value></init-param><load-on-startup>2</load-on-startup></servlet><servlet-mapping><servlet-name>JeeCmsFront</servlet-name><url-pattern>*.jhtml</url-pattern></servlet-mapping><servlet-mapping><servlet-name>JeeCmsFront</servlet-name><url-pattern>*.jspx</url-pattern></servlet-mapping><servlet-mapping><servlet-name>JeeCmsFront</servlet-name><url-pattern>*.jsp</url-pattern></servlet-mapping><servlet-mapping><servlet-name>JeeCmsFront</servlet-name><url-pattern>*.htm</url-pattern></servlet-mapping>通过servlet配置，可以找到jeecms-servlet-front.xml，在此配置文件的最后有<import resource="jeecms-servlet-front-action.xml"/>代码找到jeecms-servlet-front-action.xml，在此配置文件中有<bean id="dynamicAct" class="com.jeecms.cms.action.front.DynamicPageAct"/>可以找到类DynamicPageAct，此类是首页模板。

在类DynamicPageAct中有public static final String TPL_INDEX = "tpl.index";找到WEB-INF\languages\jeecms_front下messages_zh_CN.properties配置文件，可以找到对应的首页面tpl.index=首页(工程中的首页.html文件)标签的配置流程，以cms_content_list为例首先，每一个标签的声明都是在jeecms-context.xml中进行的，<?xml version="1.0" encoding="UTF-8"?><beans xmlns="/schema/beans" xmlns:xsi="/2001/XMLSchema-instance "xsi:schemaLocation="/schema/beans /schema/beans/sprin g-beans-3.0.xsd"default-lazy-init="true">……<bean id="cms_content_list" class="com.jeecms.cms.action.directive.ContentListDirective"/>(声明标签对应的类)<bean id="staticPageSvc" class="com.jeecms.cms.staticpage.StaticPageSvcImpl"><property name="freeMarkerConfigurer"><bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"><property name="freemarkerVariables"><map>……<entry key="cms_content_list" value-ref="cms_content_list"/>……</map></property><property name="templateLoaderPath" value=""/>……</bean></property></bean></beans>此外，在配置文件jeecms-servlet-front.xml中，还有一段对标签的配置<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer"><property name="freemarkerVariables"><map>……<entry key="cms_content_list" value-ref="cms_content_list"/>……</map></property>……</bean></bean>类ContentListDirective继承自AbstractContentDirective，最主要的是execute方法public class ContentListDirective extends AbstractContentDirective {/*** 模板名称*/public static final String TPL_NAME = "content_list";/*** 输入参数，文章ID。

允许多个文章ID，用","分开。

排斥其他所有筛选参数。

*/public static final String PARAM_IDS = "ids";@SuppressWarnings("unchecked")public void execute(Environment env, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body) throws TemplateException, IOException {//获取站点CmsSite site = FrontUtils.getSite(env);//获取内容列表，可以通过此处进行更改，获取自己数据库中的数据List<Content> list = getList(params, env);Map<String, TemplateModel> paramWrap = new HashMap<String, TemplateModel>( params);//OUT_LIST值为tag_list，在类DirectiveUtils中声明，将内容列表放入其中paramWrap.put(OUT_LIST, DEFAULT_WRAPPER.wrap(list));//将params的值复制到variable中Map<String, TemplateModel> origMap = DirectiveUtils.addParamsToVariable(env, paramWrap);//获取的是参数PARAM_TPL，是否调用模板以及调用的模板类型InvokeType type = DirectiveUtils.getInvokeType(params);//获取传入参数，列表样式，根据不同的参数获取不同的样式列表String listStyle = DirectiveUtils.getString(PARAM_STYLE_LIST, params);if (InvokeType.sysDefined == type) {if (StringUtils.isBlank(listStyle)) {throw new ParamsRequiredException(PARAM_STYLE_LIST);}//列表样式模板env.include(TPL_STYLE_LIST + listStyle + TPL_SUFFIX, UTF8, true);} else if (erDefined == type) {if (StringUtils.isBlank(listStyle)) {throw new ParamsRequiredException(PARAM_STYLE_LIST);}//列表样式模板路径 WEB-INF\t\cms_sys_defined\style_list\style_2-1.htmlFrontUtils.includeTpl(TPL_STYLE_LIST, site, env);} else if (InvokeType.custom == type) {//这个模板就是自己声明的，即content_list.html，如果采用自定义模板的话，页面中可以只写上标签，并添加上标签内需要的几个参数，不需要写标签体的内容，会去自动调用模板中的标签体。