All Downloads are FREE. Search and download functionalities are using the official Maven repository.

cn.ponfee.disjob.supervisor.configuration.EnableSupervisor Maven / Gradle / Ivy

The newest version!
/*
 * Copyright 2022-2024 Ponfee (http://www.ponfee.cn/)
 *
 * 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
 *
 *     https://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 cn.ponfee.disjob.supervisor.configuration;

import cn.ponfee.disjob.common.spring.SpringUtils;
import cn.ponfee.disjob.common.util.ClassUtils;
import cn.ponfee.disjob.core.base.BasicDeferredImportSelector;
import cn.ponfee.disjob.core.base.CoreUtils;
import cn.ponfee.disjob.core.base.Supervisor;
import cn.ponfee.disjob.supervisor.SupervisorStartup;
import cn.ponfee.disjob.supervisor.base.GroupInfoImpl;
import cn.ponfee.disjob.supervisor.configuration.EnableSupervisor.EnableSupervisorConfiguration;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.boot.web.context.WebServerApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Import;

import java.lang.annotation.*;

import static cn.ponfee.disjob.core.base.JobConstants.SPRING_BEAN_NAME_LOCAL_SUPERVISOR;

/**
 * Enable supervisor role
 * 

必须注解到具有@Component的类上且该类能被spring扫描到 * *

 * `@AutoConfigureBefore、@AutoConfigureAfter、@AutoConfigureOrder:
 *   1)专门用于控制Spring-boot自动配置类之间的加载顺序(用户自定义的类是排在自动配置类`EnableAutoConfiguration`的前面)
 *   2)Spring-boot`2.7.x`配置文件位置:`META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`
 *
 * `@Order、@Priority、PriorityOrdered、Ordered
 *   1)用户自定义的类之间的创建顺序是按照文件的目录结构从上到下排序且无法干预
 *   2)影响List元素的顺序,间接影响列表中bean的方法执行顺序,本质上是beanList.sort(AnnotationAwareOrderComparator.INSTANCE)
 *   3)`@Priority/PriorityOrdered`优先于`@Order/Ordered`
 *
 * `@Import(DisjobCoreDeferredImportSelector.class)
 *   1)多处@Import(XXX.class)同一个类,只会有一个生效,后面的会被去重忽略
 *   2)如果一个类即有@Component注解,又被@Import引入,则@Component生效,@Import被忽略
 * 
* * @author Ponfee */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) @Documented @Import({ EnableSupervisorConfiguration.class, BasicDeferredImportSelector.class, SupervisorDeferredImportSelector.class, SupervisorLifecycle.class }) public @interface EnableSupervisor { @EnableConfigurationProperties(SupervisorProperties.class) @ComponentScan(basePackageClasses = SupervisorStartup.class) class EnableSupervisorConfiguration { @Bean(SPRING_BEAN_NAME_LOCAL_SUPERVISOR) public Supervisor.Local localSupervisor(WebServerApplicationContext webServerApplicationContext) { int port = SpringUtils.getActualWebServerPort(webServerApplicationContext); Object[] args = {CoreUtils.getLocalHost(), port, GroupInfoImpl.INSTANCE}; try { // inject local supervisor: Supervisor.class.getDeclaredClasses()[0] return ClassUtils.invoke(Class.forName(Supervisor.Local.class.getName()), "create", args); } catch (Exception e) { // cannot happen throw new Error("Creates Supervisor.Local instance occur error.", e); } } } }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy