32 Star 47 Fork 7

mvilplss / nature-framework

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
Apache-2.0

框架简介

nature-framework是一个以自由为理念,以易用,代码简洁,开发快速,功能强大,易扩展,低耦合为目标,适用于快速开发的轻量级MVC+ORM框架。无getter/setter方法,无xml配置,包括源码的jar仅280KB。有效的为您节省大量时间来感受生活的美好,该快试试吧!!!

功能特点

  • 完整的MVC支持,功能齐全,简单易用;
  • 模块结构自然:Control,Service,Model;
  • 简单易用的依赖注入ioc;
  • 比Struts功能强大的拦截器intercepter;
  • 后台验证器validator; 支持国际化i18n;
  • 防重复提交令牌token;
  • 灵活易用的Ecache本地缓存,强大的Redis分布式缓存;
  • 支持c3p0和druid数据源; 支持一个项目多个数据库连接;
  • 比Hibernate更简单易用的数据库操作,包括自动建表;
  • 数据库支持Mysql,Microsoft SQL Server,Oracle,Sqlite等;
  • 不得不说的事务控制,多数据事务控制;
  • 拥有强大的插件扩展plugin;
  • 比Springmvc更好用的Restful风格请求;
  • 轻量级的WebService服务;
  • 支持分布式的任务调度;
  • 基于Freemark和jsp的前端权限验证;

maven依赖

https://oss.sonatype.org/#nexus-search;quick~nature4j

<dependency>
   <groupId>org.nature4j</groupId>
   <artifactId>nature-framework</artifactId>
   <version>1.0.5</version>
   <optional>true</optional>
 </dependency>

最新改进

增加优化测试用例写法

写法如下,只需继承NatureTest即可

public class TestDemo extends NatureTest{

    @Test
    public void demo(){
        MainService service = ServiceHelper.getService(MainService.class);
        NatureMap natureMap = service.riskRate();
        System.out.println(natureMap);
    }


}

增加事务的传递支持

原来不能对服务的方法进行嵌套,只能用DatabaseHelper:

@Service
public class UserService extends NatureService {
    @Tx
    public void insert() {
        User user = new User();
        user.put(User.loginname, "lucy");
        user.put(User.nickname, "god");
        DatabaseHelper.use().insert(user);
        user.put(User.loginname, "tom");
        DatabaseHelper.use().update(user);
    }
}

现在:

@Service
public class UserService extends NatureService {
    @Tx
    public void insert() {
        User user = new User();
        user.put(User.loginname, "lucy");
        user.put(User.nickname, "god");
        insert(user);
        user.put(User.loginname, "tom");
        update(user);
    }
}

增加hessian分布式工具插件内置

  • 通过注解@hessian来实现接口api成为hessian服务,hessian服务url必须以.hessian链接结尾
  • 增加HessianClient工具来生成实现类

服务提供者:

@Hessian("/user.hessian")
public interface UserServiceIntf {

	public List<NatureMap> list(String sql);
	
}

服务消费者:

public static void userList(){
		String url = "http://localhost:8080/nature-user/user.hessian";
		UserServiceIntf basic =  HessianClient.create(url,UserServiceIntf.class);
		List list = basic.list("select * from tb_user");
		System.out.println(list.toString());
	}

框架安全升级

  • 传入参数和返回参数进行解耦,考虑增加参数传入和传出专用拦截器(本次提交已经改进);
  • 增强框架本身的安全策略,如xss,csrf,sql注入等防范(本次提交已经改进);
  • 在拦截器中可以通过invocation在invoke前后分别获取请求参数和响应参数,并可以对其进行验证和修改,如下例子就是对请求参数进行html编译,防止XSS攻击。
public void intercept(Invocation invocation) {
		NatureMap requestParams = invocation.getRequestParams();
		Set<Entry<String, Object>> entrySet = requestParams.entrySet();
		for (Entry<String, Object> entry : entrySet) {
			requestParams.put(entry.getKey(),StringUtil.XHTMLEnc( CastUtil.castString(entry.getValue())));
		}
		
		System.err.println("***测试拦截器执行前***");
		invocation.invoke();
		System.err.println("***测试拦截器执行后***");
	}

如何使用

快速上手

三分钟上手实例(如果是初次接触此框架):https://git.oschina.net/mvilplss/nature-user 功能全面的实例(略熟悉此框架的朋友):https://git.oschina.net/mvilplss/nature-demo

功能介绍

实体类

