1.概述
一个软件设计的好坏,我想很大程度上取决于它的整体架构,而这个整体架构其实就是你对整个宏观商业业务的抽象框架,当代表业务逻辑的高层抽象层结构 合理时,你底层的具体实现需要考虑的就仅仅是一些算法和一些具体的业务实现了。当你需要再开发另一个相近的项目时,你以前的抽象层说不定还可以再次利用 。面对对象的设计,复用的重点其实应该是抽象层的复用,而不是具体某一个代码块的复用。
说到了抽象,我就不能不提到曾让我头痛的Java接口和Java抽象类了,这也是本文我想说的重点。
既然面向对象设计的重点在于抽象,那Java接口和Java抽象类就有它存在的必然性了。
Java接口(interface)和Java抽象类(abstract class)代表的就是抽象类型,就是我们需要提出的抽象层的具体表现。
OOP面向对象的编程,如果要提高程序的复用率,增加程序 的可维护性,可扩展性,就必须是面向接口的编程,面向抽象的编程,正确地使用接口、抽象类这些有用的抽象类型作为你结构层次上的顶层。
Java接口和Java抽象类有太多相似的地方,又有太多特别的地方,究竟在什么地方,才是它们的最佳位置呢?把它们比较一下,你就可以发现了。
1、Java接口和Java抽象类最大的一个区别,就在于Java抽象类可以提供某些方法的部分实现,而Java接口不可以(就是interface中只能定义方法,而不能有方法的实现,而在abstract class中则可以既有方法的具体实现,又有没有具体实现的抽象方法),这大概就是Java抽象类唯一的优点吧,但这个优点非常有用。
如果向一个抽象类里加入一个新的具体方法时,那么它所有的子类都一下子都得到了这个新方法,而Java接口做不到这一点,如果向一个Java接口里加入一个 新方法,所有实现这个接口的类就无法成功通过编译了,因为你必须让每一个类都再实现这个方法才行,这显然是Java接口的缺点。
2、一个抽象类的实现(这里的实现只能通过extend)只能由这个抽象类的子类给出,也就是说,这个实现处在抽象类所定义出的继承的等级结构中,而由于Java语言的类的单继承性(参考我的另一篇文章总结:Java中的单继承和多继承),所以抽象类作为类型定义工具的效能大打折扣。
在这一点上,Java接口的优势就出来了,任何一个实现了一个Java接口所规定的方法的类都可以具有这个接口的类型,而一个类可以实现任意多个Java接口,从而这个类就有了多种类型。(使用抽象类,那么继承这个抽象类的子类类型就比较单一,因为子类只能单继承抽象类;而子类能够同时实现多个接口,因为类型就比较多。接口和抽象类都可以定义对象,但是只能用他们的具体实现类来进行实例化。)
3、从第2点不难看出,Java接口是定义混合类型的理想工具,混合类表明一个类不仅仅具有某个主类型的行为,而且具有其他的次要行为。
4、结合1、2点中抽象类和Java接口的各自优势,具精典的设计模式就出来了:声明类型的工作仍然由Java接口承担,但是同时给出一个Java 抽象类,且实现了这个接口,而其他同属于这个抽象类型的具体类可以选择实现这个Java接口,也可以选择继承这个抽象类,也就是说在层次结构中,Java 接口在最上面,然后紧跟着抽象类,这下两个的最大优点都能发挥到极至了。这个模式就是“缺省适配模式”。在Java语言API中用了这种模式,而且全都遵循一定的命名规范:Abstract +接口名。(A extends AbstractB implements interfaceC,那么A即可以选择实现(@Override)接口interfaceC中的方法,也可以选择不实现;A即可以选择实现(@Override)抽象类AbstractB中的方法,也可以选择不实现;同时 AbstractB 可以选择实现 interfaceC的方法,也可以选择不实现)
实际项目代码:BaseDocTagModel.java
package com.portal.doccenter.action.tag.base;
import com.portal.doccenter.service.ArticleService;
import com.portal.doccenter.service.ChannelService;
import com.portal.sysmgr.entity.Site;
import com.portal.sysmgr.service.SiteService;
import com.portal.sysmgr.utils.ContextTools;
import com.portal.sysmgr.utils.TagModelTools;
import com.portal.sysmgr.utils.ViewTools;
import freemarker.core.Environment;
import freemarker.template.TemplateDirectiveModel;
import freemarker.template.TemplateException;
import freemarker.template.TemplateModel;
import java.util.Date;
import java.util.Map;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Page;
/*
* @param null:
* @return null
* @author zzp
* @description 文章标签基础类,继承 freemaker 中的TemplateDirectiveModel接口
* 通过实现FreeMarker的TemplateDirectiveModel就在后端实现了一个自定义的宏,
* 这里定义未抽象类并没有实现 TemplateDirectiveModel中 void execute()方法,留个其他实现抽象类的子类(如下文中的DocListTagModel.java)去实现该方法
* @date 2021-10-13 15:06
*/
public abstract class BaseDocTagModel
implements TemplateDirectiveModel
{
public static final String PARAM_CHANNEL_ID = "cId";
public static final String PARAM_MODEL_ID = "mId";
public static final String PARAM_DEPART_ID = "dId";
public static final String PARAM_USER_ID = "uId";
public static final String PARAM_CALL_LEVEL = "callLevel";
public static final String PARAM_TYPE_ID = "tId";
public static final String PARAM_RECOMMEND = "recommend";
public static final String PARAM_DATE = "date";
public static final String PARAM_ORDER_BY = "orderBy";
@Autowired
protected ChannelService channelService;
@Autowired
protected SiteService siteService;
@Autowired
protected ArticleService articleService;
protected Integer[] getChannelIds(Map<String, TemplateModel> params)
throws TemplateException
{
Integer[] ids = TagModelTools.getIntArray("cId", params);
if ((ids != null) && (ids.length > 0)) {
return ids;
}
return null;
}
protected Integer getDepartId(Map<String, TemplateModel> params)
throws TemplateException
{
return TagModelTools.getInt("dId", params);
}
protected Integer getUserId(Map<String, TemplateModel> params) throws TemplateException
{
return TagModelTools.getInt("uId", params);
}
protected Date getDate(Map<String, TemplateModel> params) throws TemplateException
{
return TagModelTools.getDate("date", params);
}
protected Integer[] getModelIds(Map<String, TemplateModel> params) throws TemplateException
{
Integer[] ids = TagModelTools.getIntArray("mId", params);
if ((ids != null) && (ids.length > 0)) {
return ids;
}
return null;
}
protected int getCallLevel(Map<String, TemplateModel> params)
throws TemplateException
{
Integer callLevel = TagModelTools.getInt("callLevel", params);
if ((callLevel == null) || (callLevel.intValue() < 0)) {
return 0;
}
return callLevel.intValue();
}
protected Integer[] getTypeIds(Map<String, TemplateModel> params)
throws TemplateException
{
Integer[] typeIds = TagModelTools.getIntArray("tId", params);
return typeIds;
}
protected Boolean getRecommend(Map<String, TemplateModel> params) throws TemplateException
{
String recommend = TagModelTools.getString("recommend", params);
if ("1".equals(recommend)) {
return Boolean.valueOf(true);
}
return null;
}
protected int getOrderBy(Map<String, TemplateModel> params)
throws TemplateException
{
Integer orderBy = TagModelTools.getInt("orderBy", params);
if (orderBy == null) {
return 0;
}
return orderBy.intValue();
}
protected Object getData(Map<String, TemplateModel> params, Environment env)
throws TemplateException
{
int orderBy = getOrderBy(params);
Boolean recommend = getRecommend(params);
Integer siteId = ViewTools.getSite(env).getId();
Integer departId = getDepartId(params);
Integer userId = getUserId(params);
Date date = getDate(params);
Integer[] typeIds = getTypeIds(params);
int count = ViewTools.getCount(params);
Integer[] channelIds = getChannelIds(params);
if (channelIds != null) {
Integer[] modelIds = getModelIds(params);
int callLevel = getCallLevel(params);
if (isPage()) {
int pageNo = ViewTools.getPageNo(env);
Page p = this.articleService.getPageTagByChannelIds(
channelIds, siteId, modelIds, typeIds, departId,
userId, recommend, date, orderBy, callLevel, pageNo,
count);
ContextTools.setTotalPages(Integer.valueOf(p.getTotalPages()));
return p;
}
int first = ViewTools.getFirst(params);
return this.articleService.getListTagByChannelIds(channelIds,
siteId, modelIds, typeIds, departId, userId, recommend,
date, orderBy, callLevel, Integer.valueOf(first), Integer.valueOf(count));
}
Integer[] modelIds = getModelIds(params);
if (modelIds != null) {
if (isPage()) {
int pageNo = ViewTools.getPageNo(env);
Page p = this.articleService.getPageTagByModelIds(modelIds,
typeIds, siteId, recommend, orderBy, pageNo, count);
ContextTools.setTotalPages(Integer.valueOf(p.getTotalPages()));
return p;
}
int first = ViewTools.getFirst(params);
return this.articleService.getListTagByModelIds(modelIds, typeIds,
siteId, recommend, orderBy, Integer.valueOf(first), Integer.valueOf(count));
}
if (isPage()) {
int pageNo = ViewTools.getPageNo(env);
Page p = this.articleService.getPageTagByChannelIds(null,
siteId, null, typeIds, departId, userId, recommend, date,
orderBy, 0, pageNo, count);
ContextTools.setTotalPages(Integer.valueOf(p.getTotalPages()));
return p;
}
int first = ViewTools.getFirst(params);
return this.articleService.getListTagByChannelIds(null, siteId, null,
typeIds, departId, userId, recommend, date, orderBy, 0,
Integer.valueOf(first), Integer.valueOf(count));
}
protected abstract boolean isPage();
}
实际项目代码:DocListTagModel.java
package com.portal.doccenter.action.tag;
import com.portal.doccenter.action.tag.base.BaseDocTagModel;
import com.portal.doccenter.entity.Article;
import com.portal.doccenter.service.ArticleService;
import com.portal.sysmgr.entity.Site;
import com.portal.sysmgr.utils.TagModelTools;
import com.portal.sysmgr.utils.ViewTools;
import freemarker.core.Environment;
import freemarker.template.ObjectWrapper;
import freemarker.template.TemplateDirectiveBody;
import freemarker.template.TemplateException;
import freemarker.template.TemplateModel;
import java.io.IOException;
import java.util.List;
import java.util.Map;
import org.apache.commons.lang.StringUtils;
public class DocListTagModel extends BaseDocTagModel
{
public static final String TPL_NAME = "tplName";
public static final String PARAM_IDS = "ids";
@Override
public void execute(Environment env, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body)
throws TemplateException, IOException
{
Site site = ViewTools.getSite(env);
String tplName = TagModelTools.getString("tplName", params);
List list = getList(params, env);
env.setVariable("list", ObjectWrapper.DEFAULT_WRAPPER.wrap(list));
env.setVariable("isPage", ObjectWrapper.DEFAULT_WRAPPER.wrap(Boolean.valueOf(false)));
if (!StringUtils.isBlank(tplName)) {
ViewTools.includeTpl(tplName, site, env);
}
else if (body != null)
body.render(env.getOut());
}
protected List<Article> getList(Map<String, TemplateModel> params, Environment env)
throws TemplateException
{
Integer[] ids = TagModelTools.getIntArray("ids", params);
if (ids != null) {
return this.articleService.getListTagByIds(ids, getOrderBy(params));
}
return (List)super.getData(params, env);
}
protected boolean isPage()
{
return false;
}
}