Package org.gradle.api.tasks

Klasse WriteProperties

java.lang.Object

org.gradle.api.internal.AbstractTask

org.gradle.api.DefaultTask

org.gradle.api.tasks.WriteProperties

Alle implementierten Schnittstellen:

Comparable<Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.TaskInternal, Named, ExtensionAware, Task, Configurable<Task>

@CacheableTask
public abstract class WriteProperties
extends DefaultTask

Writes a Properties in a way that the results can be expected to be reproducible.

There are a number of differences compared to how properties are stored:

• no timestamp comment is generated at the beginning of the file
• the lines in the resulting files are separated by a pre-set separator (defaults to '\n') instead of the system default line separator
• the properties are sorted alphabetically

Like with Properties, Unicode characters are escaped when using the default Latin-1 (ISO-8559-1) encoding.

Seit:

3.3

Siehe auch:

• Properties.store(OutputStream, String)

Verschachtelte Klassen - Übersicht

Von Schnittstelle geerbte verschachtelte Klassen/Schnittstellen org.gradle.api.Task

Task.Namer

Feldübersicht

Von Schnittstelle geerbte Felder org.gradle.api.Task

TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
WriteProperties()

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
String	getComment()	Returns the optional comment to add at the beginning of the properties file.
abstract RegularFileProperty	getDestinationFile()	The output properties file.
String	getEncoding()	Returns the encoding used to write the properties file.
String	getLineSeparator()	Returns the line separator to be used when creating the properties file.
File	getOutputFile()	Veraltet.
Map<String,String>	getProperties()	Returns an immutable view of properties to be written to the properties file.
void	properties(Map<String,Object> properties)	Adds multiple properties to be written to the properties file.
void	property(String name, Object value)	Adds a property to be written to the properties file.
void	setComment(String comment)	Sets the optional comment to add at the beginning of the properties file.
void	setEncoding(String encoding)	Sets the encoding used to write the properties file.
void	setLineSeparator(String lineSeparator)	Sets the line separator to be used when creating the properties file.
void	setOutputFile(File outputFile)	Veraltet. Use getDestinationFile() instead.
void	setOutputFile(Object outputFile)	Veraltet. Use getDestinationFile() instead.
void	setProperties(Map<String,Object> properties)	Sets all properties to be written to the properties file replacing any existing properties.
void	writeProperties()

Von Klasse geerbte Methoden org.gradle.api.DefaultTask

compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesService

Von Klasse geerbte Methoden org.gradle.api.internal.AbstractTask

acceptServiceReferences, appendParallelSafeAction, doNotTrackState, getAsDynamicObject, getConvention, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, setImpliesSubProjects

Von Klasse geerbte Methoden java.lang.Object

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

Von Schnittstelle geerbte Methoden org.gradle.api.Task

doNotTrackState, getConvention, notCompatibleWithConfigurationCache

Konstruktordetails

WriteProperties

public WriteProperties()

Methodendetails

getProperties

@Input
public Map<String,String> getProperties()

Returns an immutable view of properties to be written to the properties file.

Seit:

3.3

setProperties

public void setProperties(Map<String,Object> properties)

Sets all properties to be written to the properties file replacing any existing properties.

Siehe auch:

• properties(Map)
• property(String, Object)

property

public void property(String name,
 Object value)

Adds a property to be written to the properties file.

A property's value will be coerced to a String with String#valueOf(Object) or a Callable returning a value to be coerced into a String.

Values are not allowed to be null.

Parameter:

name - Name of the property

value - Value of the property

Seit:

3.4

properties

public void properties(Map<String,Object> properties)

Adds multiple properties to be written to the properties file.

This is a convenience method for calling property(String, Object) multiple times.

Parameter:

properties - Properties to be added

Seit:

3.4

Siehe auch:

• property(String, Object)

getLineSeparator

@Input
public String getLineSeparator()

Returns the line separator to be used when creating the properties file. Defaults to `\n`.

setLineSeparator

public void setLineSeparator(String lineSeparator)

Sets the line separator to be used when creating the properties file.

getComment

@Nullable
@Optional
@Input
public String getComment()

Returns the optional comment to add at the beginning of the properties file.

setComment

public void setComment(@Nullable
 String comment)

Sets the optional comment to add at the beginning of the properties file.

getEncoding

@Input
public String getEncoding()

Returns the encoding used to write the properties file. Defaults to ISO_8859_1. If set to anything different, unicode escaping is turned off.

setEncoding

public void setEncoding(String encoding)

Sets the encoding used to write the properties file. Defaults to ISO_8859_1. If set to anything different, unicode escaping is turned off.

getOutputFile

@Internal
@Deprecated
public File getOutputFile()

Veraltet.

Returns the output file to write the properties to.

setOutputFile

@Deprecated
public void setOutputFile(File outputFile)

Veraltet.

Use getDestinationFile() instead.

Sets the output file to write the properties to.

Seit:

4.0

setOutputFile

@Deprecated
public void setOutputFile(Object outputFile)

Veraltet.

Use getDestinationFile() instead.

Sets the output file to write the properties to.

getDestinationFile

@OutputFile
public abstract RegularFileProperty getDestinationFile()

The output properties file.

Seit:

8.1

writeProperties

public void writeProperties()
                     throws IOException

Löst aus:

IOException