LightAdmin：Java Web应用的可插拔CRUD UI库-优快云博客

LightAdmin：Java Web应用的可插拔CRUD UI库

light-admin [PoC] Pluggable CRUD UI library for Java web applications 项目地址: https://gitcode.com/gh_mirrors/li/light-admin

项目介绍

LightAdmin 是一个为Java Web应用设计的可插拔CRUD（创建、读取、更新、删除）UI库。它的主要目标是加速应用程序的开发过程，通过提供一个完全可操作的数据管理后端，使开发者能够专注于更重要的业务逻辑，而不是繁琐的CRUD操作。LightAdmin支持JPA（Java Persistence API），并且可以轻松集成到现有的Spring应用中。

项目技术分析

LightAdmin基于Spring框架，利用Spring Security进行认证和授权，Spring Data REST提供REST API支持。它支持Servlet 2.5/3.0，并且可以通过简单的DSL配置来定制管理界面。LightAdmin还支持JSR-303注解驱动的验证规则，确保数据的完整性和一致性。

项目及技术应用场景

LightAdmin适用于需要快速开发数据管理后台的Java Web应用。无论是企业内部管理系统、电子商务平台，还是任何需要数据管理的应用，LightAdmin都能提供一个强大且易于定制的后台管理界面。它特别适合那些希望减少重复性工作，专注于核心业务逻辑的开发团队。

项目特点

DSL配置：开发者可以通过简单的DSL配置来定制管理界面，无需编写大量代码。
持久化实体展示：支持自定义列表和快速视图，并提供分页和排序功能。
CRUD操作：完全支持实体及其关联的操作，简化数据管理流程。
自动验证：支持JSR-303注解驱动的验证规则，确保数据的有效性。
搜索功能：用户可以通过文本字段、日期、数值和关联进行搜索。
过滤器范围：通过预定义的过滤器范围快速筛选数据。
可插拔安全：基于Spring Security的认证机制，确保系统的安全性。
REST API：集成Spring Data REST，为应用提供RESTful API支持。
易于集成：支持Servlet 2.5/3.0，可以轻松集成到现有的Web应用中。

如何开始

添加Maven依赖

<dependency>
  <groupId>org.lightadmin</groupId>
  <artifactId>lightadmin</artifactId>
  <version>1.2.0.RC1</version>
</dependency>

或者使用快照版本：

<dependency>
  <groupId>org.lightadmin</groupId>
  <artifactId>lightadmin</artifactId>
  <version>1.2.0.BUILD-SNAPSHOT</version>
</dependency>

配置web.xml或WebApplicationInitializer

在web.xml中配置LightAdmin：

<context-param>
  <param-name>light:administration:base-url</param-name>
  <param-value>/admin</param-value>
</context-param>

<context-param>
  <param-name>light:administration:security</param-name>
  <param-value>true</param-value>
</context-param>

<context-param>
  <param-name>light:administration:base-package</param-name>
  <param-value>[package with @Administration configurations, ex.: org.lightadmin.demo.config]</param-value>
</context-param>

或者在WebApplicationInitializer中配置：

@Override
public void onStartup(ServletContext servletContext) throws ServletException {
  servletContext.setInitParameter(LIGHT_ADMINISTRATION_BASE_URL, "/admin");
  servletContext.setInitParameter(LIGHT_ADMINISTRATION_BACK_TO_SITE_URL, "http://lightadmin.org");
  servletContext.setInitParameter(LIGHT_ADMINISTRATION_BASE_PACKAGE, "org.lightadmin.administration");

  super.onStartup(servletContext);
}

创建实体和管理配置

定义一个JPA实体：

@Entity
public class User {

  @Id
  @GeneratedValue(strategy = GenerationType.AUTO)
  private Integer id;
  private String firstname;
  private String lastname;
       
  // Getters and setters
}

创建管理配置：

public class UserAdministration extends AdministrationConfiguration<User> {

  public EntityMetadataConfigurationUnit configuration( EntityMetadataConfigurationUnitBuilder configurationBuilder ) {
    return configurationBuilder.nameField( "firstname" ).build();
  }

  public ScreenContextConfigurationUnit screenContext( ScreenContextConfigurationUnitBuilder screenContextBuilder ) {
    return screenContextBuilder
      .screenName( "Users Administration" )
      .menuName( "Users" )
      .build();
  }

  public FieldSetConfigurationUnit listView( final FieldSetConfigurationUnitBuilder fragmentBuilder ) {
    return fragmentBuilder
      .field( "firstname" ).caption( "First Name" )
      .field( "lastname" ).caption( "Last Name" )
      .build();
  }
}