/*
 * Copyright 2012-2020 the original author or authors.
 *
 * 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 org.springframework.boot.devtools.remote.client;

import java.net.InetSocketAddress;
import java.net.Proxy.Type;
import java.net.URL;
import java.util.Collections;
import java.util.List;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

import org.springframework.beans.factory.InitializingBean;
import org.springframework.beans.factory.ObjectProvider;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.boot.devtools.autoconfigure.DevToolsProperties;
import org.springframework.boot.devtools.autoconfigure.DevToolsProperties.Restart;
import org.springframework.boot.devtools.autoconfigure.OptionalLiveReloadServer;
import org.springframework.boot.devtools.autoconfigure.RemoteDevToolsProperties;
import org.springframework.boot.devtools.autoconfigure.RemoteDevToolsProperties.Proxy;
import org.springframework.boot.devtools.autoconfigure.TriggerFileFilter;
import org.springframework.boot.devtools.classpath.ClassPathChangedEvent;
import org.springframework.boot.devtools.classpath.ClassPathFileSystemWatcher;
import org.springframework.boot.devtools.classpath.ClassPathRestartStrategy;
import org.springframework.boot.devtools.classpath.PatternClassPathRestartStrategy;
import org.springframework.boot.devtools.filewatch.FileSystemWatcher;
import org.springframework.boot.devtools.filewatch.FileSystemWatcherFactory;
import org.springframework.boot.devtools.livereload.LiveReloadServer;
import org.springframework.boot.devtools.restart.DefaultRestartInitializer;
import org.springframework.boot.devtools.restart.RestartScope;
import org.springframework.boot.devtools.restart.Restarter;
import org.springframework.context.ApplicationListener;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.support.PropertySourcesPlaceholderConfigurer;
import org.springframework.core.log.LogMessage;
import org.springframework.http.client.ClientHttpRequestFactory;
import org.springframework.http.client.ClientHttpRequestInterceptor;
import org.springframework.http.client.InterceptingClientHttpRequestFactory;
import org.springframework.http.client.SimpleClientHttpRequestFactory;
import org.springframework.util.Assert;
import org.springframework.util.StringUtils;

Configuration used to connect to remote Spring Boot applications.
Author:Phillip Webb
See Also:
Since:1.3.0
/** * Configuration used to connect to remote Spring Boot applications. * * @author Phillip Webb * @since 1.3.0 * @see org.springframework.boot.devtools.RemoteSpringApplication */
@Configuration(proxyBeanMethods = false) @EnableConfigurationProperties(DevToolsProperties.class) public class RemoteClientConfiguration implements InitializingBean { private static final Log logger = LogFactory.getLog(RemoteClientConfiguration.class); private final DevToolsProperties properties; @Value("${remoteUrl}") private String remoteUrl; public RemoteClientConfiguration(DevToolsProperties properties) { this.properties = properties; } @Bean public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() { return new PropertySourcesPlaceholderConfigurer(); } @Bean public ClientHttpRequestFactory clientHttpRequestFactory() { List<ClientHttpRequestInterceptor> interceptors = Collections.singletonList(getSecurityInterceptor()); SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory(); Proxy proxy = this.properties.getRemote().getProxy(); if (proxy.getHost() != null && proxy.getPort() != null) { requestFactory .setProxy(new java.net.Proxy(Type.HTTP, new InetSocketAddress(proxy.getHost(), proxy.getPort()))); } return new InterceptingClientHttpRequestFactory(requestFactory, interceptors); } private ClientHttpRequestInterceptor getSecurityInterceptor() { RemoteDevToolsProperties remoteProperties = this.properties.getRemote(); String secretHeaderName = remoteProperties.getSecretHeaderName(); String secret = remoteProperties.getSecret(); Assert.state(secret != null, "The environment value 'spring.devtools.remote.secret' is required to secure your connection."); return new HttpHeaderInterceptor(secretHeaderName, secret); } @Override public void afterPropertiesSet() { logWarnings(); } private void logWarnings() { RemoteDevToolsProperties remoteProperties = this.properties.getRemote(); if (!remoteProperties.getRestart().isEnabled()) { logger.warn("Remote restart is disabled."); } if (!this.remoteUrl.startsWith("https://")) { logger.warn(LogMessage.format( "The connection to %s is insecure. You should use a URL starting with 'https://'.", this.remoteUrl)); } }
LiveReload configuration.
/** * LiveReload configuration. */
@Configuration(proxyBeanMethods = false) @ConditionalOnProperty(prefix = "spring.devtools.livereload", name = "enabled", matchIfMissing = true) static class LiveReloadConfiguration { private final DevToolsProperties properties; private final ClientHttpRequestFactory clientHttpRequestFactory; private final String remoteUrl; private ExecutorService executor = Executors.newSingleThreadExecutor(); LiveReloadConfiguration(DevToolsProperties properties, ClientHttpRequestFactory clientHttpRequestFactory, @Value("${remoteUrl}") String remoteUrl) { this.properties = properties; this.clientHttpRequestFactory = clientHttpRequestFactory; this.remoteUrl = remoteUrl; } @Bean @RestartScope @ConditionalOnMissingBean LiveReloadServer liveReloadServer() { return new LiveReloadServer(this.properties.getLivereload().getPort(), Restarter.getInstance().getThreadFactory()); } @Bean ApplicationListener<ClassPathChangedEvent> liveReloadTriggeringClassPathChangedEventListener( OptionalLiveReloadServer optionalLiveReloadServer) { return (event) -> { String url = this.remoteUrl + this.properties.getRemote().getContextPath(); this.executor.execute( new DelayedLiveReloadTrigger(optionalLiveReloadServer, this.clientHttpRequestFactory, url)); }; } @Bean OptionalLiveReloadServer optionalLiveReloadServer(ObjectProvider<LiveReloadServer> liveReloadServer) { return new OptionalLiveReloadServer(liveReloadServer.getIfAvailable()); } final ExecutorService getExecutor() { return this.executor; } }
Client configuration for remote update and restarts.
/** * Client configuration for remote update and restarts. */
@Configuration(proxyBeanMethods = false) @ConditionalOnProperty(prefix = "spring.devtools.remote.restart", name = "enabled", matchIfMissing = true) static class RemoteRestartClientConfiguration { private final DevToolsProperties properties; RemoteRestartClientConfiguration(DevToolsProperties properties) { this.properties = properties; } @Bean ClassPathFileSystemWatcher classPathFileSystemWatcher(FileSystemWatcherFactory fileSystemWatcherFactory, ClassPathRestartStrategy classPathRestartStrategy) { DefaultRestartInitializer restartInitializer = new DefaultRestartInitializer(); URL[] urls = restartInitializer.getInitialUrls(Thread.currentThread()); if (urls == null) { urls = new URL[0]; } return new ClassPathFileSystemWatcher(fileSystemWatcherFactory, classPathRestartStrategy, urls); } @Bean FileSystemWatcherFactory getFileSystemWatcherFactory() { return this::newFileSystemWatcher; } private FileSystemWatcher newFileSystemWatcher() { Restart restartProperties = this.properties.getRestart(); FileSystemWatcher watcher = new FileSystemWatcher(true, restartProperties.getPollInterval(), restartProperties.getQuietPeriod()); String triggerFile = restartProperties.getTriggerFile(); if (StringUtils.hasLength(triggerFile)) { watcher.setTriggerFilter(new TriggerFileFilter(triggerFile)); } return watcher; } @Bean ClassPathRestartStrategy classPathRestartStrategy() { return new PatternClassPathRestartStrategy(this.properties.getRestart().getAllExclude()); } @Bean ClassPathChangeUploader classPathChangeUploader(ClientHttpRequestFactory requestFactory, @Value("${remoteUrl}") String remoteUrl) { String url = remoteUrl + this.properties.getRemote().getContextPath() + "/restart"; return new ClassPathChangeUploader(url, requestFactory); } } }