在寫thymeleaf頁面的時候,我為了偷懶,不想為每個select下拉選單框都寫一個介面,於是這個懶人jar誕生了。該jar的核心功能是直接通過thymeleaf頁面的自定義標籤的屬性,直接執行sql並初始化select資料。
簡介
thymeleaf-extras-db是針對thymeleaf的擴充套件,主要是簡化前端select標籤資料的獲取,讓select標籤直接從資料庫載入資料,而不需要單獨寫介面,支援快取。
匯入
<dependency>
<groupId>com.github.jeesun.thymeleaf.extras</groupId>
<artifactId>thymeleaf-extras-db</artifactId>
<version>0.0.1</version>
</dependency>
使用教程
thymeleaf-extras-db目前支援兩種自定義標籤t:dict和t:select,兩個標籤僅一個屬性不同,其他屬性兩者都支援。t:dict和t:select都支援普通select標籤屬性,也支援select2和easyui-combobox屬性。需要注意的是,t:dict標籤的資料,是從表t_dict_type和t_dict_type_group查詢的,需要建表mysql.sql。
在html頁面上,需要給html標籤新增屬性xmlns:t="http://www.w3.org/1999/xhtml"。
使用示例:
<t:dict class="form-control select2" id="add_menu_type" name="menuType" dict-name="menu_type" style="width:100%"></t:dict>
<t:select id="add_menu_group_id" name="pid" order="desc" query="t_side_menu,name,id,pid is null" class="form-control select2" data-live-search="true" style="width:100%"></t:select>
easyui中使用方式:
<t:dict class="easyui-combobox" id="search_authority" name="authority" dict-name="role_type" style="width:160px" allow-empty="true"></t:dict>
1. 新建配置類
在Spring Boot中,使用thymeleaf-extras-db很簡單,先新建一個配置類:
@Configuration
public class CustomDialectConfig {
@Autowired
private JdbcTemplate jdbcTemplate;
@Autowired
private CacheManager cacheManager;
@Bean
public DbDialect dbDialect(){
//return new DbDialect(jdbcTemplate);
return new DbDialect(jdbcTemplate, cacheManager);
}
}
2. 配置快取
請在application.yml中新增如下配置:
spring:
cache:
cache-names: listOptionCache
如果你使用的是ehcache,那麼還需要在ehcache.xml中新增如下類似配置:
<cache name="listOptionCache"
maxElementsInMemory="0"
eternal="true"
overflowToDisk="true"
diskPersistent="true"
memoryStoreEvictionPolicy="LRU">
</cache>
3. 標籤屬性及含義
屬性 | 含義 | 是否必填 | 可選值 | 預設值 |
---|---|---|---|---|
id | id | 否 | ||
class | class | 否 | ||
name | name | 否 | ||
style | style | 否 | ||
order | 排序方式 | 否 | ||
allow-empty | 允許空值 | 否 | true,false | true |
empty-message | 空值顯示內容 | 否 | | |
cacheable | 是否允許快取 | 否 | true,false | true |
data-live-search | select2專有屬性 | 否 | true,false | |
multiple | select2專有屬性 | 否 | multiple | |
data-options | easyui-combobox專有屬性 | 否 | ||
dict_name | (t:dict獨有)字典名稱,只能填t_dict_type_group的type_group_code欄位的值 | 是 | ||
query | (t:select獨有)屬性規則:表名,顯示的欄位名,作為option的value的欄位名 | 是 |