org.springframework.boot.system

Class ApplicationPidFileWriter

java.lang.Object

org.springframework.boot.system.ApplicationPidFileWriter

All Implemented Interfaces:

EventListener, ApplicationListener<SpringApplicationEvent>, Ordered

public class ApplicationPidFileWriter
extends Object
implements ApplicationListener<SpringApplicationEvent>, Ordered

An ApplicationListener that saves application PID into file. This application listener will be triggered exactly once per JVM, and the file name can be overridden at runtime with a System property or environment variable named "PIDFILE" (or "pidfile") or using a spring.pid.file property in the Spring Environment.

If PID file can not be created no exception is reported. This behavior can be changed by assigning true to System property or environment variable named PID_FAIL_ON_WRITE_ERROR (or "pid_fail_on_write_error") or to spring.pid.fail-on-write-error property in the Spring Environment.

Note: access to the Spring Environment is only possible when the triggerEventType is set to ApplicationEnvironmentPreparedEvent, ApplicationReadyEvent, or ApplicationPreparedEvent.

Since:

1.4.0

Author:

Jakub Kubrynski, Dave Syer, Phillip Webb, Tomasz Przybyla, Madhura Bhave

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
ApplicationPidFileWriter() Create a new ApplicationPidFileWriter instance using the filename 'application.pid'.
ApplicationPidFileWriter(File file) Create a new ApplicationPidFileWriter instance with a specified file.
ApplicationPidFileWriter(String filename) Create a new ApplicationPidFileWriter instance with a specified filename.

Method Summary

Modifier and Type	Method and Description
int	getOrder()
void	onApplicationEvent(SpringApplicationEvent event)
protected static void	reset() Reset the created flag for testing purposes.
void	setOrder(int order)
void	setTriggerEventType(Class<? extends SpringApplicationEvent> triggerEventType) Sets the type of application event that will trigger writing of the PID file.

Methods inherited from class java.lang.Object

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

Constructor Detail

ApplicationPidFileWriter

public ApplicationPidFileWriter()

Create a new ApplicationPidFileWriter instance using the filename 'application.pid'.

ApplicationPidFileWriter

public ApplicationPidFileWriter(String filename)

Create a new ApplicationPidFileWriter instance with a specified filename.

Parameters:

filename - the name of file containing pid

ApplicationPidFileWriter

public ApplicationPidFileWriter(File file)

Create a new ApplicationPidFileWriter instance with a specified file.

Parameters:

file - the file containing pid

Method Detail

setTriggerEventType

public void setTriggerEventType(Class<? extends SpringApplicationEvent> triggerEventType)

Sets the type of application event that will trigger writing of the PID file. Defaults to ApplicationPreparedEvent. NOTE: If you use the ApplicationStartingEvent to trigger the write, you will not be able to specify the PID filename in the Spring Environment.

Parameters:

triggerEventType - the trigger event type

onApplicationEvent

public void onApplicationEvent(SpringApplicationEvent event)

Specified by:

onApplicationEvent in interface ApplicationListener<SpringApplicationEvent>

setOrder

public void setOrder(int order)

getOrder

public int getOrder()

Specified by:

getOrder in interface Ordered

reset

protected static void reset()

Reset the created flag for testing purposes.