Flowable工作流(一) 之 springboot集成flowable modeler设计器

Myth丶恋晨 2023-02-21 02:27 65阅读 0赞

### springboot集成flowable modeler设计器 ###

*  源码
 *  maven依赖
 *  需要的文件
 *   *   *  1.复制源代码 \*\*modules\\flowable-ui-modeler\\flowable-ui-modeler-app\\src\\main\\resources\\static\*\*文件夹下的所有文件到springboot项目的\*\*resources\*\*文件夹下
         *  2.复制\*\*AppDispatcherServletConfiguration\*\*到任意位置
         *  3.复制\*\*ApplicationConfiguration\*\* 到任意位置
         *  4.复制\*\*FlowableStencilSetResource\*\* 到任意位置
         *  5.复制\*\*FlowableController\*\* 到任意位置
         *  6.新建包org.flowable.ui.common.security并复制SecurityUtils到包里
         *  7.在springboot项目resources下建个文件夹stencilset，把下面链接里的两个文件下载下来拷贝进去
         *  8.修改springboot项目resources\\static\\scripts\\configuration\\url-config.js
 *  application.yml配置
 *  启动

> 年纪大了记性不好，还是得记点笔记~，懒得折腾直接下载搞好的[flowable-ui][]，闲得蛋疼想折腾就慢慢黏贴复制

# 源码 #

githup上下载老版本源码[https://github.com/flowable/flowable-engine/releases][https_github.com_flowable_flowable-engine_releases]  
龟速下载的情况可以在[https://github.com/flowable/flowable-engine][https_github.com_flowable_flowable-engine]直接clone一个版本的源码，依然龟速还是通过码云导入仓库吧，再去下载了  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU_size_16_color_FFFFFF_t_70]

有需要的情况可以使用maven命令 mvn clean package -DskipTests -Pdeploy -Dmaven.javadoc.skip=true 自行编译源码，网络差的话就算了…不想吐槽

flowable-6.5.0 源码目录  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU_size_16_color_FFFFFF_t_70 1]  
**开始正题：直接在springboot集成flowable modeler设计器，比自带的更便利好用，使用的版本是springboot2.3.1，flowable6.5.0**

# maven依赖 #

<parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.3.1.RELEASE</version>
            <relativePath/> 
        </parent>
        
        <groupId>priv.gitonline</groupId>
        <artifactId>flowable-ui</artifactId>
        <version>1.0</version>
        <name>flowable-ui</name>
        <description>Demo project for Spring Boot</description>
    
        <properties>
            <java.version>1.8</java.version>
            <flowable.version>6.5.0</flowable.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.flowable</groupId>
                <artifactId>flowable-ui-modeler-rest</artifactId>
                <version>${ flowable.version}</version>
            </dependency>
            <dependency>
                <groupId>org.flowable</groupId>
                <artifactId>flowable-ui-modeler-logic</artifactId>
                <version>${ flowable.version}</version>
            </dependency>
            <dependency>
                <groupId>org.flowable</groupId>
                <artifactId>flowable-ui-modeler-conf</artifactId>
                <version>${ flowable.version}</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
            </dependency>
    
        </dependencies>

# 需要的文件 #

### 1.复制源代码 **modules\\flowable-ui-modeler\\flowable-ui-modeler-app\\src\\main\\resources\\static**文件夹下的所有文件到springboot项目的**resources**文件夹下 ###

### 2.复制**AppDispatcherServletConfiguration**到任意位置 ###

/* 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. */
    package priv.gitonline.flowable.ui.config;
    import org.flowable.ui.modeler.rest.app.EditorGroupsResource;
    import org.flowable.ui.modeler.rest.app.EditorUsersResource;
    import org.flowable.ui.modeler.rest.app.StencilSetResource;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.boot.autoconfigure.web.servlet.WebMvcRegistrations;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.ComponentScan;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.context.annotation.FilterType;
    import org.springframework.scheduling.annotation.EnableAsync;
    import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;
    import org.springframework.web.servlet.i18n.SessionLocaleResolver;
    import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping;
    
    @Configuration
    @ComponentScan(value = {  "org.flowable.ui.modeler.rest.app"
            // 不加载 rest，因为 getAccount 接口需要我们自己实现
            //,"org.flowable.ui.common.rest"
            },excludeFilters = { 
            // 移除 EditorUsersResource 与 EditorGroupsResource，因为不使用 IDM 部分
            @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = EditorUsersResource.class),
            @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = EditorGroupsResource.class),
            // 配置文件用自己的
            @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = StencilSetResource.class),
    })
    @EnableAsync
    public class AppDispatcherServletConfiguration implements WebMvcRegistrations { 
    
        private static final Logger LOGGER = LoggerFactory.getLogger(AppDispatcherServletConfiguration.class);
    
        @Bean
        public SessionLocaleResolver localeResolver() { 
            return new SessionLocaleResolver();
        }
    
        @Bean
        public LocaleChangeInterceptor localeChangeInterceptor() { 
            LOGGER.debug("Configuring localeChangeInterceptor");
            LocaleChangeInterceptor localeChangeInterceptor = new LocaleChangeInterceptor();
            localeChangeInterceptor.setParamName("language");
            return localeChangeInterceptor;
        }
    
        @Override
        public RequestMappingHandlerMapping getRequestMappingHandlerMapping() { 
            LOGGER.debug("Creating requestMappingHandlerMapping");
            RequestMappingHandlerMapping requestMappingHandlerMapping = new RequestMappingHandlerMapping();
            requestMappingHandlerMapping.setUseSuffixPatternMatch(false);
            requestMappingHandlerMapping.setRemoveSemicolonContent(false);
            Object[] interceptors = {  localeChangeInterceptor() };
            requestMappingHandlerMapping.setInterceptors(interceptors);
            return requestMappingHandlerMapping;
        }
    }

