org.opends.server.admin.std.client
Interface FileBasedDebugLogPublisherCfgClient

All Superinterfaces:
ConfigurationClient, DebugLogPublisherCfgClient, LogPublisherCfgClient

public interface FileBasedDebugLogPublisherCfgClient
extends DebugLogPublisherCfgClient

A client-side interface for reading and modifying File Based Debug Log Publisher settings.

File Based Debug Log Publishers publish debug messages to the file system.


Method Summary
 ManagedObjectDefinition<? extends FileBasedDebugLogPublisherCfgClient,? extends FileBasedDebugLogPublisherCfg> definition()
          Get the configuration definition associated with this File Based Debug Log Publisher.
 long getBufferSize()
          Gets the "buffer-size" property.
 java.lang.String getJavaClass()
          Gets the "java-class" property.
 java.lang.String getLogFile()
          Gets the "log-file" property.
 java.lang.String getLogFilePermissions()
          Gets the "log-file-permissions" property.
 int getQueueSize()
          Gets the "queue-size" property.
 java.util.SortedSet<java.lang.String> getRetentionPolicy()
          Gets the "retention-policy" property.
 java.util.SortedSet<java.lang.String> getRotationPolicy()
          Gets the "rotation-policy" property.
 long getTimeInterval()
          Gets the "time-interval" property.
 boolean isAppend()
          Gets the "append" property.
 boolean isAsynchronous()
          Gets the "asynchronous" property.
 boolean isAutoFlush()
          Gets the "auto-flush" property.
 void setAppend(java.lang.Boolean value)
          Sets the "append" property.
 void setAsynchronous(boolean value)
          Sets the "asynchronous" property.
 void setAutoFlush(java.lang.Boolean value)
          Sets the "auto-flush" property.
 void setBufferSize(java.lang.Long value)
          Sets the "buffer-size" property.
 void setJavaClass(java.lang.String value)
          Sets the "java-class" property.
 void setLogFile(java.lang.String value)
          Sets the "log-file" property.
 void setLogFilePermissions(java.lang.String value)
          Sets the "log-file-permissions" property.
 void setQueueSize(java.lang.Integer value)
          Sets the "queue-size" property.
 void setRetentionPolicy(java.util.Collection<java.lang.String> values)
          Sets the "retention-policy" property.
 void setRotationPolicy(java.util.Collection<java.lang.String> values)
          Sets the "rotation-policy" property.
 void setTimeInterval(java.lang.Long value)
          Sets the "time-interval" property.
 
Methods inherited from interface org.opends.server.admin.std.client.DebugLogPublisherCfgClient
createDebugTarget, getDebugTarget, getDefaultDebugCategory, getDefaultDebugLevel, getDefaultThrowableStackFrames, isDefaultIncludeThrowableCause, isDefaultOmitMethodEntryArguments, isDefaultOmitMethodReturnValue, listDebugTargets, removeDebugTarget, setDefaultDebugCategory, setDefaultDebugLevel, setDefaultIncludeThrowableCause, setDefaultOmitMethodEntryArguments, setDefaultOmitMethodReturnValue, setDefaultThrowableStackFrames
 
Methods inherited from interface org.opends.server.admin.std.client.LogPublisherCfgClient
isEnabled, setEnabled
 
Methods inherited from interface org.opends.server.admin.ConfigurationClient
commit, properties
 

Method Detail

definition

ManagedObjectDefinition<? extends FileBasedDebugLogPublisherCfgClient,? extends FileBasedDebugLogPublisherCfg> definition()
Get the configuration definition associated with this File Based Debug Log Publisher.

Specified by:
definition in interface ConfigurationClient
Specified by:
definition in interface DebugLogPublisherCfgClient
Specified by:
definition in interface LogPublisherCfgClient
Returns:
Returns the configuration definition associated with this File Based Debug Log Publisher.

isAppend

boolean isAppend()
Gets the "append" property.

Specifies whether to append to existing log files.

Returns:
Returns the value of the "append" property.

setAppend

void setAppend(java.lang.Boolean value)
               throws IllegalPropertyValueException
Sets the "append" property.

Specifies whether to append to existing log files.

Parameters:
value - The value of the "append" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

isAsynchronous

boolean isAsynchronous()
Gets the "asynchronous" property.

Indicates whether the File Based Debug Log Publisher will publish records asynchronously.

Returns:
Returns the value of the "asynchronous" property.

setAsynchronous

void setAsynchronous(boolean value)
                     throws IllegalPropertyValueException
Sets the "asynchronous" property.

Indicates whether the File Based Debug Log Publisher will publish records asynchronously.

Parameters:
value - The value of the "asynchronous" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

isAutoFlush

boolean isAutoFlush()
Gets the "auto-flush" property.

Specifies whether to flush the writer after every log record.

If the asynchronous writes option is used, the writer is flushed after all the log records in the queue are written.

