# anyline **Repository Path**: amtech/anyline ## Basic Information - **Project Name**: anyline - **Description**: 基于spring生态的D-ORM,兼容各种数据库。动态注册切换数据源，生成或执行DDL/DML。读写元数据。常用于动态结构的场景,如:数据中台、可视化、低代码后台、SAAS、自定义表单、异构数据库迁移同步、物联网车联网数据处理、数据清洗、运行时自定义报表/查询条件/数据结构、爬虫数据解析等,只需要一个注解即可与springboot,mvc等框架项目完美整合。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: http://doc.anyline.org/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 846 - **Created**: 2023-08-26 - **Last Updated**: 2023-08-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ***详细说明请参考:*** [http://doc.anyline.org/](http://doc.anyline.org/) 下载的源码在执行前，首先要配置好maven环境,请参考[【maven配置】](http://doc.anyline.org/ss/35_1148) 关于多数据源，请先阅读 [【三种方式注册数据源】](http://doc.anyline.org/aa/a9_3451) [【三种方式切换数据源】](http://doc.anyline.org/aa/64_3449) [【多数据源事务控制】](http://doc.anyline.org/ss/23_1189) 低代码平台、数据中台等场景需要生成SQL(只生成不执行)参考 [【JDBCAdapter】](http://doc.anyline.org/ss/01_1193) 或 [【AnylineDao】](https://gitee.com/anyline/anyline/blob/master/anyline-data/src/main/java/org/anyline/dao/init/springjdbc/DefaultDao.java) ***快速开始请参考示例源码(各种各样最简单的hello world):*** [https://gitee.com/anyline/anyline-simple](https://gitee.com/anyline/anyline-simple) ***一个字都不想看，就想直接启动项目的下载这个源码:*** [https://gitee.com/anyline/anyline-simple-clear](https://gitee.com/anyline/anyline-simple-clear) 有问题请不要自行百度，因为百度收录的内容有可能过期或版本不一致,有问题请联系 [

](http://shang.qq.com/wpa/qunwpa?idkey=279fe968c371670fa9791a9ff8686f86dbac0b5edba8021a660b313e2dd863ad)

QQ群(86020680) 或微信群 ***为了更准确的提供技术支持，请备注一下使用场景或用到哪一部分功能*** ## 简介 AnyLine的核心是一个基于spring生态的D-ORM(动态对象关系影射),其重点是: - 以最简单、快速方式操作 ***数据库*** 与 ***结果集*** - 兼容各种数据库，统一生成或执行DML/DDL，读写表结构、索引等元数据 - 一切基于动态、基于运行时(包括数据源、数据结构等) 常用于动态结构的场景中，作为SQL解析引擎或适配器出现 , 就是根据用户提交的参数，翻译成不同数据库的方言(DML/DDL) 如:数据中台、可视化、低代码、SAAS、自定义表单、异构数据库迁移同步、物联网车联网数据处理、数据清洗、运行时自定义报表/查询条件/数据结构、爬虫数据解析等。参考【[适用场景](http://doc.anyline.org/ss/ed_14)】也可以这样理解，ORM相当于总成、而anyline相当于散件DIY。如果你的开发出来的产品面向的终端业务用户，如作个CRM/MRP或**管理系统之类的，那你选ORM不会有什么大问题，最多也就是写SQL和配置文件费点代码。但你既然都找到这了，那你的需求当然不会这么简单了。有可能考虑的重点是团队的技术积累，面向的是基础程序员，比如要给大家提供一个低代码之类的基础平台。这就不是三言两语的事了，参考【[技术选型](http://doc.anyline.org/ss/3e_1199)】 ### 与ORM最明显的区别是： - ***摒弃了各种繁琐呆板的实体类以及相关的配置文件*** 让数据库操作更简单，不要一动就是一整套的service/dao/mapping/VOPODTO有用没用的各种O，生成个简单的SQL也各种判断遍历。 - ***强强化了结果集的对象概念*** 面向对象的对象不是只有get/set/注解这么弱需要把数据及对数据的操作封装在一起，作为一个相互依存的整体，并实现高度的抽象要关注元数据，不要关注姓名、年龄等具体属性强化针对结果集的数据二次处理能力如结果集的聚合、过滤、行列转换、格式化及各种数学计算尽量作到一键...一键... 而不要像ORM提供的entity,map,list除了提供个get/set/foreach，稍微有点用的又要麻烦程序员各种判断各种遍历参考【[疑问与优劣对比](http://doc.anyline.org/ss/ae_1196)】 ### 与如何实现数据操作的两个阶段，1.针对数据库中数据 2.针对数据库查询的结果集(内存中的数据) - ***提供一个通用的AnylineService实现对数据库的一切操作*** - ***提供一对DataSet/DataRow实现对内存数据的一切数学计算*** DataSet/DataRow不是对List/Map的简单封装他将是提高我们开发速度的重要工具，各种想到想不到的数学计算，只要不是与业务相关的都应该能实现 ## 为什么还要要有AnyLine AnyLine的用户按来源大概分两类，一类是技术选型过程中选到了AnyLine,这类用户既然有造型能力，那他需要什么以及AnyLine能提供什么自己是非常清晰的。对于这类用户也不需要解释什么了。主要是第二类用户，是参与的项目中已经有了AnyLine，属于被动接收。对于这类用户首先会有个疑问：已经了有spring-data,hibernate,mybatis 为什么还多此一AnyLine 如果只是Hello World似的增删改查,那确实不需要，但实际工作中发现太难了、工作量太大了（补充：工作不是指找工作不是求职面试,找工作的话anyline可能是个减分项）还是从动态、简单、结果集说起 ### 动态、运行时即运行时才能最终确定动态的数据源、数据结构、展现形式如我们需要开发一个数据中台或者一个数据清洗插件，编码阶段我们还不知道数据来源、什么类型的数据库甚至不是数据库、会有什么数据结构对应什么样的实体类，如果需要前端展示的话，更不会知道不同的终端需要什么各种五花八门的数据组合那只能定义一个高度抽象的实体了，想来想去也只有Collection可以胜任了。 ### 简单快速的操作数据库最常见的操作：根据条件分页查询一个表的几列这一动就要倾巢出动一整套的service/dao/vo dto 各种O/mapper，生成个查询条件各种封装、为了拼接个SQL又是各种if else forearch 如果查询条件是由前端的最终用户动态提供的，那Java里if完了还不算完，xml中if也少不了一旦分了页，又要搞出另一套数据结构，另一组接口，另一组参数(当然这种拙劣的设计只是极个别，不能代表ORM) ### 简单快速的操作结果集数据库负责的是存储，其结构肯定是与业务需要不一样的。所以结果集需要处理。当我们需要用Map处理数据或数学计算时，如最常见的数据格式化、筛选、分组、平均值、合计、方差等聚合计算再如空值的处理包括,"",null,"null","\n","\r","\t"," "全角、半角等各种乱七八糟的情况这时就会发现Map太抽象了，除了get/set/forearch好像也没别的可施展了。要处理的细节太多了，if都不够用了。 ### 动态数据源再比如多数据源的情况下，要切换个数据源又是IOC又是AOP一堆设计模式全出场。经常是在方法配置个拦截器。在同一个方法里还能切换个数据源了？数据中台里有可能有几百几千个数据源，还得配上几千个方法？数据源是用户动态提交的呢怎么拦截呢？这不是DB Util的本职工作么，还要借助其他？哪个项目少了AOP依赖还切换不了数据源了？ ### 重复工作如果只是写个helloworld，以上都不是问题，没什么解决不了的。但实际工作中是需要考虑工作量和开发速度的。比如一个订单可能有几十上百列的数据，每个分析师需要根据不同的列查询。有那么几十列上同时需要<>=!=IN FIND_IN_SET多种查询方式算正常吧不能让开发人员挨个写一遍吧，写一遍是没问题，但修改起来可就不是一遍两遍的事了所以需要提供一个字典让用户自己去配置，低代码开发平台、自定义报表、动态查询条件应该经常有这个需求。当用户提交上来一个列名、一个运算算、一组值，怎么执行SQL呢，不能在代码中各种判断吧，如果=怎么合成SQL，如果IN怎么合成SQL ### 多方言 DML方面hibernate还可以处理，DDL呢？国产库呢？当然这种问题很难有定论，只能在实际应用过程中根据情况取舍。可以参考【[适用场景](http://doc.anyline.org/ss/ed_14)】和【[实战对比](http://doc.anyline.org/ss/c9_1153)】中的示例造型之前，当然要搞明白优势劣势，参考【[优势劣势](http://doc.anyline.org/aa/24_3712)】 ## 误解当然我们并不是要抛弃Entity或ORM，相反的 AnyLine源码中也使用了多达几十个Entity 在一些 **可预知的固定的** 场景下，Entity的优势还是不可替代的程序员应该有分辨场景的能力 AnyLine希望程序员手中多一个数据库操作的利器，而不是被各种模式各种hello world限制 ## 如何使用数据操作***不要***再从生成xml/dao/service以及各种配置各种O开始默认的service已经提供了大部分的数据库操作功能。操作过程大致如下: ``` DataSet set = service.querys("HR_USER(ID,NM)", condition(true,"anyline根据约定自动生成的=,in,like等查询条件")); ``` 这里的查询条件不再需要各种配置,各种if else foreach标签 Anyline会自动生成,生成规则可以【参考】这里的[【约定规则】](http://doc.anyline.org/s?id=p298pn6e9o1r5gv78acvic1e624c62387f2c45dd13bb112b34176fad5a868fa6a4) 分页也不需要另外的插件，更不需要繁琐的计算和配置，指定true或false即可 ## 如何集成只需要一个依赖、一个注解即可实现与springboot,netty等框架项目完美整合，参考【入门系列】大概的方式就是在需要操作数据库的地方注入AnylineService 接下来service就可以完成大部分的数据库操作了。常用示例可以参考【[示例代码](https://gitee.com/anyline/anyline-simple)】 ## 兼容如果实现放不下那些已存在的各种XOOO DataSet与Entity之间可以相互转换或者这样: ``` EntitySet = service.querys(User.class, condition(true,"anyline根据约定自动生成的查询条件")); //true：表示需要分页 //为什么不用返回的是一个EntitySet而不是List? //因为分页情况下,EntitySet中包含了分页数据,而List不行。 //无论是否分页都返回相同的数据结构，而不需要根据是否分页实现两个接口返回不同的数据结构 //也可以这样(如果真要这样就不要用anyline了,还是用MyBatis,Hibernate之类吧) public class UserService extends AnylinseService userService.querys(condition(true,"anyline根据约定自动生成的查询条件")); ``` ## 适用场景 - **低代码后台** 主要用来处理动态属性、动态数据源(下拉列表)以及用户自定义的一些属性灵活的DDL也可以快速统一的操作各种表结构(包括各种时序、列式数据库) [【示例】](https://gitee.com/anyline/service) - **数据中台** 动态处理各种异构数据源、强大的结果集批量处理能力，不再需要对呆板的实体类各种遍历各种转换。 [【示例】](https://gitee.com/anyline/anyline-simple) - - **可视化数据源** 主要用来处理动态属性，以及适配前端的多维度多结构的数据转换 [【参考】](http://doc.anyline.org/a?id=p298pn6e9o1r5gv78vicac1e624c62387f7bb5cdeaeddf6f93f9eb865d5cc60b9b) - **物联网车联网数据处理** 如车载终端、交通信号灯、数字化工厂传感器、环境检测设备数据等 [【示例】](https://gitee.com/anyline/service) - **数据清洗、数据批量处理** 各种结构的数据、更多的是不符合标准甚至是错误的结构这种场景下需要一个灵活的数据结构来统一处理各种结构的数据再想像一下临时有几个数据需要处理一下(如补齐或替换几个字符) 这个时候先去创建个Entity,XML,Service,Dao吗 [【示例】](https://gitee.com/anyline/service) - **报表输出，特别是用户自定义报表** 类似于可视化环境,样式相对简单一点，但精度要求极高，需要控制到像素、字体等如检验检测报告、资质证书等，当然这需要配合 anyline-office [【office示例】](https://gitee.com/anyline/anyline-simple/tree/master/anyline-simple-office-word) - **运行时自定义表单/查询条件/数据结构** 各个阶段都要自定义，比低代码要求更高的是:操作用户不懂编程 [【示例】](https://gitee.com/anyline/service) - **网络爬虫数据解析** 不固定的结构、html解析(当然不是用正则或dom那太费脑子了) [【参考】](http://doc.anyline.org/s?id=p298pn6e9o1r5gv78acvic1e624c62387f51d08504f16eef5d4dd25719cf7844ce) - **异构数据库迁移同步** 动态的数据结构可以灵活的适配多种不同的表,需不需要反复的get/set 兼容多种数据库的DDL也可以方便的在不同类型的数据库中执行 [【参考】](http://doc.anyline.org/a?id=p298pn6e9o1r5gv78vicac1e624c62387f7bb5cdeaeddf6f9382274223893eaf06) [【源码】](https://gitee.com/anyline/service/tree/master/anyline-service-sync) - **还有一种很实现的场景是许多项目到了交付的那一天实体也没有设计完成** 别说设计了，需求都有可能还没结束就催交付了,Entity哪里找 [【示例】](https://gitee.com/anyline/service) ## 关于数据库的适配直接看示例(代码都是一样的、可以用来测试一下自己的数据库是否被支持) [【源码】](https://gitee.com/anyline/anyline-simple/tree/master/anyline-simple-data-jdbc-dialect)