Smart2.0开发指南——特性

最新推荐文章于 2024-07-22 15:12:37 发布
最新推荐文章于 2024-07-22 15:12:37 发布
阅读量154 收藏
点赞数
文章标签： 数据库 测试 json
原文链接：https://my.oschina.net/ketayao/blog/195401
版权

2019独角兽企业重金招聘Python工程师标准>>> hot3.png

4.特性

4.1MVC

　　借鉴 Spring MVC 与 RESTful Web Service 的思路，打造了一款轻量级 MVC 框架。Model 由 Entity 或 JavaBean 充当，View 为 JSON 格式的数据（也可为 XML 格式），Controller 在框架中被命名为 Action。


　　请求统一发送到 DipatcherServlet，由它转发到相应的 Action（@Action标记过的类） 中，可通过 @Request 注解在 Action 中设置转发规则。
　　相比1.0版本，不再继承BaseAction，减少了依赖。

4.1.1MVC注解

  1. @Action：定义Action类，只有标记过的类才会被转发。
  2. @Request：定义URL映射规则。

4.1.2映射规则

　　在 @Request 注解的参数中，使用“请求方法 + 请求地址”的格式定义一个完整的请求。
  1. 请求方法：
    GET、POST、PUT、DELETE四种，不区分大小写（推荐大写）。
  2. 请求地址： 请求地址要以“/”开头，末尾无需“/”，同样不区分大小写（推荐小写）。在地址中，允许使用一个或多个带“{xxx}”格式的占位符，依次对应 Action 方法中的参数，类型一般为 long 或 String。可使用 Map<String, Object> 封装所有请求参数，key 为参数名，value 为参数值，可根据实际情况对 Object 类型的参数值进行转型。
　　通过一个 Action 类来说明 @Request 注解的用法，代码如下： 
@Action
public class ProductAction {

    @Request("GET:/product")
    public Page index() {
		......
    }

    @Request("POST:/product/create")
    public Result create(Map<String, Object> fieldMap, List<Multipart> multipartList) {
		......
    }
	
	@Request("PUT:/product/update/{id}")
    public Result update(long id, Map<String, Object> fieldMap) {
		......
    }

    @Request("DELETE:/product/delete/{id}")
    public Result delete(long id) {
		......
    }
}

4.1.3Action方法

  1. Action方法参数
    允许定义空参数、long、Map 、List四种类型，以及它们之间的各种组合。例如： 
    public Page index();
public Result delete(long id) 
public Page search(Map<String, Object> fieldMap)
public Result update(long id, Map<String, Object> fieldMap)
public Result create(List<Multipart> multipartList)
public Result create(Map<String, Object> fieldMap, List<Multipart> multipartList)
public Result uploadPicture(long id, Map<String, Object> fieldMap, List<Multipart> multipartList) 
......
  2. Action方法返回值

    Action方法返回值允许为void、Page、Result三种。

    a. 以void为返回值的方法，处理完业务后，不做后续操作，例如下载等。

    b. 以Page为返回值的方法，则转发或重定向到相应的页面中。

    Page常用方法：      

    　　void setPath(String path);//设置路径
　　void setData(Map<String, Object> data);//设置参数

    c. 以Result为返回值的方法，则返回包含基本信息的json字符串。

    Result常用方法： 

    void setSuccess(boolean success);//设置成功标志
　　void setError(int error);//设置错误代码
　　void setData(Object data);//设置响应数据

4.2IOC

     借鉴 Spring IOC 的思路，可将任意的类标注为@Bean，当应用启动时，框架会自动创建这些 Bean实例，并放入容器中。随后可使用 BeanHelper.getBean() 方法获取对应的 Bean实例。一般情况下，会将 Action类标注为@Action，Service实现类标注为 @Service，可在 Action类中使用 @Inject注解注入所需的 Service接口。 

Action类：
　　@Action
　　public class ProductAction {
　　
　　@Inject
　　private ProductService productService;
　　
　　　...
　　}

