从应用示例来认识Tiny框架

呵呵，Tiny框架神龙见首不见尾已经许多时间了，里面只看到一些几个孤零零的子框架。今天就通过Tiny开发示例的方式来重点展示一下利用Tiny框架是如何开发的。

HelloWorld

首先从这个神一样的示例写起。

服务开发：

方式1：注解方式

@ServiceComponent()
public class HelloWorldAnnotationService{
@ServiceMethod(serviceId = "sayHelloA")
@ServiceResult(name = "result")
@ServiceViewMapping("/helloworld/helloresult.page")
public String sayHello(String name) {
if (name == null) {
name = "world.";
}
return "hello," + name;
}
}

解释：

@ServiceMethod(serviceId = "sayHelloA")声明服务ID，必须不能重复，保证唯一

@ServiceResult(name = "result")声明返回结果在服务调用完之后旋转在数据总线的名称

@ServiceViewMapping("/helloworld/helloresult.page")声明如果调用服务之后转向的展现页面，可省略

表单输入界面：helloworld.page

服务方式：
<form action="sayHelloA.servicepage">
输入名称：<input type="text" name="name"/>
<input type="submit" value="提交"/>
</form>

运行结果界面：

helloresult.page

$!result

方式2：Xml配置方式

public class HelloWorldXmlService{
public String sayHello(String name) {
if (name == null) {
name = "world.";
}
return "hello," + name;
}
}

上面写完类之后，还要再加一个配置文件：

<service-components>
<service-component type="org.tinygroup.helloworld.service.HelloWorldXmlService"
group-id="org.tinygroup" artifact-id="helloworldservice">
<service-method name="sayHello" local-name="sayHello"
service-id="sayHello" version="" description=""
method-name="sayHello">
<service-parameters>
<service-parameter name="name" type="java.lang.String"
required="true" is-array="false" />
</service-parameters>
<service-result name="result" required="false"
is-array="false" type="java.lang.String" />
</service-method>
</service-component>
</service-components>

这段Xml手工写还是有点麻烦的，不过没关系，咱有工具：





如果想在调用服务之后自动转向到一个页面，则要再配下面的xml

<service-view-mappings>
<service-view-mapping service-id="sayHello" path="/helloworld/helloresult.page" type="forward"></service-view-mapping>
</service-view-mappings>

表单输入界面：helloworld.page

服务方式：
<form action="sayHello.servicepage">
输入名称：<input type="text" name="name"/>
<input type="submit" value="提交"/>
</form>

运行结果界面：

helloresult.page

$!result

方式3：流程编排方式

要通过流程编排方式实现，先要写一个组件：

