WCS开发指导手册.docx

WCS开发指导手册.docx

《WCS开发指导手册.docx》由会员分享，可在线阅读，更多相关《WCS开发指导手册.docx（14页珍藏版）》请在冰豆网上搜索。

WCS开发指导手册

一、环境搭建

1.安装JDK（1.5版本以上），软件路径：

\\192.168.3.2\常用软件\程序设计

2.安装WebSphereCommerce环境，安装文件向项目组成员索取。

搭建过程：

1）解压WCS压缩包，压缩包中会包含两个文件夹，分别是：

IBM、WCS7。

2）将IBM文件夹放到C盘如下目录：

C:

\DocumentsandSettings\AllUsers\ApplicationData（如果没有这个目录就新建此目录结构，再将IBM文件夹放在此路径）

3）将WCS7文件夹放到D盘的根目录下（注意：

WCS7必须放在D盘根目录，更改目录需要修改很多配置）

4）在D:

\WCS7\WCDE_ENT70\workspace目录下将最新的代码下载下来，并将.metadata文件夹的内容替换成最新的

3.在DOS下执行命令（需要先到D:

\WCS7\WCDE_ENT70\bin目录下）：

setdbtypeoracleE:

\app\shiwei\product\11.2.0\client_1wcsdbsystemsystem1234xiu_goodsxiu_goods192.168.3.1061521

各个参数介绍：

Oracle：

数据库类型为oracle

E:

\app\shiwei\product\11.2.0\client_1：

oracle客户端路径主要是JDBC发jar包

Wcsdb：

oracle数据库的SID

System：

oracle的system用的用户名

system1234：

oracle的system用的用户密码

xiu_goods：

oracle数据库的xiu_goods用户

xiu_goods：

oracle数据库的xiu_goods用户密码

192.168.3.106：

oracle数据库的服务器IP

1521：

oracle数据库的服务端口

4.查看日志：

D:

\WCS7\WCDE_ENT70\logs\setdbtype.log观察是否执行数据库参数修改成功。

5.如果日志提示成功，则执行D:

\WCS7\WCDE_ENT70\bin\startWCToolkit.bat，启动WCS开发平台。

6.启动成功后，界面如图：

7.先发布项目再启动WebSphereCommerceTestServer，然后打开WCS控制台。

打开WCS控制台需要打开D:

\WCS7\WCDE_ENT70\hintsandtips.html文件，界面如下图：

贸易加速器就是商品中心的管理平台入口。

注意：

1.在执行setdbtype时如果出现“此时不应该出现**”，出现此情况的原因是操作系统的环境变量值有变量的路径中有空格，如果出现环境变量有空格的为不重要的可以删除掉

2.如果在启动的时候出现端口占用情况可以执行以下命令：

1、查询本机所有端口信息

netstat-ano

2、查询结果中过滤某个端口

netstat-aon|findstr"8080"

3、查看进程信息

tasklist|findstr"8080"

4、结束进程

tskill8080

查看进程的pid:

tasklist

根据进程号查询进程：

tasklist|findstr"3208"

二、WCS介绍

WCS是WebSphereCommerceServer的简称

1.WebSphereCommerce软件组件

2.框架代码结构

2.1前台部分

WebSphereCommerceServerExtensionData：

这个项目负责与底层数据库交互，存放的是所有EJB，包括EJB技术产生的数据模型（由数据库表映射产生）、实体Bean、AccessBean、主键类、远程home接口类等，这个实际上后台也会用到。

WebSphereCommerceServerExtensionLogic：

这个项目存放的是所有逻辑控制的JAVA类，包括：

DataBeanCommand、ControllerCommand、TaskCommand，所有的Command通过调用M层的EJB完成与数据库的交互操作，这个实际上后台也会用到。

Stores：

这个项目是以Struts1.1技术实现的jsp展示层，所有的前台展示所用JSP全部存放在这里，通过Struts技术实现JSP与逻辑控制层的交互。

2.2后台部分

CommerceAccelerator：

贸易加速器。

WCS本身提供的销售管理后台，负责比如商品管理、广告管理、价格管理、促销管理等功能。

该模块的使用者是业务人员。

OrganizationAdministration：

组织管理控制台。

WCS本身提供的人员组织管理，负责人员角色的创建、角色权限的分配。

该模块的使用者是人事管理人员。

SiteAdministration：

站点管理控制台。

WCS本身提供的站点、商店管理，负责配置商店等功能。

该模块的使用者是超级管理员或业务人员（视具体情况而定）。

以上三个部分都是以Struts+XML技术来实现的（Struts框架本身就是一个MVC2的架构）。

3.运行时框架（Runtimeframework）结构图

4.WCS的MVC模型—视图—控制器

5.WebSphereCommerce核心控制和业务处理command

▪每个command有一个接口，和至少一个实现类。

▪基于command的默认实现类和数据库中的注册信息，使用command工厂可以把接口映射到正确的将要被调用的实现类。

