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.


Copyright © 2001-2010 The Apache Software Foundation. All Rights Reserved.