public class HelloWorldComponent implements ComponentInterface {
String name;
String resultKey;
public String getResultKey() {
return resultKey;
}
public void setResultKey(String resultKey) {
this.resultKey = resultKey;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public void execute(Context context) {
context.put(resultKey, String.format("Hello, %s", name));
}
}

写完组件之后，还要编写组件定义文件来定义组件的定义文件，当然要做成组件，就一定要有通用性，这样就可以一次定义，到处使用，对于只用一次的，这么做就不方便了。

<components>
<component name="helloworld" bean="helloworld"
title="HelloWorld组件" category="测试组件" icon="/icon/component.gif">
<short-description>helloworld component</short-description>
<long-description>helloworld component long description
</long-description>
<parameter name="name" title="名字" type="java.lang.String"></parameter>
<parameter name="resultKey" title="结果键值" type="java.lang.String"></parameter>
</component>
</components>

OK，现在流程组件就开发完毕了。



就可以像上面一样在可视的流程编辑器中进行可视化开发了。

表单输入页面:

/helloworld.page

流程方式：
<form action="helloworld.pageflow">
输入名称：<input type="text" name="name"/>
<input type="submit" value="提交"/>
</form>

运行结果页面：

helloresult.page

$!result

上面的展现简单是简单了点，但是容易理解。

通过上面的HelloWorld，我们对Tiny框架的服务开发及界面开发及控制层的开发都有了一定的了解，下面我们就进入更加复杂一点的示例：

四则运算

由于前面一节已经有了一定了解，因此这一节就只贴代码，解释就省了。

通过注解方式开发服务

@ServiceComponent()
public class FourOperateAnnotationService{
@ServiceMethod(serviceId = "additionWithAnno")
@ServiceResult(name = "result")
@ServiceViewMapping("/fouroperate/result.page")
public double addition(double number1,double number2){
return number1+number2;
}
@ServiceMethod(serviceId = "subtractWithAnno")
@ServiceResult(name = "result")
@ServiceViewMapping("/fouroperate/result.page")
public double subtraction(double number1,double number2){
return number1-number2;
}
@ServiceMethod(serviceId = "multiWithAnno")
@ServiceResult(name = "result")
@ServiceViewMapping("/fouroperate/result.page")
public double multi(double number1,double number2){
return number1*number2;
}
@ServiceMethod(serviceId = "divisionWithAnno")
@ServiceResult(name = "result")
@ServiceViewMapping("/fouroperate/result.page")
public double division (double number1,double number2){
return number1/number2;
}
}

通过Xml配置方式开发服务

public class FourOperateXmlService{

public Double addition(Double number1,Double number2){
return number1+number2;
}

public Double subtraction(Double number1,Double number2){
return number1-number2;
}

public Double multi(Double number1,Double number2){
return number1*number2;
}

public Double division (Double number1,Double number2){
return number1/number2;
}
}

通过流程方式开发服务

下面先搞个抽象类：

public  abstract class AbstractFourOperateComponent implements ComponentInterface {
protected double number1;
protected double number2;
protected String resultKey;
public String getResultKey() {
return resultKey;
}
public void setResultKey(String resultKey) {
this.resultKey = resultKey;
}
public double getNumber1() {
return number1;
}
public void setNumber1(double number1) {
this.number1 = number1;
}
public double getNumber2() {
return number2;
}
public void setNumber2(double number2) {
this.number2 = number2;
}
}

接下来就简单了：

public class AdditionComponent extends AbstractFourOperateComponent {

public void execute(Context context) {
context.put(resultKey, number1+number2);
}

}

public class DivisionComponent extends AbstractFourOperateComponent {

public void execute(Context context) {
context.put(resultKey, number1/number2);
}

}

public class MultiComponent extends AbstractFourOperateComponent {

public void execute(Context context) {
context.put(resultKey, number1*number2);
}

}

public class SubtractionComponent extends AbstractFourOperateComponent {

public void execute(Context context) {
context.put(resultKey, number1-number2);
}

}

然后就可以通过编辑器，可视化编辑了。



由于这里主要说明服务端的开发，因此客户端的开发就省略了，其实也是非常简单的。

数据库示例

搞开发，怎么能不搞数据库呢？？

下面展现一下数据的开发：

采用Hibernate来开发数据库应用

首先搞个Pojo

public class User {

private int id;
private String name;
private int age;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}

接下来配个hbm文件：

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="org.tinygroup.crud.pojo">
<class name="User" table="user" >
<id name="id" >
<generator class="native" />
</id>
<property name="name" />
<property name="age" />
</class>
</hibernate-mapping>

再接下来写个Dao：

public class HibernateCrudDao extends HibernateDaoSupport implements CrudDbDao<User>{

public void addUser(User user) {
getHibernateTemplate().save(user);
}

public void updateUser(User user) {
getHibernateTemplate().update(user);
}

public void deleteUser(User user) {
getHibernateTemplate().delete(user);
}

@SuppressWarnings("unchecked")
public List<User> queryUsers(User user) {
if(user==null){
return getHibernateTemplate().loadAll(User.class);
}
return getHibernateTemplate().findByExample(user);
}

public User queryUserById(int id) {
return (User) getHibernateTemplate().get(User.class, id);
}

}

接下来实现服务：

@ServiceComponent()
public class HibernateCrudService implements CrudDbService<User> {

private CrudDbDao&l
d7cf
t;User> crudDbDao;

public CrudDbDao<User> getCrudDbDao() {
return crudDbDao;
}

public void setCrudDbDao(CrudDbDao<User> crudDbDao) {
this.crudDbDao = crudDbDao;
}
@ServiceMethod(serviceId = "addUser")
@ServiceViewMapping(value="/queryUsers.servicepage",type="redirect")
public void addUser(User user) {
crudDbDao.addUser(user);
}
@ServiceMethod(serviceId = "updateUser")
@ServiceViewMapping(value="/queryUsers.servicepage",type="redirect")
public void updateUser(User user) {
crudDbDao.updateUser(user);
}
@ServiceMethod(serviceId = "deleteUser")
@ServiceViewMapping(value="/queryUsers.servicepage",type="redirect")
public void deleteUserById(int id) {
User user=getUserById(id);
crudDbDao.deleteUser(user);
}
@ServiceMethod(serviceId = "queryUsers")
@ServiceResult(name = "users")
@ServiceViewMapping("/crud/service/hibernate/list.page")
public List<User> queryUsers(User user) {
return crudDbDao.queryUsers(user);
}
@ServiceMethod(serviceId = "queryUserById")
@ServiceResult(name = "user")
@ServiceViewMapping("/crud/service/hibernate/operate.page")
public User getUserById(Integer id) {
if(id==null){
return null;
}
return crudDbDao.queryUserById(id);
}

}

没错，你看起来这里的服务都是直接调用dao里的方法的，对于这个简单例子看起来有点重复，但是实际应用中是不可能直接把dao发布成服务的，因此你可以想像一下这里有好多步操作就好了。

至此基于Hibernate就可以开发完毕了。

采用TinyDB来实现

TinyDB采用了No Pojo,No Dao的解决方案：

@ServiceComponent()
public class TinyDbCrudService extends BeanSupport implements CrudDbService<Bean>{

private DBOperator operator;

private BeanOperatorManager manager;

private String beanType;

public void setBeanType(String beanType) {
this.beanType = beanType;
}

public void setManager(BeanOperatorManager manager) {
this.manager = manager;
}

/** 初始化bean。 */
protected void init() throws Exception {
Assert.assertNotNull(manager, "manager must not null");
operator=manager.getDbOperator(beanType);
}

@ServiceMethod(serviceId = "addUserTiny")
@ServiceViewMapping(value="/queryUsersTiny.servicepage?@beantype=user",type="redirect")
public void addUser(Bean user) {
operator.insert(user);
}
@ServiceMethod(serviceId = "updateUserTiny")
@ServiceViewMapping(value="/queryUsersTiny.servicepage?@beantype=user",type="redirect")
public void updateUser(Bean user) {
operator.update(user);
}
@ServiceMethod(serviceId = "deleteUserTiny")
@ServiceViewMapping(value="/queryUsersTiny.servicepage?@beantype=user",type="redirect")
public void deleteUserById(int id) {
operator.deleteById(id);
}
@ServiceMethod(serviceId = "queryUsersTiny")
@ServiceResult(name = "users")
@ServiceViewMapping("/crud/service/tinydb/list.page")
public List<Bean> queryUsers(Bean user) {
if(user==null){
user=new Bean(beanType);
}
Bean[] beans= operator.getBeans(user);
return Arrays.asList(beans);
}
@ServiceMethod(serviceId = "queryUserByIdTiny")
@ServiceResult(name = "user")
@ServiceViewMapping("/crud/service/tinydb/operate.page")
public Bean getUserById(Integer id) {
if(id==null){
return null;
}
return operator.getBean(id);
}

}

OK，这样就算完成了。

够简单么？？NO，还不够简单。

实际上TinyDB中对于常用的CRUD，根本就不用写代码，框架默认就全部支持了，所以只有复杂的业务逻辑的都需要像上面一样写一下，简单的CRUD，就不用写了。

通过流程方式开发

框架内嵌已经包含了常用的数据库处理组件：



哇，只要拖拖配配就可以了。

页面流

页面流是Tiny框架推荐的控制层解决方案，它强大，简单，可视性好。



呵呵，是不是实现简单，看起来清晰？

当然它的强大在这么简单的例子里是看不到的。

WEB工程

从上面的示例来看，它的界面确实是简单的。然后上面的三个工程最后打了3个Jar包，就算开发完毕了。

在我们的Web工程中，我们要添加这些示例，只要修改pom文件即可：

<dependency>
<groupId>org.tinygroup</groupId>
<artifactId>org.tinygroup.helloworld</artifactId>
<version>1.2.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.tinygroup</groupId>
<artifactId>org.tinygroup.fouroperate</artifactId>
<version>1.2.0-SNAPSHOT</version>
</dependency>
<dependency>
<groupId>org.tinygroup</groupId>
<artifactId>org.tinygroup.crud</artifactId>
<version>1.2.0-SNAPSHOT</version>
</dependency>

POM添加了，功能就添加了；POM删除了，功能就删除了，这就是Tiny框架中所说的模块化。

UI引擎

示例完成之后，我对做示例的同学说，你这个示例写得还是可以的，但是我展示的时候很不方便，我要记得每个地址，这对我要求也太高了，能不能给我搞个菜单出来？？

此同学说好的，结果他创建了一个default.layout文件，加了如下的代码：

<table border="1" width="100%">
<tr>
<td colspan="2">
helloworld示例:<a href="${TINY_CONTEXT_PATH}/helloworld/helloworld.page">helloworld</a><br/>
四则运算示例:<a href="${TINY_CONTEXT_PATH}/fouroperate/fouroperate.page">四则运算</a><br/>
增删改查示例:<a href="${TINY_CONTEXT_PATH}/crud/crud.page">增删改查</a><br/>
</td>
</tr>
<tr>
<td width="20%">内容展示</td>
<td>
$pageContent
</td>
</tr>
</table>

然后我就在访问所有页面的时候都有菜单可用了，这就是TinyUI框架中的装饰。

应用截图

首页：



点击helloworld进入helloworld示例首页



再点下面的服务方式后的helloworld链接



输入abc之后，点提交：



结果就出来了。

下面是数据访问页面：



添加界面：



四则运算界面：



呵呵，不要嫌界面丑，界面丑是因为我不想引入复杂的页面使得注意力转移到其它地方。

总结

上面用了三个例子：HelloWorld,四则运算，数据库访问来对Tiny框架的开发过程进行了展示。当然，Tiny框架提供的实际内容要远远多于你上面看到的内容，比如：
对页面的局部刷新有强有力的支持，便于进行Ajax处理
提供Bigpipe模式来提升用户体验
提供CSS合并、提供JS合并，提供内容压缩输出到浏览器端
上面开发的所有服务都可以提供xml,json方式结果的返回，也可以通过webservice进行访问
提供分层部署能力
提供集群部署支持，接入服务器可以水平进行扩展，应用服务器可以进行水平扩展。

更多内容请看官方网站：www.tinygroup.org