▪客户仅需要使用command的接口就可以通过以下步骤调用该command：

--设置command的输入属性

--调用command的execute（）方法

--获取command的输出属性

5.1Command的分类：

5.1.1Controllercommands（OrderProcessCmd）

1.封装了完成一个服务请求所需的所有逻辑

2.调用taskcommands以执行各工作单元，并对整个应用逻辑流进行控制以满足整个请求

3.整个流程完成后，返回一个视图名给Web控制器，然后Web控制器负责决定当前商店和发出请求所用设备的view实现类

5.1.2Taskcommands

1.每个taskcommand执行一个工作单元

2.Taskcommand通常使用accessbean包装器（其隐藏了与EJB交互的复杂度）来访问单个业务数据

5.1.3Databeancommands

JSP模板通过databean管理器调用databeancommand，其目的是为了得到相应的databeans

5.1.4Viewcommands

1.重定向（Redirect）viewcommand–使用redirect协议发送view

2.定向（Direct）viewcommand–直接发送view给客户

3.转发（Forward）viewcommand–转发view请求给另一个Web控制器（通常是一个JSPtemplate）

6.WCS的O/R映射

6.1持久化对象层（EJB2.1组件架构）

1.WebSphereCommerce中大多数实体bean基于EJB1.1，少部分基于EJB2.0

2.WebSphereCommerce所有的EJB模块基于EJB2.X

3.使用sessionbean作为JDBCHelper（服务facade）进行复杂的查询

6.2WebSphereCommerce实体bean

三、WCS开发

1.WCS代码结构分析

1.1CommerceAccelerator后台界面开发工程

此工程主要是后台管理页面和控制类配置，工程是基于sturts1.*。

工程代码目录结构图：

下面简单介绍下WebContent目录下各个目录

描述

WebContent/css

CSS存放目录

WebContent/images

图片存放目录

WebContent/javascript

工具js文件存放目录

WebContent/META-INF

WebContent/perfmonitor

WCS平台性能监视页面（多国语言）

WebContent/reports

WCS系统报表（多国语言）

WebContent/templates

批量批价模版

WebContent/tools

WCS系统管理页面

WebContent/tools-xiu

OpenXiu扩展管理页面

WebContent/WEB-INF

Web配置文件如web.xml、sturts配置文件等存放目录，其中struts-config-ext.xml配置文件为OpenXiu的sturts扩展配置文件。

Sturts配置文件分析：

xmlversion="1.0"encoding="UTF-8"?

>

DOCTYPEstruts-configPUBLIC"-//ApacheSoftwareFoundation//DTDStrutsConfiguration1.2//EN""dtds/struts-config_1_2.dtd">

path="/PriceReviewAddCmd"type="merce.struts.BaseAction">

0"/>

0"/>

上面为sturts配置文件的部分配置代码：

节点名称

描述

global-forwards

所有页面跳转配置

forward

针对单个Action跳转页面相信配置

name同action的path名称一致

className为WCS页面跳转基类

path为跳转的页面路径

action-mappings

action配置节点

type为WCS的actionMapping基类

action

Parameter为自定义action的实现类

Path为action的名称

Type为WCS的action基类

Set-property为设置action属性

Property为属性名称

Value为属性值

在jsp页面上直接调用path的配置即可进入控制类

在jsp中是通过top.setContent（“资源文件取值”,”请求地址”,true,”请求参数”）来触发action的跳转功能

1.2WebSphereCommerceServerExtensionsLogic后台逻辑开发工程

此工程是command逻辑实现的工程，业务处理全部在此工程实现。

工程代码目录结构图：

源码包结构分析：

包名称

描述

merce.attributeDict

商品中心-属性

merce.brand

商品中心-品牌

merce.category

商品中心-分类

merce.catgroup

商品中心-分类组

mon

公共包

merce.exl

扩展包

merce.goodscenter

商品中心

merce.helpers

系统属性包

merce.hessian

对外接口

merce.log

日志

merce.period

商品中心-调度

merce.portal

Portal业务

merce.pricereview

商品中心-价格

merce.product

商品中心-商品

merce.sale

merce.standardColour

标准色

merce.storeManage

渠道

merce.util

工具包

merce.utils

工具包

1.3WebSphereCommerceServerExtensionsData后台数据持久层

定义EJB数据库访问的操作方法

1.4WC（WCS的集成发布工程）

此工程是集成其他几个工程的web应用工程，次工程是数据库配置，系统参数读取等的操作。

其中wc-server.xml配置文件是系统集成的主要配置文件。

而在配置文件中的需要主意的配置是registry，此配置是在WCS启动的时候首先加载类的配置。

注意：

在环境搭建中执行setdbtype命令的时候修改的就是wc-server.xml文件数据配置信息。

2.WCS开发流程

WCS是MVC的架构（针对商品中心）：

M层：

WebSphereCommerceServerExtensionsData

V层：

CommerceAccelerator

C层：

WebSphereCommerceServerExtensionsLogic