### 3.复制**ApplicationConfiguration** 到任意位置 ###

/* 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. */
    
    package priv.gitonline.flowable.ui.config;
    
    import org.flowable.ui.common.service.idm.RemoteIdmService;
    import org.flowable.ui.modeler.properties.FlowableModelerAppProperties;
    import org.flowable.ui.modeler.servlet.ApiDispatcherServletConfiguration;
    import org.springframework.boot.context.properties.EnableConfigurationProperties;
    import org.springframework.boot.web.servlet.ServletRegistrationBean;
    import org.springframework.context.ApplicationContext;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.ComponentScan;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.context.annotation.FilterType;
    import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
    import org.springframework.web.servlet.DispatcherServlet;
    
    @Configuration(proxyBeanMethods = false)
    @EnableConfigurationProperties(FlowableModelerAppProperties.class)
    @ComponentScan(basePackages = { 
    // "org.flowable.ui.modeler.conf", //不引入 conf
            "org.flowable.ui.modeler.repository",
            "org.flowable.ui.modeler.service",
    // "org.flowable.ui.modeler.security",//授权方面的都不需要
    // "org.flowable.ui.common.conf", // flowable 开发环境内置的数据库连接
    // "org.flowable.ui.common.filter",// IDM 方面的过滤器
            "org.flowable.ui.common.service",
            "org.flowable.ui.common.repository",
    // "org.flowable.ui.common.security",//授权方面的都不需要
            "org.flowable.ui.common.tenant" },excludeFilters = { 
            // 移除 RemoteIdmService
            @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, value = RemoteIdmService.class)
    })
    public class ApplicationConfiguration { 
    
        @Bean
        public ServletRegistrationBean modelerApiServlet(ApplicationContext applicationContext) { 
            AnnotationConfigWebApplicationContext dispatcherServletConfiguration = new AnnotationConfigWebApplicationContext();
            dispatcherServletConfiguration.setParent(applicationContext);
            dispatcherServletConfiguration.register(ApiDispatcherServletConfiguration.class);
            DispatcherServlet servlet = new DispatcherServlet(dispatcherServletConfiguration);
            ServletRegistrationBean registrationBean = new ServletRegistrationBean(servlet, "/api/*");
            registrationBean.setName("Flowable Modeler App API Servlet");
            registrationBean.setLoadOnStartup(1);
            registrationBean.setAsyncSupported(true);
            return registrationBean;
        }
    
    }

### 4.复制**FlowableStencilSetResource** 到任意位置 ###

### 5.复制**FlowableController** 到任意位置 ###

package priv.gitonline.flowable.ui.config;
    
    import org.flowable.ui.common.model.UserRepresentation;
    import org.flowable.ui.common.security.DefaultPrivileges;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.util.ArrayList;
    import java.util.List;
    
    
    @RestController
    @RequestMapping("/login")
    public class FlowableController { 
    
        /** * 获取默认的管理员信息 * @return */
        @RequestMapping(value = "/rest/account", method = RequestMethod.GET, produces = "application/json")
        public UserRepresentation getAccount() { 
            UserRepresentation userRepresentation = new UserRepresentation();
            userRepresentation.setId("admin");
            userRepresentation.setEmail("admin@flowable.org");
            userRepresentation.setFullName("Administrator");
    // userRepresentation.setLastName("Administrator");
            userRepresentation.setFirstName("Administrator");
            List<String> privileges = new ArrayList<>();
            privileges.add(DefaultPrivileges.ACCESS_MODELER);
            privileges.add(DefaultPrivileges.ACCESS_IDM);
            privileges.add(DefaultPrivileges.ACCESS_ADMIN);
            privileges.add(DefaultPrivileges.ACCESS_TASK);
            privileges.add(DefaultPrivileges.ACCESS_REST_API);
            userRepresentation.setPrivileges(privileges);
            return userRepresentation;
        }
    }

