常见问题

生成的SQL语法不对，常见的如分页语法

语法不对一般是因为没有正确识别数据库类型造成。或者虽然识别出了正确类型但没有找到相应的适配器。 先检查一下pom中有没有相应的适配器， 如果是mysql需要anyline-data-jdbc-mysql 如果是oracle需要anyline-data-jdbc-oracle 其他数据库类似。 具体原

根据SQL获取元数据信息

根据SQL获取元数据信息 service.metadata(String sql, boolean comment) comment:表示是否需要获取列注释，需要数据库官方驱动的支持 如果需要获取表结构应该用service.metadata().table("表名")//返回列、索引等全部表结构

关于Orcle的MERGE INTO 如果存在重复数据 覆盖或忽略

service.insert(table, set, new DefaultConfigStore().override(true, "ID")); service.insert(table, set, new DefaultConfigStore().override(false, "ID"))

MySQL LIMIT OFFSET不支持表达式的问题

发现有个项目里这样写 String sql = SELECT * FROM CRM_USER LIMIT (:page) OFFSET (:page-1)*:vol service.querys(sql, configs) 在Pg里可以正常执行，但返回的DataSet中不包含分页的Pgae

关于分页参数

DataSet set service.querys(table, condition(true)); //分页，参数根据配置文件或PageNaviConfig 当前页数会提取http中的参数 PageNavi navi = set.getNavi(); navi.getTotalPage

mysql表结构导入postgres

先用mysql数据源获取表结构 Table table = mysql_service.metadata()table("crm_user") 再用pg数据源创建表 pg_service.ddl().create(table) 需要注意的是：schema和catalog需要根据情况调整一下，一般设置

SQL日志开关及格式

默认情况下可以通过ConfigTable设置全局变量。ConfigStore也提供了类似的配置项，仅对当前流程有效

返回SQL方言(DDL/DML/DQL)以及SQL日志

在SQL执行过程中，在控制台或日志文件中会生成带占位符的日志。 如果需要在执行完成后返回SQL,可以在service调用的方法中添加ConfigStore参数 在执行完成后从ConfigStore中获取执行的SQL, 因为执行的SQL可能是多条，所以会返回一个List集合， 默

检测数据源是否正常可连接

检测数据源连接状态 DataSourceHolder.validate(String ds)

关于不同数据库版本的驱动

有些数据库不同的版本之间差别比较大如 MSSQL2000与MSQL2005+ Oracle9i,10g,11g与Oracle12c+ 这种情况只需要 1.在pom中依赖相应的驱动 2.根据不同版本的规则修改连接url anyline-data-jdbc-mssql中已经包含了2000与2005+运行

显式指定adapter

通常情况下系统运行时可以根据数据源的一些特征识别出当前数据库的类型，从而定位到适合当前数据库的DriverAdapter(adapter用来处理数据方言)可以用于识别的特征主要是jdbc协议名称,如jdbc:mysql jdbc:postgresql但有许多数据库没有自己的协议直接用了mysql或p

AnylineService注入失败

8.7.2之后需要等上下文全部加载完成后，才注册数据源,runtime,service等 如果通过注解注入需要添加一个@Lazy注解 或者AnylineService service = ServiceProxy.service("数据源名称") 如果只有一个数据源可以直接调用ServiceProx

未注入EnvironmentWorker,基础Java环境调用DefaultEnvironmentWorker.start()

未注入EnvironmentWorker,基础Java环境调用DefaultEnvironmentWorker.start()其他环境添加依赖如:anyline-environment-spring-data-jdbc 因为8.7.2后区分了运行环境 具体支持的环境参考https://gitee.c

bean注入失败

bean注入失败通常会引起 AnylineService空指针、未注册数据源:default等异常anyline默认是通过/META-INF/spring.factories或/META-INF/spring/org.springframework.boot.autoconfigure.AutoCo

tinyint(1)类型查询结果返回boolean

tinyint与tinyint(1)稍微有点区别 tinyint(1)类型，在JDBC连接MySQL数据库时会返回true或false,可以通过在JDBC的URL中增加tinyInt1isBit=false参数来解决。加上这个参数后会返回0或1 当设计MySQL表结构时，应避免设计为tin

直接操作DataSource或Connection