Returns:
Returns the value of the "auto-flush" property.

setAutoFlush

void setAutoFlush(java.lang.Boolean value)
                  throws IllegalPropertyValueException
Sets the "auto-flush" property.

Specifies whether to flush the writer after every log record.

If the asynchronous writes option is used, the writer is flushed after all the log records in the queue are written.

Parameters:
value - The value of the "auto-flush" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getBufferSize

long getBufferSize()
Gets the "buffer-size" property.

Specifies the log file buffer size.

Returns:
Returns the value of the "buffer-size" property.

setBufferSize

void setBufferSize(java.lang.Long value)
                   throws IllegalPropertyValueException
Sets the "buffer-size" property.

Specifies the log file buffer size.

Parameters:
value - The value of the "buffer-size" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getJavaClass

java.lang.String getJavaClass()
Gets the "java-class" property.

The fully-qualified name of the Java class that provides the File Based Debug Log Publisher implementation.

Specified by:
getJavaClass in interface DebugLogPublisherCfgClient
Returns:
Returns the value of the "java-class" property.

setJavaClass

void setJavaClass(java.lang.String value)
                  throws IllegalPropertyValueException
Sets the "java-class" property.

The fully-qualified name of the Java class that provides the File Based Debug Log Publisher implementation.

Specified by:
setJavaClass in interface DebugLogPublisherCfgClient
Parameters:
value - The value of the "java-class" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getLogFile

java.lang.String getLogFile()
Gets the "log-file" property.

The file name to use for the log files generated by the File Based Debug Log Publisher .

The path to the file is relative to the server root.

Returns:
Returns the value of the "log-file" property.

setLogFile

void setLogFile(java.lang.String value)
                throws IllegalPropertyValueException
Sets the "log-file" property.

The file name to use for the log files generated by the File Based Debug Log Publisher .

The path to the file is relative to the server root.

Parameters:
value - The value of the "log-file" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getLogFilePermissions

java.lang.String getLogFilePermissions()
Gets the "log-file-permissions" property.

The UNIX permissions of the log files created by this File Based Debug Log Publisher .

Returns:
Returns the value of the "log-file-permissions" property.

setLogFilePermissions

void setLogFilePermissions(java.lang.String value)
                           throws IllegalPropertyValueException
Sets the "log-file-permissions" property.

The UNIX permissions of the log files created by this File Based Debug Log Publisher .

Parameters:
value - The value of the "log-file-permissions" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getQueueSize

int getQueueSize()
Gets the "queue-size" property.

The maximum number of log records that can be stored in the asynchronous queue.

Returns:
Returns the value of the "queue-size" property.

setQueueSize

void setQueueSize(java.lang.Integer value)
                  throws IllegalPropertyValueException
Sets the "queue-size" property.

The maximum number of log records that can be stored in the asynchronous queue.

Parameters:
value - The value of the "queue-size" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.

getRetentionPolicy

java.util.SortedSet<java.lang.String> getRetentionPolicy()
Gets the "retention-policy" property.

The retention policy to use for the File Based Debug Log Publisher .

When multiple policies are used, log files are cleaned when any of the policy's conditions are met.

Returns:
Returns the values of the "retention-policy" property.

setRetentionPolicy

void setRetentionPolicy(java.util.Collection<java.lang.String> values)
                        throws IllegalPropertyValueException
Sets the "retention-policy" property.

The retention policy to use for the File Based Debug Log Publisher .

When multiple policies are used, log files are cleaned when any of the policy's conditions are met.

Parameters:
values - The values of the "retention-policy" property.
Throws:
IllegalPropertyValueException - If one or more of the new values are invalid.

getRotationPolicy

java.util.SortedSet<java.lang.String> getRotationPolicy()
Gets the "rotation-policy" property.

The rotation policy to use for the File Based Debug Log Publisher .

When multiple policies are used, rotation will occur if any policy's conditions are met.

Returns:
Returns the values of the "rotation-policy" property.

setRotationPolicy

void setRotationPolicy(java.util.Collection<java.lang.String> values)
                       throws IllegalPropertyValueException
Sets the "rotation-policy" property.

The rotation policy to use for the File Based Debug Log Publisher .

When multiple policies are used, rotation will occur if any policy's conditions are met.

Parameters:
values - The values of the "rotation-policy" property.
Throws:
IllegalPropertyValueException - If one or more of the new values are invalid.

getTimeInterval

long getTimeInterval()
Gets the "time-interval" property.

Specifies the interval at which to check whether the log files need to be rotated.

Returns:
Returns the value of the "time-interval" property.

setTimeInterval

void setTimeInterval(java.lang.Long value)
                     throws IllegalPropertyValueException
Sets the "time-interval" property.

Specifies the interval at which to check whether the log files need to be rotated.

Parameters:
value - The value of the "time-interval" property.
Throws:
IllegalPropertyValueException - If the new value is invalid.