推荐系统Easyrec框架与代码结构

整体框架

EasyRec是一个易集成、易扩展、功能强大且具有可视化管理的推荐系统。EasyRec可以同时给多个不同的网站提供推荐服务，通过商户(tenan)来区分不同的网站。架设EasyRec服务器，为网站申请商户Id(tenant)，通过商户Id就可以很方便地将推荐服务集成到网站中。通过各种不同的数据收集动作（view,buy.rating）API收集到网站的用户行为(Action)，EasyRec 推荐引擎的离线分析组件通过分析计算，就可以产生推荐信息，网站就可以通过个性化推荐(Recommendations)和公共排名(Community Rankings)来进行推荐业务的实现。

从源码来看，EasyRec纵向采用三层架构模式（展现层、业务层和持久层），横向采用模块化（核心模块，插件模块，特定领域模块及推荐模块等）。可以清晰的了解到，EacyRec 的分层很清晰，下面是我理解的模块结构图。

代码结构

Easyrec代码框架很清晰，目前项目由八个部分组成。

上下文组件(Content)

这一模块包含商品关联规则的生成器，随Web应用一起发布并预装的生成器。目前，

关联规则生成器是唯一预装的生成器，并作为推荐系统的离线生成器的服务组件。

This module holds item association generators that are delivered with the webapp and preinstalled as generators. Currently the 'AssocRuleMiner' is the only preinstalled generator, which also serves as offline generator.

核心组件(Core)

这一模块是推荐系统Easyrec的核心包，它包含了系统所有的数据模型对象、数据访问和基本数据服务的相关的所有类。基本的数据服务包括：ActionService、ItemAssocService、RecommenderService和RecommendationHistoryService。在这个模块中所有的类与接口都提供了最一般的方法，对特定信息域，如动作与项目对象，能进行不同的参数化。

This module is the core package of easyrec. It contains model objects, classes for database access and basic services like the 'ActionService', the 'ItemAssocService', the

'RecommenderService' and the 'RecommendationHistoryService'. All interfaces and classes in this module provide generic methods, thus domain information like action or item types can be parameterized individually.

域组件(Domain)

为了对特定领域的内容分离，引入这个包。域组件包提供了为一个通用领域提供服务和数据库访问的类，如象音乐领域这样的特定领域。同时为集成对评价动作信息，提供对第三方数据进行访问的附加接口与实用工能类。

For the isolation of domain specific content, this package is introduced, providing services and database access classes for a generic domain, as well as for specific domains like the music domain. Additional interfaces for the access of Third-Party data and a utility class for the aggregation of actions to ratings are included.

插件API接口包(Plugin API)

插件API接口包提供推荐系统Easyrec插件开发的基础。它提供了实现推荐系统插件所需的所有接口。是所有插件的父类，定义了扩展插件需要实现的接口。

This module provides the basis for plugin development. It provides interfaces a plugin provider needs to implement.

插件容器(Plugin Container)

插件容器提供插件执行的框架。

This module provides the framework for plugin execution.

插件组件(Plugins)

插件组件包本身就是一个父模块，同时也是目前easyrec支持的多个插件的集合。

This module is a parent module itself, and bundles several plugins for easyrec.

功能组件包(Utils)

功能组件包包含推荐系统Easyrec中其它模块所需要使用的功能类。

This module provides utility classes used within all other modules of the easyrec. Web组件(Web)

Web模块是对推荐系统的各种Web服务方法的扩展，从而为各个领域提供模型对象，数据访问类和服务。另外“idmappingservice”允许将外部的字符串IDS到内部的整数ID映射；h 此外，“authenticationservice”管理几个商户的对Web服务方法的授权访问。

This module is concerned with the propagation of various Web service methods of the recommender system, hence providing model objects, data access classes and services for various domains. Additionally an 'IDMappingService' allows for the mapping of external 'String' ids to internal 'Integer' ids. Furthermore the 'AuthenticationService' manages the access of Web service methods for several tenants.