有些复杂场景如果需要操作connection可以通过runtime获取， 注意获取到connection要保证用完释放(放回连接池) 参考spring jdbc的处理方式 DataSource ds = ((JDBCRuntime) RuntimeHolder.runtime("sso")

关于文档和注释

没有根据注释自动生成的文档， 需要看说明可以点类或方法看源码上的注释，如果没有注释可能没有关联上源码，IDEA会有download source提示，点一下就下载下来了。 有哪部分注释没说明白的请到群里说一下。

关于ConfigTable静态变量与DataRow静态变量顺序问题

ConfigTable中变量比较多，项目中也经常用到。 但DataRow中有几个静态变量用的比较少如DEFAULT_KEY_CASE 注意在设置的时候尽量放在Spring启动之前 ConfigTable放在DataRow之前，因为DataRow静态变量初始前会引用到ConfigTable

druid连接SQL Server异常

在获取schema时会有个异常，换成1.1.15版本试一下

不具备更新条件

默认情况下update方法只会更新值有变化的列，可以调用DataSet(DataRow)的 clearUpdateColumns或者  addAllUpdateColumns 更新除了主键之外所有的列

为什么推荐视图

理由是在用到的时候JAVA和配置文件里都可以临时写。 如果数据量不大，结构不复杂，数据不敏感，只是显示个列表或明细确实没什么大问题。 但是以下实际情况簇不是这样： 既然都需要写SQL了复杂度还是有点的 当然不能拿那些helloworld说事，那些SQL都是多余的 

数据源连接失败后一直重连的问题

这跟连接池有关，一般连接池会有失败重试的参数可以设置，如druid 配置文件 spring.datasource.druid.connectionErrorRetryAttempts = 1  spring.datasource.druid.breakAfterAcquireFailure

ehcache不生效

先看pom有没有添加依赖 org.anyline anyline-data-cache-ehcache

关于主键与查询(过滤)条件

在更新和删除时需要至少一个过滤条件，通常是根据主键 如 where id = 100 主键key:id 主键value:100 DataRow提供了setPrimaryKey()和setPrimaryValue()方法用来设置主键key以及主键value 有进会有多个主键对就setPrim

通过DataRow/DataSet更新ID

默认情况下ID被作为主键，不会更新，实在需要更新ID 1.修改默认主键 set.setPrimaryKey("PK"); 这样SQL中PK作为主键生成过滤条件 2.但默认情况下不会更新默认主键， 这个默认主键通过DataRow.DEFAULT_PRIMARY_KEY = "PK"

查询结果集的元数据信息

正常情况下在查询结果的DataRow或DataSet对象上都会有metadatas属性 但是如果查询结果集是空的，可以打开IS_CHECK_EMPTY_SET_METADATA(通过ConfigTable-全局或ConfigStore-本次查询都可以设置)表示空结果集也要查一次元数据信息

gpg:1.6:sign (sign-artifacts) @ anyline-dependency --- gpg

如果提示 gpg:1.6:sign (sign-artifacts) @ anyline-dependency --- gpg 是因为package或install时选择了central

‌N+1查询问题‌

‌N+1查询问题‌是指在数据库查询中，对每个关联对象执行一次查询，导致总查询次数为N+1次。这种情况通常出现在一对多或多对多的关系中，例如，一个用户可以有多个订单，查询所有用户及其订单时，首先查询所有用户（1次查询），然后对每个用户执行一次查询以获取其订单（N次查询），总共执行N+1次查询 可

几个重要概念的解释

根据支持的协议每类数据源会有对应的DataSourceHolder，Actuator 每种数据源会有对应的Adapter，如OracleAdapter,MySQLAdapter 每个holder,adapter上会有适应的规则特征、一般是根据驱动类、连接协议等如 jdbc:mysql jdbc:po

前置命令

有些查询需要一些前置命令，如先创建临时表 ConfigStore可以设置前置命令 ConfigStore configs = new DefaultConfigStore(); RunPrepare prepare = new DefaultTextPrepare("

不同数据库不同字符集下汉字占用的字节数不同的问题

一般是在不同数据库迁移时会用到 service.length()可以获取当前连接中 一个中文占字节数 Table.resetColumnLength(double rate, String ... types)可以重新设置列长度

检测数据库适配器失败

通常是因为没有与数据源相匹配的adapter 1.需要添加数据库相应的依赖如org.anyline:anyline-data-jdbc-mysql、org.anyline:anyline-data-jdbc-oracle等 2.如果是spring环境需要添加spring支持org.anyline:a

关于JSON类型的插入

大部分数据库的JSON类型可以通过String(varchar)类型插入。 但测试中发现PG环境通过占位符形式插入时会抛出类型转换异常 1.禁用占位符 ConfigStore configs = new DefaultConfigStore(); configs.setPlacehol

数据库中插入自定义类型

如果有项目中自定义的类型 在写入数据库时 驱动有可能不支持 可以注册一个DataWriter，实现write方法，在写入数据库时如果匹配到相关的类型 会调用write方法执行类型转换 write要把Object value转换成java默认类型，这样系统内部会转换成驱动需要的类型 或者直接转换成数据

自定义SQL忽略未赋值部分查询条件

在执行查询时，如果有部分占位符没有赋值通常需要忽略这部分条件 String sql = "SELECT * FROM FI_USER WHERE 1=1 ${AND (ID>:MAX OR ID<:MIN)} AND NAME IS NOT NULL ${AND LVL

把mysql的DDL解析转换成Oracle的DDL

直接解析DDL是很困难的，所以不直接解析把DDL交给数据库执行一下mysqlService.execute(ddl) 在生成了表之后，从数据库中读取表结构对象Table table = mysqlService.metadata().table(表名) 再用oracle创建表oracleS

指定参数值数据类型

对于有些严格要求数据类型的数据库，参数类型与数据库列的类型要一致，可能通过::数据类型 后缀的格式指定数据类型，如pg要求类型一致需要指定格式，而mysql可以隐式转换不用指定 service.querys("HR_EMPLOYEE" , condition("ID:>=min::

多个数据源特征(协议)相同

多个数据源特征(协议)相同 如mysql数据库和doris数据库，都使用jdbc:mysql协议 在操作mysql定位adapter时dodrisAdapter了符合条件，所以有可能返回dorisAdapter，但doris与mysql语法有区别，生成doris SQL在mysql中执行不

关于分页(不)查询总行数

默认情况下分页前会是查询一次总行数。 但还有场景如数量特别大、下划加载更多等不需要总数或项目中单独维护的总数 可以通过PageNaviConfig.IS_AUTO_COUNT=false 全局设置分页查不计算总数 也可以通过ConfigStore.autoCount(false)或Page

关注SQL注入

防注入是指把符合SQL特征的参数值过滤或修改，避免拼接上参数值后破坏原SQL结构 anyline方法唯一与注入相关的是把参数值换成了占位符 但方法内部不会检测参数值是否合法，因为ConfigStore.and(String sql)之类的方法是可以接收原生SQL作参数的，这部分参数基本符合注入特征，

convert定位失败

出现这个异常是因为从origin类型转换到target类型失败了 出现这个日志时，可以打开ConfigTable.IS_THROW_CONVERT_EXCEPTION=true 看看具体是哪一行引起的 异常通常是发生成 1.SQL点位符赋值时 2.从数据库中查询出数据给实体类实例赋值时，如数据库中是

DataSet 与 List

各版本差异

原版本 新版本 主要差异

空值被替换成了null

默认情况下""与null都会统一成null处理，是因为主要考虑到web提交数据的场景，在input中没有输入值时会提交空值""这时这通常不应该把""插入数据库，实际更多需要的应该是null 如果确认需要""可以通过以下方式实现  ConfigTable.IS_REPLACE_EMPTY_N

各数据库需要的依赖

每个数据库需要 1 个anyline提供的适配器 + 1 个数据库官方的驱动 适配器参考以下，打开适配器可以查看官方驱动的依赖，因为是provided形式的依赖，所以需要把驱动也复制到自己POM中

以provided形式依赖的库

由于每个项目的基础库版本各不相同，但anyline需要基于这些基础库，所以在依赖是以provided形式依赖了以下基础库 所以在实际项目中需要根据自己的版本要求添加以下依赖（如果用到的话） org.springframework.boot:spring-boot-starter-jdbc org.s

启用maven中央库的SNAPSHOT版本依赖

默认情况下maven已经禁用了中央库的SNAPSHOT版本。但在开发过程中经常需要用到 POM中可以这样开启

查询部分列(属性)

查一个职员列表，因为简介等大文本影响IO,所以只查ID,NAME两列

根据情况生成不同的查询条件

这里主要说的时空值的情况，相关的查询条件是否生效 如果提供了年龄值，则按年龄查询条件有效，如果没有提供年龄值，则忽略年龄查询条件

根据情况生成不同的查询条件(FIND_IN_SET)

仅针对MySQL

查询条件默认值

如果http request提供了参数值并且不为空，则按提供的参数值查询，否则按默认值查询。

关于动态

动态主要是指在运行时才能明确、编码是不明确。可能出现在 数据源 数据库类型 查询的表 查询列 分页 查询条件 数量: 同一个接口中根据前端参数，根据组合成不同的查询条件，如 service.querys("crm_user", c

为什么推荐结果集key强转大写

因为有些情况下容易产生歧义，如userId,userID都合理，在前端调用接口时还需要查文档才能确定， 另外不推荐驼峰格式,因为有些数据库会把列名转成大写

DriverAdapter

DriverAdapter用来适配不同的数据源驱动，根据数据源类型生成不同的执行命令(如果是支持JDBC的数据源就是SQL和参数) 多数据源适配过程： 系统启动时会把pom中依赖的所有adapter注册到spring上下文环境中 注册数据源时会定义一个key,切换时根据这个key切换 在执行生成

8.7.2及之后版本开始区分运行环境(Java/Spring/Solon/Vertx)

8.7.1及之前的版本默认基于spring 8.7.2及之后的版本需要区分运行环境，目前支持： Java(默认支持) Spring Solon Vertx 主要的区别只是类加载机制不同，核心代码都是一样的，对项目代码没有影响 如果是纯java环境，

关于查询分区表(子表)性能

查询分区表可以按分区表名称也可以按主表(超表)查询，分别适用不同的场景

流式查询

默认情况下查询数据会把符合条件的数据一次性读到内存中，但是在大数据处理时会比较耗时甚至内存溢出。在这种情况下可以启用流式查询。返回一个迭代器。在迭代器中执行业务处理。 handler支持4种形式,按性能排序ResultSet>Map>DataRow>Entity 其中ResultS

关于查询元数据时返回的LinkedHashMap大小问题

因为不同数据库的配置不一致，以及设计人为风格的不一致，所以表名列名的大小写很容易混淆，对于不区分大小写的数据库没有问题，但是区分大小写的数据库一定要保持代码与原数据库一致。 在读取元数据时一般会返回一个LinkedHashMap，因为在读取元数据的过程中有可能需要多个过程才能读出完整数据，使用map

pg分区表-多级分区

进口数据多个国别，多个年份，原始结构如下 ID 年份 国别 品类 金额 1 2001 法国

关于默认数据源(default)与通用数据源(common)

这里的通用和默认是指数据源对应的service,就是我们在业务代码中用来操作数据库的类 通用service(bean.id=anyline.service)是指可以通过切换数据源的方式来操作所有数据源的service 默认service(bean.id=anyline.service.default

为什么查一个表的结构时，在日志中会发现要查询出所有的表

因为不同的数据库配置不一样，查出出来的结果有可能大写有可能小定，如mysql这样的数据库，有些人安装完了也不配置直接上线，就会导致区分大小，这时表名crm_user与CRM_USER是不一样的。如果大小写没写对根据表名是查不到结果的。 所以会先把所有表查出来放到一个Map中以表名大小作为key,这样

未注册数据源:common

一般在初次测试时会遇到这种问题，正式的开发环境不会遇到 在上文中没有找到spring jdbc template实例时会抛出这个异常。 jdbctemplate一般是连接池插件例化的，springboot2，3环境下默认使用HikariCP连接池(org.springframework.boot:s

关于日期类型显示格式问题

如 关于查询结果集中不显示秒的问题 数据库中数据类型datetime 查询结果显示2023-05-25T07:00(不同的环境显示格式可能不一样) 有时候会发现没有秒 是因为数据库存储的本来也不是String格式，而是一个时间戳，在显示时需要经过toString转换，转换成什么格式就不

关于集合(数组)参数值

集合(数组)参数值在IN，NOT IN等可以接收多个值的查询条件中，所有条目都将参与执行。否则只有第0个条目参与执行. 如 DataRow row= new DataRow(); row.put("NAME",  "1,2,3".split(",")); service.save

关于数据库名、表名中出现中划线(减号)的问题

数据库名、表名中出现中划线(减号)时在jdbc是容易被误当成减号处理引起语法异常。尽量不要用中划线，如果必须要用的话可以打开界定符开关 这样在处理表名时会当成一个词处理。 启动类中ConfigTable.IS_SQL_DELIMITER_OPEN = true 或配置

为什么配置文件没有自动提示

如果项目中依赖了spring-boot-configuration-processor，集成开发环境会有key提示 如anyline.aliyun.oss.bucket= anyline-mvc默认依赖了anyline-boot,anyline-boot中默认依赖了spring-boot-con

关于数据库名称的中划线(减号)引起的语法错误

首先建议把中划线去掉，命名时不要用中划线。如果控制不了的话可以打开界定符 在启动类的spring启动前前加 ConfigTable.IS_SQL_DELIMITER_OPEN = true 或者在spring配置文件中加 anyline.sql-delimiter-op

未指定列(DataRow或Entity中没有需要更新的属性值

说明没有可插入的值 注意检查 是否开启了 IS_AUTO_CHECK_METADATA  会检测列名是否存在表中，如果不存在则忽略 是否开启了 public static boolean IS_UPDATE_NULL_COLUMN = false ; // 是否更新n

Anyline连接OceanBase

OceanBase的背后是MySQL或Oracle直接用MySQL的驱动就可以 参考源码https://gitee.com/anyline/anyline-simple/tree/master/anyline-simple-data-jdbc-dialect/anyline-simple-data-

指定数据库类型

数据库类型是不需要指定的，经常有这搜索个问题所以说明一下内部是如何判断数据库类型的

为什么保存实体对象时驼峰会自动转成下划线格式

为什么保存实体对象时驼峰会自动转成下划线格式

关于默认主键

在默认情况下，更新数据时以ID作为主键。
可以通过ConfigTable.DEFAULT_PRIMARY_KEY = "CD" 或配置文件统一修改

在实际业务中经常需要根据其他列来执行批量修改可以通过
DataRow或DataSet的setPrimaryKey("user_id")来设置新的主键,这样可以实现按user_id批量更新数据

Failed to execute goal org.apache.maven.plugins:maven-gpg-plugin:1.6:sign (sign-artifacts)

出现以下异常，应该是因为profiles选中了central，因为central是发布到中央库其中配置了maven-gpg-plugin所以需要签名, 如果只是本地install不需要签名，选anyline或其如果你本地maven配置文件中配置了其他的profiles也可以，一个不选也可以。 [ER

时间导致的时差以及日期时间格式

如果数据库中存储的时间与Java中查出来的时间不一致，一般是由于时区不同造成的。 先确认服务器时间和数据库时间是否一致。 再看服务器时区、数据库时区、Java连接数据库的时区 关于LocalTime中如果秒位置是0 则toString()会忽略秒如 12:00:00会显示成12:00(分

service.update(DataRow)只更新值有变化的列

service.update(DataRow)只更新值有变化的列

从数据库中查出日期类型(Date,LocalDateTime)获取时间戳

DataRow row = service.query("table");
如果数据类型是时间类型，可以直接获取时间戳或日期类型
Long ts = row.getLong("time");
Date date = row.getDate("time");

DataRow与Map的区别

DataRow是继承自Map所以Map有的方法DataRow都有， 并且对Map进行了改造和扩展，主要有: 改造了get/set方法，在get/set执行前会先检测key,以实现忽略大小写、下划线、驼峰等格式，效果就是get("userid") get("userId") get("user_id"

getColumns与getMetadatas区别

getColumns返回的是DataRow中查询出来的列属性 getMetadatas返回的是整个表的列属性 如CRM_USER表中有三列，ID,NAME,AGE DataRow row = service.query("CRM_USER(ID,NAME)"); 这时getMetadatas会返回3

数据集外键关联

应用场景如 订单集合中有user_id，需要根据user_id到users集合中关联中user_name 如果通过SQL实现大概是这样 SELET O.*, U.NAME AS USER_NAME FROM MM_ORDER AS O LEFT JOIN CRM_USER AS U ON M.U

DataSet分页

DataSet set = new DataSet(); List pages = set.page(10) //每页10行，分成多少页根据总数 List pages = set.split(10)//分成10页，每页多少行根据总

关于DataSet.total()与size()

total()表示总行数，如果没有经过分页，total()与size()结果一致。如果经过分页则返回PageNavi.totalRow()也就是数据库中符合条件的总行数可能要比size()结果大 size()表示当前DataSet中的实际行数。

Entity中的集合(数组)属性保存到数据库中

Entity中的集合(数组)属性保存到数据库中["A","B","C"]与A,B,C格式 如果数据库中是JSON格式则会保存成["A","B","C"]格式 如果数据库中是vachar类型则默认会保存成A,B,C格式(为了方便 findinset函数执行)，如果需要保存成["A","

Entity 下划线与大小驼峰转换

如果属性上有注解则按注解设置的列名转换， 如果属性上没有注解 会根据 ConfigTable.ENTITY_FIELD_COLUMN_MAP进程转换; 默认"camel_"属性小驼峰转下划线 joinYmd > join_ymd

Entity(Field)与Table(Column)的对应关系

在有些场景中可能需要用到实体类。如: DataRow(DataSet)与Entity相互转换。 查询返回Entity或集合 根据Entity保存或更新数据 这时需要确定Entity与Table的对应关系，以及Field与Column的对应关系 默认情况下anyline根据DefaultEntityA

Entity注解

anyline并没有依赖JAP，只是根据注解的名称及注解属性名称来解析注解，所以需要注解的需要自己添加相关依赖 可以解析的注解： 表名:table.name, table.value, tableName.name, tableName.value 列名:column.name,column.val

EntityAdapter接口说明

EntityAdapter主要用来实现实体类与表，属性与列之间的转换。 系统自带一个默认的EntityAdapter，每个项目也可以提供定制的EntityAdapter，参考【EntityAdapter定制】 在执行转换时会按顺序调用,直到成功为止，顺序以EntityAdapter.order()方

关于json、object、arry等非基础类型属性

对于非基础类型属性，在数据库可以用json类型。 在插入或更新数据时会把属性值转换成json格式，同样的读取数据时也会把json格式还原成属性对应的数据类型。 需要注意的是，在插入数据时数据需要先知道数据库中是JSON类型才会转换。 这样就需要开启一个开关，来保证插入数据前先检查数据库结构。当然这个

Data truncation: Cannot create a JSON value from a string with CHARACTER SET 'binary'

出现这个异常是因为视图把json类型保存到数据库中，一般来说数据库会设置一个JSON类型。 但在页mysql驱动对json的sql类型会要求一个String类型的数据, 需要打开ConfigTable.IS_AUTO_CHECK_METADATA  = true ,这样

属性关联表主键生成器注解

通常情况下通过配置文件设置一个统一的主键生成器就可以，但如果有一部分表需要单独设置 一种方式是可以通过配置文件单独指定 另一种方式可以通过注解设置 另外一些属性的关联表的主键生成器也可以通过注解设置,这种情况比较特殊在其他JPA中一般不这样用 @Table(name="HR_EMPLOYEE")

关于类/属性VS数据库表/列之间的转换

通常情况下类和属性会采用大小驼峰的格式命名，而数据库则采用下划线的格式命名 默认情况下org.anyline.adapter.EntityAdapter接口实现了 类/属性 VS 表/列  之间的默认转换， 但有些数据库设计时并不采用下划线，也用了驼

关于元数据(表结构、索引等)缓存

由于元数据的查询需要许多SQL,所以默认情况下会生成缓存。 当通过service.ddl()修改数据库时，缓存会刷新，但通过其他方式修改数据库时，缓存无法接收通知，所以会导致缓存与数据库不一致的情况 为避免以上情况，可以 1.数据库修改都通过service.ddl()执行 2.数据库修改后调用系统接

Table转JSON格式循环引用导致堆栈溢出的问题

Table上提供了json和map方法 如果需要String格式可以调用json() 如果直接返回给前端可以调用map()

sequence

BigDecimal next = service.sequence("SIMPLE_SEQ"); DataRow nexts = service.sequences("SIMPLE_SEQ", "SIMPLE_SEQ2"); BigDecimal cur = service.sequence(fa

删除数据的几种场景

删除会有以下几类情况 1.先查出数据，再执行删除 2.直接执行SQL 3.根据约定参数删除 4.复杂条件可以构造ConfigStore 源码请参考 https://gitee.com/anyline/anyline-simple/tree/master/anyline-simple-d

插入数据后返回主键值

插入数据后返回主键值

设置SQL执行的超时时间

 //设置SQL执行的超时时间(毫秒) ConfigTable.SQL_QUERY_TIMEOUT = 1; ConfigTable.SQL_UPDATE_TIMEOUT = 1;

简易方式指定数据源和主键

service.querys("table(col1,col2)") <数据源>放在开头 <主键>放在结尾 ds_sso表示数据源 ID,CODE表示主键

多数据源场景中service注入失败

如果是单个数据源默认情况下AnylineController中已经默认注入了一个AnylineService service;这个service可以操作多个数据源bean.id = @Service("anyline.service") 但是在多数据源情况下，为了更强的隔离性，避免线程共享

关于更新条件

确定更新条件的 按指定条件更新；没有指定条件的 按主键更新 @Test public void updateRow(){ DataRow row = new DataRow(); row.put("ID", 10); row.put("

关于几个 空值 的查询示例

//service.query("crm_user", "+id:null"); // ID IS NULL //service.query("crm_user", "+id:");     // ID IS NULL //以上两种情况 经常是通过变量拼接出来如 "+i

group/order/having/exists条件

group/order/having/exists都可以放在query参数中,与查询条件混在一块，如 service.query("SSO_USER AS M", "order by id desc", "group by type", "exists(SELECT * FROM HR_USER A

metadata缓存

在执行DDL时，需要频繁的读取表结构等元数据，非常耗时，所以会添加一层缓存。 也是就是不会每次都从数据库中读取数据。 以下3种情况会清空缓存： 1.缓存过期 2.执行DDL 3.调用CacheProxy.clear()  这样会存在一个问题。如果表结构还在

关于不同数据库的catalog/schema/database

获取表或视图的DDL

//查询表结构时，默认会查询DDL Table table = service.metadata().table("CRM_USER") List ddls = table.ddls(); 对于确认只有一条SQL的数据库可以 String ddl = table.ddl(

查询表上的索引

查询crm_user表上的索引 LinkedHashMap indexs = service.metadata().indexs("crm_user"); for(Index item:indexs.values()){ System.out.printl

修改主键

Table table = service.metadata().table("TEST_PK"); Column pcol = table.addColumn("PKID", "int"); PrimaryKey pk = new PrimaryKey(); pk.addColumn(pcol);

删除列

1.保存表时 在指定列上标记删除 2.保存表时删除数据库中有，但表结构中没有的列 3.直接删除列

DDL保存表结构时，删除列和添加列

如数据库中原来有3列，C1,C2,C3 保存结构时只提供了C3,C5 在默认情况下 修改C3,添加C5 C1,C2保持不变 打开 ConfigTable.IS_DDL_AUTO_DROP_COLUMN = true 删除C1,C2 修改C3,添加C5

多个ConfigStore合成一个ConfigStore

在代代码，运行时自定义场景中，经常会调用不同的方法生成多个ConfigStore也就是多组查询条件 但在调用service.querys时只能接收一个ConfigStore 解决方式： 生成一个ConfigStore 在合成查询条件时把ConfigStore作为参数输入，通过

复杂条件的合成

ConfigStore a1 = new DefaultConfigStore().and( "id11", 11).and("id12", 12); ConfigStore a2 = new DefaultConfigStore().and( "id21", 2

关于函数操作

在查询条件和查询列中经常需要函数，当然这样查询对性能影响非常严重，只是举例说明一下语法 SELECT  id,to_char(reg_time,'yyyy-mm') as ym FROM crm_user WHERE char(reg_time,'yyyy-mm-dd') LIKE

condition参数与query参数的混淆

在controller中查询数据时经常会用到： String status = "FINAL"; service.query("CRM_USER", condition(true, "TYPE_CODE:type"), "DATA_STATUS:"+status); 实际执行的

关于分页参数

AnylineController中提供了condition(boolean navi)用来根据前端提交的数据封装分页参数 经常要用到两个参数 1.当前第几页 2.每页多少条 默认情况下这两个参数值比较长，是为了避免与其他业务参数冲突。定义在PageNaviConfig中 public static

关于数组参数值

标准的url中一般是这样http://127.0.0.1/list?id=1&id=2&id=3 或者用form表表单提交三个name=id的input 也可以提交json格式{id:[1,2,3]} 以上三种情况condition("ID:[id]")都可以解析成WHERE I

XML中自定义复杂SQL

文件格式: SELECT M.I

关于自定义SQL中的变量赋值

String sql = "SELECT * FROM CRM_USER WHERE CODE = :PARAM_CODE"; DataSet set = service.querys(sql, "PARAM_CODE:1"); //生成SQL SELECT * FROM CRM_USER WHERE CODE = 1 //特别注意这以下情况 CODE:1与SQL中的变量匹配不成功时，SQL会

关于JPA(mybatis,hibernate,spring-data-jdbc,spring-data-jpa等)转anyline或与anyline集成

如果有些历史项目已基于JPA(mybatis,hibernate,spring-data-jdbc,spring-data-jpa等)开发 或者已经习惯了实体类的形式 这不影响anyline的集成，可以保留原来的实体类其他的如service,dao,repository,mapp

数据源覆盖

在注册动态数据源时，如果key相同会覆盖原来的数据源，但是需要打开spring配置spring.main.allow-bean-definition-overriding=true 否则会抛出异常Invalid bean definition with name 'anyline.jdbc.temp

数据源注销

可以主动注销，DataSourceHolder.destroy(key); 实际最终调用的是JDBCRuntimeHolder.destroy(key);因为这时不只是要注销数据源了，相关的bean都要一块注销 在注册同名数据源时也会自动注销

关于临时数据源连接泄漏的问题

无论是什么数据源都会配置一个连接池，在一个命令执行完后，相关的连接会放回连接池待下一个命令复用 这里只是放回了连接池，并没有真正释放连接，也就是没有与数据库断开连接。 只有在注销数据源时，才会把连接池中的连接彻底断开。 但临时数据时没有提供注销的功能，如果需要注销的话应该使用正

缓存有效期和刷新频率

如果设置了缓存时间100秒有效，再前90(90%*100)秒内会从缓存中提取数据 第90秒后的第一次也从缓存中提取数据，同时开启子线程刷新缓存

禁用Anyline事务管理器

默认情况下，注册一个数据源就会自动生成一个事务管理器。如果项目没事务控制的需求，可以禁用Anyline事务管理器 ConfigTable.IS_OPEN_TRANSACTION_MANAGER = false; 这样无论是通过配置文件还是Java注册数据源时，都不会生成事务管理器

关于DDL与事务控制

MySQL的DDL语句是非事务的，即不能对DLL语句进行回滚操作 并且在执行到DDL语句时，会隐式的将当前回话的事务进行一次“COMMIT”操作，也就是说之前未提交的事务会被提交。 因此在MySQL中执行DDL语句时，应该严格地将DDL和DML完全分开，不能混合在一起执行

日期类型

有些数据库对数据类型要求比较严格，不能隐式转换，这时需要开启        ConfigTable.IS_AUTO_CHECK_METADATA = true; 这样在插入数据前可以检测列的数据类型，检测到数据类型才能实现正确的格式转换 例如Oracle

多数据源注解事务异常 found 2:anyline.transaction

在多数据源情况下，通过注解控制事务会报这个异常 org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type [TransactionManager] is defined:

多数据源事务控制

这里说的是有多个数据源，并且多个数据源需要控制事务。【为会么要创建多个事务管理器】 如果然后有多个数据源，但只需要控制主数据源的事务，不要往下看只需要参考【多数据源注解事务异常】 分两种情况说明 一、需要控制事务的方法内部不需要切换数据源。并且编码阶段已经可以确认是哪个数据源  

为会么要创建多个事务管理器

在多数据源的情况下会生成多个事务管理器。 为了更强的隔离性。否则数据源切换过程中，不好跟踪事务，如果遇到线程共享时，切换数据源也有可能失败，那事务管理器肯定就乱了。 为了在切换数据源过程中，保持事务状态。就是不要因为切换数据源，而把上一个事务强制提交或回滚。

多数据源事务管理器bean.name

在存多数据源的情况下会创建多个事务管理器【为会么要创建多个事务管理器】 事务管理器在spring上下文环境中的命名也就是bean.name 如在默认数据源之外 又创建多个数据源a,b,c spring会针对默认数据生成一个默认事务管理器:transactionManager anyline

关于VoltDB timestamp类型

插入时可用Long类型，需要注意的时new Date().getTime()或System.currentTimeMillis()返回的毫秒基础上要*1000 也可以String类型，格式必须是YYYY-MM-DD hh.mm.ss.nnnnnn 或 YYYY-MM-DD

数据库读、写过程中的类型转换

读取数据库的过程中，驱动类从数据库中读取出数据后，会有一步类型转换的过程，通常情况下内置的DataReader可以满足大部分的情况， 但如果遇到特殊情况比如希望转换成项目定义的类型,这时需要注册一个自定义的DataReader 可以调用DefaultDriverAdapter静态方法 /*

数据类型之间的转换

在生成SQL的过程中，如果没有占位符，数字类型一般可以直接拼接，String类型需要加单引号， 而日期类型有些数据库可以实现隐式转换，加单引号即可，有些数据库不能实现，需要内置函数转换成日期类型 还有些更复杂的类型类byte,json,array,geometry等类型更需要内置函数 如果有占位符

插入数组类型

pg数组库支持数组类型，在定义时可以这样 table.addColumn("TYPE_IDS", "INT[]"); //在原型基础上加[] 插入数组类型时，需要设置这一列的数据类型，否则会把数组拆开只取下标0的条目，因为不知道数据库中是数组类型 可以打开ConfigTable.IS_AU

关于日期时间格式化

通过情况一可以用DateUtil.format来格式化 或DateUtil.parse执行解析 可以接收各种数据类型如String/Long/Date(包括sql.Date)/LocalDate等 String ymd = DateUtil.format("yyyy-MM-dd")把当前日

从其他系统中下载文件 为本系统用户提供下载源

@RequestMapping("export") public void export(HttpServletRequest request, HttpServletResponse response){ 	HttpResponse httpResponse= HttpBuilder.init().setUrl(url).setParams(par
                        

                        

                            
                        
                    

Java截取html

在截取html时经常会遇到html标签被破坏的情况，这时需要识别出截止位置是否处于某个标签内部,如果在标签内容需要定位到标签的结束位置

entity()根据表结构获取request提交的参数

entity()根据表结构获取request提交的参数

关于后台日志输出

ConfigTable提供了以下开关用为控制日志输出，系统启动时后台会输出的AnyLine版本信息 可以通过IS_DEBUG=false关闭 ConfigTable属性与配置文件一一对应,配置项参考AnylineProperty public static boolean IS

[检测数据库适配器][检测其他可用的适配器失败][可能没有依赖anyline-data-jdbc-*或没有扫描org.anyline包]

如果后台日志提示[检测数据库适配器][检测失败][检测其他可用的适配器] 说明根据数据源连接信息没有找到合适的适配器(这个适配器用来为不同的数据库生成特定的SQL) 如连接信息中是 mysql数据库，但没有依赖anyline-data-jdbc-mysql 也有可能没有扫描org.anyline这个

如果数据库中已存在数据则更新或跳过，如果数据库中不存在则insert

如果数据库中已存在数据则更新或跳过，如果数据库中不存在则insert

关于BLOB数据类型

1.通常情况下数据库的blob类型会对应entity的byte[]类型 2.有些情况下数据库是blob类型，而entity的属性是String类型

关于JSON数据类型

如果属性是Entity或List 类型，数据库中是json类型，在执行插入或更新时会把属性转换成json(String) 相应的在从数据库中查询结果时，会把json类型转换成Entity或List 实例

切换数据源失败可能的原因

启动类上添加注解@Import(DynamicDataSourceRegister.class) 启动类上需要扫描包org.anyboot

jdk8升级到jdk17

8.6.5之后开始支持jdk17 版本号添加缀加 如8.6.5-SNAPSHOT > 8.6.5-jdk17-SNAPSHOT 需要tomcat10支持 参考tomcat9升级到tocmat10的

Tomcat9升级到Tomcat10

javax.servlet javax.servlet-api 换成

动态注册多数据源

动态注册多数据源

为什么有时update sql不执行

如果DataRow是通过查询数据库创建的，并且其中的值没有更新，则执行service.update时不会执行更新SQL

关于生成水印位置偏移

WatermarkUtil实现水印添加 主要通过设置x,y坐标实现水印定位 默认以左上为(0,0)起始位置往右下偏移 如果设置xy为负数则从右下为(0,0)起始位置往左上偏移 xy默认为起始位置的偏移像素数量， 如果设置xy为小数则按长或宽的百分比计算偏移量如wihth=100,x=0.5则按左侧偏移50(100*0.5)像素 WatermarkUtil util = new 

需要清空内容的列没有更新

默认情况下内容为空的列(“”或null) 不会出现在UPDATE SQL中

关于必须条件

 以“+”开头表示当前条件必须拼接 如condition("+NM:nm") 如果客户端提供了nm值，如http://localhost?nm=zh 则正常生成SQL:  SELECT * FROM TAB WHERE NM = 'zh' 如果没有提供nm值,如如http://localhost或 http://local?nm= 则生成SQL: 

关于IN条件

关于IN条件

关于or

OR条件构造相关复杂 可以根据http参数生成OR条件 或在java中取值生成OR条件

删除空值

删除空值

替换空值

替换空值

关于DataRow中key的大小写

关于DataRow中key的大小写

DataSet中cut与truncate区别

cut与truncate都是根据条件截取

save与insert区别

save与insert区别

HttpUtil访问https的问题

HttpUtil访问https的问题，SunCertPathBuilderException：unable to find valid certification path to requested target

前端未提交数据情况下清空一列值

默认情况下前端不传值时，执行update时并不更新这一列 如 DataRow row = entity("ID:id","REMARK:remark","NAME:name"); service.save(row); 这时如果没有提交remark参数值，或remark值为空时，并不更新REMARK列 但有些情况下是前端需要清空一个属性值，有以下种方式 1.提交一个"NULL"的值 2.指定必须更新

html中抽取标签时嵌套问题

从html中抽取多个标签，如需要抽取a标签和li标签 最简单的是抽取两次 RegularUtil.fetchAllTag(html,"a") RegularUtil.fetchAllTag(html,"li") 但这样有个问题，两个标签的顺序会乱， 如果需要保持顺序可以通过RegularUtil.fetchAllTag(html,"a","li"); 但是一定注意:这里

AnylineService注入失败

还有可能没有依赖spring-jdbc，因为anyline以是provided形式依赖的，是为了方便项目修改版本。（更多provide依赖参考这里） 如果是spring-mvc项目可以依赖这个 <dependency> <groupId>org.springfram

关于几种OR条件查询的情况

//以下三种格式,只有cd取值成功时，条件才生效 //当cd=1,id=2时 WHERE CODE = 1 OR CODE =2 //当cd=null,id=2时 条件不生效 //当cd=1,id=null时 WHERE CODE = 1 service.querys("HR_USER", condition("CODE:cd|id")); //当cd=1时 WHERE CODE =1 OR

几个常用的配置参数

//DataRow的key大小写(默认大写) DataRow.DEFAULT_KEY_KASE = KeyAdapter.KEY_CASE.LOWER; //http分页参数-当前当前第几页(默认page) PageNaviConfig.DEFAULT_KEY_PAGE_NO = "pageNum"; //http分页参数-每页多少条(默认vol) PageNaviConfig.DEFAULT_K

关于分页参数

默认的分页参数名比较长: public static String DEFAULT_KEY_PAGE_ROWS = "_anyline_page_rows" ; //设置每页显示多少条的key public static String DEFAULT_KEY_PAGE_NO = "_anyline_page" ; //设置当前第几页的key public static

get(String key)与getString(String key)的区别

get(String key)与Map的get(String key)效果一样 getString(String key)支持表达式 getString("${ID}-${NAME}")

关于自动检测表结构

在执行数据库操作时，许多参数是以String形式获取到的,无法参数识别数据类型，如url中的参数 还有一些数据类型在Java中没有对应关系,如xml/josn/几何图形等 而有些数据库在执行SQL时会执行强类型检测。 不像我们平时用的MySQL在执行时会进行隐式转换，无论什么类型只要能转换成功就可以执行。 而PostgreSQL则要求jdbc参数与表结构对应，如果在va

关于更新部分属性(列)、忽略部分属性(列)

在实际操作中经常需要更新指定的列，或者忽略更新指定的列

关于insert或update时确定哪些列参与到insert或update中

关于insert或update时确定哪些列参与到insert或update中

屏蔽anyline版本信息在控制台的日志输出

如果要关闭以上输出可以在anyline-config.xml配置文件中添加boolean 如果没有配置文件可以在启动类加载spring上下文之前设置ConfigTable.IS_DEBUG = false;

查询数据库返回的数据字段全是大写，字段怎么设置返回小写

可以通过ConfigTable设置全局参数 ConfigTable.IS_LOWER_KEY = true; ConfigTable.IS_UPPER_KEY = false;

关于查询结果的数据结构(数据类型、长度、精度、非空等)

关于查询结果的数据结构(数据类型、长度、精度、非空等)

DataSet/DataRow 下划线与大小驼峰转换

数据库中经常是下划线命名，如果需要给前端输大小驼峰格式。可以通过DataSet/DataRow转换

为什么有些boolean的属性用int类型有些用Integer

为什么有些boolean的属性用int类型，如是否可以为空 因为需要标记一个未知状态，就是不知道是true还是false 在metadata操作赋值时，经常需要根据多种渠道获取一个值，这种情况下如果既不是true也不是false时就可以覆盖，如果已经有值了ture或false就不再继

DDL中极易混淆的操作:rename

修改表名或列名的操作比较特殊， 先看一个最终执行的SQL  RENAME TABLE 原表名 TO 新表名 与其他修改属性的操作不一样的新名与原表名与新表名都需要保留，否则就不知道要修改的是哪个表或哪个列了。这不像在Java中可以引用传址。 这里有一个需要记住

SQL中的变量及占位符格式

SELECT * FROM CRM_USER WHERE ID = :ID  以:标识的执行时直接替换  以::标识的执行时以?占位   NAME LIKE :NM + '%'   (NAME = :NM)   NAME = ':NM'   NM IN (:NM)  

数据源连接池配置参数(连接池类的属性)

注意：不同版本的连接池参数名会不一样，url/driverClass经常会出现不同的名称如jdbcUrl/driver/driverClassName等。要打开源码看一样当前版本的属性 HikariCP查看com.zaxxer.hikari.HikariDataSource Druid查看com

关于2023-03-31之后数据源切换@Import(DynamicDataSourceRegister.class)

2023-03-31之前多数据源切换是利用spring提供的AbstractRoutingDataSource为spring返回不同的数据源。 也就是同一个JdbcTemplate需要切换多个DataSource。 应用方式：启动类添加注解@Import(DynamicDataSourceReg

切换数据源失败可能的原因

切换数据源失败可能的原因 有可能缺少注解@Import(org.anyboot.jdbc.ds.DynamicDataSourceRegister.class)

三种方式切换数据源

切换数据源有两种试: 1.使用通用AnylineService实例 1.1)通过DataSourceHoldersetDataSource("crm")方式设置当前数据源,再调用service.query等方法操作数据库 1.2)service.query("USER");在表名前添加数据源名称 2.通过ServiceProxy返回数据源对应的service(推荐使用这一种方式,隔离性更强,不容易混淆​)

关于POINT类型

如果是Entity 或者用org.anyline.entity.Point类型 或者用double[] 或Double[] 但是要关闭这个开关 ConfigTable.IS_AUTO_SPLIT_ARRAY = false; 关闭的后果是 更新数据库时 不能把数组值赋值给一列（原