org.apache.maven.settings.building
Interface SettingsBuildingRequest

All Known Implementing Classes:

DefaultSettingsBuildingRequest

public interface SettingsBuildingRequest

Collects settings that control the building of effective settings.

Author:

Benjamin Bentmann

Method Summary

File	getGlobalSettingsFile() Gets the global settings file.
Properties	getSystemProperties() Gets the system properties to use for interpolation.
Properties	getUserProperties() Gets the user properties to use for interpolation.
File	getUserSettingsFile() Gets the user settings file.
SettingsBuildingRequest	setGlobalSettingsFile(File globalSettingsFile) Sets the global settings file.
SettingsBuildingRequest	setSystemProperties(Properties systemProperties) Sets the system properties to use for interpolation.
SettingsBuildingRequest	setUserProperties(Properties userProperties) Sets the user properties to use for interpolation.
SettingsBuildingRequest	setUserSettingsFile(File userSettingsFile) Sets the user settings file.

Method Detail

getGlobalSettingsFile

File getGlobalSettingsFile()

Gets the global settings file.

Returns:

The global settings file or null if none.

setGlobalSettingsFile

SettingsBuildingRequest setGlobalSettingsFile(File globalSettingsFile)

Sets the global settings file. A non-existent settings file is equivalent to empty settings. If both a user settings file and a global settings file are given, the user settings take precedence.

Parameters:

globalSettingsFile - The global settings file, may be null to disable global settings.

Returns:

This request, never null.

getUserSettingsFile

File getUserSettingsFile()

Gets the user settings file.

Returns:

The user settings file or null if none.

setUserSettingsFile

SettingsBuildingRequest setUserSettingsFile(File userSettingsFile)

Sets the user settings file. A non-existent settings file is equivalent to empty settings. If both a user settings file and a global settings file are given, the user settings take precedence.

Parameters:

userSettingsFile - The user settings file, may be null to disable user settings.

Returns:

This request, never null.

getSystemProperties

Properties getSystemProperties()

Gets the system properties to use for interpolation. The system properties are collected from the runtime environment like System.getProperties() and environment variables.

Returns:

The system properties, never null.

setSystemProperties

SettingsBuildingRequest setSystemProperties(Properties systemProperties)

Sets the system properties to use for interpolation. The system properties are collected from the runtime environment like System.getProperties() and environment variables.

Parameters:

systemProperties - The system properties, may be null.

Returns:

This request, never null.

getUserProperties

Properties getUserProperties()

Gets the user properties to use for interpolation. The user properties have been configured directly by the user on his discretion, e.g. via the -Dkey=value parameter on the command line.

Returns:

The user properties, never null.

setUserProperties

SettingsBuildingRequest setUserProperties(Properties userProperties)

Sets the user properties to use for interpolation. The user properties have been configured directly by the user on his discretion, e.g. via the -Dkey=value parameter on the command line.

Parameters:

userProperties - The user properties, may be null.

Returns:

This request, never null.