一个典型的Web应用通常是由一组数据（Database）对象（包括Model和持久化数据库），控制（Controller）对象、工作任务（Job）对象和一个单一的计划（Schema）对象将它们紧紧地联系在一起。在这种情况下，应用可以使用一个普通的“View handler”进行测试。以下的提供的源码是一个股票买卖的例子，Orange Trader，2002年4月由Peter Pilgrim编写。

5.1 创建包

通常需要创建如下包：

² dbobj: 包含数据库对象；

² controller: 包含控制器对象；

² job: 包含工作任务对象，可选；

5.2 创建一个Schema对象

Schema：a Web Application Context object

创建一个Schema对象，放在包的根；Schemo对象为Expresso提供全部的引用，用以安全管理等（注册后），这是设计模式的FACADE模式思想。

必需做的工作：

1. 加入所有的和应用相关的controllers, dbobjects or jobs；

2. 设置MessageBundle路径，getMessageBundlePath()返回国际化项目资源所在路径；

最容易的方法是拷贝一个现成的Schema类进行修改，如：

<OrangeTraderSchema.java>

import com.jcorporate.expresso.core.db.*;

import com.jcorporate.expresso.core.dbobj.Schema;

public class OrangeTraderSchema extends Schema

{

public OrangeTraderSchema() throws DBException

{

super();

try {

addDBObject( "com.xenonsoft.orangetrader.ot1.dbobj.StockTrade" );

addController( "com.xenonsoft.orangetrader.ot1.controller.StockController" );

}

catch ( Throwable t ) {

throw new DBException( t.getMessage() );

}

public String getMessageBundlePath() {

return "com/xenonsoft/orangetrader";

}

5.3 创建一些需要的数据（DB）对象

通常情况下，所有数据对象类均放在dbobj包里，并使用Schema类注册这些数据对象，以便DBTool和DBCreate能够使用它们。

数据对象是为Expresso的持久层而设计的，相当于EJB里的Entity JavaBean（若使用EJB，可对应移植），是表在关系数据库里的直接映射。使用数据对象的优势在于：缓冲机制、值校验、引用完整性和数据安全；可以避免编写SQL语句，而这些SQL语句由于不同的数据库系统有不同的版本；数据对象和业务逻辑是相关的，通过引用完整性和复杂的表间关系可以达到和存储过程一样的效果。这样就实现了“与数据库无关”。

创建的方法有很多，一个DBObject里必需的实现constructors、setupFields、getThisDBObj()方法。

< StockTrade.java >

import com.jcorporate.expresso.core.dbobj.*;

import com.jcorporate.expresso.core.db.*;

public class StockTrade extends SecuredDBObject

{

public StockTrade() throws DBException

{ super(); }

public StockTrade(DBConnection theConnection) throws DBException

{ super(theConnection); }

protected synchronized void setupFields()

throws DBException

{

setTargetTable("STOCKTRADE");

setDescription("Stock Trade I");

addField("ST_ID", "int", 0, false, "Text Channel Autoincrement ID");

addField("ST_TITLE", "varchar", 40, false, "Stock Title");

addField("ST_TRADER", "varchar", 40, false, "Owner Trader");

addField("ST_STATUS", "varchar", 10, true, "Trade Status" );

addField("ST_PRICE", "float", 0, true, "Current Price" );

addField("ST_ASK", "float", 0, true, "Asking Price" );

addField("ST_BID", "float", 0, true, "Bid Price" );

addField("ST_CHANGE", "float", 0, true, "Percentage Change" );

addKey("ST_ID");

}

public DBObject getThisDBObj() throws DBException {

return new StockTrade();

}

5.4 创建一些需要的控制器（Controller）对象

一个控制器就是应用从当前状态转换成下一状态的访问点。这就是Finite State Machine的思想。最典型的例子就是ATM自动取款机，和你交互的取款机就是一个控制器，每一次交互就对应控制器的一个功能单元（State）。

控制器对象类通常放在Controller包里。

控制器对象封装了应用的大部分业务逻辑（数据对象也有业务逻辑），象征着整个应用的业务层。你可以单独地去设计你的表示层，充分考虑输入和输出。

控制器中有着“run+状态名（首字母大写）+State”的方法会在调用相应状态名时被自动调用，该方法还应该申明为void和private或protected。

Controller和View的接口：

Controller的输入：

命令行参数；From_bean方式

Controller的输出：

通常采用Block对象集合传递参数，Block又可包含Input、Output、Action对象。

< StockController.java >

import java.util.*

import com.jcorporate.expresso.core.controller.*;

import com.jcorporate.expresso.core.controller.session.*;

import com.jcorporate.expresso.core.dbobj.*;

import com.jcorporate.expresso.core.db.*;

import com.xenonsoft.orangetrader.ot1.dbobj.StockTrade;

public class StockController extends DBController

{

public StockController()

{

super();

addState( new State("displayStocks", "displayStocks"));

addState( new State("promptBuyStock", "Prompt Buy Stock"));

addState( new State("promptSellStock", "Prompt Sell Stock"));

addState( new State("buyStock", "Buy Stock"));

addState( new State("sellStock", "Sell Stock"));

setInitialState("displayStocks"); //一定别忘了

}

public String getTitle() {

return "Stock Controller II";

}

protected ControllerResponse runDisplayStocksState(

ControllerRequest myRequest, ControllerResponse myResponse )

throws ControllerException

{

String myName=thisClass+"displayStocks() ";

System.out.println( myName );

try {

// Create a block called "StockList" which is the root of the controller

// response.

Block blockList = new Block("StockList" );

// We retrieve all the stocks from the database. For each row

// tuple form the database we create an Output for it.

StockTrade stockInit = new StockTrade();

stockInit.setDBName( myRequest.getDBName() );

ArrayList list = stockInit.searchAndRetrieveList( "ST_TITLE" );

int N=list.size();

for ( int k=0; k<N; ++k ) {

StockTrade stock = (StockTrade)list.get(k);

// Create a Block for each row tuple

Block blockRow = new Block("Stock"+k );

blockList.add( blockRow );

// Create an Output for the DBObject row tuple and add to

// the row Block

Output out1 = new Output();

out1.setName( "Detail" );

out1.setAttribute( "Title", stock.getField("ST_TITLE") );

out1.setAttribute( "Trader", stock.getField("ST_TRADER") );

out1.setAttribute( "Price", stock.getField("ST_PRICE") );

out1.setAttribute( "Ask", stock.getField("ST_ASK") );

out1.setAttribute( "Bid", stock.getField("ST_BID") );

out1.setAttribute( "Change", stock.getField("ST_CHANGE") );

out1.setAttribute( "Status", stock.getField("ST_STATUS") );

blockRow.add( out1 );

// out1.setAttribute( "", stock.getField("ST_") );

// Add a "buy" transition

// NOTE: this state requires a request parameter "buyPage"

// to specifies the JSP of the prompt buy view

Transition buyTransition = new Transition("Buy", getClass().getName() );

buyTransition.setName( "Buy" );

buyTransition.addParam("state", "promptBuyStock");

buyTransition.addParam("stock", stock.getField("ST_ID") );

blockRow.add(buyTransition);

// Add a "sell" transition

// NOTE: this state requires a request parameter "sellURL"

// to specifies the JSP of the prompt sell view

Transition sellTransition = new Transition("Sell", getClass().getName() );

sellTransition.setName( "Sell" );

sellTransition.addParam("state", "promptSellStock");

sellTransition.addParam("stock", stock.getField("ST_ID") );

blockRow.add(sellTransition);

}

// Finally add the block to the list

myResponse.addBlock( blockList );

}

catch (DBException dbe) {

throw new ControllerException(

myName+ " database exception: "+dbe.getMessage() );

}

myResponse.setStyle("displayStocks" );

return myResponse;

}

//……More code

｝

构造器里不能少的是调用父类方法super()和setInitialState()；而super.newState(newState)则是应用安全规则所必需的。

以下为显示页面

< orangetrader/ot2 /index.jsp>

<%@ page language="java" contentType="text/html; charset=ISO-8859-1" %>

<%@ taglib uri="/xenon" prefix="xenon" %>

<%@ taglib uri="/xspresso" prefix="xspresso" %>

<%@ page import="com.xenonsoft.orangetrader.ot1.dbobj.StockTrade" %>

<%@ page import="com.xenonsoft.orangetrader.ot1.controller.StockController" %>

<tr>

<th> <b>Title</b> </th>

<th> <b>Trader</b> </th>

<th> <b>Price</b> </th>

<th> <b>Change</b> </th>

<th> <b>Status</b> </th>

<th colspan="2"> <b>Command</b> </th>

</tr>

<xspresso:block blockPath="StockList" id="blockStocks" >

<xenon:loop name="blockStocks" property="nested"

loopId="block" className="com.jcorporate.expresso.core.controller.Block"

counterId="counter" >

<xspresso:output outputPath="Detail" blockName="block" >

</xspresso:output>

<form action="<%= contextPath %>/StockController2.do?cmd=button" method="POST" >

<td>

<xspresso:transition transitionName="Buy" blockName="block"

htmlClass="orange-form-submit-orange" />

</td>

<td>

<xspresso:transition transitionName="Sell" blockName="block"

htmlClass="orange-form-submit-orange" />

</td>

</form>

</tr>

</xenon:loop>

</xspresso:block>

</table>

5.5 创建一些需要的工作任务（Job）对象

Job对象通常被用在那些不需要用户交互而独立运行的任务，或者是把一耗时长的任务封装到一个线程里处理。Job对象和用户间通常采用消息通讯。

Job对象通常放在job包里。

每一Job对象均对应一个JobHandler线程，JobHandler线程能被配置成在连接数据库后自动执行。

（本例不涉及Job对象）

5.6 安装Expresso应用

5.6.1 在config目录里创建XML配置文件

struts-config.xml

该文件是Expresso框架在Struts组件里自身的URL's到"Action"对象的映射关系，一般情况下，用户不必调整此文件。用户的Struts对应关系由用户编写XXX-config.xml完成（XXX表示应用的名字），具有这样命名格式的配置文件在struts-config.xml被读取时一同被读取，编写方法可借鉴struts-config.xml，更多内容请阅读Struts文档。

以下为orange-struts-config.xml文件部分内容：

</action>

其实质表示：

1. 动作的输入为/StockController2.do?state= displayStocks；

2. 在执行/orangetrader/ot2/index.jsp之前插入了StockController的一段代码，相当于传统的Jsp头部的嵌入式脚本；

3. StockController和Jsp之间的数据采用Block对象传递；

4. 在页面中的服务器脚本交由标签处理。

expressoLogging.xml

定义Expresso使用Log4j各对象产生日志的等级，用户应用使用Log4j各对象产生的日志等级由XXX Logging.xml定义，XXX表示应用的名字。

expressoLogging.xml文件由LogManager进行读入管理，ConfigManager是第一个调用LogManager的对象。

5.6.2 注册Schema和创建/初始化数据库

启动Expresso的Tomcat服务程序，使用浏览器打开Expresso主页：http://localhost:8080/expresso/frame.jsp，使用Admin登陆，选择“Applications”页，使用Component Manager去添加注册Schema。

上例如下设置：

Schema Class File: com.xenonsoft.orangetrader.OrangeTraderSchema

Schema Description: OrangeTrader Demo

Component Code: orangetrader

在Setup也，使用Create/Verify Database Structure & Perform Initial Setup来创建数据库表。

使用浏览器输入URL：http://localhost:8080/应用目录/ 就可以开始你的应用了。

6 Expresso专题

6.1 数据对象

继承自SecuredDBObject类的数据对象无需加入任何代码便有了安全属性，也就是说，可以用此来控制某个用户是否可用该数据对象。

在SetupFields里可以使用：

使用setDBName(String)方法可以指定数据库；

addDetail方法可以实现表间Master/Detail关系，并应用主从表规则如自动删除、键置更新等；

还可以通过setLookupObject方法实现一个数据对象对应多个表的情况。

通过Schema注册数据对象的不同方法，可以将表映射到不同机器的数据库中。

6.2 控制器对象

Controller和DBController的不同就象DBObject之于SecuredDBObject，均是安全性的不同。一个控制器可类似地对应一个use case，每个State便是use case的细节用例。

控制器能被各种各样的客户端程序调用： Servlet，JSP，Applet和Application。

控制器是居留内存的，不安全线程代码是一个可怕恶梦，请注意使用synchronized（针对静态数据成员）或Hashtable来处理线程安全性问题。

控制器活动图：

状态：椭圆表示；

输出：带名字的箭头表示；

每个控制器状态都是安全线程模式的，也就是说：不可能指望在状态间共享内存变量。

你可用通过在expresso-config.xml插入如下行而修改成自己的登陆界面（而不是通过修改Expresso自带的Jsp文件）：

<class-handler name="login"

classHandler="com.jcorporate.myproject.controller.MyLoginController"/>

6.3 初始化Expresso为Java Application环境

让Expresso不是Web Application方式执行也是可能的，如下就是一个例子：com.jcorporate.expresso.core.utility.JobHandler，这时Struts将不能使用，但是ConfigManager、CacheManager、DB connection pools和logging等仍能使用。

6.4 DBTool和DBCreate

DBTool是一个脱离Web环境的Java Application，DBCreate/DBTool可以通过用户定义的DBObject在数据库里创建表，也可以反过来，从数据表产生Java bean（DBObject）。

6.5 数据库连接池

支持多连接池，可同时提供多个分布在不同机器、不同类型的数据库连接池，也就是说，可以实现例如将Sybase的数据导入Oracle数据库的功能。

7 使用Expresso框架后工作划分

7.1 分析和设计人员（包括数据库设计）

² 系统分析

² 需求分析

² 软件设计

1. 控制器和视图之间的数据交换接口

2. MVC设计图

3. 由控制器延伸业务相关类图

4. 由控制器延伸业务相关序列图

5. 数据字典

6. 表间关系、触发器和存储过程

7. 不再需要Web Application的结构设计

7.2 美工、界面设计人员

² 熟悉标签库

² 输入界面

² 输出界面

7.3 程序员

² 编写控制器对象

² 延伸出来的业务相关Java Bean

² 数据对象（按照数据库设计人员的数据字典编写表的创建脚本代码）

8 Expresso和Spring+Hiberate组合结构的比较

1. Expresso最大的亮点就是引入了作为业界MVC标准的Struts，并以之为核心思想，实现了一个表示层－业务层－持久层的应用框架。

2. Expresso没有使用第三方持久层组件，持久层和连接池为自主开发，效率值得考证。事实上，持久层的强大功能也是Expresso的一大亮点，她将“与数据库无关”理论实现得相当完美。

3. Expresso整个系统所引入的东西较多（多于200个文件），包括很多JSP、Java Bean、配置XML、数据库表等，造成本身的结构都很复杂，给学习者带来较大的困难，且怎么取舍那么多界面元素的.jsp还是个问题。

4. Expresso本身就是一个Web应用，不象许多第三方组件商，仅提供.jar包，因此使用该框架进行开发，就使用方法方面带来了差异。与其说是使用Expresso工具为我们的项目应用服务，还不如说是扩展开发Expresso。Expresso带来的是一些现成的工具，同时带来了一种开发模式。开发模式和开发方式比较固定，自由度较低，层级功能是很难单个拆分的，如去掉Expresso的用户安全系统可能就比较难了。