Service 实现类：
　　@Service
　　public class ProductServiceImpl implements ProductService { 
　　   
　　...
　　}
     若在项目中一个接口同时存在多个实现类，此时只能选择其中的一个实现类生效，可在接口上使用 @Impl指定具体的实现类。 

4.3AOP

　　借鉴 Spring 与 AspectJ 的思路，去掉了复杂的切点表达式，简化为指定包名与指定类名进行横向拦截，需使用 @Aspect 注解定义一个 Aspect 类，并继承 AspectProxy方法，通过覆盖父类中的某些钩子方法，来实现编写对应的增强代码。
　　包括以下几种增强类型，即钩子方法：

方法

说明

void begin()

在进入方法时执行。

boolean intercept(Method method, Object[] args)

设置过滤条件。默认返回 true，表示无过滤条件。

void before(Method method, Object[] args)

在目标方法调用前执行。

void after(Method method, Object[] args)

在目标方法调用后执行。

void error(Method method, Object[] args, Exception e)

在抛出异常时执行。

void end()

在方法执行完毕前执行。

　　相比1.0版本，不再继承BaseAspect，不再需要@Bean注解，新增了@Order注解。

4.3.1AOP注解

  1. @Aspect：定义需要拦截的类，只有满足条件的类或方法才会被拦截。
    参数：pkg定义需要拦截的包名。
    　　   cls需要拦截的类名。如果为空，则拦截该包下的所有类；否则如果包名与类名均不为空，则添加指定类。
  2. @Order：多个拦截方法的执行顺序。
    参数：value序号的值越小越靠前

以下编写了一个 Aspect 类，用于横切 com.smart.sample.action下所有类的方法，除了SystemAction类，代码如下： 

@Aspect(pkg = "com.smart.sample.action")
@Order(0)
public class AccessAspect extends AspectProxy {

    @Override
    public boolean intercept(Class<?> cls, Method method, Object[] params) throws Exception {
        boolean result = true;
        if (cls == SystemAction.class) {
            result = false;
        }
        return result;
    }

    @Override
    public void before(Class<?> cls, Method method, Object[] params) throws Exception {
        Long userId = DataContext.Session.get(Constant.USER_ID);
        if (userId == null) {
            WebUtil.setRedirectURL(DataContext.getRequest(), Constant.REDIRECT_URL);
            throw new AccessException();
        }
    }
}
可在 intercept() 方法中，对目标方法（Method 对象）的名称、参数、返回值、注解等信息设置过滤条件。

4.4ORM

　　借鉴 JPA 的思路，对 ORM 映射规则进行了简化，尽量减少相关的注解配置。每个 Entity 类必须继承 BaseEntity，该父类中提供了实体主键字段，名称为 id，类型为 long，在实际项目中可对主键字段进行统一修改。
　　通过一个简单的示例来说明 ORM 映射规则，代码如下： 
public class Product extends BaseEntity {

    private long productTypeId;

    private String productName;

    private String productCode;

    private int price;

    private String description;

    ... getter/setter 方法
}

映射规则如下：

Entity 类

数据库

类名（如：Product）

表名（如：product）

属性名（如：productTypeId）

列名（如：product_type_id）

      可见，将 Entity 类的类名与属性名的“驼峰式”转为“下划线式”，即为数据库的表名与列名。若表名带有前缀（如：t_product），则此时需要借助 @Table 注解，将其标注在 Entity 类上，在该注解的参数中指定所对应的表名（如：@Table(“t_product”)）。

同理，对于属性名与列名的不规则映射规则，可以借助 @Column 注解实现映射关系。当列名为 Java 关键字时（如：class），需要考虑此方案。

     在本框架中使用“贫血式”模型，不使用 OneToMany、ManyToOne、ManyToMany 等“充血式”模型，也就是说，一个 Entity 与一个 Table 对应，一个 Property 与一个 Column 对应。建议使用 Java 原始类型，而不是封装类型，如：建议使用 int，而不是 Integer。 

Entity 属性类型只能从以下类型中选择：

类型

说明

int

