@Mutable @ThreadSafety(level=NOT_THREADSAFE) public final class ExportTaskProperties extends java.lang.Object
NOTE: This class, and other classes within the
com.unboundid.ldap.sdk.unboundidds
package structure, are only
supported for use against Ping Identity, UnboundID, and
Nokia/Alcatel-Lucent 8661 server products. These classes provide support
for proprietary functionality or for external specifications that are not
considered stable or mature enough to be guaranteed to work in an
interoperable way with other types of LDAP servers.
Constructor and Description |
---|
ExportTaskProperties(ExportTask task)
Creates a new set of export task properties from the settings for the
provided task.
|
ExportTaskProperties(ExportTaskProperties properties)
Creates a new set of export task properties as a copy of the provided set
of properties.
|
ExportTaskProperties(java.lang.String backendID,
java.lang.String ldifFile)
Creates a new set of export task properties without default values for
all properties except those specified.
|
Modifier and Type | Method and Description |
---|---|
boolean |
appendToLDIF()
Indicates whether to append to an existing LDIF file rather than
overwriting it.
|
boolean |
compress()
Indicates whether the LDIF file should be compressed.
|
boolean |
encrypt()
Indicates whether the LDIF file should be encrypted.
|
java.lang.Boolean |
getAlertOnError()
Retrieves the flag that indicates whether the server should send an
administrative alert notification if the task does not complete
successfully.
|
java.lang.Boolean |
getAlertOnStart()
Retrieves the flag that indicates whether the server should send an
administrative alert notification when the task starts running.
|
java.lang.Boolean |
getAlertOnSuccess()
Retrieves the flag that indicates whether the server should send an
administrative alert notification if the task completes successfully.
|
java.lang.String |
getBackendID()
Retrieves the backend ID of the backend to be exported.
|
java.util.List<java.lang.String> |
getDependencyIDs()
Retrieves the task IDs for any tasks that must complete before the new
collect support data task will be eligible to start running.
|
java.lang.String |
getEncryptionPassphraseFile()
Retrieves the path to a file containing the passphrase to use to generate
the encryption key.
|
java.lang.String |
getEncryptionSettingsDefinitionID()
Retrieves the ID of the encryption settings definition to use to generate
the encryption key.
|
java.util.List<java.lang.String> |
getExcludeAttributes()
Retrieves the names of the attributes to exclude from the exported entries.
|
java.util.List<java.lang.String> |
getExcludeBranches()
Retrieves the set of base DNs for the subtrees to exclude from the export.
|
java.util.List<java.lang.String> |
getExcludeFilters()
Retrieves a set of filter strings to use to identify entries to exclude
from the export.
|
FailedDependencyAction |
getFailedDependencyAction()
Retrieves the action that the server should take if any of the tasks on
which the new task depends did not complete successfully.
|
java.util.List<java.lang.String> |
getIncludeAttributes()
Retrieves the names of the attributes to include in the exported entries.
|
java.util.List<java.lang.String> |
getIncludeBranches()
Retrieves the set of base DNs for the subtrees to include in the export.
|
java.util.List<java.lang.String> |
getIncludeFilters()
Retrieves a set of filter strings to use to identify entries to include in
the export.
|
java.lang.String |
getLDIFFile()
Retrieves the path to the LDIF file to be written.
|
java.lang.Integer |
getMaxMegabytesPerSecond()
Retrieves the maximum rate at which the LDIF file should be written, in
megabytes per second.
|
java.util.List<java.lang.String> |
getNotifyOnCompletion()
Retrieves the addresses to email whenever the task completes, regardless of
its success or failure.
|
java.util.List<java.lang.String> |
getNotifyOnError()
Retrieves the addresses to email if the task does not complete
successfully.
|
java.util.List<java.lang.String> |
getNotifyOnStart()
Retrieves the addresses to email whenever the task starts running.
|
java.util.List<java.lang.String> |
getNotifyOnSuccess()
Retrieves the addresses to email if the task completes successfully.
|
java.util.List<java.lang.String> |
getPostExportTaskProcessors()
Retrieves a list containing the names or DNs of any post-LDIF-export task
processors that should be invoked for the export.
|
java.util.Date |
getScheduledStartTime()
Retrieves the earliest time that the task should be eligible to start
running.
|
java.lang.String |
getTaskID()
Retrieves the task ID that should be used for the task.
|
int |
getWrapColumn()
Retrieves the column at which long lines should be wrapped.
|
void |
setAlertOnError(java.lang.Boolean alertOnError)
Specifies the flag that indicates whether the server should send an
administrative alert notification if the task does not complete
successfully.
|
void |
setAlertOnStart(java.lang.Boolean alertOnStart)
Specifies the flag that indicates whether the server should send an
administrative alert notification when the task starts running.
|
void |
setAlertOnSuccess(java.lang.Boolean alertOnSuccess)
Specifies the flag that indicates whether the server should send an
administrative alert notification if the task completes successfully.
|
void |
setAppendToLDIF(boolean appendToLDIF)
Specifies whether to append to an existing LDIF file rather than
overwriting it.
|
void |
setBackendID(java.lang.String backendID)
Specifies the backend ID of the backend to be exported.
|
void |
setCompress(boolean compress)
Specifies whether the LDIF file should be compressed.
|
void |
setDependencyIDs(java.util.List<java.lang.String> dependencyIDs)
Specifies the task IDs for any tasks that must complete before the new
collect support data task will be eligible to start running.
|
void |
setEncrypt(boolean encrypt)
Specifies whether the LDIF file should be encrypted.
|
void |
setEncryptionPassphraseFile(java.lang.String encryptionPassphraseFile)
Specifies the path to a file containing the passphrase to use to generate
the encryption key.
|
void |
setEncryptionSettingsDefinitionID(java.lang.String encryptionSettingsDefinitionID)
Specifies the ID of the encryption settings definition to use to generate
the encryption key.
|
void |
setExcludeAttributes(java.util.List<java.lang.String> excludeAttributes)
Specifies the names of the attributes to exclude from the exported entries.
|
void |
setExcludeBranches(java.util.List<java.lang.String> excludeBranches)
Specifies the set of base DNs for the subtrees to exclude from the export.
|
void |
setExcludeFilters(java.util.List<java.lang.String> excludeFilters)
Specifies a set of filter strings to use to identify entries to exclude
from the export.
|
void |
setFailedDependencyAction(FailedDependencyAction failedDependencyAction)
Specifies the action that the server should take if any of the tasks on
which the new task depends did not complete successfully.
|
void |
setIncludeAttributes(java.util.List<java.lang.String> includeAttributes)
Specifies the names of the attributes to include in the exported entries.
|
void |
setIncludeBranches(java.util.List<java.lang.String> includeBranches)
Specifies the set of base DNs for the subtrees to include in the export.
|
void |
setIncludeFilters(java.util.List<java.lang.String> includeFilters)
Specifies a set of filter strings to use to identify entries to include in
the export.
|
void |
setLDIFFile(java.lang.String ldifFile)
Specifies the path to the LDIF file to be written.
|
void |
setMaxMegabytesPerSecond(java.lang.Integer maxMegabytesPerSecond)
Specifies the maximum rate at which the LDIF file should be written, in
megabytes per second.
|
void |
setNotifyOnCompletion(java.util.List<java.lang.String> notifyOnCompletion)
Specifies the addresses to email whenever the task completes, regardless of
its success or failure.
|
void |
setNotifyOnError(java.util.List<java.lang.String> notifyOnError)
Specifies the addresses to email if the task does not complete
successfully.
|
void |
setNotifyOnStart(java.util.List<java.lang.String> notifyOnStart)
Specifies the addresses to email whenever the task starts running.
|
void |
setNotifyOnSuccess(java.util.List<java.lang.String> notifyOnSuccess)
Specifies the addresses to email if the task completes successfully.
|
void |
setPostExportTaskProcessors(java.util.List<java.lang.String> postExportTaskProcessors)
Specifies a list containing the names or DNs of any post-LDIF-export task
processors that should be invoked for the export.
|
void |
setScheduledStartTime(java.util.Date scheduledStartTime)
Specifies the earliest time that the task should be eligible to start
running.
|
void |
setSign(boolean sign)
Specifies whether the LDIF file should be cryptographically signed.
|
void |
setTaskID(java.lang.String taskID)
Specifies the task ID that should be used for the task.
|
void |
setWrapColumn(int wrapColumn)
Specifies the column at which long lines should be wrapped.
|
boolean |
sign()
Indicates whether the LDIF file should be cryptographically signed.
|
java.lang.String |
toString()
Retrieves a string representation of this collect support data task
properties object.
|
void |
toString(java.lang.StringBuilder buffer)
Appends a string representation of this collect support data task
properties object to the provided buffer.
|
public ExportTaskProperties(@NotNull java.lang.String backendID, @NotNull java.lang.String ldifFile)
backendID
- The backend ID of the backend containing the data to
export. It must not be null
.ldifFile
- The path to the LDIF file to create. It may be an
absolute path or a path relative to the server install
root. It must not be null
.public ExportTaskProperties(@NotNull ExportTaskProperties properties)
properties
- The export task properties that should be used to
create the new export task properties object. It must
not be null
.public ExportTaskProperties(@NotNull ExportTask task)
task
- The export task to use to create the task properties.@NotNull public java.lang.String getBackendID()
public void setBackendID(@NotNull java.lang.String backendID)
backendID
- The backend ID of the backend to be exported. It must
not be null
.@NotNull public java.lang.String getLDIFFile()
public void setLDIFFile(@NotNull java.lang.String ldifFile)
ldifFile
- The path to the LDIF file to be written. It may be an
absolute path or one that is relative to the server
root. It must not be null
.public boolean appendToLDIF()
true
if the export should append to an existing LDIF file,
or false
if the existing file should be overwritten.public void setAppendToLDIF(boolean appendToLDIF)
appendToLDIF
- Indicates whether to append to an existing LDIF file
rather than overwriting it.@NotNull public java.util.List<java.lang.String> getIncludeBranches()
public void setIncludeBranches(@Nullable java.util.List<java.lang.String> includeBranches)
includeBranches
- The set of base DNs for the subtrees to include in
the export. It may be null
or empty if no
include branches should be specified.@NotNull public java.util.List<java.lang.String> getExcludeBranches()
public void setExcludeBranches(@Nullable java.util.List<java.lang.String> excludeBranches)
excludeBranches
- The set of base DNs for the subtrees to exclude
from the export. It may be null
or empty
if no exclude branches should be specified.@NotNull public java.util.List<java.lang.String> getIncludeFilters()
public void setIncludeFilters(@Nullable java.util.List<java.lang.String> includeFilters)
includeFilters
- A set of filter strings to use to identify entries
to include in the export. It may be null
or empty if no include filters should be specified.@NotNull public java.util.List<java.lang.String> getExcludeFilters()
public void setExcludeFilters(@Nullable java.util.List<java.lang.String> excludeFilters)
excludeFilters
- A set of filter strings to use to identify entries
to exclude from the export. It may be null
or empty if no exclude filters should be specified.@NotNull public java.util.List<java.lang.String> getIncludeAttributes()
public void setIncludeAttributes(@Nullable java.util.List<java.lang.String> includeAttributes)
includeAttributes
- The names of the attributes to include in the
exported entries. It may be null
or
empty if no include attributes should be
specified.@NotNull public java.util.List<java.lang.String> getExcludeAttributes()
public void setExcludeAttributes(@Nullable java.util.List<java.lang.String> excludeAttributes)
excludeAttributes
- The names of the attributes to exclude from the
exported entries. It may be null
or
empty if no exclude attributes should be
specified.public int getWrapColumn()
public void setWrapColumn(int wrapColumn)
wrapColumn
- The column at which long lines should be wrapped. It
may be less than or equal to zero if long lines should
not be wrapped.public boolean compress()
true
if the LDIF file should be compressed, or
false
if not.public void setCompress(boolean compress)
compress
- Indicates whether the LDIF file should be compressed.public boolean encrypt()
true
if the LDIF file should be encrypted, or
false
if not.public void setEncrypt(boolean encrypt)
encrypt
- Indicates whether the LDIF file should be encrypted.@Nullable public java.lang.String getEncryptionPassphraseFile()
null
if the LDIF file should not
be encrypted or if it should be encrypted with a key obtained
through some other means.public void setEncryptionPassphraseFile(@Nullable java.lang.String encryptionPassphraseFile)
encryptionPassphraseFile
- The path to a file containing the
passphrase to use to generate the
encryption key. It may be null
if the LDIF file should not be encrypted
or if it should be encrypted with a key
obtained through some other means.@Nullable public java.lang.String getEncryptionSettingsDefinitionID()
null
if the LDIF file should not be
encrypted, if it should be encrypted with the server's preferred
encryption settings definition, or if it should be encrypted with
a key obtained through some other means.public void setEncryptionSettingsDefinitionID(@Nullable java.lang.String encryptionSettingsDefinitionID)
encryptionSettingsDefinitionID
- The ID of the encryption settings
definition to use to generate the
encryption key. It may be
null
if the LDIF file
should not be encrypted, if it
should be encrypted with the
server's preferred encryption
settings definition, or if it
should be encrypted with a key
obtained through some other means.public boolean sign()
true
if the LDIF file should be cryptographically signed,
or false
if not.public void setSign(boolean sign)
sign
- Indicates whether the LDIF file should be cryptographically
signed.@Nullable public java.lang.Integer getMaxMegabytesPerSecond()
null
if no rate limiting should
be used.public void setMaxMegabytesPerSecond(@Nullable java.lang.Integer maxMegabytesPerSecond)
maxMegabytesPerSecond
- The maximum rate at which the LDIF file
should be written, in megabytes per second.
A value of null
, or one that is less
than or equal to zero, indicates that no
rate limiting should be used.@NotNull public java.util.List<java.lang.String> getPostExportTaskProcessors()
public void setPostExportTaskProcessors(@Nullable java.util.List<java.lang.String> postExportTaskProcessors)
postExportTaskProcessors
- A list containing the names or DNs of any
post-LDIF-export task processors that
should be invoked for the export. It may
be null
or empty if no
post-LDIF-export task processors should
be invoked.@Nullable public java.lang.String getTaskID()
null
if a
random UUID should be generated for use as the task ID.public void setTaskID(@Nullable java.lang.String taskID)
taskID
- The task ID that should be used for the task. It may be
null
if a random UUID should be generated for use
as the task ID.@Nullable public java.util.Date getScheduledStartTime()
null
if the task should be eligible to start
immediately (or as soon as all of its dependencies have been
satisfied).public void setScheduledStartTime(@Nullable java.util.Date scheduledStartTime)
scheduledStartTime
- The earliest time that the task should be
eligible to start running. It may be
null
if the task should be eligible to
start immediately (or as soon as all of its
dependencies have been satisfied).@NotNull public java.util.List<java.lang.String> getDependencyIDs()
public void setDependencyIDs(@Nullable java.util.List<java.lang.String> dependencyIDs)
dependencyIDs
- The task IDs for any tasks that must complete before
the new collect support data task will be eligible
to start running. It may be null
or empty
if the new task should not depend on any other
tasks.@Nullable public FailedDependencyAction getFailedDependencyAction()
null
if the property should not be specified when creating
the task (and the server should choose an appropriate failed
dependency action).public void setFailedDependencyAction(@Nullable FailedDependencyAction failedDependencyAction)
failedDependencyAction
- The action that the server should take if
any of the tasks on which the new task
depends did not complete successfully. It
may be null
if the property should
not be specified when creating the task
(and the server should choose an
appropriate failed dependency action).@NotNull public java.util.List<java.lang.String> getNotifyOnStart()
public void setNotifyOnStart(@Nullable java.util.List<java.lang.String> notifyOnStart)
notifyOnStart
- The addresses to email whenever the task starts
running. It amy be null
or empty if no
email notification should be sent when starting the
task.@NotNull public java.util.List<java.lang.String> getNotifyOnCompletion()
public void setNotifyOnCompletion(@Nullable java.util.List<java.lang.String> notifyOnCompletion)
notifyOnCompletion
- The addresses to email whenever the task
completes. It amy be null
or empty if
no email notification should be sent when the
task completes.@NotNull public java.util.List<java.lang.String> getNotifyOnSuccess()
public void setNotifyOnSuccess(@Nullable java.util.List<java.lang.String> notifyOnSuccess)
notifyOnSuccess
- The addresses to email if the task completes
successfully. It amy be null
or empty if
no email notification should be sent on
successful completion.@NotNull public java.util.List<java.lang.String> getNotifyOnError()
public void setNotifyOnError(@Nullable java.util.List<java.lang.String> notifyOnError)
notifyOnError
- The addresses to email if the task does not complete
successfully. It amy be null
or empty if
no email notification should be sent on an
unsuccessful completion.@Nullable public java.lang.Boolean getAlertOnStart()
null
if the property should not be specified when the
task is created (and the server will default to not sending any
alert).public void setAlertOnStart(@Nullable java.lang.Boolean alertOnStart)
alertOnStart
- The flag that indicates whether the server should
send an administrative alert notification when the
task starts running, It may be null
if the
property should not be specified when the task is
created (and the server will default to not sending
any alert).@Nullable public java.lang.Boolean getAlertOnSuccess()
null
if the property should not be
specified when the task is created (and the server will default to
not sending any alert).public void setAlertOnSuccess(@Nullable java.lang.Boolean alertOnSuccess)
alertOnSuccess
- The flag that indicates whether the server should
send an administrative alert notification if the
task completes successfully, It may be
null
if the property should not be
specified when the task is created (and the server
will default to not sending any alert).@Nullable public java.lang.Boolean getAlertOnError()
null
if the property should not be
specified when the task is created (and the server will default to
not sending any alert).public void setAlertOnError(@Nullable java.lang.Boolean alertOnError)
alertOnError
- The flag that indicates whether the server should
send an administrative alert notification if the task
does not complete successfully, It may be
null
if the property should not be specified
when the task is created (and the server will default
to not sending any alert).@NotNull public java.lang.String toString()
toString
in class java.lang.Object