org.springframework.boot.context.listener

Class FileEncodingApplicationListener

java.lang.Object

org.springframework.boot.context.listener.FileEncodingApplicationListener

All Implemented Interfaces:

EventListener, org.springframework.context.ApplicationListener<SpringApplicationEnvironmentAvailableEvent>

public class FileEncodingApplicationListener
extends Object
implements org.springframework.context.ApplicationListener<SpringApplicationEnvironmentAvailableEvent>

An ApplicationListenerthat halts application startup if the system file encoding does not match an expected value set in the environment. By default has no effect, but if you set spring.mandatory_file_encoding (or some camelCase or UPPERCASE variant of that) to the name of a character encoding (e.g. "UTF-8") then this initializer throws an exception when the file.encoding System property does not equal it.

The System property file.encoding is normally set by the JVM in response to the LANG or LC_ALL environment variables. It is used (along with other platform-dependent variables keyed off those environment variables) to encode JVM arguments as well as file names and paths. In most cases you can override the file encoding System property on the command line (with standard JVM features), but also consider setting the LANG environment variable to an explicit character-encoding value (e.g. "en_GB.UTF-8").

Author:

Dave Syer

Constructor Summary

Constructors

Constructor and Description
FileEncodingApplicationListener()

Method Summary

Methods

Modifier and Type	Method and Description
void	onApplicationEvent(SpringApplicationEnvironmentAvailableEvent event)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FileEncodingApplicationListener

public FileEncodingApplicationListener()

Method Detail

onApplicationEvent

public void onApplicationEvent(SpringApplicationEnvironmentAvailableEvent event)

Specified by:

onApplicationEvent in interface org.springframework.context.ApplicationListener<SpringApplicationEnvironmentAvailableEvent>