对于长度较小的数值类型数据，推荐使用 int 类型，不要使用 Integer 类型。

long

对于长度较长的数值类型数据，推荐使用 long 类型，不要使用 Long 类型。

double

对于所有的浮点类型数据，推荐使用 double 类型，不要使用 Double、float/Float 等类型。

String

对于字符类型数据，推荐使用 String 类型，不要使用 char 类型。

注意：对于日期或时间，推荐使用 String 或 long 类型，而不要使用 Date 类型。

4.5DAO

      封装 Apache DbUtils 类库，提供 DataSet 工具类，可执行基于单表的 SQL 语句，详细的 DataSet API 请见附录。
对于复杂的 SQL 语句，可编写在代码中，也可编写在 sql.properties 文件中，通过 SQLHelper.getSQL() 方法来获取具体的 SQL 语句，可配合使用 DBHelper 来执行 SQL 语句。

4.6事务控制

　　借鉴 Spring 声明式事务控制的思路，提供了一个 @Transaction 注解，将此注解标注在 Service 实现类中打算进行事务控制的方法上，该方法在运行时就会具备事务特性。事务使用默认的传播行为，本框架不考虑复杂的传播行为，也不考虑嵌套事务与跨库事务。
　　相比1.0版本，新增@Service注解，用于区分其他类型的Bean，作用和@Bean注解一样。

4.7异常处理

      采用 C/C++ 编码风格，采用错误代码取代异常处理机制，该方案仅用于 Action 方法中。通过一个简单的示例展示基于错误代码的异常处理机制，代码如下： 
@Action
public class ProductAction {

    @Inject
    private ProductService productService;

    ...

    @Request("get:/product/{id}")
    public Result getProductById(long productId) {
        if (productId == 0) {
            return new Result(false).error(ERROR_PARAM);
        }
        Product product = productService.getProduct(productId);
        if (product != null) {
            return new Result(true).data(product);
        } else {
            return new Result(false).error(ERROR_DATA);
        }
    }

    ...
}
     当 productId 为 0 时，返回一个 Result 对象，成功标志为 false，错误代码 ERROR_PARAM（值为 10）。错误代码可统一定义。
     同理，当 product 不为 null 时，返回一个 Result 对象，成功标志为 true，相关数据为 product，否则，也返回一个 Result 对象，成功标志为 false，错误代码为 ERROR_DATA（值为 20）。Action 方法的返回值，也就是 Result 对象，将会序列化为 JSON 格式的数据，通过 AJAX 的方式返回到回调函数中，可通过获取 result 对象的 success 属性来判断操作是否成功，可访问 error 属性获取相应的错误代码，并给出具体的提示信息。AJAX 代码示例如下： 
...
    $.ajax({
        url: '/product/' + productId,
        type: 'get',
        success: function(result) {
            if (result.success) {
                var product = result.data;
                $('#product_type_id').val(product.productTypeId);
                $('#product_name').val(product.productName);
                $('#product_code').val(product.productCode);
                $('#price').val(product.price);
                $('#description').val(product.description);
            } else {
                switch (result.error) {
                    case 10:
                        alert('The parameter is error!');
                        break;
                    case 20:
                        alert('The data is error!');
                        break;
                }
            }
        }
    });
...

4.8单元测试

      使用 JUnit 作为单元测试框架，并对其进行了扩展，可使用 @Order 注解设置被测方法的执行顺序。以下是一个 Test 类，代码如下： 
public class ProductServiceTest extends BaseTest {

    private ProductService productService = BeanHelper.getBean(ProductServiceImpl.class);

    @BeforeClass
    @AfterClass
    public static void init() {
        initSQL("sql/product.sql");
    }

    @Test
    @Order(1)
    public void getProductListTest() {
        List<Product> productList = productService.getProductList();
        Assert.assertNotNull(productList);
        Assert.assertEquals(productList.size(), 7);
    }

    @Test
    @Order(2)
    public void getProductTest() {
        long productId = 1;
        Product product = productService.getProduct(productId);
        Assert.assertNotNull(product);
    }