1、实体类,无需GET/SET方法,只需声明数据库字段的名称 2、使用注解控制指定主键@id,支持ADDSELF(数据库自增长)、UUID(框架维护)、ASSIGN(程序员指定id) 3、@Type:按照JAVA语言的基本类型进行设定,无需考虑数据库的字段,还支持默认值,长度设定等,简单快捷

@Table(name = "tb_user")
public class User extends NatureMap {

    @Id(strategy = Strategy.ADDSELF)
    @Type(type = Types.INT)
    public String id = "id";

    @Type(type = Types.INT)
    public String age = "age";

    @Type(def = "女")
    public String sex = "sex";

    public String name = "name";
    
    @Type(length="300")
    public String address = "address";

}

服务类

1、服务类,为了开发简单可以继承框架中的NatureService(非必需),添加@Service注解即可 2、事物控制可以通过@Tx进行急速实现 3、如果某些业务多读少写则建议使用缓存,使用方法只需传入缓存名称即可,如果缓存有配置则使用,否则使用默认配置。 4、所有业务逻辑建议放在Service层

@Service
public class UserService extends NatureService {

    public Page page(Page page) {
        String sql = "select id,name,sex,age from tb_user where 1=1 order by id desc";
        return DatabaseHelper.query(page, sql,"user_cache");
    }

    @Tx
    public int delete(NatureMap natureMap) {
        return super.delete(natureMap,"user_cache");
    }

}

控制类

1、创建控制层继承NatureCtrl类并增加@Ctrl注解即可 2、类@Ctrl的namespace是控制层的命名空间,所有本控制层的请求都要通过namespace 3、属性@Inject注解是注入Service实例 4、方法@Ask注解是对方法的映射,如果不写url则默认映射为方法名;与namespace共同组成请求路径/namespace/list 5、返回支持直接返回页面"xxx.jsp",返回方法"xxx",返回JSON数据 JsonData,返回下载文件FileData等,绝对的简单快捷 6、在控制层需要页面传值的只需声明public类型变量即可,无需冗长的GET/SET 7、如需上传文件,控制层直接声明File类型变量即可,支持多文件集合上传,就像接受普通变量一样简单

@Ctrl(namespace="/user")
public class UserCtrl extends NatureCtrl{
    public User user=new User();//可以不new,如果new的话会提高项目效率
    public File myfile;//文件接收
    public ArrayList<File> files = new ArrayList<File>();//多文件接收。前台只需input的name为files[0...]
    public String action;

    @Inject
    protected UserService userService;

    @Ask(url="/list")
    public Object list(){
        page = userService.page(page);
        return "list.ftl";
    }

    @Ask
    public Object toOper(){
        if (user.getInt(user.id)!=0) {
            userService.byId(user);
            action = "update";
        }else{
            action = "insert";
        }
        return "oper.ftl";
    }

    @Ask
    @Redirect
    public Object insert(){
        userService.insert(user,"user_cache");
        return "list";
    }

    @Ask
    @Redirect
    public Object update(){
        userService.update(user,"user_cache");
        return "list";
    }

    @Ask
    @Redirect
    public Object delete(){
        userService.delete(user,"user_cache");
        return "list";
    }

    @Ask
    public Object getJson(){
        return new JsonData(userService.byId(user));
    }

    //文件下载示例,就是这么简单
    @Ask
    public Object getFile(){
        InputStream inputStream =this.getClass().getResourceAsStream("文件.docx");
        return new FileData(inputStream, "文件.docx");
    }

}

技术交流

目前框架已经应用公司十多个大小型项目,经过实战和改版升级后正式开源,技术交流群 148999765 ,如果有问题和意见欢迎加入群进行讨论。

特别鸣谢

nature-framework框架的建设离不开开源社区的开源项目和技术分享,特别感谢@Jfinal https://git.oschina.net/jfinal/jfinal @黄勇 https://git.oschina.net/huangyong/smart-framework Struts2 SpringMVC等优秀框架

Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: You must give any other recipients of the Work or Derivative Works a copy of this License; and You must cause any modified files to carry prominent notices stating that You changed the files; and You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "{}" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright 2016 mvilplss Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

简介

nature-framework是一个基于jdk8和servlet3.0规范,以自由为理念,以易用,代码简洁,开发快速,功能强大,易扩展,低耦合为目标,适用于快速开发的轻量级MVC+ORM框架。无getter/setter方法,无xml配置,包括源码的jar仅280KB,不仅适合网站的快速开发,更适合最接口服务。可以为您节省更多的时间做更多有意义的事儿!赶快动手体验吧! 展开 收起
Java
Apache-2.0
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/mvilplss/nature-framework.git
git@gitee.com:mvilplss/nature-framework.git
mvilplss
nature-framework
nature-framework
nature4j

搜索帮助