### 6.新建包org.flowable.ui.common.security并复制SecurityUtils到包里 ###

/* 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. */
    package org.flowable.ui.common.security;
    
    import org.flowable.idm.api.User;
    import org.flowable.ui.common.model.RemoteUser;
    import org.flowable.ui.common.security.FlowableAppUser;
    import org.springframework.security.core.GrantedAuthority;
    import org.springframework.security.core.context.SecurityContext;
    import org.springframework.security.core.context.SecurityContextHolder;
    
    import java.util.ArrayList;
    import java.util.List;
    
    /** * Utility class for Spring Security. */
    public class SecurityUtils { 
    
        private static User assumeUser;
    
        private SecurityUtils() { 
        }
    
        /** * Get the login of the current user. */
        public static String getCurrentUserId() { 
            User user = getCurrentUserObject();
            if (user != null) { 
                return user.getId();
            }
            return null;
        }
    
        /** * @return the {@link User} object associated with the current logged in user. */
        public static User getCurrentUserObject() { 
            if (assumeUser != null) { 
                return assumeUser;
            }
    
    // User user = null;
    // FlowableAppUser appUser = getCurrentFlowableAppUser();
    // if (appUser != null) { 
    // user = appUser.getUserObject();
    // }
    
            //自定义用户
            RemoteUser user = new RemoteUser();
            user.setId("admin");
            user.setDisplayName("Administrator");
            user.setFirstName("Administrator");
            user.setLastName("Administrator");
            user.setEmail("admin@flowable.com");
            user.setPassword("123456");
            List<String> pris = new ArrayList<>();
            pris.add(DefaultPrivileges.ACCESS_MODELER);
            pris.add(DefaultPrivileges.ACCESS_IDM);
            pris.add(DefaultPrivileges.ACCESS_ADMIN);
            pris.add(DefaultPrivileges.ACCESS_TASK);
            pris.add(DefaultPrivileges.ACCESS_REST_API);
            user.setPrivileges(pris);
    
            return user;
        }
    
        public static FlowableAppUser getCurrentFlowableAppUser() { 
            FlowableAppUser user = null;
            SecurityContext securityContext = SecurityContextHolder.getContext();
            if (securityContext != null && securityContext.getAuthentication() != null) { 
                Object principal = securityContext.getAuthentication().getPrincipal();
                if (principal instanceof FlowableAppUser) { 
                    user = (FlowableAppUser) principal;
                }
            }
            return user;
        }
    
        public static boolean currentUserHasCapability(String capability) { 
            FlowableAppUser user = getCurrentFlowableAppUser();
            for (GrantedAuthority grantedAuthority : user.getAuthorities()) { 
                if (capability.equals(grantedAuthority.getAuthority())) { 
                    return true;
                }
            }
            return false;
        }
    
        public static void assumeUser(User user) { 
            assumeUser = user;
        }
    
        public static void clearAssumeUser() { 
            assumeUser = null;
        }
    
    }

### 7.在springboot项目resources下建个文件夹stencilset，把下面链接里的两个文件下载下来拷贝进去 ###

> https://github.com/gitonlie/flowable-ui/tree/master/src/main/resources/stencilset

### 8.修改springboot项目resources\\static\\scripts\\configuration\\url-config.js ###

/* ACCOUNT URLS */
    
        getAccountUrl: function () { 
            // return FLOWABLE.CONFIG.contextRoot + '/app/rest/account';
            return FLOWABLE.CONFIG.contextRoot + '/login/rest/account';
        },

# application.yml配置 #

#mysql
    spring.datasource.url=jdbc:mysql://localhost:3306/flowable_ui?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
    spring.datasource.username=root
    spring.datasource.password=ADMIN123
    spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 启动 #

启动后直接访问 localhost:8080 即可  
![在这里插入图片描述][20200701153747185.png]

[flowable-ui]: https://github.com/gitonlie/flowable-ui.git
[https_github.com_flowable_flowable-engine_releases]: https://github.com/flowable/flowable-engine/releases
[https_github.com_flowable_flowable-engine]: https://github.com/flowable/flowable-engine
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/2020070114141392.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200628135611790.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA5NTc2NDU=,size_16,color_FFFFFF,t_70
[20200701153747185.png]: https://img-blog.csdnimg.cn/20200701153747185.png