    ...
}
      Test 类必须继承 BaseTest 类。在类中可使用 BeanHelper.getBean() 方法初始化相关的 Bean 实例（这里是 Service 实现类实例），注意：此时不能使用 @Inject 实现依赖注入。可使用 JUnit 提供的 @Test、@BeforeClass、@AfterClass 等注解来标注被测方法。在 init() 方法上同时标注了 @BeforeClass 与 @AfterClass，表示该方法会在测试之前与测试之后被 JUnit 框架所调用，用于执行数据初始化脚本，该脚本在 test/resources/sql/ 目录下。
      可在 test/resources/config.prperties 文件中单独配置单元测试所对应的数据源，一般情况下一个应用对应两个数据库，一个作为开发，另一个作为测试。 建议保证单元测试方法的顺序性，并合理使用 @Order 注解，让整个单元测试可反复测试。

4.9MVC配置文件

    MVC中所有涉及到的参数配置都在根类路径下config.properties文件中。参数说明见： 
#应用名称
app.name=smart-sample
#Action类所在的包
app.package=com.smart.sample
#网站静态资源路径
app.www_path=/www/
#jsp路径
app.jsp_path=/WEB-INF/jsp/
#登录地址
app.home_page=/login
#上传文件尺寸大小（MB）
app.upload_limit=10

#数据库类型
jdbc.type=mysql
#驱动名
jdbc.driver=com.mysql.jdbc.Driver
#数据库链接地址
jdbc.url=jdbc:mysql://localhost:3306/sample
#登录名
jdbc.username=root
#密码
jdbc.password=root

#是否动态加载i18n文件
i18n.reloadable=true

#上传路径
sample.upload_path=/www/upload/

转载于:https://my.oschina.net/ketayao/blog/195401

weixin_33743880
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Hybrid App开发 Cordova框架实践——Android篇
2301_79098336的博客
05-01 429
如果你没有方向，这里给大家分享一套由阿里高级架构师编写的《Android八大模块进阶笔记》，帮大家将杂乱、零散、碎片化的知识进行体系化的整理，让大家系统而高效地掌握Android开发的各个知识点。相对于我们平时看的碎片化内容，这份笔记的知识点更系统化，更容易理解和记忆，是严格按照知识体系编排的。
蓝牙4.0/2.0开发SDK——Lib.rar
12-12
总之，"蓝牙4.0/2.0开发SDK——Lib.rar"提供的资源可以帮助开发者在Windows 10平台上，利用Visual Studio 2017进行蓝牙设备的连接、数据收发，实现各种物联网或移动设备应用。通过学习和使用这些SDK，开发者可以创建...
Smart2.0开发指南——入门
weixin_33851177的博客
01-22 613
2019独角兽企业重金招聘Python工程师标准>>> ...
Smart2.0开发指南——开发工具
weixin_34075268的博客
01-21 141
2019独角兽企业重金招聘Python工程师标准>>> ...
Smart 2.0 开发指南 —— 附录
weixin_34166472的博客
01-23 145
为什么80%的码农都做不了架构师？>>> ...
Smart 2.0 开发指南 —— 架构
weixin_34221112的博客
01-22 104
2019独角兽企业重金招聘Python工程师标准>>> ...
Gradle 2.0 用户指南翻译——第二十一章. Gradle 插件
一个码农的博客
04-24 459
Gradle 在它的核心中有意地为真实世界的自动化提供一些有用的功能。所有有用的功能，例如能够编译 Java代码，都是通过插件来添加的。插件添加了新任务（如 JavaCompile），域对象（如 SourceSet），约定（如主要的 Java 源码是位于 的src/main/java），以及从扩展的核心对象和其他插件的对象。
OpenHarmony 实战开发——智能指南针
m0_70748458的博客
07-09 611
电子指南针是现代的一种重要导航工具，大到飞机船舶的导航，小到个人手机导航，电子指南针可以说和咱们生活息息相关，密不可分。为什么电子指南针能指示方向？本 Demo 将为你呈现，其中蕴含了人类智慧及大自然的奥妙。本项目分为数据采集端（设备端）和效果展示端（应用端）：
Gradle 2.0 用户指南翻译——第三十六章. Sonar Runner 插件
一个码农的博客
02-01 781
本文禁止w3cschool转载！ 翻译项目请关注Github上的地址：https://github.com/msdx/gradledoc 。 本文翻译所在分支：https://github.com/msdx/gradledoc/tree/2.0 。更好的阅读体验请访问：http://gradledoc.githang.com/2.0/userguide/userguide.html 。 另外，...
OpenHarmony实战开发——宿舍全屋智能开发指南
m0_70748458的博客
07-10 871
以上案例实质上还是在使用现有的解决方案、数字管家的服务器实现，甚至连开门的操作UI都是台灯的，虽然这个可以在数字管家修改图标，但本质还是没有变化，本教程目的在于记录数字管家碰一碰的开发入门，为后期再添加自己的解决方案、服务器作为参考。搭建开发环境Windows 开发环境的搭建Ubuntu 开发环境搭建Linux 与 Windows 之间的文件共享……构建子系统启动流程子系统分布式任务调度子系统分布式通信子系统驱动子系统……
西门子 PC Access Smart V2.0
10-19
西门子PC Access Smart V2.0是一款专为S7-200 Smart系列PLC设计的OPC服务器软件。该软件提供了与这些小型西门子PLC进行数据通信的强大工具，使得用户能够轻松地从个人计算机（PC）访问和控制PLC的数据，实现了工业...
Smart2.0 用户手册
04-12
JavaWeb 轻量级框架 Smart
STEP7 MicroWIN SMART V2.0完整版安装包_下载.txt
05-18
STEP7 MicroWIN SMART V2.0 完整版安装包
Pc_Access_for_S7-200SMART_V2.0
07-27
为了实现与这些设备的有效通信，西门子开发了一款名为Pc_Access的软件工具，其最新版本Pc_Access_for_S7-200SMART_V2.0提供了强大的数据交互功能。本文将深入探讨这一软件的特性、功能以及如何利用它来优化PLC编程和...
OAuth2.0 or Spring Session or 单点登录流程
qq_53374893的博客
07-20 440
一句话精辟解释： 在过滤器放行的时候，偷偷的把原生的 request 和 response 对象换成了它的实现，也就是 调用getSession 的时候拿到的 其实是对redis 操作的Session。但其他的操作还是使用原生的，只不过重写的方法，调用的是子类的，也就是往 redis 里放入 Session，把原生的操作给替换了！分布式Session原理，使用子域名，的时候放入父域名的 JsessionId 然后将这个ID 的所存的内容放入Redis ，这样实现不同域名共享同一sessionID.
redis+spring面试题
github_36510643的博客
07-21 410
redis+spring面试题
基于JSP的高校信息资源共享平台
最新发布
heye0910032的博客
07-22 659
高校信息资源共享平台的开发和实现，为高校信息资源的管理和共享提供了一个有效的解决方案。通过使用JSP技术和MySQL数据库，本系统实现了一个稳定、安全、易用的高校信息资源管理平台。虽然在开发过程中遇到了一些技术挑战，但通过不断学习和实践，最终完成了一个能够满足用户需求的系统。未来，我们将继续优化系统功能，提升用户体验，以期达到更高的应用价值和社会效益。高校信息资源共享平台的开发和实现，为高校信息资源的管理和共享提供了一个有效的解决方案。
docker容器
2401_83945639的博客
07-20 949
root@lvs-server ~]# docker start 8a1e7f458daf --手动start启动。-v 目录映射【宿主机的目录映射给容器的某个目录，将容器中的目录挂载到宿主机的目录中】docker rm -f $(docker ps -aq) 删除所有的容器。docker rm -f cname 强制删除，可以删除正在运行的容器。-p 端口映射【宿主机的端口映射给容器的某个端口】创建容器并运行 --这个是mysql的容器。docker ps -q 查看所有容器id。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值